前言¶
DSH 的插件生态强调「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对使用 DSH Agent 做项目交付的开发者来说，需求、Run、Step、验收场景/用例和工作记忆如果分开维护，容易缺少统一状态。dsh-pm 由春笋（ChunSun）驱动，仓库 owner 为 mqhe2007，目标是把这些对象接入同一个交付闭环。
这是什么¶
dsh-pm 是一个 DSH 插件，以需求为工作对象，组织 Run、Step、验收场景/用例和工作记忆，形成 AI 原生项目交付闭环。它提供 Host 服务、模型工具、Client 面板，以及 typert、remote、client 入口。工作记忆与状态以春笋自部署实例为 SSOT。
插件许可证为 MIT，要求 Node.js >= 24 + npm；DSH profile 管理插件使用 pnpm。春笋自部署实例可选；不提供时，插件侧只能看到未连接状态。
核心功能¶
下面列几个可核对的能力：
- 提供 28 个
chunsun_*模型工具，覆盖连接/状态、需求、Run、Step、场景/用例、工作记忆、环境变量、缺陷、reset。 - 支持 DSH Agent 以需求为工作对象开 Run、上报 Step、维护验收场景/用例、读写工作记忆，并过
completed硬门禁。 - 提供会话级交付 GUI：composer 上方状态条展示当前需求 / Run 轮次 / Step，「项目管理」视图提供总览页。
- 支持通过工作区
.env或 GUI「项目管理」视图配置CHUNSUN_API_URL、CHUNSUN_SECRET_KEY，并测试连接。
安装与启用¶
下面以 web profile 为例。
1. 本地构建¶
在 dsh-pm 目录内安装依赖并构建：
npm install
npm run build
构建使用 tsc。因为 @Remote 是 Stage 3 装饰器，不能用 tsdown 构建。
2. 安装到 DSH profile¶
在 dsh-pm checkout 目录执行：
dsh plugin --profile web add ./dsh-pm
这条命令会把本地插件加入 web profile。pnpm 对本地路径依赖创建符号链接，之后每次改动只需重新构建，无需重新 add。
3. 从 GitHub 安装¶
也可以直接从 GitHub 安装：
dsh plugin --profile web add github:mqhe2007/dsh-pm
这条命令会跑 prepare 构建脚本。如果 pnpm 拦截，把报错里给出的 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试。
4. 启动 DSH¶
启动后进入 web profile：
dsh web
或者：
dsh --profile web
典型用法¶
配置春笋连接¶
可以先在工作区 .env 中写入：
CHUNSUN_API_URL=http://localhost:11111/api/v1
CHUNSUN_SECRET_KEY=
CHUNSUN_API_URL 默认值为 http://localhost:11111/api/v1。CHUNSUN_SECRET_KEY 在接入后必填，并标记为 Secret。也可以在 GUI 的「项目管理」视图中填写，并执行「保存并测试连接」。
开发迭代¶
修改 src/*.ts 后重新构建：
npm run build
Host 侧改动需要重启 DSH；Client 侧改动需要刷新浏览器。
提交前校验¶
提交前运行：
npx tsc --noEmit
npm run build
node --check lib/index.js
node --check lib/tools.js
npm test
Client 产物 lib/client.js 必须是 lazy-CJS，且以 window.__ModuleLoader__.load 开头。仓库外 Host 与 Client 需自备 ./typert 与 ./remote；remote.chunsun 需要显式 $mount。
适用场景与注意¶
这个插件适合需要把 DSH Agent 的交付对象统一到需求、Run、Step、验收场景/用例和工作记忆的开发者；也适合已经准备春笋自部署实例，并希望把状态集中到 SSOT 的使用者。
注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。CHUNSUN_SECRET_KEY 是 Secret，写入 .env 或 GUI 配置时应按密钥管理要求处理。仓库外使用 Host 与 Client 时，需要确认 ./typert、./remote 和 $mount 接线完整。
dsh-pm 的价值在于把春笋的交付状态作为 DSH 插件接入，使 Agent 能在需求、Run、Step、验收场景/用例和工作记忆之间形成闭环。GitHub 仓库地址为：https://github.com/mqhe2007/dsh-pm 。社区目录页地址以实际检索到的目录站点为准。
