dsh-pm
dsh-pm（pm = project management）由 春笋（ChunSun） 驱动 —— 把「春笋」AI 原生项目交付平台的能力，作为 DeepSeek Harness（DSH）的一等插件深度接入。
dsh-pm 让 DSH Agent 以「需求」为工作对象自主交付：开 Run、上报 Step、维护验收场景/用例、读写工作记忆、过 completed 硬门禁，并在 GUI 的会话级交付面板（composer 上方状态条 + 「项目管理」视图）实时看交付进度。工作记忆与状态以春笋自部署实例为 SSOT。
结构
src/index.ts —— ChunsunService（TypertRemoteService，@Remote 方法）src/tools.ts —— 28 个 chunsun_* 模型工具src/typert.ts / src/remote.ts —— Host ./typert 与 Client ./remote（仓库外需自备；dsh-api-remotes 不会替你 mount）src/client/index.ts —— 会话级交付 GUI（lazy-CJS）：conversation.input.dock 状态条（实时当前需求/Run 轮次/Step）+ conversation.view「项目管理」视图（总览页）；apply 内 $mount(./remote) 后再用 ctx.remote.chunsuncordis.patch.yml —— 组合包 patch（service + tools 两行）lib/ —— npm run build 的产物（被 .gitignore 忽略）
已提供（Host 工具）
需求（list/show）· Run（start/takeover/status/list/remind）· Step（add/list）· 场景（list/upsert/status）· 用例（upsert/status）· 工作记忆（context_get/put）· 环境变量（env_list/env_get，secret 走审批栈）· reset · status
快速开始：安装到 DSH
前置条件
- Node.js ≥ 20 + npm（本仓库构建用）；pnpm（DSH profile 管理插件用）
- 一个可启动的 DSH（下文以
web profile 为例）
- 可选：春笋自部署实例（否则只能看到「未连接」状态）
1. 构建插件（在 dsh-pm 目录内）
npm install
npm run build # tsc 转译，产物输出到 lib/（与 package.json exports 对齐）
构建必须用 tsc（不能用 tsdown）：@Remote 是 Stage 3 装饰器，DSH 用原生 Node ESM 加载组合包入口，需要 tsc 降级成 __esDecorate。tsdown/oxc 目前不支持 Stage 3 装饰器，会把 @Remote 原样留在 .js 里导致 Invalid or unexpected token。
2. 装进 DSH profile
dsh plugin --profile web add ./dsh-pm # 在 dsh-pm checkout 目录执行
这条命令等价于：在 ~/.dsh/profiles/web/ 里执行 pnpm add <checkout 绝对路径>，成功后自动把声明了 dsh.bundle 的 dsh-pm 追加到 package.json 的 dsh.profile.bundles。
pnpm 对本地路径依赖创建符号链接（node_modules/dsh-pm -> 你的 checkout），因此之后每次改动只需重新构建，无需重新 add。
如果 dsh 不在 PATH（如从 monorepo checkout 直接跑），用完整路径：
node <dsh-checkout>/apps/cli/lib/bin.js plugin --profile web add ./dsh-pm
手动方式（效果相同）：编辑 ~/.dsh/profiles/web/package.json，在 dependencies 加 "dsh-pm": "file:/绝对路径/dsh-pm"，在 dsh.profile.bundles 加 "dsh-pm"，然后在 profile 目录 pnpm install。
3. 启动并接入
dsh web # 或 dsh --profile web
首次接入：把 CHUNSUN_API_URL + CHUNSUN_SECRET_KEY 写进工作区 .env（与 chunsun CLI 同源）。也可以在 GUI 的「项目管理」视图（conversation.view）里填写并「保存并测试连接」——composer 上方状态条仅作实时状态展示，不含「配置」入口。
开发调试
迭代循环
改 src/*.ts → npm run build → 生效
├─ Host 侧（服务/工具）：重启 DSH
└─ Client 侧（面板）：刷新浏览器页面
- Host 侧改动（
src/index.ts、src/tools.ts）：DSH 启动时加载 lib/index.js / lib/tools.js，必须重启 DSH 才生效。
- Client 侧改动（
src/client/index.ts）：webServer 直接服务 lib/client.js（lazy-CJS / __ModuleLoader__.load），重新构建 + 刷新浏览器即可；若同时跑着 DSH 的 dev:web 监视构建，会自动广播重载。
- 依赖变更（package.json）：
npm install 后再构建。
提交前快速校验
npx tsc --noEmit # 必须 0 错误
npm run build # 必须无 UNRESOLVED_IMPORT 之类警告
ls lib/ # index.js / tools.js / client.js（+ 对应 .d.ts）
调试手段
| 层 | 手段 |
|---|
| 构建/类型 | npx tsc --noEmit；检查 lib/ 产物是否更新、路径/扩展名是否与 package.json exports 一致；lib/client.js 必须以 window.__ModuleLoader__.load({ 开头 |
| Host 服务/工具 | 看 DSH 启动日志；在 DSH 会话里直接让 Agent 调用 chunsun_* 工具，观察返回 JSON；需要时在源码里加日志 |
| Client 面板 | 浏览器 DevTools：Console 看报错、Network 看 remote.chunsun.* RPC 请求与响应 |
| 接线自检 | 面板「保存并测试连接」→ 依次触发 config-read / config-save / status；curl 春笋实例 /health 可区分是插件问题还是实例问题 |
注意事项与常见坑
- 构建后用
node --check lib/index.js 校验 Host：产物里不应再出现 @Remote；应看到 __esDecorate / Remote('status') 这类降级代码。若仍有裸 @，说明没用 tsc 构建。
- Client 必须是 lazy-CJS：
exports["./client"] 指向的 lib/client.js 必须调用 window.__ModuleLoader__.load({ id: "dsh-pm", factory })；普通 ESM（import/export）会报 loaded without registering ... via __ModuleLoader__.load。
remote.chunsun 不会自动出现：仓库外插件必须导出 ./remote，并在 Client apply 里 await ctx.remote.$mount(...)；不要 inject: ['remote.chunsun'] 却无人 mount（会一直 pending）。react 保持 external：客户端 factory 里通过 require("react") 取壳层播种的 React，不要试图打包它。- 工具参数是 DSL 不是 JSON Schema：
defineTool 的 parameters 是「属性名 → 值 schema」映射，必填以逐属性 required: true 标注（src/tools.ts 的 regTool 已封装）。
- npm 缓存 EPERM：若报
Your cache folder contains root-owned files，执行 sudo chown -R 501:20 ~/.npm，或临时用 npm install --cache <本地目录>。
- git 安装插件：
dsh plugin ... add github:mengqinghe/dsh-pm 会跑 prepare 构建脚本，pnpm 会拦截，需把报错里给出的 key 加进 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试。
- profile 位置：默认
~/.dsh/profiles/<name>/（可用 DSH_HOME 环境变量改）。
设计文档
详见本仓库 docs/design.md、docs/p5-promotion.md 与 docs/prototype/（动态插件原型源码）。
