dsh-task-atlas
DeepSeek Harness 的项目拆解与结构化任务树：固定在右侧边栏的树状视图，包含状态语义（返工 / 受阻 / 放弃，每项均附原因）、明确的分支来源、带有说明的前置条件，以及每个节点可重新打开的输出。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ateen18/dsh-task-atlas#0719856263091f696bbbc6c2a44936ebd53ef484Task Atlas 以 dsh-task-atlas 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 的项目拆解 + 任务树，同时服务于两个人：你和 AI。
它解决的是长对话里的一个具体失效：上下文越长，主线越淡。过程信息（报错、文件内容、试错）会把「原本要做什么、现在做到哪、这件事为什么在这儿」淹掉。人靠翻记录找不回来，模型靠读历史也抓不住。
所以插件做两件事：在右侧栏常驻一棵跟着真实进展变化的树，并在每一步开始前，把「当前在哪」用一小段话递给模型。
未开始 / 进行中 / 已完成 / 需返工 / 阻塞 / 已废弃。负向状态强制写原因并保留完整历史；乱序状态必须你确认才能生效。B.dependsOn = [A] 读作「A 是 B 的前置」。成环会被拒。每个前置还能带一句「需要 A 的什么」，所以连线不是"谁先谁后"的猜测，而是可核对的依赖。<工作区>/.dsh/task-atlas.md，可读、可 diff、可进版本库。todo_write 与 goal 只读显示，插件从不改写。在 agent/pre-step 里注入一段状态，只在真正有必要时：
| 何时 | 内容 |
|---|---|
| 状态签名变了（换节点、标完成、计数变化） | 当前节点、路径、前置、下一步（实测约 35 token，硬预算 420 字） |
| 上下文刚被压缩 | 上面那段 + 「任务图谱没有被压缩，进度仍然有效」 |
| 连续 20 步没碰过图谱 | 「如果还在当前节点上就忽略这条；否则登记成分支或更新状态」 |
| 用户连续 2 条消息与项目无关 | 先问再答：「这是项目外的临时问题，还是要立项？拿到答复再继续」 |
注入失败一律降级为「不注入」，绝不弄坏任何一轮对话。
| 需要 | 说明 |
|---|---|
| Node.js ≥ 22.19（或 24+） | 仓库的 engines 要求 |
| pnpm | 下面所有命令都用它 |
DSH Desktop 或 dsh web | 实测于 0.2.1-rc.2 |
1. 克隆并构建
git clone https://github.com/ateen18/dsh-task-atlas.git
cd dsh-task-atlas
pnpm install
pnpm run build
必须构建。 仓库里没有
lib/（构建产物不进版本库），而package.json的main指向lib/index.js。跳过这步，插件会加载失败。
2. 装进 profile
cd ~/.dsh/profiles/desktop
pnpm add link:<克隆下来的绝对路径>
3. 让 profile 加载它
编辑 ~/.dsh/profiles/desktop/package.json，把包名加进 dsh.profile.bundles：
{
"dsh": { "profile": { "bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-task-atlas"
] } }
}
只做了第 2 步、没做第 3 步时，宿主按包名找不到插件，重启后面板直接不出现，也不报错。这是安装环节唯一容易漏的一步。
4. 退出应用再启动
彻底退出（不是关窗口——关窗口只是收进托盘）。
5. 验证
左栏底部出现「▤ 任务图谱」，或右侧栏引导页出现卡片。
pnpm add github:ateen18/dsh-task-atlas试过，在 pnpm 11 上不可靠：
ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED
The git-hosted package "dsh-task-atlas@0.0.1" needs to execute build scripts
but is not in the "allowBuilds" allowlist.
pnpm 11 默认禁止运行 git 依赖的构建脚本（因为 lib/ 不在仓库里，必须现场构建）。要这么装就得先在自己的 pnpm-workspace.yaml 里 allowlist 这个包，还得你的网络能连 GitHub。仓库里带了 prepare 脚本，npm install 从 git 装时能自动构建；pnpm 用户建议走上面的五步。
cd <克隆路径>
git pull
pnpm install && pnpm run build
然后重启应用。改了源码必须重新 build——装上的是 lib/，不是 src/。
cd ~/.dsh/profiles/desktop
pnpm remove dsh-task-atlas
再把 dsh.profile.bundles 里的 dsh-task-atlas 删掉，重启。
工具会自己说明用法，但判断纪律写在 skill 里：什么时候该拆、result 怎么写、为什么不能自己把节点标成需返工、核心产出要登记成可点的把手、以及怎么对待 [任务图谱] 开头的那条消息（它是插件生成的上下文，不是用户说的话）。
mkdir -p ~/.dsh/skills
cp -r <克隆路径>/skills/task-atlas ~/.dsh/skills/
Windows PowerShell 等价写法（cp -r 在 PowerShell 里能用，但参数解析靠缩写，容易踩坑）：
Copy-Item -Recurse <克隆路径>\skills\task-atlas $HOME\.dsh\skills\
| 工具 | 权限 | 作用 |
|---|---|---|
atlas_status | 读 | 唯一读取入口：拆解 + 进度 + 树 + 前置 + 当前专注 + 待确认 |
atlas_breakdown_draft | — | 校验拆解草案，不落盘 |
atlas_breakdown_confirm | — | 建项目 + 落拆解 + 按拆解建模块 |
atlas_breakdown_amend | AI 自主 | 修订拆解，必须写 reason，逐字段记录「原来 → 现在」 |
atlas_node_add / atlas_node_update | AI 自主 | 增改节点（层级由父节点强制；update 可设 dependsOn，整体替换） |
atlas_node_move | AI 自主 | 连带子树挪到新父节点；层级按位置重算，状态与历史保留 |
atlas_focus | AI 自主 | 声明「现在在做这个」 |
atlas_node_done | AI 自主 | 完成，result 必填 |
atlas_node_status | 分级 | active/pending 自主；rework/blocked/dropped 需你确认；dropped → active 恢复同样需确认 |
atlas_confirm | 用户授权 | 应用一条待确认 |
atlas_branch_create / atlas_branch_resolve | AI 自主 | 分支登记与合回 |
atlas_node_delete | 安全阀 | 只删「从未承载过决定」的节点 |
atlas_workspace_history | 读 | 开工前判定这个工作区有没有前情 |
在 profile 的 cordis.patch.yml 里按行覆盖（config 是整体替换，不是深合并）：
- id: task-atlas
config:
enabled: true # 总开关
exportMarkdown: true # 是否写 Markdown 镜像
exportDir: .dsh # 镜像目录（相对工作区）
inject: true # 是否向模型注入状态；嫌吵可以关，面板不受影响
done 不是终态。done → rework 合法。整件事的理由就是让「做完了但还得改」有正当表达。dropped → active，且必须写原因 + 你确认——恢复原因进历史，不留成节点的「当前原因」。agent/pre-step 接受用户消息，agent/pre-call 明确不能改消息。所以注入内容会出现在对话记录里，前缀 [任务图谱] 就是用来区分「这不是你说的」。ctx.storageDomain 的 dsh_task_atlas 域 documents 表，一个工作区一条记录（zod 校验）。<工作区>/.dsh/task-atlas.md，每回合结束覆盖写，只输出不读入。GET /task-atlas/state（快照，含 revision 与 drift）、GET /task-atlas/wait?revision=N（长轮询）、POST /task-atlas/confirm。charter 的字段会被归一化成 breakdown——改名时没有迁移数据，所以读取端必须认旧键，否则整个域打不开。pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # node --test test/*.test.ts（231 项）
pnpm run build # tsdown + 客户端依赖护栏
两个诊断脚本（都不是猜，是测量）：
node scripts/check-storage.mjs # 存储记录是否仍符合 schema，并打印项目/拆解/修订
node scripts/check-running-build.mjs 端口 # 运行的进程是不是当前构建 + 路由是否真的应答
scripts/restart-desktop.ps1 不再杀进程。原因写在文件头：关窗口只是收进托盘，强杀宿主会让桌面端弹「host exited」错误框，而脚本本身又是宿主的子进程，会跟着一起死。
面向 DSH 0.2.1-rc.2（@deepseek-ai/*@0.2.1-rc.2，cordis ~4.0.5，zod 固定 4.4.3）。DSH 走夜间通道自动更新，插件面变动频繁，所以：
tools 是硬依赖，其余服务（存储、web server、会话语料）都晚绑定；缺了就在面板上明说，而不是整个插件静默消失。~/.dsh/task-atlas-startup.log。诚实列出来，免得把「应该能工作」当「已经工作」：
compaction/end，事件名来自运行时事件表，但没观察到真实压缩发生过。MIT