前言¶
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 插件模型接在一起，用少量原生工具弥合两边的工具与子智能体差异。目录与文档：
