official pstack 的 DeepSeek Harness 移植
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
22 个玩法（playbooks）和 21 条原则（principles）是 poteto 写的，出自 official pstack。本仓库是 DeepSeek Harness 移植（aa2246740/pstack-dsh）。调用层用 HARNESS.md 里的 DSH 工具名。玩法和原则不是本仓库写的。
The 22 playbooks and 21 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.
安装 / Install
dsh plugin add github:aa2246740/pstack-dsh
本地目录也可以：
A local checkout also works:
dsh plugin add ./pstack-dsh
工具对照见 HARNESS.md。工作台是 dshx，用来 check / verify-boot。不要用它当 DSH 发行版。
Tool mapping is in HARNESS.md. dshx is the out-of-process workbench for check / verify-boot. It is not a DSH fork.
开始用 / Get started
两步。
Two steps.
-
要做事、要严谨，直接用 /poteto-mode。不用先跑 setup。子 agent 默认继承当前对话的路由。
-
只有想给某个角色换已登录的路由时，打开 设置 → pstack（导航「pstack 角色」/「pstack roles」）。页面写入 $DSH_HOME/pstack-dsh.json。/setup-pstack 只是指向那一页的指针。
-
Use /poteto-mode for work that needs rigor. No setup required. Children inherit this conversation's route.
-
To pin a logged-in route per role, open Settings → pstack (nav label pstack 角色 / pstack roles). The page writes $DSH_HOME/pstack-dsh.json. /setup-pstack is an optional pointer to that page.
第一次用可以看 pstack 指南。
New here? The pstack guide walks through a first real task.
其余技能是按需的。/poteto-mode 会在步骤需要时自己去调。
The other skills are situational. The mode skill uses them when a step needs them.
默认模型与 effort / Defaults
装完就能用，不必先打开设置，也不必跑 /setup-pstack。
A fresh install is usable without Settings → pstack and without /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）。
Do not send model unless that pair was detected live. Missing overlay inherits the parent. Do not invent Cursor panel slugs.
effort. 只提供该路由 resolveModelInfo().reasoning.efforts 列出的 id。没有 effort 字段就省略。skill 从不在 spawn 上发送 reasoning_effort 或 thinking。官方 subagent schema 没有这些字段。角色 effort 写在 overlay 里，由 agent/request 落到 LlmCallConfig.reasoningEffort。
Effort is only the ids that route actually accepts. If the route has none, omit it. Skills never send reasoning_effort or thinking on spawn. Official subagent has no such field. Role effort lives in the overlay and is applied on agent/request.
设置 / Settings. 配置页是官方 Settings 里的 settings.section（id pstack，order 16）。只列出已登录路由；effort 只列出该路由 live resolveModelInfo().reasoning.efforts。空列表就是继承父对话。保存写同一份 overlay，不是第二份配置。
The editor is the official Settings settings.section (id pstack, order 16). It lists logged-in routes only. Effort options are that route's live resolveModelInfo().reasoning.efforts. An empty list means inherit the parent. Save writes the same overlay, not a second file.
设置页只列出已经登录的 API key 路由，以及 dsh-oauth-login 仓库里已经签过名、并且 pi-* 适配器已注册的路由。空目录就是继承父对话。
推荐依赖 / Recommended peer
订阅登录（ChatGPT / Claude / Grok / Copilot / OpenRouter / Kimi）要出现在 设置 → pstack 列表里，需要另装 dsh-oauth-login。不是硬依赖。只用 API key 的用户可以不装。本插件不读写 ~/.pi、~/.codex、~/.claude、grok CLI 登录文件。
Subscription logins show up on Settings → pstack after you install dsh-oauth-login. It is not required. API-key-only users work without it. This plugin does not read or write official CLI auth files.
dsh plugin add github:aa2246740/dsh-oauth-login
这不是 Cursor 插件 / Not the Cursor plugin
这里的角色映射在 设置 → pstack。官方 Cursor /setup-pstack 会写 ~/.cursor/rules，并用 Cursor 的模型名。不要在 DSH 上跑那份。
Role mapping in this repo is Settings → pstack. Official Cursor /setup-pstack writes ~/.cursor/rules and uses Cursor slugs. Do not run it here.
工具 / Tools
本插件注册：
This plugin registers:
| 工具 / 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 指向设置页。
Slash entry: /poteto-mode, plus the bundled playbook and principle skills. /setup-pstack points at the Settings page.
开发 / Develop
npm install
npm test
npx dshx check pstack-dsh --harness /path/to/deepseek-harness
npx dshx verify-boot pstack-dsh --port 43123
不要对用户正在用的 DSH Host 发 --force，也不要杀它。verify-boot 只允许隔离冷启动。对照 TEST-PLAN.md。
Do not --force or kill a user's live DSH Host. verify-boot is isolated cold boot only. See TEST-PLAN.md.
许可 / License
MIT。玩法与原则：Lauren Tan。DSH 移植打包：aa2246740。见 LICENSE。
MIT. Playbooks and principles: Lauren Tan. DSH port packaging: aa2246740. See LICENSE.
