dsh-doc-annotate · 个人版

在 DSH 右侧预览文档、写批注，再把批注放进当前对话草稿。只在本机浏览器保存，不需要账号、数据库或额外服务。

怎么用

1. 点击会话顶部「文档批注」，输入文件路径或打开文件树。
2. 在预览里选中文字，点击浮动「批注」；图片等也可以使用顶部的框选按钮。
3. 写评论并保存。第一次使用无需建立工作区或填写任何标识。
4. 可按建议／问题／疑问分类，标记已解决、筛选、编辑、归档和撤销。
5. 点「发给 Agent」将文件位置、原文和评论放进输入框，检查后自己发送。

安装

当前版本：0.2.0-personal.1。在 DSH 侧栏「插件」页安装，来源填写：

github:YHzed/dsh-doc-annotate

也可以使用 DSH CLI（web 为目标 profile）：

dsh plugin --profile web add github:YHzed/dsh-doc-annotate

若插件页已安装旧版，先保存或复制未保存的草稿，再卸载旧版并安装上述来源；CLI 可直接执行上述命令替换。卸载插件本身不会主动清除浏览器批注数据，不要清除网站数据。替换已加载的版本后，重启 DSH 并刷新页面。

仓库已包含构建后的客户端，无需另行构建。安装后确认「文档批注」已启用。尚未发布 npm 包。

旧批注与数据

• 旧版本批注只需「预览升级批注 → 确认升级批注」。默认按原会话分组，旧数据和迁移备份保留；可选的自定义分组收在高级选项里。
• 新批注保存在当前浏览器、当前 DSH 地址的 localStorage。刷新／重启不会主动删除，但清除网站数据、换浏览器或换地址端口不会自动带走批注。没有跨设备同步。
• 保存失败会保留草稿；旧数据损坏时不覆盖。写入需要浏览器 Web Locks（当前 Chrome／Edge 的 localhost 支持）；没有它时保持只读。
• 原始引用保留不变；「重新定位引用」只更新用户确认的位置，不改源文。PDF／Office／图片的页码或区域引用不能当作源代码行号。
• 文件预览复用 DSH 自带能力。HTML iframe／Excel 画布不能选中文字时用框选。发送只填对话草稿，不自动启动另一套 Agent 或修改文件。

开发与验证

npm run build
npm run test:smoke
npm test

开发需要 Node.js 22+；面板测试需要 react、react-dom 和 jsdom。可在开发环境安装这些依赖，或通过 DSH_TEST_DEPENDENCIES 指向包含它们的 node_modules 目录。

这是浏览器端个人插件，空的宿主入口仅供 DSH 加载客户端，属于正常实现。未接入的宿主持久化／独立任务／自动回滚实验不随安装包发布，也不是个人使用的前置条件。

两个个人主流程均经过实际 red→green，全部 374 项回归通过（无失败、跳过或取消）。这是 React 挂载与本地适配验证，不是当前 GUI 的人工验收。历史开发证据留在仓库 docs 中，不随安装包发布。

License

MIT