maci0/dsh-ponytail

dsh-ponytail

Ponytail，懒散资深开发者模式，作为一个 DeepSeek Harness 插件。

改编自 DietrichGebert/ponytail（MIT）。
“他一言不发。他写一行代码。它就能跑。”

| 能力 | 扩展点 | 效果 |
|---|---|---|
| 常驻规则集 | ctx.systemPrompt.section() | 当 off 以外的级别处于激活状态时，经过模式过滤的 ponytail 规则集会出现在每个请求中。 |
| 六个技能 | ctx.skills.registerProvider() | ponytail、ponytail-review、ponytail-audit、ponytail-debt、ponytail-gain、ponytail-help 通过 skill 工具加载——因此会作为 /ponytail-review、/ponytail-audit……出现在输入框中，这正是 DSH 自身用于用户可调用技能的命令界面。 |
| 级别控制 | ctx.tools.register() + ctx.commands.register() + ctx.on('session/event') | 模型调用 ponytail 工具；人类输入 /ponytail [lite\|full\|ultra\|review\|off]，或者直接说 stop ponytail / normal mode。 |
| 设置卡片 | ctx.settings.installSection() + settings.plugin.item | 在设置 → 插件 → 插件配置中有一张 Ponytail 卡片，像内置卡片一样折叠，展开后是 Off/Lite/Full/Ultra 选择器。 |
| 输入框标签 | conversation.input.left | 输入框工具行中有一个只读的级别标签，无需打开设置即可看到当前激活的级别。当级别为 off 时隐藏。 |
| 本地化文案 | ctx.locale.register() | 卡片和标签在 ponytail 语言命名空间下提供 en + zh 词典。 |

阶梯

七级——YAGNI、复用、标准库、原生平台、已安装依赖、一行代码，然后是能跑起来的最小代码。
skills/ponytail/SKILL.md 是唯一事实来源，并且它就是在 off 以外的级别处于激活状态时注入每个请求的确切文本；本 README 有意不再保留它的第二份副本。

懒散，但不疏忽：理解问题、信任边界校验、数据丢失处理、安全性和可访问性永远不在削减之列。

级别

| 级别 | 行为 | 是否持久化 |
|---|---|---|
| lite | 构建所要求的东西，用一行指出更懒的替代方案。 | 是 |
| full | 强制执行阶梯。默认。 | 是 |
| ultra | YAGNI 极端主义者：在构建需求之前先质疑需求。 | 是 |
| review | 过度工程审查；指向 ponytail-review 技能。 | 否——仅限会话 |
| off | 不注入。正常行为。 | 是 |

四个可持久化的级别存放在 ponytail 设置命名空间（~/.dsh/settings.yaml）中，因此卡片、标签、工具和 /ponytail 都保持一致，并且该选择在重启后仍然保留。review 仅限会话，因为它是一种审查模式，而不是部署启动时应处的级别；工具和 /ponytail 仍然接受它。

从消息中切换

/ponytail full 是一条命令。将 stop ponytail 或 normal mode 作为普通消息输入时，会从持久的 user/message 事件中捕获，该事件
在回合的提示词被组装之前就已到达——因此携带该命令的回合已经在没有规则集的情况下运行，而不是晚一个回合。

只有人类自己的话才算数。注入的上下文（技能正文、文件引用、重放的历史记录）搭乘同一事件流，永远无法切换级别，而且消息必须就是该命令：“add a normal mode toggle”会被忽略。

与上游的一个有意差异，上游只清除会话模式：这里写入与 /ponytail off 相同的 off，因为在 DSH 中级别就是持久化的偏好，而仅会话级的覆盖会让卡片和标签报告提示词并未执行的内容。

安装

该插件在一个包中包含两半，除了 @deepseek-ai/schemastery 之外没有运行时依赖（设置服务用它来序列化命名空间 schema）：

- 宿主端 — src/index.ts，由 Loader 从 profile 加载；
- 浏览器端 — lib/client.js，由客户端模块系统提供，因为该包声明了 dsh.client 并导出了 ./client。

安装

实时重载安装：将该包保持为普通依赖（不要 dsh.bundle），并把 Loader 行放入 profile 自己的 cordis.patch.yml。该文件正是 patchReload: live 所监视的。dsh.profile.bundles 在启动时被冻结——不要把这个包放进去。

dsh plugin --profile web add /path/to/dsh-ponytail
pnpm will warn "declares no dsh.bundle — installed as a plain dependency". That is the point.

然后将以下内容粘贴到 ~/.dsh/profiles/web/cordis.patch.yml（或合并到现有的 - insert: 列表中）：

- insert:
- id: ponytail
name: dsh-ponytail
config:
defaultMode: full

保存该文件会重新挂载插件。无需重启 profile。insert 不会对 id 去重——也绝不要同时将该包列在 dsh.profile.bundles 中。

验证

在保存 profile 补丁之后（首次还需刷新页面 Web 客户端）：

- 设置 → 插件 → 插件配置 显示 Ponytail 卡片；
- skill 工具的目录列出了六个 ponytail 技能；
- 在级别为 off 之前，编辑器工具行显示 Ponytail: full 标签；
- /ponytail 在编辑器中报告当前级别；
- 在消息中准确发送 stop ponytail 会关闭该标签，且下一个请求不携带规则集。

配置

| 字段 | 默认值 | 含义 |
|---|---|---|
| defaultMode | PONYTAIL_DEFAULT_MODE，然后是 full | 组合层级别。用户的设置命名空间会覆盖它。必须是 off、lite、full 或 ultra。 |

无效配置会在插件加载时失败，而不是静默地做错误的事。

布局

src/index.ts        host plugin: section, provider, tool, command, message watcher, settings namespace
src/modes.ts        levels, the mode filter, the injected ruleset, default resolution
src/skills.ts       skills provider over skills//SKILL.md
src/frontmatter.ts  极简 frontmatter 读取器（纯文本、>、|、带引号标量）
src/host.ts         宿主接口的结构化声明
lib/client.js       浏览器端：设置卡片 + 输入框标签（loader 工厂格式）
cordis.patch.yml    要粘贴到 profile 实时监视补丁中的 Loader 行
skills/             六个技能，逐字来自上游
tests/              node:test 单元测试 + 假宿主集成覆盖

lib/client.js 有意使用纯 JavaScript。客户端模块系统将包的
exports["./client"] 产物作为惰性 CJS 工厂提供，并注册到
window.__ModuleLoader__；树外插件可以直接编写该产物，
而不必复刻仓库的 tsdown 客户端预设。

它的界面样式是一张样式表，而不是内联样式对象。工厂在实例化时追加一个
标签，模块系统会为该包认领它，并在卸载时移除。这样就让每一次
状态变化（卡片展开、胶囊选中、禁用）都避开 React 的内联样式 diff——
被移除的样式键会用空字符串清除，而这会分解与它并列的简写属性，
这正是 v0.3.1 中一个取消选中的胶囊边框被悄悄清空的原因。

开发

npm test          # node --test tests/.test.ts（Node >= 22.6，无需构建步骤）
npm run typecheck # tsc --noEmit

卸载

dsh plugin --profile web remove dsh-ponytail

并从
~/.dsh/profiles//cordis.patch.yml 中删除 id: ponytail 行。保存后即会卸载。

限制

- 当启用 id: hmr 且此检出位于 config.root 时，宿主源码编辑会重新挂载。
否则，实时补丁重载会从内存中已有的 ESM 模块重新运行 apply。
- 浏览器端编辑需要刷新页面。 客户端模块系统从包中提供
exports["./client"]，因此宿主端可以保持运行。
- 级别是进程范围的。 规则集是全局提示词区段，级别是一个命名空间值，
因此进程中的每个 agent 都共享它。
- 两种语言环境。 卡片和标签提供 en 和 zh；任何其他活动语言环境
都会通过服务自身的回退链回退。
- 外部子 agent 无法触及。 进程内子级会加入父级组合并继承规则集，
但 subagent-claude-code 和 subagent-codex 会启动自己的 CLI，
并带有自己的系统提示词，而且没有任何 harness 扩展点可以包装一次启动。
上游通过 SubagentStart 钩子覆盖这一点；DSH 没有可注册的等效钩子。
- emit 模式：级别变化不会作为会话事件公布；重放的会话显示的是
每个请求已经携带的规则集。

归属与许可

MIT。技能内容和模式语义：© DietrichGebert
（ponytail）。DSH 移植：见 LICENSE。

六个 skills//SKILL.md 文件是逐字副本，因此它们携带的是上游的
数据和引用，而不是本包的。因此 /ponytail-gain
报告了最初的五任务单次基准测试——行数减少 80–94%，
成本降低 47–77%，速度提升 3–6 倍——而上游自己的 README 此后已将其修订为
在其智能体基准测试上大约行数减少 54%、成本降低 20%、速度提升 27%；
并且其 Source: 行标注为 benchmarks/，而本包并未附带该目录。
两者都按原样保留，而不是进行分叉，因为分叉会在每次上游同步时再次产生分歧。