dsh-ponytail

DietrichGebert/ponytail 的 DSH 完整移植版 — always-on 注入 + 6 个中文 Skill，无空 tool。

🚀 安装（默认装到 web）

web 即日常的 DSH Web UI（3080）。示例中的 demo 可换成任意 --profile <name>。

# 方式一：npm
dsh plugin --profile web add @wenaixi/dsh-ponytail

# 方式二：GitHub 直装（lib 已提交，无需构建）
dsh plugin --profile web add github:Wenaixi/dsh-ponytail

# 方式三：本地 / tarball
pnpm install && pnpm build && dsh plugin --profile web add ./
pnpm pack && dsh plugin --profile web add ./wenaixi-dsh-ponytail-*.tgz

# 卸载
dsh plugin --profile web remove @wenaixi/dsh-ponytail

# 验证
dsh --profile web --dump-config | grep -A2 ponytail

WARN missing peer @deepseek-ai/... 属正常，peer 由 DSH 运行时提供；Packages: +2 Done 即成功。

✨ 特性

• 梯子 7 阶：YAGNI → 复用 → 标准库 → 平台原生 → 已有依赖 → 一行 → 最小实现，off 时静默
• 6 个中文 Skill（rank: 550）：ponytail / ponytail-review / ponytail-audit / ponytail-debt / ponytail-gain / ponytail-help
• 三档强度：lite / full（默认）/ ultra
• 无空 tool：全部能力经 ctx.skills 暴露

| 能力 | 说明 | |---|---| | ponytail | 7 阶梯子，触发词兼容中英文 | | ponytail-review | diff 评审，delete/stdlib/native/yagni/shrink | | ponytail-audit | 全仓审计，按可删收益排序 | | ponytail-debt | 收割 ponytail: 注释 | | ponytail-gain | 收益看板（benchmark 中位数） | | ponytail-help | 速查卡 |

🪝 Hook 注入

上游 hooks/ 的 4 个生命周期 Hook 已合并进单一 DSH 插件，无需宿主配置。

| 上游 | DSH 侧 | |---|---| | ponytail-config.js | src/ponytail-config.ts（env > 文件 > full，review 不可默认） | | ponytail-instructions.js | src/ponytail-instructions.ts（按 lite/full/ultra 裁剪 + 中文 fallback） | | ponytail-runtime.js | src/ponytail-runtime.ts（.ponytail-active + 三平台识别） | | ponytail-activate.js + mode-tracker.js + subagent.js | src/ponytail.ts 统一合并 |

启动:  env PONYTAIL_DEFAULT_MODE → cordis defaultMode → ~/.config/ponytail/config.json → full
       → setMode(flag 文件)

每轮请求前: agent/pre-step (waterfall, 必须 return next())
            → 解析 /ponytail 族 / stop ponytail → 切 currentMode + 写 flag → next()

注入: systemPrompt:section { name: ponytail, order: 50 }
      order 50 在 persona(0) 之后、工具(100) 之前；同步读 SKILL.md 按 currentMode 裁剪
      off → 空，review → 指向技能，读盘失败 → 中文 fallback，assembly 前以 readMode() 对齐

持久化: /ponytail default <mode> → 写入 config.json
子智能体: PONYTAIL_SUBAGENT_MATCHER 正则（非法 warn 回退），共享同一 section
HMR: 全部走 ctx，热重载逆序自动清理

systemPrompt 而非 agent.inject：落入日志可重建，order: 50 优先级高，每次 assemble 动态求值，off 零成本。Flag 兼容 CLAUDE_PLUGIN_ROOT / PLUGIN_DATA / QODER_SESSION_ID。

⚙️ 配置

- insert:
    - id: ponytail
      name: "@wenaixi/dsh-ponytail"
      config:
        providerName: ponytail
        defaultMode: full  # off|lite|full|ultra

优先级：PONYTAIL_DEFAULT_MODE env > cordis.defaultMode > ~/.config/ponytail/config.json > full。持久化：/ponytail default <mode> 写入文件，review 不可作默认。

🎮 使用

• 自动生效，无需手动触发
• /ponytail [lite|full|ultra|off] / /ponytail default <mode> / /ponytail-review / /ponytail-audit / /ponytail-debt / /ponytail-gain / /ponytail-help
• 退出：stop ponytail / normal mode（整句）或 /ponytail off

🛠️ 开发

pnpm typecheck && pnpm build && node scripts/verify.mjs
dsh --profile web --patch ./cordis.patch.yml --dump-config
pnpm dsh web --patch ./cordis.patch.yml  # 热重载
# 发版：pnpm run bump:dsh && pnpm build && npm publish --provenance --access public
# 或 push tag v* 触发 GitHub Actions publish.yml

• 版本：每个版本固定带 -dsh.N（初始 4.9.0-dsh.0），pnpm run bump:dsh 递增，上游发新版时 pnpm run bump:dsh -- 4.10.0 重置

🔗 上游

原仓 https://github.com/DietrichGebert/ponytail（MIT）

📄 许可

MIT © DietrichGebert / Wenaixi