erixwong Standard Anchor - 标准锚点识别工具集
为标准管理 App 的"锚点识别 agent"（引用清洗 agent）提供最小工具集。
工具
| 工具 | 说明 | 关键参数 |
|---|---|---|
parse_anchor |
解析锚点串 | anchor |
list_revision_sections |
按 revision_id 列出章节列表 | revision_id |
read_section_context |
读指定 section 正文及上下文（按 chunk 翻页） | outline_id, context_window, page, max_page_chars |
read_revision_content |
读指定 revision 全文（支持字符分页） | revision_id, max_chars, offset_chars |
get_section_locator |
outline_id 反查 document/revision 定位 | outline_id |
find_documents_by_standard_code |
按标准编号查找已纳管标准 | standard_code |
find_documents_by_standard_name |
按标准名称查找已纳管标准 | standard_name |
get_document_revisions |
获取文档版本列表 | document_id |
select_revision_candidate |
按版本线索筛选最匹配 revision（纯函数），无线索时按 publish_date 取最新（无日期回退 revision_no 降序） | revisions, hints |
find_section_candidates |
按节号/标题查找候选 section | document_id, revision_id, title_hint, seq_hint, query_text |
list_reference_gaps |
列出待回填引用缺口 | standard_id |
write_anchor_result |
写入引用判断结果（幂等） | standard_id, source_revision_id, source_outline_id, occurrence_index, source_text（必须是原文逐字连续子串），ref_type, status, source |
数据访问路径
工具运行在 VM 沙箱子进程，无数据库连接。读取业务数据通过 HTTP 回调文档平台 API：
API_BASE+USER_ACCESS_TOKEN由 skill-runner 自动注入- 请求头：
Authorization: Bearer ${process.env.USER_ACCESS_TOKEN}
parse_anchor
解析锚点字符串 <document_id+revision_id(+outline_id)>，返回结构化对象。
输入示例：
<doc123+rev456+out789>→{ document_id, revision_id, outline_id }<doc123+rev456>→{ document_id, revision_id, outline_id: null }
list_revision_sections
调用 GET /api/docs/revisions/:revision_id/outlines，返回章节列表（title, seq, from_line, to_line, outline_id）。
read_section_context
调用 GET /api/docs/outlines/:outline_id/section?page=0&max_page_chars=4000 获取 section 文本，可选前后相邻 section 对象作为上下文（由 context_window 控制前后各取几个相邻 outline）。
分页（R16-2，按 chunk 翻页）：服务端把该 outline 下的 document_chunks 展平成页，每页 1 个 chunk（默认 ≤4000 字符，低于摘要阈值 5000）。返回的 section.page_has_more=true 时，必须用 section.page_next_offset 作为下次调用的 page 继续翻页，直到 page_has_more=false。翻页期间 outline_id 不变，occurrence_index 跨页累计递增。禁止只读第一页就跳过剩余内容——工具结果超过 5000 字符会被上下文管理摘要化，agent 只能看到摘要，必须用小页读完大节。
返回还含 chunk_id / chunk_seq / from_line / to_line / overlap_lines：overlap_lines>0 表示本页与上一 chunk 有行重叠（embedding 上下文连续性设计），写锚点时按 from_line 去重，不要把重叠处的引用写两遍。
read_revision_content
调用 GET /api/docs/revisions/:revision_id/content?max_chars=20000&offset_chars=0，返回 revision 全文。默认截断 20000 字符，传 max_chars=0 不截断。
分页（R16-2）：长文返回 content_has_more=true 时，用 offset_chars 继续翻页直到 content_has_more=false。清洗场景建议单页 max_chars=4000，避免工具结果超过 5000 字符摘要阈值被上下文管理摘要化。
get_section_locator
调用 GET /api/docs/outlines/:outline_id/locator，返回 outline/revision/document 三元组定位信息。