前言¶

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 。社區目錄頁地址以實際檢索到的目錄站點爲準。