← Back to home@aa2246740

pstack-dsh

DeepSeek Harness port of official pstack. Playbooks and principles are poteto's; only the harness call layer is rewritten.

Stars
0
Language
TypeScript
Created
Aug 25, 2026
Updated
Aug 25, 2026
Skills
GitHub repo

Introduction

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.

  1. 要做事、要严谨，直接用 /poteto-mode。不用先跑 setup。子 agent 默认继承当前对话的路由。

  2. 只有想给某个角色换已登录的路由时，才跑 /setup-pstack。它是可选的、全局的，写入 $DSH_HOME/pstack-dsh.json。

  3. Use /poteto-mode for work that needs rigor. No setup required. Children inherit this conversation's route.

  4. Optionally run /setup-pstack to pin a logged-in route per role. It is optional and global. It writes $DSH_HOME/pstack-dsh.json.

第一次用可以看 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 /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.

/setup-pstack 只列出已经登录的 API key 路由，以及 dsh-oauth-login 仓库里已经签过名、并且 pi-* 适配器已注册的路由。空目录就是继承父对话。

/setup-pstack lists only logged-in API-key routes and signed-in dsh-oauth-login routes whose pi-* adapter is registered. An empty catalog means inherit the parent.

推荐依赖 / Recommended peer

订阅登录（ChatGPT / Claude / Grok / Copilot / OpenRouter / Kimi）要出现在 setup 列表里，需要另装 dsh-oauth-login。不是硬依赖。只用 API key 的用户可以不装。本插件不读写 ~/.pi、~/.codex、~/.claude、grok CLI 登录文件。

Subscription logins show up as routes 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

这里的 /setup-pstack 只给 DeepSeek Harness 配路由。官方 Cursor /setup-pstack 会写 ~/.cursor/rules，并用 Cursor 的模型名。不要在 DSH 上跑那份。

/setup-pstack in this repo configures DSH routes. 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。

技能入口：/poteto-mode、/setup-pstack，以及 bundled 的 playbook / principle skills。

Slash entry: /poteto-mode, /setup-pstack, plus the bundled playbook and principle skills.

开发 / 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.