songofhawk/doco-dsh

README 摘要

doco-dsh Doco 知识库的 DeepSeek Harness（dsh）原生插件 。用 6 个工具把 Agent 接到你的 Doco 知识库上：块级寻址、按 token 预算精读、乐观并发写入草稿、来源引用，全部复用 doco-agent-cli 的 DocoClient （HTTP / ETag / Token 逻辑不复制）。 默认 只读 ；写入走 dsh 原生审批 + scope 门禁，绝不静默提交。 能力 工具 读/写 说明 doco status 读 连接自检：当前用户、scope、API 地址、读写能力 doco list knowledge bases 读 列出可见知识库（选 knowledge base id ） doco search 读 Search v2 全文搜索，带完整性证明（ projection.complete / freshness ） doco outline 读 文档结构大纲（稳定 block id + heading path），先规划再精读 doco read 读 按 token 预算局部读取正文（ around / cursor 续读） doco save draft 写 把 Agent 产出存成 新草稿 （ preview → 确认 → commit ） 回答里的事实命中有来源引用（ document uri / web url ）； doco search 返回 complete=false 或 freshness=stale 时，插件会显式标注「结果不完整」，禁止 Agent 据此断言「知识库里没有」。 安装 doco-dsh 依赖： - doco-agent-cli@^0.1.3 （npm 运行时依赖）； - @deepseek-ai/dsh-tools / @deepseek-ai/cordis （ peer dep ，由宿主 dsh 提供，本插件不捆绑）。 装包并自动挂载（推荐）——本包声明了 dsh.bundle.patch ， dsh plugin add 装完即自动挂进 profile 层栈： 手动挂载（备选）两步： 再在 dsh 的 Composition YAML（如 agent.cordis.yml ）里追加一条—— name 既可用 npm 包名，也可用本地相对路径： （最简形式也可只写 - name: 'doco-dsh' 。挂载语法细节见 dsh 教程《07 · Into the Harness》。） 挂载完成后， apply 会： 1. 解析配置（见下）； 2. 注册 6 个工具（命名带 doco 前缀，可配 DOCO DSH TOOL PREFIX 覆盖）； 3. 注入系统提示词分段（仅规则，不注入内容/Token）； 4. 注册 /doco 命令。 配置走环境变量与 doco…

分类