dsh-spec-ponytail · 懒惰阶梯

一个 DeepSeek Harness（dsh）插件：把 Ponytail 搬进 dsh， 并加一个「需求配方召回」能力，让它记住每个项目里"这类需求上次是怎么做的"，下次同类需求直接照做。

包名 dsh-spec-ponytail，运行时身份仍是 ponytail：命令（ponytail lite/full/ultra、ponytail recipes）、 技能名（ponytail-review 等）、常驻段（ponytail:ruleset）与数据目录（<cwd>/.dsh-ponytail/）全部保持不变， 避免破坏已安装版本与既有文档。只有插件包/仓库名改成了 dsh-spec-ponytail。

它给每一轮请求装上一套懒惰阶梯：最好的代码是你从没写过的代码。

实测于 @deepseek-ai/dsh 0.1.2-alpha.4（Windows + Web profile）。dsh 仍是 developer preview， 插件已锁定其 API 面（systemPrompt.section / skills.register / agent/pre-step）；升级 dsh 后如失效，先看 CHANGELOG。

它解决什么

三层结构（各管一段，互不重复）

① 常驻系统提示段   systemPrompt.section（text 是函数 → 每 step 重新渲染，随档位变化）
   规则集一直在上下文里，且**一次都不用重复发送**

② 切档注入         agent/pre-step（只在用户真的切档那一步注入一次）
   系统提示段在 pre-step 之前就组装完了，不补这一次，切档当步读到的还是旧档位

③ 八个 Skill       skills.register（review / audit / debt / gain / verdicts / recall / help 按需加载）
   完整说明不占常驻 token

为什么不用上游那套每轮推送：Claude Code 只有 UserPromptSubmit 一个注入口，所以上游每轮 把规则集重发一遍；dsh 有常驻段（且每 step 重新 assemble），一次注册就一直在，还能吃到 供应商侧的前缀缓存。这是阶梯第 4 级「原生功能优先」的直接应用。

档位

怎么切换

dsh 没有斜杠命令面，所以切换就是发一条独立成句的消息 —— 插件在请求发出前就解析并生效， 不经过模型理解，也不会被模型漏读：

判据是整句锚定：ponytail ultra 是切档，帮我按 ponytail 的风格改一下 是普通正文， ponytail-review（技能名）也不会被吞成指令 —— 三种情况都有单测守着。

默认档位解析顺序：持久化档位 > PONYTAIL_DEFAULT_MODE 环境变量 > 插件 defaultMode 配置 > full。

切过的档会记住。 每次切档都会把档位写进 <dsh 启动目录>/.dsh-ponytail/mode（一行档位名），所以：

• 重启不丢档 —— 这也是持久化排在优先级第一的原因；
• 全机一份（重要）：路径取的是插件进程的 process.cwd()，本机实测 = C:\Users\wen13\.qbot-dsh\home —— 那是侧栏启动 dsh 的目录，不是会话工作区。所以它实际是跨工作区共享的： 在 A 项目切 ultra，B 项目也跟着 ultra。（0.2.0 文档里一度写成"按工作区隔离"，是错的，已更正。）
• 想回到配置默认值，删掉那个文件即可。

八个 Skill

需求配方召回（0.3.0 新增）

让相似需求快速响应：把「这类需求上次怎么做的」沉淀成一份三要素配方（触发 / 做法 / 禁区）， 下次同类需求由插件自动召回注入，实现就从已验证的改法开头，而不是从零推导。

• 配方放 <会话工作目录>/.dsh-ponytail/recipes.md（每个项目一份，与 verdicts.md 同构）：

  ## Spring 分页查询接口
  触发：分页 查询接口 列表翻页
  做法：
  - 四层：Controller → Service → ServiceImpl → Mapper
  禁区：
  - common/Result.java 是全局契约，别改

• 自动召回：一条编码需求若覆盖某配方触发词 ≥2 个单元且 ≥50%（CJK 感知），插件注入该配方。 只认强命中，普通回合零注入、零 token。
• 显式召回：ponytail recipes 注入整个配方库（空库也会说明格式）。
• 沉淀：任务收敛时若"这次做法下次可照做"，用普通文件工具往 recipes.md 追加一条 （沿用 ## 名称 + 触发：… 结构）。见 ponytail-recall Skill。

成本（npm run token-audit 实测）

诚实边界：526 token/step 是每个 step 的固定税，会叠加在宿主自身已有的系统提示上。三点缓解：

1. 常驻段进的是系统提示前缀，供应商侧通常有前缀缓存，实际计费远低于此；
2. off 档下常驻段整段消失，是真正的 0；
3. 阶梯里「输出最多三行」这条，省下的是回答侧的 token —— 上游实测同一批任务 tokens −22%。

觉得太贵就 ponytail lite 或 /ponytail off；要改规则集文本，见 lib/ruleset.js（上限由 tests/ruleset.test.js 守着，超 2200 字符直接测试失败）。

安装

前置：dsh 可用、Node 22+。

dsh plugin --profile web add github:winston-hoo/dsh-spec-ponytail
dsh web   # 必须重启，插件才会组合进插件树

本地源码调试（--patch 加载，注意 Windows 要 file:/// 形式）：

node apps/cli/lib/bin.js --profile headless \
  --patch D:/HBuilderProjects/DSH/dsh-spec-ponytail/dev/ponytail.patch.yml "你的任务"

验证装上了（--dump-config 只合成插件树、不启动服务，是排障第一招）：

pnpm dsh --profile web --dump-config | Select-String ponytail

出现 # == dsh-spec-ponytail 段即成功。

快速验收

1. 随便提个编程需求 → 全程不提「ponytail」也能看到阶梯生效：更短的 diff、skipped: … 三行交代
2. 发 ponytail ultra → 当步就收到 Level → **ultra**，之后行为更激进
3. 发 ponytail → 回一句 [ponytail] Current level: **full**（这句话只可能由本插件的 pre-step 处理器产生，是最省事的一键验收）—— ✅ 已实测通过
4. 发 关闭 ponytail → 常驻段消失（行为回到常规）
5. 让模型写个刻意简化的实现 → 代码里应出现 # ponytail: <上限>, <升级触发>
6. 跑 ponytail-debt → 上面那个标记被收进台账
7. 切完档看一眼 <dsh 启动目录>/.dsh-ponytail/mode（本机 = C:\Users\wen13\.qbot-dsh\home\.dsh-ponytail\mode）→ 里面就是刚才那个档位名；重启 dsh 后档位不变

首次安装时实际观察到的

• pnpm add 返回 layers added: dsh-spec-ponytail / activation: applied，profile 的 dsh.profile.bundles 里出现 dsh-spec-ponytail；
• 该 profile 的 patchReload: live —— skill 目录当场就变（八个 ponytail 技能出现在会话里，无需重启）；
• 常驻规则集：本会话的系统提示里出现 PONYTAIL MODE ACTIVE — level: full 段，措辞与本插件 lib/ruleset.js 一致；已排查 app 包、agent presets、DSH home、其它工程，全机器没有第二个 PONYTAIL MODE ACTIVE 注入源 —— 这一段只能来自本插件。

⚠️ file: 安装是复制一份到 profile（不是软链）。改了源码要重新刷新才生效： 在 profile 目录执行 pnpm update dsh-spec-ponytail（或再走一次 dsh plugin add）。 日常开发用 dev/ponytail.patch.yml 走 --patch 加载，那条路径才是直接读源码。

本地跑测试

npm test        # node --test，85 条
npm run token-audit

本地跑测试需要能解析 @deepseek-ai/schemastery（宿主在运行时提供）。仓库里用一条 junction 指向 harness checkout 的 vendor/schemastery 即可（node_modules/ 已 gitignore）：

New-Item -ItemType Junction -Path node_modules\@deepseek-ai\schemastery `
  -Target D:\HBuilderProjects\DSH\deepseek-harness\vendor\schemastery

沙箱内注意：node --test 会 spawn 子进程（管道 stdio 会被拒为 EPERM），逐文件跑即可： node tests/mode.test.js; node tests/ruleset.test.js; node tests/store.test.js; node tests/verdicts.test.js; node tests/plugin.test.js; node tests/recipes.test.js。

已知边界

1. dsh 还是开发者预览版。 锁定的 API 面是 systemPrompt.section / skills.register / agent/pre-step；升级 dsh 后失效先 --dump-config。
2. 档位文件是全机一份：路径 = 插件进程的 process.cwd()，本机实测为 C:\Users\wen13\.qbot-dsh\home（侧栏启动 dsh 的目录），不是会话工作区 —— 因此跨工作区共享，同一 dsh 进程里的多个会话也共享一个档位。要真按工作区隔离，得改用 agent.session.cwd 并在常驻段渲染时按会话解析（多一次磁盘读或一层缓存）；没做。写入失败（目录不可写）只告警，本轮切档照常生效，只是重启后不保留。
3. 切档只认独立成句的指令。 夹在长句里的 ponytail 一律当正文，不会被吞 —— 这是刻意的取舍（宁可漏切，不可误吞需求）。
4. 常驻段与 SKILL.md 是两处文本，压缩版 + 完整版。改规则必须两边一起改，否则模型读到的两个版本会打架。tests/ruleset.test.js 守着压缩版的七级阶梯与安全底线不丢项，但守不住措辞分叉。
5. 子代理继承的是常驻段（全局作用域段对子代理一并生效），不是上游那种专门注入。0.2.0 已派真实子代理实测：它自己的系统提示里确实带该段，档位也对 —— 所以那个 PONYTAIL_SUBAGENT_MATCHER 在我们的机制下没有存在必要（阶梯第 1 级）。
6. ponytail-gain 的数字是上游基准，不是本仓库实测；该 Skill 明确禁止把基准说成「你这个仓库省了多少」。
7. 插件与宿主同进程同权限：只读自己的 skills/ 目录、不联网、不执行 shell、不读写你的项目文件。源码公开，装前可自行审查。

卸载

dsh plugin --profile web remove dsh-spec-ponytail
# 若声明了 dsh.bundle.patch，还需清理 profile 的 cordis.patch.yml 对应行
dsh web   # 重启生效

卸载会移除插件与常驻段；<dsh 启动目录>/.dsh-ponytail/mode 与各项目 <会话工作目录>/.dsh-ponytail/（verdicts / recipes）是你自己的记忆文件，留着不影响、删了干净。

FAQ

Q：这个插件会不会像「开票催办」事故那样，把文档标可选但承担功能的参数偷偷砍掉，或点击直接调接口、连二次确认都没有？

A：上游 ponytail 只声明「别砍校验 / 防数据丢失 / 安全 / 无障碍」这一类安全底线，并不覆盖「功能性的可选参数」和「不可逆 / 对外的写操作须确认」，所以这类"曲解偷懒"它兜不住。本插件 0.3.2 把这两条写死进常驻段（每回合都生效，见 lib/ruleset.js 的 ## Never lazy about）：

1. 可选 ≠ 可省：接口字段即使文档标 optional，只要当前流程用它就必须传（remark / reason 不是装饰），不得因为 schema 允许空值就把唯一业务参数当装饰砍掉。
2. 不可逆 / 对外写须确认：通知 / 发送、作废、红冲、重开、金额等发出去收不回、或波及第三方的写动作，先弹窗确认 + 可填说明，禁止 @click 直连接口。判据 = "能撤吗？会波及第三方吗？"——沾一条就确认。

完整来龙去脉见 CHANGELOG.md 的 0.3.2 条目。

致谢与许可

本插件是 Ponytail 的 DeepSeek Harness 插件化改造，遵循上游的 MIT 开源协议：

• 上游：Ponytail，Copyright (c) 2026 DietrichGebert，MIT。
• 规则文本与六个 Skill（ponytail / -review / -audit / -debt / -gain / -help）移植自上游； 逐项差异见 NOTICE。ponytail-verdicts / ponytail-recall 为本插件自有能力，未移植。
• 本插件自身：MIT，见 LICENSE；MIT 许可文本随 LICENSE 一并保留。
• 使用/再分发时请保留上游与本插件的版权声明及许可文本（MIT 要求）。

更多文档

• CHANGELOG.md —— 逐版本变更记录
• docs/design.md —— 三层注入契约、档位模型、改动规则集时要同步的四处
• lib/ruleset.js —— 模型看到的全部规则文本（唯一事实来源）