前言¶
在 DeepSeek Harness(DSH)里做智能体开发时,系统提示与「写多少代码、改多少范围」往往靠手工维护,换会话或换工具链后容易不一致。社区里已有 Ponytail 这类面向「lazy senior dev mode」的极简代码规则集;若要在 DSH 桌面端里常驻生效,并能在设置页、输入区状态条和用量面板里直接操作,就需要专门的宿主适配插件。
下面介绍 KB1SLN-Labs 维护的客户端插件 dsh-ponytail(npm 包名 @kb1slnlabs/dsh-ponytail)。它是 Ponytail 5.3.3 的非官方移植,保留上游 minimal-code 规则原文,并增加 DSH 原生界面:设置页、模式选择器、Composer 状态条与用量仪表盘。上游源码为 DietrichGebert/ponytail(MIT),与本移植无隶属关系。插件归类为 客户端,当前为 Beta;资料注明在 Windows 上配合 DSH 0.2.1-rc.3 / rc.5 的宿主适配与打包测试已通过,macOS Desktop UI 尚未验证。
这是什么¶
dsh-ponytail 把 Ponytail 5.3.3 的规则与六项上游技能(review、audit、debt、gain、help 等)接到 DSH 插件体系里。除始终可用的规则集外,支持按会话切换强度(lite / full / ultra / off),并在客户端展示当前模式、测试命令提示与按会话聚合的用量信息。
兼容范围(peer):DSH >=0.2.1-rc.3 且 <0.3.0。CI 会针对 current latest、alpha 与 rc.3 做日常检查;后续预发布版仍可能破坏 API。
核心功能¶
规则与模式¶
- 模式:
lite、full(上游默认)、ultra、off。包默认强度为full;可在 Settings → Plugins → Ponytail 里改默认(例如选ultra)。 - Profile 级设置重启后保留;本会话用
/ponytail <mode>设置的覆盖在进程重启后清除。环境与全局默认的优先级见仓库内 adapter reference。
DSH 客户端界面¶
- 设置页:Ponytail 专用配置(具体入口随 DSH 版本可能略有差异)。
- 模式选择器:可用时通过
/ponytail打开。 - Composer 状态条:展示演示数据时可展开;其中「测试命令」为当前进程最后一次记录的简单前台测试命令及其退出码,仅作该命令证据,不代表整套测试结论。
- 用量仪表盘:按会话最后更新日期分组展示 provider 报告的整会话用量;无可用用量的会话会标为不可用;不提供会话成本或节省估算(
/ponytail-gain展示的是上游基准参考)。
斜杠命令¶
| 命令 | 作用 |
|---|---|
/ponytail |
打开模式选择器(UI 可用时) |
/ponytail lite / full / ultra / off |
设置本会话模式 |
/ponytail status |
显示当前模式及来源 |
/ponytail reset |
清除本会话覆盖 |
/ponytail-review、/ponytail-audit、/ponytail-debt、/ponytail-gain、/ponytail-help |
一次性技能命令;review、audit 等会启动模型工作,而 status、help 等子命令不会 |
安装与启用¶
安装前若已安装 @mengyuly/dsh-ponytail,需先移除该插件,再按仓库 migration 替换配置行以保留设置。
插件在 DSH 进程权限下运行;安装前应自行审阅 GitHub 源码 与 MIT 许可证及上游归属说明。
DSH Desktop(推荐入口)¶
在 Plugins 侧栏支持 Add plugin 的 Desktop 版本上:打开 Plugins → Add plugin,输入:
@kb1slnlabs/dsh-ponytail@5.3.3-dsh.6
审核并安装、启用后,完全退出 DSH 再重新打开,并新建会话。Desktop 的安装写入其独立 profile,与下文 CLI 示例二选一即可,不是额外必做步骤。
CLI / npm(示例 profile 为 web)¶
需要 DSH 0.2.1-rc.3 CLI。安装后关闭所有 DSH 进程再启动。推荐 pinned 版本:
dsh plugin --profile web add @kb1slnlabs/dsh-ponytail@5.3.3-dsh.6
其他来源(资料原文):
dsh plugin --profile web add github:KB1SLN-Labs/dsh-ponytail
# https://github.com/KB1SLN-Labs/dsh-ponytail/releases/download/v5.3.3-dsh.6/kb1slnlabs-dsh-ponytail.tgz
dsh plugin --profile web add file:./kb1slnlabs-dsh-ponytail.tgz
开发本地链接:
dsh plugin --profile web add "link:$PWD"
Desktop 自带 CLI(profile desktop)¶
Windows 示例:
$dshDesktop = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
& $dshDesktop plugin --profile desktop add @kb1slnlabs/dsh-ponytail@5.3.3-dsh.6
macOS 示例:
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add @kb1slnlabs/dsh-ponytail@5.3.3-dsh.6
重启后在 Settings → Plugins → Ponytail 选择默认模式并保存。
典型用法¶
1、安装并重启 DSH,新建对话。
2、在设置里把默认模式设为 full 或 ultra(按项目需要)。
3、会话中临时切换:
/ponytail ultra
/ponytail status
4、需要上游技能时调用例如 /ponytail-review;查看基准参考用 /ponytail-gain。
5、结束临时覆盖:
/ponytail reset
适用场景与注意¶
适合:已在用或计划用 Ponytail 极简代码规则、希望在 DSH Web/Desktop 客户端里统一管理模式、查看状态条与历史会话用量概览的开发者。
注意:
- 状态为 Beta;macOS Desktop UI 未在资料中验证通过。
- DSH 小版本预发布可能破坏插件 API;安装版本请与 peer 范围一致。
- 仪表盘与状态条中的示例截图在 README 中标注为 Demonstration data,实际数据取决于 provider 与会话记录是否含用量。
- Active time 为已完成轮次的耗时,含等待审批与工具的时间。
- 社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」思路,本插件同样需在信任源码的前提下安装。
结尾¶
dsh-ponytail 在 DSH 上提供 Ponytail 5.3.3 的非官方适配:保留上游规则与技能,并补上设置页、模式选择、Composer 状态条和用量仪表盘。若你要在 Harness 里长期约束「少写、少改、可切换强度」,可按上文安装 pinned 包 @kb1slnlabs/dsh-ponytail@5.3.3-dsh.6,用斜杠命令与会话覆盖配合 profile 默认即可。
- 目录页:https://www.skillhub.cn/plugins/KB1SLN-Labs/dsh-ponytail
- 仓库:https://github.com/KB1SLN-Labs/dsh-ponytail