ultra-documents：DeepSeek Harness 里边批注边修订的文档工作流

它是做什么的？

ultra-documents 是 DeepSeek Harness（DSH）的文档插件，把 AI 生成的内容变成可以批注、回传、再编辑的独立文档。它解决的是「AI 写完一份报告就结束、你只能复制粘贴再提需求」的麻烦：插件让智能体输出一个自包含的 HTML 页面，在聊天里以卡片出现，并在 DSH 右侧边栏打开。之后你可以选中文字或点击图表留下评论，一键把评论交回 AI 生成下一版，也可以自己直接改文字和排版。每次改动都会成为一个新版本，可随时切换，所有数据只留在本机。

核心功能

• 文档卡片与侧边栏渲染：智能体产出的自包含 HTML 文档以卡片形式出现在对话中，点击即在 DSH 右侧边栏打开，支持全屏查看。
• 批注：默认处于评论模式，可选中任意文本，或点击图表、表格留下评论；切到阅读模式即可正常与页面交互。
• 一键回传 AI：点击 Send to AI 把当前未处理的评论交给智能体，它写出下一版并逐条回应每条评论。
• 直接编辑与版本管理：可在最新版本上修改文字与格式，保存即生成新版本，历史版本之间可自由切换。
• 本地存储与沙箱隔离：文档存放在工作区内的隐藏目录中并被 git 忽略，页面在无同源权限的沙箱 iframe 中运行，脚本无法访问 DSH 页面、Cookie 或你的文件。
• 配套智能体工具与技能：提供创建、修订、读取评论、列出文档四类工具，以及一个指导何时调用工具、如何写 HTML 的技能。

怎么使用这个插件？

在 DSH 中启用后，新建一个会话并直接向智能体要一份文档，例如让它用 ultra-documents 做一份带日程表的杭州两日行程。文档生成后会以卡片出现在聊天里，点击卡片即可在侧边栏打开；选中文字或点击图表添加评论，再按 Send to AI 获取下一版，展开已处理评论可以看到 AI 对每条评论的回复。想自己动手时，在最新版本上按 Edit 修改文字和格式，再保存为新版本。建议每份文档单独开一个会话，因为长会话会把大量上下文带进每一次修订；另外，自带脚本的文档可以批注但不能直接编辑。该插件由 Libraqg 维护，采用 AGPL-3.0 协议，需要较新版本的 DSH 及其 Web 界面。

报错怎么排查？

文档无法直接编辑时，先确认它是否自带脚本：运行自身脚本的文档只支持批注，不支持直接编辑，这是已知限制。同一会话在两个 DSH 进程中同时打开也可能引发异常，按官方说明避免重复打开即可。