打开文档标注页面（H5）：创建标注会话并启动本地 HTTP 服务，在独立浏览器应用窗口打开标注页（无地址栏/工具栏/标签页）。若同一文档已有存活窗口则直接复用（原位重载、清空上轮标注），不重新开窗。返回 {session_id, url}。多轮循环：窗口会在文档被修改后自动重载最新内容（apply_edit 成功后服务端主动推送），无需每次手动调用本工具；也可在本轮开始或需要立即刷新时主动调用。同一文档重复调用会复用现有窗口。

阻塞等待标注会话完成 / 取消 / 窗口关闭，返回用户提交的标注列表。返回 {session_id, status, reason?, annotations, next?}，status 为 done | cancelled | closed | timeout。缺省永不超时（timeout_seconds 不传则一直等待直到用户提交/取消/关闭窗口，或 agent 退出）；如客户端对单次调用有超时上限，可传 timeout_seconds 设一个安全值，被截断或超时后再次调用本工具继续等待即可（会话在服务端持续存在，不会因单次调用被截断而取消）。status=closed 表示标注窗口已关闭：reason=window_closed/page_unload 是用户主动关闭——本轮标注流程已结束，不要再调用本工具或 annotate_document（除非用户明确要求继续），直接总结结果即可；reason=window_lost（窗口崩溃/被强杀）或 agent_cancelled/agent_exited 时才考虑询问用户是否重开。status=done 且存在标注时：处理这些标注时请在 apply_edit / template_replace / find_replace / restore_version 中带上本返回值中的 session_id（确保标注窗口重载到正确的会话，多对话共享同一 server 时尤为重要）；处理完后（窗口会自动重载修改后的内容）应再次调用本工具等待用户下一轮标注。status=done 且标注为空：用户确认本轮无需修改，标注流程已结束（窗口已自动关闭），不要再调用本工具或 annotate_document，直接总结结果即可。

取消标注会话（用户点了“取消”）。返回 {session_id, status}。

读取文档大纲：docx 逐段 {loc,text}；xlsx 每 sheet 维度与抽样；pptx 每页形状文本。返回 {format, items|sheets|slides}。

读取指定位置的原文与相邻上下文，供生成新内容前核对。返回 {loc, text, context}。

对指定位置应用修改（首次编辑前自动生成 .bak-<时间戳> 备份；同一标注轮次内只有第一次编辑会快照到版本历史，其余编辑复用该版本——一轮多个标注只产生一个版本，版本描述会汇总本轮全部修改）。mode 缺省 replace；引擎错误返回结构化错误。返回 {ok, loc, new_content, version}（version 为 null 表示本轮已快照过、未新增版本；version.desc 表达该快照为'修改前/该轮标注前的状态'——会话场景为'第 N 轮标注前的状态（本轮修改：…）'，无会话为'修改前：<编辑摘要>'，回退到该版本即恢复为此内容）。修改成功后，该文档的标注窗口会自动重载展示最新内容（无需再手动调用 annotate_document）；用户检查后可能继续标注，此时应再次调用 wait_for_annotations 获取下一轮标注。若修改后发现内容异常，可用 list_versions / restore_version 回退到修改前再重新生成。

批量替换 docx 文档中的 {{变量}} 模板占位符。variables 为 {变量名: 值} 映射；未提供值的变量保持原样并在 missing_vars 中列出。同段落多处占位符按从右到左应用保证坐标正确；跨 run 断裂的占位符也能正确替换。返回 {matched, replaced, missing_vars, applied}。

在 docx 文档中全文查找并替换字符串（普通字符串，非正则；匹配范围含表格内单元格）。match_case=false 时大小写不敏感，替换文本原样插入。返回 {matched, replaced, locations}。

列出文档的版本历史（.versions/ 快照链：同一标注轮次内多个编辑合并为一个版本，即每轮首个编辑前快照；新版本在前）。返回 [{index, path, size, mtime, kind?, desc?, ts?}]，无版本时返回 []。每条 desc 表达'修改前/该轮标注前的状态'（如'第 1 轮标注前的状态'或'修改前：替换…'），回退到该版本即恢复为该内容。配合 restore_version 实现任意步回退。

将文档直接回退到 list_versions 给出的某个版本（回到该版本锚点：文档被覆盖为该版本内容，回退前不会快照当前状态，因此版本记录不会增加）。⚠️ 警告：该版本之后的全部修改将丢失，且回退本身不可通过新快照撤销（但既有版本链仍保留，可再回退到其它版本）。回退后旧标注的 loc 索引可能失效，应重新 read_structure 遍历后再继续编辑。返回 {restored_index, path, version_path, versions}。

批量预览修改（仅内存计算，不写盘）：按顺序在内存中对同一文档应用 edits 列表，返回每处的 {loc, before, after}。适合在真正 apply_edit 前检查一批修改是否符合预期。edits 元素为 {loc, new_content?, mode?, style?}。返回 [{loc, before, after}]。