njuptlzf/dsh-ponytail

dsh-ponytail

English · 点击下方「中文」切换中文

一个 DeepSeek Harness 插件，用于安装 Ponytail 的“懒惰资深开发者”规则集。它镜像了上游的两层拆分：

- 一个始终开启、可切换模式的系统提示词区段，由精简规则集（约 2.5 KB）构建，以及
- 完整规则集 + 5 个配套技能，作为按需的 / 技能。

本仓库不内置任何技能内容。 首次启动时，它会从上游 DietrichGebert/ponytail 拉取一次，缓存到磁盘，之后不再重新拉取或手动同步。

它的作用

1. 始终开启的区段（精简） —— 将精简规则集（.agents/rules/ponytail.md，约 2.5 KB）作为系统提示词区段，缓存于 ~/.dsh/ponytail-cache/compact.md。使用 /ponytail lite|full|ultra|off 按会话切换级别；off 会清空该区段，从而真正节省 token。默认 full。
2. 按需技能（仅用户） —— 将完整规则集（ponytail）和 5 个配套技能（ponytail-help / ponytail-audit / ponytail-debt / ponytail-gain / ponytail-review）一次性写入 ~/.dsh/skills//SKILL.md，可从 / 面板调用。每个文件的 frontmatter 都带有 disable-model-invocation: true，因此这些技能保持用户可调用（在 / 中显示并带有“user only”标签），但不会向模型宣传 —— 没有 available_skills 目录开销，也不会在“ANY coding task”时自动加载。始终开启的精简区段是唯一面向模型的副本。

安装

dsh plugin --profile web add @njuptlzf/dsh-ponytail
without a global dsh:
npx @deepseek-ai/dsh plugin --profile web add @njuptlzf/dsh-ponytail
from git instead: dsh plugin --profile web add github:njuptlzf/dsh-ponytail

安装后重启 dsh web。首次启动会拉取一次并缓存，因此之后的启动 —— 无论在线还是离线 —— 都不会再访问网络。要更新技能，请删除相应的缓存/技能文件并重启。

用法

- /ponytail —— 报告当前级别；/ponytail lite|full|ultra|off —— 切换级别。模式按会话（agent.id）区分，因此一个对话的 off 不会影响另一个。
- 这 6 个技能会留在 / 面板中，标记为“user only”；输入 / 并选择一个（例如 /ponytail-review）即可手动触发 —— 模型绝不会主动引入它们。

dsh-ponytail 与 codex-ponytail 对比

| | codex-ponytail（上游 Codex 插件） | dsh-ponytail（本插件） |
|---|---|---|
| 机制 | Codex 插件：SessionStart + SubagentStart + UserPromptSubmit 生命周期钩子 | DSH bundle：systemPrompt 区段 + commands 服务 |
| 始终开启的内容 | 完整规则集，按模式过滤，在 SessionStart 时 | 精简规则集（约 2.5 KB） 每一步 |
| 每轮开销 | 完整规则仅在会话开始 / 精简 / 子代理时；每轮一行模式 | 每一步重新渲染约 2.5 KB（DSH systemPrompt 的逐步语义） |
| off | UserPromptSubmit 停止注入，节省 token | section 渲染为空，节省 token（对等） |
| 档位 | lite/full/ultra 过滤完整规则集的按模式行 | 档位作为 header + 行为携带；按模式细节位于按需加载的完整 skill 中 |
| 会话隔离 | 单会话进程 → 进程级标志文件 | 多会话进程 → 按 agent.id（== session.id） |
| 压缩 | SessionStart 在 compact matcher 上重新触发 | 压缩只会打碎历史，绝不会打碎 system prompt（固有） |
| 子代理 | SubagentStart + PONYTAIL_SUBAGENT_MATCHER | 全局 section 通过组合继承到子代理（预期无需补丁） |
| 按需细节 | ponytail skill | ponytail skill（对等） |
| 回退 | 内联 getFallbackInstructions | TODO（见 OPTIMIZATION_PLAN.md） |

结构

dsh-ponytail/
├── index.js               # 宿主插件：抓取一次 → 压缩为常驻 + 镜像 full/companions
├── package.json           # dsh.bundle.patch 声明
├── cordis.patch.yml       # 挂载行
├── OPTIMIZATION_PLAN.md   # 完整设计理由 + 对比
├── README.md
└── LICENSE                # MIT

归属

技能内容来自 DietrichGebert/ponytail（MIT），在运行时抓取。插件封装为 MIT © 2026 Kasakaze (njuptlzf)。

中文 · 点击上方「English」切换英文

一个 DeepSeek Harness 插件：把 Ponytail「懒高级工程师」规范接入进来，对标上游的两层结构：

- 常驻、可按档切换的 system-prompt section，用 精简规则（~2.5 KB）构建；
- 全文规则 + 5 个同伴技能作为按需 / skill。

本仓库不存技能内容——首次启动从上游 DietrichGebert/ponytail 抓取一次并落盘缓存，之后不再联网、永不手工同步。

它做什么

1. 常驻 section（精简） — 精简规则（.agents/rules/ponytail.md，~2.5 KB）作为 system-prompt section，缓存于 ~/.dsh/ponytail-cache/compact.md。用 /ponytail lite|full|ultra|off 按会话切档；off 会让 section 渲染为空、真的省回 token。默认 full。
2. 按需 skills（仅用户可用） — 全文规则（ponytail）和 5 个同伴（ponytail-help / ponytail-audit / ponytail-debt / ponytail-gain / ponytail-review）写入 ~/.dsh/skills//SKILL.md，/ 面板可调。每个 skill 的 frontmatter 都带 disable-model-invocation: true：技能保持仅用户可调用（在 / 里显示、带「仅用户可用」标签），但不对模型公开——不进 available_skills catalog、不会因描述写着 "ANY coding task" 被自动加载。常驻精简 section 是唯一面向模型的那一份。

安装

dsh plugin --profile web add @njuptlzf/dsh-ponytail
无全局 dsh：
npx @deepseek-ai/dsh plugin --profile web add @njuptlzf/dsh-ponytail
或者从 git 安装：dsh plugin --profile web add github:njuptlzf/dsh-ponytail

安装后重启 dsh web：首次启动联网抓取一次并缓存，之后无论在线离线都不再联网。要更新技能，删对应缓存/技能文件再重启即可触发重抓。

使用

- /ponytail — 报告当前档；/ponytail lite|full|ultra|off — 切档。档位按会话（agent.id）隔离，一个会话的 off 不影响其它会话。
- 6 个技能常驻 / 面板、标「仅用户可用」；打 / 看候选、手工选一个（如 /ponytail-review）触发——模型不会未经请求就自动加载它们。

dsh-ponytail vs codex-ponytail

| | codex-ponytail（上游官方 Codex 插件） | dsh-ponytail（本插件） |
|---|---|---|
| 接入机制 | Codex 插件：SessionStart + SubagentStart + UserPromptSubmit 三个 lifecycle hook | DSH bundle：systemPrompt section + commands 服务 |
| 常驻内容 | SessionStart 时注入全文（按 mode 过滤） | 每步注入精简规则（~2.5 KB） |
| 每轮成本 | 全文只在会话开始/压缩/子代理时；每轮只一行 mode 标记 | 每步重渲 ~2.5 KB（DSH systemPrompt 的 per-step 语义） |
| off | UserPromptSubmit 停止注入、省回 token | section 渲染为空、省回 token（对齐） |
| 强度档 | lite/full/ultra 过滤全文对应档的内容 | 档位以 header + 行为承载；分档细节落在按需全文 skill |
| 会话隔离 | 单会话进程 → 进程级 flag 文件 | 多会话单进程 → 按 agent.id（== session.id）隔离 |
| 压缩/遗忘 | SessionStart 的 compact matcher 在压缩时重注入 | 压缩只 shadow 历史、不动 system prompt（天然免疫） |
| 子代理 | SubagentStart + PONYTAIL_SUBAGENT_MATCHER | 全局 section 随 composition 继承子代理（预期无需补丁） |
| 按需详情 | ponytail skill | ponytail skill（对齐） |
| 兜底 | 内置 getFallbackInstructions | 待补（见 OPTIMIZATION_PLAN.md） |

结构

dsh-ponytail/
├── index.js               # host 插件：只抓一次 → 精简常驻 + 镜像全文/同伴
├── package.json           # dsh.bundle.patch 声明
├── cordis.patch.yml       # 挂载行
├── OPTIMIZATION_PLAN.md   # 完整设计说明与对比
├── README.md
└── LICENSE                # MIT

归属

技能内容来自 DietrichGebert/ponytail（MIT），运行时抓取。插件包装层 MIT © 2026 Kasakaze (njuptlzf)。