执行纪律插件套件Classicoke/cleverer-dsh

cleverer-dsh

让 DeepSeek Harness (DSH) 变聪明的插件套件——把执行纪律、实用工具和技能库一次性装进 DSH。

✨ 功能总结

| 图标 | 功能 |
|---|---|
| ⚡ | 实测更快更省：同一任务对比裸 DSH，速度提升 49%、估算 token -44%（小样本，未大规模测试） |
| 🧠 | 执行纪律：失败自动拦截、强制反思、任务规划提醒、记忆自动去重、经验自动沉淀成技能 |
| 🛠️ | 开箱即用工具：秒级找文件 + 9 项环境体检，遇到问题不再靠猜 |
| 📦 | 一条命令安装/卸载（走 DSH 自带插件管理器） |
| 🧪 | 478 项单元测试全绿，语句/行覆盖率 100%；纯代码、零依赖，不碰 DSH 本体 |
| 📚 | 6 个内置技能：错误处理六步法、错误速查表、快速找文件、根因排查、本地优先、先计划再执行 |

效果对比

我们用同一个真实任务（分析一份软件打包日志），分别跑装了本套件的 DSH 和什么都没装的裸 DSH，结果：

| 指标 | 装套件 | 裸 DSH | 差距 |
|---|---|---|---|
| 总耗时 | 8.6 分钟 | 12.8 分钟 | 速度提升 49% |
| LLM 调用次数 | 51 次 | 61 次 | 少 20% |
| 工具调用次数 | 59 次 | 67 次 | 少 14% |
| 估算总 token | ~41,000 | ~73,000 | 省 44% 流量 |
| 反复推理次数 | 401 | 1,163 | 少 65% |

实际体验差距：装套件后，遇到问题不硬磕（会自动换思路）、把好用的命令沉淀成脚本复用、关键节点会先问你再动手；裸 DSH 会在同一个问题上反复试 13 次、不沉淀方法、也不征求你意见。

⚠️ 声明：每组只测了 1 次（n=1），token 是按日志估算的（误差约 ±20%），还没有大规模测试——方向有证据，具体数字等更多样本和真实账单校准。

解决什么问题

DSH 功能齐全，但不够聪明：系统提示词是空的、失败了会死磕、技能装了不用、规划工具爱用不用。本套件用四层补齐：

| 层 | 作用 |
|---|---|
| 纪律层（8 个插件） | 失败拦截、强制反思、任务规划、记忆去重 |
| 协作中枢（discipline-hub） | 统一失败记录 + 提醒限流——插件不打架、问题可追溯 |
| 工具层（2 个插件） | 秒级找文件、环境体检 |
| 技能层（6 个技能） | 按需自动加载——出错知道怎么办、找东西快 |

架构

方式一安装（插件管理器）——所有插件内联在一个配置

cordis.patch.yml
├─ discipline-hub          协作中枢（失败记录 / 提醒限流 / 回合统计）
├─ anti-stuck              死磕拦截：同样的错误不让重复试、强制换思路
├─ dsh-env-triage          问题溯源：几个方案都失败就停下来报告
├─ dsh-plan-discipline     任务规划：多步骤任务提醒建计划
├─ dsh-memory              跨会话记忆：自动去重、防膨胀
├─ skill-evolver           经验沉淀：失败→解法→自动存成技能
├─ dsh-discipline          执行规则：每轮注入 11 条做事纪律
├─ dsh-skill-loader        技能调用：按需提醒用技能
├─ dsh-skill-provider      技能注册：6 个内置技能随包直接可用
├─ dsh-cordis-discipline   插件使用规范：防止乱装乱卸载
├─ dsh-fast-locate         找文件工具：一次扫描多个目录
└─ dsh-env-check-tool      环境体检工具：9 项检查

方式二安装（脚本安装）——插件分组为子板

cordis.patch.yml（主配置）
├─ discipline-hub              协作中枢，最先加载（失败记录 / 提醒限流 / 回合统计）
├─ cordis:include → discipline-board.cordis.yml   （纪律组，8 个插件）
│  ├─ anti-stuck               死磕拦截
│  ├─ dsh-env-triage           问题溯源
│  ├─ dsh-plan-discipline      任务规划
│  ├─ dsh-memory               记忆去重
│  ├─ skill-evolver            经验沉淀
│  ├─ dsh-discipline           11 条执行纪律
│  ├─ dsh-skill-loader         技能调用
│  └─ dsh-cordis-discipline    插件使用规范
└─ cordis:include → tools-board.cordis.yml        （工具组，2 个插件）
├─ dsh-fast-locate          找文件工具
└─ dsh-env-check-tool       环境体检工具

子板布局让插件协作成为结构保证：纪律组通过协作中枢共享统一的失败记录与提醒通道，作为一个整体协同工作，而不是各自为战。

安装

前置要求：已安装 DSH 并初始化过 ~/.dsh；需要 pnpm（DSH 插件管理器）。

先看这里：两种方式怎么选？ 区别在插件的组织方式：

| | 方式一：插件管理器（官方） | 方式二：脚本安装 |
|---|---|---|
| 命令 | dsh plugin add ... | 粘贴一行 PowerShell |
| 插件组织 | 全部内联在一个配置 | 分组为 discipline-board（纪律组）+ tools-board（工具组）两个子板 |
| 插件协同 | 各插件独立工作 | 更强——纪律插件共享统一的失败记录与提醒通道，作为一个整体配合 |

💡 为什么子板是更好的方案：这些插件不是各干各的——一个定位根因、一个沉淀经验、一个提醒你先列计划。子板把这种协作变成结构保证（插件天然属于同一组、共享同一套设施），而不是靠运气；纪律组和工具组物理分离、边界清楚，以后想加自己的插件也知道放哪；插件按组整体启停，升级排查更省心。

方式一：DSH 插件管理器安装（官方方式）

dsh plugin --profile web add github:Classicoke/cleverer-dsh
headless 用户：  dsh plugin --profile headless add github:Classicoke/cleverer-dsh

无需构建——命令跑完插件和技能直接可用。卸载：

dsh plugin --profile web remove cleverer-dsh

方式二：一键脚本安装（需 PowerShell 7+）

在 PowerShell 里粘贴这一行（自动下载发布包 → 解压 → 安装 → 清理临时文件）：

$u = 'https://github.com/Classicoke/cleverer-dsh/archive/refs/tags/v1.2.zip'
$z = "$env:TEMP\cleverer-dsh.zip"; $d = "$env:TEMP\cleverer-dsh-install"
Invoke-WebRequest $u -OutFile $z
Expand-Archive $z $d -Force
pwsh -File "$d\cleverer-dsh-1.2\install.ps1"
Remove-Item $z, $d -Recurse -Force

⚠️ 两种安装方式二选一。 同时安装 = 每个插件被加载两次（行为重复、提前误判）。切换方式前先卸载另一种。

方式二卸载

1. 还原安装时自动备份的配置（安装前没有 cordis.patch.yml 的，备份是空 []，还原=回到安装前状态）
$dshHome = Join-Path $HOME '.dsh'
if (-not (Test-Path $dshHome)) { Write-Host "未找到 $dshHome，已中止"; exit 1 }
$bak = Get-ChildItem "$dshHome\cordis.patch.yml.bak-cleverer-*" |
Sort-Object LastWriteTime -Descending | Select-Object -First 1
if ($bak) { Copy-Item $bak.FullName "$dshHome\cordis.patch.yml" -Force }

2. 只删除 cleverer-dsh 安装的文件（精确清单——你自己装的插件/技能在同一目录也不会被误删）
$plugins = @('_shared','anti-stuck','discipline-hub','dsh-cordis-discipline','dsh-discipline',
'dsh-env-check-tool','dsh-env-triage','dsh-fast-locate','dsh-memory',
'dsh-plan-discipline','dsh-skill-loader','dsh-skill-provider','skill-evolver')
foreach ($p in $plugins) { Remove-Item "$dshHome\plugins\$p.mjs" -ErrorAction SilentlyContinue }
$skills = @('debug-by-root-cause','dsh-error-protocol','dsh-error-triage','dsh-fast-lookup','local-first','plan-before-execute')
foreach ($s in $skills) { Remove-Item "$dshHome\skills\$s.md" -ErrorAction SilentlyContinue }
Remove-Item "$dshHome\discipline-board.cordis.yml", "$dshHome\tools-board.cordis.yml" -ErrorAction SilentlyContinue
Remove-Item "$dshHome\scripts\dsh-env-check.mjs" -ErrorAction SilentlyContinue

3. 重启 DSH

所有删除都限定在 $HOME\.dsh（你自己的用户目录，绝不可能是系统路径），且只碰上面列出的文件。

插件一览

| 插件 | 解决什么问题 | 什么时候触发 |
|---|---|---|
| anti-stuck | 死磕：同一个命令反复失败还硬试 | 同一错误 ≥2 次 → 拦住；一次任务失败 ≥3 次 → 提醒；≥5 次 → 强制停下来反思 |
| dsh-env-triage | 换着参数试错、绕圈圈 | ≥2 个方案都失败 → 提示查原因；≥3 个 → 停下报告 |
| dsh-plan-discipline | 任务规划工具爱用不用 | 多步骤任务没建计划 → 提醒；失败 ≥3 次且计划没更新 → 强制刷新 |
| dsh-memory | 记忆重复膨胀、乱用强制写入 | 写入前查重 + 60 秒窗口去重 |
| skill-evolver | 沉淀垃圾技能 | 存技能前过"泛化门槛"，路径名/临时内容直接拒收 |
| dsh-discipline | 系统提示词是空的 | 每轮注入 11 条执行纪律 |
| dsh-skill-loader | 技能装了从来不用 | 任务开头提醒可用技能 + 关键词点名 |
| dsh-cordis-discipline | 动态插件乱装乱卸 | 前置检查（没定义不许运行、没停止不许卸载） |
| discipline-hub | 插件各管各的、提醒刷屏 | 统一记录失败 + 提醒限流 |
| dsh-fast-locate | 找文件慢 | 一条命令并行扫描多个目录 |
| dsh-env-check-tool | 环境问题全靠猜 | 一键跑 9 项环境体检 |

内置技能

| 技能 | 用途 |
|---|---|
| dsh-error-protocol | 出错后的六步处理流程（分类→诊断→决策→验证→沉淀） |
| dsh-error-triage | 错误速查表：什么错对应什么命令 |
| dsh-fast-lookup | 快速找文件的方法论 |
| debug-by-root-cause | 排查问题先找根因，不盲目试 |
| local-first | 能本地验证就不上网猜 |
| plan-before-execute | 动手前先列计划，边做边更新 |

已知限制

- 只在 Windows + PowerShell 上验证过；Linux/macOS 没测（插件本身跨平台，安装脚本是 PowerShell）
- 不修改 DSH 源码；只通过配置注入和技能注入
- headless 模式部分功能受限（无网页服务 → 部分网页相关功能跳过）

许可证

MIT © 2026 cleverer-dsh contributors