前言¶
DeepSeek Harness（DSH）把能力拆成插件，會話裏能調用的技能、工具和子智能體都取決於已安裝的插件。Cursor 生態裏的 pstack 提供一套偏嚴謹的 agent 工作流：playbook 匹配任務、維護 todo 與證據、多角色子智能體協作等。若直接在 DSH 裏複用同名思路，會遇到接口差異——例如上游大量 skill 聲明瞭 disable-model-invocation: true，DSH 的 skill 工具只暴露模型可見目錄；DSH 也沒有 Cursor 的 model slug、subagent_type、readonly 以及 Bun 腳本等對等能力。
dsh-pstack 由維護者 l246804 發佈，分類爲工作流，作用是把 pstack 的技能、playbook 與參考文檔移植到 DSH，並在插件層做工具名、子智能體字段、模型標識與路徑的適配。社區目錄頁見 SkillHub（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
這是什麼¶
一句話：dsh-pstack 是 pstack 在 DSH 上的移植包（npm 包名 dsh-pstack，當前資料中版本爲 0.2.1，MIT 許可證），描述爲「pstack for DeepSeek Harness: rigorous agent workflows ported from cursor/plugins」。移植基準標註爲 pstack 0.15.36；包內統計爲 58 個 pstack skills、23 個 playbooks、5 個原生工具、2 個 agent preset、5 個 bundled scripts。更完整的能力映射、缺口與驗收狀態見倉庫內 pstack/README.md。
環境與依賴¶
安裝前請確認：
- DSH 版本
>=0.2.1-rc.5（README 標明；更新版 DSH 默認仍支持，不兼容項見倉庫 Compatibility 小節）。 - Node.js
>=24.21.1。
核心功能¶
適配層在做什麼¶
插件保留上游 pstack 的 skills、playbooks 與參考文檔；五個原生工具補齊 DSH 接口缺口。/poteto-mode 會按名稱路由到那些對模型隱藏的 skill，而不僅依賴 DSH 默認可見的技能目錄。安裝並完成初始化後，通常從 /poteto-mode 進入主工作流。
五個原生工具¶
| 工具 | 作用 |
|---|---|
pstack_skill |
按名稱加載本插件註冊的隱藏 skill，並讀取 skill 目錄內相對路徑資源。 |
pstack_models |
只讀列出當前 DSH 部署實際提供的 provider、模型與 reasoning effort，供 /setup-pstack 使用。 |
pstack_roles |
只讀列出各 pstack 角色的形態及是否爲 automatic panel，便於 pstack_subagent 傳入正確的 roleIndex。 |
pstack_subagent |
按角色讀取 $DSH_HOME/pstack-models.mdc，解析 provider/model [effort]，按 agent 選 preset，可並行啓動多個子智能體。 |
pstack_script |
按固定 id 運行內置 Node 腳本，不依賴 Bun 或任意 shell 腳本。 |
poteto-agent 與 comment-sicko 兩個 preset 分別對應實現委託與只讀評論審查。pstack_script 支持的腳本 id 爲封閉枚舉：check-plan、watch-pr、worktree-audit、log、statechart，不能用來拼接任意路徑。
倉庫內額外 skills¶
skills/ 並非上游 pstack 目錄，收錄 pstack 未提供但工程裏常用的技能；來源爲 skills/authored/ 與 skills/.agents/skills/，構建後發佈到 dist/skills/authored/ 與 dist/skills/vendored/。資料中列出的示例包括 vendored 的 writing-for-agents、retro，以及 authored 的 decision-write、decision-audit、setup-project-docs 等（完整表格見 GitHub README Skills directory 小節）。
配置入口¶
在 DSH 界面打開 Plugins → Installed plugins → dsh-pstack，在 bundle 頁眉點擊 Configure 打開配置對話框。角色所用模型可在初始化後於此查看與編輯。
安裝與啓用¶
1、安裝插件（命令來自 README Quick start）：
dsh plugin --profile web add dsh-pstack
也可在 Web 或 Desktop 的 Plugins 頁面安裝。GitHub 倉庫當前星標爲 5（與目錄頁一致）。
2、重啓對應 profile 或新開 Session。
3、首次使用前執行：
/setup-pstack
該命令讀取當前部署下的 provider、模型與 reasoning effort，寫入 $DSH_HOME/pstack-models.mdc。缺少此文件時，各角色會繼承父級路由。完成 setup 後，可在 Plugins → Installed plugins → dsh-pstack 中查看和修改相同內容。
典型用法¶
README 給出的常用入口如下（在 Session 中以 slash 命令觸發）：
| 命令 | 用途 |
|---|---|
/poteto-mode |
主工作流：爲任務匹配 playbook，維護 todo 與證據。 |
/setup-pstack |
配置角色模型並初始化 pstack 環境。 |
/how、/why、/teach |
架構走查、證據調查、漸進式講解。 |
/architect、/arena、/swarm |
多方案設計、並行候選、切片並行實現。 |
/create-verification-skill |
爲真實項目生成 verification skill。 |
/statechart |
用 TLA+ 與 TLC 檢查狀態模型，並輸出 Mermaid 狀態圖。 |
/show-me-your-work |
維護 TSV 決策日誌並審計當前工作。 |
/retro |
回顧編碼會話的環境。 |
/docs-drift |
審計項目內文檔；report 只讀，fix 修復已批准項。 |
典型順序：安裝 → 重啓 Session → /setup-pstack → 按任務選擇 /poteto-mode 或其他 playbook 命令。需要多角色或腳本能力時，由上述原生工具在後臺配合 slash 命令與 playbook 定義。
適用場景與注意¶
適合已經在用或計劃用 DSH 做複雜編碼任務、希望沿用 pstack 那套 playbook、證據與子智能體分工的開發者。若你只需要單次問答或輕量 skill，全量 pstack 工作流可能偏重，可按 README 中的命令表按需選用。
安全與權限：插件隨當前 DSH 進程權限運行，能訪問會話工作區與 DSH 配置路徑（例如 $DSH_HOME/pstack-models.mdc）。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認符合團隊策略；可選 DSH 插件的說明見上游 README「Optional DSH plugins」小節。
結尾¶
dsh-pstack 把 Cursor pstack 的工作流資產和 DSH 插件模型接在一起，用少量原生工具彌合兩邊的工具與子智能體差異。目錄與文檔：
