doco-dsh
在终端中运行以下命令:
dsh plugin install songofhawk/doco-dsh
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在已安装 DeepSeek Harness 的环境中执行 dsh plugin install songofhawk/doco-dsh 即可安装本插件,项目源码见 https://github.com/songofhawk/doco-dsh,安装后按提示完成 Doco 设备授权即可使用。
插件介绍
当 Agent 需要读取或写入 Doco 知识库时,经 29 工具的 MCP server 中转会多一跳 RPC,且写入审批只能走单一机制。doco-dsh 以 dsh Harness 原生插件的形式直接挂载,复用 doco-agent-cli 的 DocoClient,让每一次读写都留在进程内并享受 dsh 原生审批流。
六把工具覆盖完整读路径:连接自检、知识库列表、带完整性证明与新鲜度标签的 Search v2 全文搜索、稳定 heading-path 大纲(先规划再精读)、以及按 token 预算的分块局部读取和游标续读。当搜索返回 complete=false 或 freshness=stale 时,插件显式标注结果不完整,阻止 Agent 据此断言某条知识不存在。写入侧,doco_save_draft 只创建新草稿,受三层门禁保护:同步开关、commit 前的 dsh 原生 scope 审批、以及幂等键冲突检测;版本冲突返回稳定错误码而非静默覆盖。
自 0.2.0 起,插件还在 apply 早期暴露统一的 doco 服务面,同进程内的兄弟插件可通过 Cordis 依赖注入消费 DocoClient、身份、scope 与错误契约;当前消费者 doco-memory-dsh 即将知识库变为 Agent 的集中式记忆库(recall / remember / context)。如果你已经在 Doco 中管理文档、又在 dsh 上跑 Agent,并希望获得安全可审计的读取与严格受控的草稿写入,doco-dsh 是最短路径。
使用场景
- Agent 按 token 预算逐块精读 Doco 文档并续读完整个章节
- 在 dsh 中原生审批下安全写入 Doco 草稿且绝不静默覆盖
- 同进程兄弟插件通过 doco 服务面复用客户端、身份与错误契约
适合人员
- 在 DeepSeek Harness 上运行 Agent 并希望接入外部知识库的开发者
- 使用 Doco 管理文档且需要 Agent 安全读取的团队
- 构建 Doco 生态插件链(如记忆层、检索层)的工程师