dsh-doc-tree
Doc Tree
DSH 右侧边栏文档树：精选层级、记录生命周期徽章、全文搜索、窗格内 Markdown 阅读，以及 AI 辅助的 /docs-organize 工作流。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Meowrium/dsh-doc-tree#493f88d9e9813ed5d653fd59d6605c598fd0178c
dsh-doc-tree
DSH 右侧边栏文档树：精选层级、记录生命周期徽章、全文搜索、窗格内 Markdown 阅读，以及 AI 辅助的 /docs-organize 工作流。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Meowrium/dsh-doc-tree#493f88d9e9813ed5d653fd59d6605c598fd0178c
Doc Tree 以 dsh-doc-tree 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A governed documentation tree for the DeepSeek Harness right sidebar.
在 DSH 原生右侧栏里按分层浏览文档、展开 records/{lifecycle}/{class}、全文搜索、同栏阅读 Markdown，并通过 /docs-organize 让模型完成语义分层、机械体检与人工审批。
records/{proposed|implemented|rejected|archived}/{class} 自动成树；生命周期色点 + class 标签；阅读时把首部 Status: 行提到标题下；记录层内可按 lifecycle / class 筛选。docs/documentation/wiki，以及项目目录下的 docs），候选带篇数，点选切换。MarkdownText，相对 .md 链接在 tab 内跳转，大纲 按 h1–h4 导航。.dsh-doc-tree.json 定义 root / groups / records.statuses；没有配置时用内置默认分层。/docs-organize 让模型 scan → 读入口 → lint → dry-run → 用 ask_user_question 批量审批 → 写配置。本插件不依赖 dsh-docs-panel 或 dsh-better-sidebar。它只使用 DSH 官方扩展点：
ctx.sidebarRightTabs.register + sidebar.right.pane.tab slotworkspaceFiles Remote（只读）@deepseek-ai/dsh-client-ui-primitives 的 MarkdownText / MarkdownDelegateProviderctx.tools.register + ctx.commands.register + ctx.fs要求 DSH 0.2.1-rc.1+（开发验证于 0.2.1-rc.2）。
# 从 GitHub 安装（dsh plugin 会把参数转发给 pnpm）
dsh plugin --profile web add github:Meowrium/dsh-doc-tree
# 或本地开发
git clone https://github.com/Meowrium/dsh-doc-tree
dsh plugin --profile web add /path/to/dsh-doc-tree
安装后重启 dsh web，浏览器硬刷新（Ctrl/Cmd+Shift+R）。右侧栏「＋」→「文档树」。
开发期可用 dsh-super-injector 热装配，免重启：
dev_install_package /path/to/dsh-doc-tree
<> 可在「策展分层」和「原始目录结构」之间切换；⟳ 重新扫描。大纲 打开标题导航，× 关闭当前文档。配置写在工作区根 .dsh-doc-tree.json（不是文档目录内）：
{
"version": 1,
"root": "docs",
"generatedAt": "2026-10-19T00:00:00.000Z",
"generatedBy": "docs-organize",
"groups": [
{ "id": "map", "title": "文档地图", "hint": "L2", "match": ["README.md", "AGENTS.md"] },
{ "id": "contracts", "title": "口径契约", "hint": "L4", "prefix": "contracts/", "match": ["contracts/**"] },
{ "id": "records", "title": "记录层", "hint": "L5", "prefix": "records/", "match": ["records/**"], "records": true },
{ "id": "development", "title": "子系统参考", "hint": "L2", "prefix": "development/", "match": ["development/**"] },
{ "id": "other", "title": "其他", "match": ["**"] }
],
"records": {
"dir": "records",
"lifecycles": ["proposed", "implemented", "rejected", "archived"],
"statuses": { "records/implemented/feature/x.md": "implemented" }
}
}
match：相对文档根的 glob，* 段内、** 跨段、? 单字符；按数组顺序匹配，建议最后一组放 catch-all。prefix：仅用于显示时剥离路径前缀。records: true：该组启用 lifecycle 色点与筛选。records.statuses：includeStatus:true 时生成的快照，读取正文时仍以文件为准。project/docs。/docs-organize/docs-organize # 默认：scan + lint + dry-run + 人工审批
/docs-organize docs # 指定工作区相对根
/docs-organize --report docs # 只出报告：不提问、不写配置
默认流程：
doc_tree_scan 拿文件清单与候选根。README.md / AGENTS.md / 索引，判断分层语义（明确要求「不要按目录名硬套」）。doc_tree_lint 做机械体检，把问题分成「必须人决定」和「仅报告」。doc_tree_apply_plan(dryRun:true) 拿覆盖校验与「旧配置 → 新配置」diff。ask_user_question（不是正文提问）批量审批，最多 3 问、固定 id：
apply-plan：应用 / 只看报告 / 调整后重试lint-decisions：仅报告 / 允许处理可机械项 / 逐项说明status-snapshot：写入 / 不写dryRun:false 落盘；选「只看报告」输出清单；选「调整」改完重跑 dryRun（≤2 轮）。ask_user_question 不可用/报错时禁止写配置，输出结构化「待审批清单」。边界：合并/删除/移动文档不在本命令范围内；lint 问题默认只报告，除非用户明确同意处理「可机械项」。
| 工具 | 作用 |
|---|---|
doc_tree_scan {root?, includeStatus?} | 扫描 Markdown、返回候选根与文件清单（标题 / Status / 字节） |
doc_tree_lint {root?, includeLinks?, maxIssues?} | 只读体检：重复内容/标题、断链、孤儿、入口可达性、Status 冲突、未归类、空文档 |
doc_tree_read_plan {} | 读当前 .dsh-doc-tree.json（没有返回 null） |
doc_tree_apply_plan {root, groups, records?, includeStatus?, dryRun?} | 校验覆盖；dryRun:true 只返回 diff 不写，false/省略才写配置 |
ask_user_question，一次批量问 1–3 个问题，拿到答案后才执行；问题渲染成交互卡片。--report 或用户选「只看报告」时不写配置，只输出分组表、diff、lint issues、建议动作与未决问题；人工确认后再跑一次普通 /docs-organize。必须人工确认：覆盖已有配置、处理 lint 的重复/断链/孤儿/状态冲突、写入 records.statuses、任何文档内容改动（本命令不做）。
dsh-doc-tree/
├─ package.json # dsh.bundle.patch + dsh.client(platform:web)
├─ cordis.patch.yml # bundle 挂载行
├─ lib/index.js # host：doc_tree_* 工具 + /docs-organize 命令
├─ lib/client.js # client：tab 类型注册 + 扫描/配置 + 树 + 阅读器
└─ docs/screenshots/ # README 截图
ctx.sidebarRightTabs.register({ id, kind, priority:'extension', keepMounted, title, guide })ctx.slots.register({ name:'sidebar.right.pane.tab', key:id, inject:(sessionId)=>({...}) }, Body)ctx.remote.workspaceFiles.list(sessionId, workspaceRel, signal) 与 read(sessionId, absolutePath, { offset, limit }, signal)MarkdownText + MarkdownDelegateProvider（baseline 模块，无需 dsh.client.external）/docs-organize <root> 或手填 root。groups 只做 glob 机械匹配；语义分层由模型在 /docs-organize 中判断。⟳ 重建。workspaceFiles.read 分页参数）。Status: 在阅读时显示。node --check lib/client.js
node --check lib/index.js
已验证：DSH 0.2.1-rc.2 右侧栏注册、124 篇扫描、记录层 80 篇展开、跨文档链接、全文搜索、记录筛选、dry-run diff、lint（真实文档 124 篇 / 0 error）。
MIT