aa2246740/pstack-dsh

official pstack 的 DeepSeek Harness 移植

dsh plugin --profile web add github:aa2246740/pstack-dsh

需要 pnpm 在 PATH 上。dsh plugin 会在 $DSH_HOME/profiles/web 里调用 pnpm。然后重启这个 Host，再刷新页面。Add 只写 profile，不会热加载正在跑的进程。

Need pnpm on PATH. dsh plugin runs it in $DSH_HOME/profiles/web. Then restart that Host and reload the page. Add writes the profile; it does not hot-load a running process.

dsh 不在 PATH 上时：

If dsh is not on PATH:

npx @deepseek-ai/dsh plugin --profile web add github:aa2246740/pstack-dsh

仓库已提交构建好的 lib/，并声明了 dsh.bundle.patch，所以这次 github: 安装不跑 prepare，也不需要把包加进 profile 的 allowBuilds。

This repo ships built lib/ and declares dsh.bundle.patch, so the git add does not run a prepare script and does not need an allowBuilds entry.

English title. pstack-dsh, a DeepSeek Harness port of official pstack.

中文. 这是 official pstack 的 DeepSeek Harness 移植。玩法和原则来自 poteto 的 official pstack；只有调用层换成 DSH。

English. This is a DeepSeek Harness port of official pstack. Playbooks and principles are poteto's. Only the harness call layer is swapped.

来源 / Credits

23 个玩法（playbooks）和 23 条原则（principles）是 poteto 写的，出自 official pstack。本仓库是 DeepSeek Harness 移植（aa2246740/pstack-dsh）。调用层用 HARNESS.md 里的 DSH 工具名。玩法和原则不是本仓库写的。

The 23 playbooks and 23 principles are poteto's, from official pstack. This repository is the DeepSeek Harness port (aa2246740/pstack-dsh). Harness calls use DSH tools named in HARNESS.md. This port did not author those playbooks or principles.

本地目录 / Local checkout

已经 clone 到本机时：

A local checkout also works:

git clone https://github.com/aa2246740/pstack-dsh.git
dsh plugin --profile web add ./pstack-dsh

然后同样重启 Host，再刷新页面。

Then restart that Host and reload the page.

dsh plugin --profile web remove pstack-dsh

DSH.app 的桌面 Plugin Manager 只接受 npm 包名，不接受 github:。桌面用户请用 dsh web（--profile web），或等 npm 发布。

DSH.app's desktop Plugin Manager accepts npm package names only, not github:. Use dsh web (--profile web), or wait for an npm publish.

开始用 / Get started

两步。

Two steps.

1. 要做事、要严谨，直接用 /poteto-mode。不用先跑 setup。子 agent 默认继承当前对话的路由。
2. 只有想给某个角色换已登录的路由时，打开 设置 → pstack（导航「pstack 角色」/「pstack roles」）。页面写入 $DSH_HOME/pstack-dsh.json。/setup-pstack 只是指向那一页的指针。

1. Use /poteto-mode for work that needs rigor. No setup required. Children inherit this conversation's route.
2. 要按角色固定一条已登录的路由，打开 Settings → pstack（导航标签为 pstack 角色 / pstack roles）。该页面会写入 $DSH_HOME/pstack-dsh.json。/setup-pstack 是指向该页面的可选入口。

角色模型列表会随 DSH 的登录、退出登录和模型目录变更通知更新，也可点击「刷新模型列表」。刷新只更新候选项，不覆盖尚未保存的角色和 effort；当前选择若失去登录会标为「暂不可用」。新加入 dsh-oauth-login 的 pi- 路由以及 dsh-antigravity-oauth 的 agy- 路由只要已登录且已注册，就会自动纳入，无需在 pstack 里再维护一份提供商名单。

模型选择会跟随 DSH 的登录/退出登录和目录通知。刷新模型也会更新候选项，但不会替换尚未保存的角色/effort 编辑。已选路由若变为不可用，会保持可见标记。新注册且已登录的 pi- 和 agy- 路由会被自动发现，无需第二份提供商允许列表。

第一次用可以看 pstack 指南。

初次使用？pstack 指南 会带你完成第一个真实任务。

其余技能是按需的。/poteto-mode 会在步骤需要时自己去调。

其他技能是按需使用的。模式技能会在某个步骤需要时调用它们。

上游 0.15 同步

技能内容同步至 cursor/plugins 的 pstack 0.15.0，提交 71ed0d1076fec562c1b74ee353121a8d00f75382。保留 DSH 工具和角色路由。

设置页的「Poteto 0.15 推荐」仅供参考，不会替换用户已保存的模型或 effort。how-critics 不再显示或启动代理，旧配置仍可读写并保留。不包含 Cursor 专用的 make-bot-ui。

Poteto 0.15 推荐仅为展示用途。现有模型和 effort 分配保持不变。已停用的 how-critics 设置出于兼容性仍可读取，但会被隐藏，且永远不会启动代理。不包含 Cursor 专用的 make-bot-ui。

默认模型与 effort / Defaults

装完就能用，不必先打开设置，也不必跑 /setup-pstack。

全新安装无需 Settings → pstack，也无需 /setup-pstack 即可使用。

模型 / Model. 不要发送 model，除非 live catalog 里已经有这一条。没有 overlay 就继承父对话。不要编造 Cursor 面板 slug（grok-4.6-fast-xhigh、gpt-5.6-sol-max、claude-fable-5-thinking-max、claude-opus-5-thinking-xhigh）。

除非该组合已被实时检测到，否则不要发送 model。缺少 overlay 时继承父对话。不要编造 Cursor 面板 slug。

effort. 只提供该路由 resolveModelInfo().reasoning.efforts 列出的 id。没有 effort 字段就省略。skill 从不在 spawn 上发送 reasoning_effort 或 thinking。官方 subagent schema 没有这些字段。角色 effort 写在 overlay 里，由 agent/request 落到 LlmCallConfig.reasoningEffort。

Effort 只能是该路由实际接受的 id。如果该路由没有 effort，就省略。技能从不在 spawn 时发送 reasoning_effort 或 thinking。官方 subagent 没有此类字段。角色 effort 存放在 overlay 中，并在 agent/request 时应用。

设置 / Settings. 配置页是官方 Settings 里的 settings.section（id pstack，order 16）。只列出已登录路由；effort 只列出该路由 live resolveModelInfo().reasoning.efforts。空列表就是继承父对话。保存写同一份 overlay，不是第二份配置。

编辑器是官方 Settings 的 settings.section（id pstack，order 16）。它只列出已登录的路由。Effort 选项是该路由实时的 resolveModelInfo().reasoning.efforts。空列表表示继承父对话。保存会写入同一份 overlay，而不是第二个文件。
设置页只列出已经登录的 API key 路由，以及 dsh-oauth-login / dsh-antigravity-oauth 里已经签过名、并且适配器已注册的路由。空目录就是继承父对话。

推荐依赖 / Recommended peer

订阅与服务登录（ChatGPT / Claude / Grok / Copilot / OpenRouter / Kimi / Google Antigravity）要出现在 设置 → pstack 列表里，可按需安装 dsh-oauth-login 或 dsh-antigravity-oauth。不是硬依赖。只用 API key 的用户可以不装。本插件不读写 ~/.pi、~/.codex、~/.claude、grok CLI 登录文件。

安装 dsh-oauth-login 或 dsh-antigravity-oauth 后，订阅登录会显示在 设置 → pstack 上。它们不是必需的。只用 API key 的用户无需安装即可使用。本插件不读写官方 CLI 认证文件。

dsh plugin --profile web add github:aa2246740/dsh-oauth-login

这不是 Cursor 插件 / Not the Cursor plugin

这里的角色映射在 设置 → pstack。官方 Cursor /setup-pstack 会写 ~/.cursor/rules，并用 Cursor 的模型名。不要在 DSH 上跑那份。

本仓库中的角色映射在 设置 → pstack。官方 Cursor /setup-pstack 会写 ~/.cursor/rules，并使用 Cursor 的 slug。不要在这里运行它。

工具 / Tools

本插件注册：

本插件注册：

| 工具 / Tool | 作用 / Role |
|---|---|
| pstack_spawn | 按角色起 DSH 子 agent。不要传 model / effort。 |
| pstack_catalog | 只列出已登录的 live 路由。 |
| pstack_overlay_read / pstack_overlay_write | 读写 $DSH_HOME/pstack-dsh.json。 |
| Settings → pstack | 官方设置页。保存同一份 overlay。 |

技能入口：/poteto-mode，以及 bundled 的 playbook / principle skills。/setup-pstack 指向设置页。

斜杠入口：/poteto-mode，以及捆绑的 playbook 和 principle 技能。/setup-pstack 指向设置页。

开发 / Develop

pnpm install
pnpm test

不要对用户正在用的 DSH Host 发 --force，也不要杀它。对照 TEST-PLAN.md。

不要对用户正在使用的 DSH Host 执行 --force，也不要杀掉它。参见 TEST-PLAN.md。

许可 / License

MIT。玩法与原则：Lauren Tan。DSH 移植打包：aa2246740。见 LICENSE。

MIT。Playbook 与原则：Lauren Tan。DSH 移植打包：aa2246740。参见 LICENSE。