前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，功能可以按需扩展，但默认行为并不强调执行纪律：系统提示为空、失败后容易重复同一套错误操作、已安装的 Skill 未必被调用、待办工具常被忽略。开发者在实际跑任务时，常见现象是智能体在同一问题上反复重试、不主动反思、也不把成功经验沉淀下来。
cleverer-dsh 是一套面向 DSH 的工作流插件套件，由 Classicoke 维护，目标是在不修改 DSH 源码的前提下，用 11 个插件和 6 个内置 Skill 补齐上述缺口。套件零外部依赖，README 标注 478 个单元测试全部通过，语句与行覆盖率 100%。
这是什么¶
cleverer-dsh 的定位是 DSH execution-discipline plugin suite：通过纪律层、工具层和 Skill 层协同，让 Harness 在失败拦截、任务规划、记忆去重、经验沉淀等方面有稳定约束。
维护者：Classicoke
许可证：MIT（见 package.json）
当前版本：1.2.0
分类：工作流
GitHub：https://github.com/Classicoke/cleverer-dsh
社区目录页：https://www.skillhub.cn/plugins/Classicoke/cleverer-dsh
核心功能¶
下面按 README 中的架构分层介绍，只列已核实能力。
纪律层（8 个插件 + 1 个 Hub）¶
| 插件 | 作用 |
|---|---|
discipline-hub |
共享失败日志、提醒节流、轮次统计 |
anti-stuck |
卡死循环防护：禁止相同参数重复重试，强制换方案 |
dsh-env-triage |
问题追踪：多种方案均失败时停止并上报 |
dsh-plan-discipline |
多步任务提醒先制定计划 |
dsh-memory |
跨会话记忆：自动去重、防膨胀 |
skill-evolver |
经验蒸馏：失败 → 解法 → 保存为 Skill |
dsh-discipline |
每轮注入 11 条执行规则 |
dsh-skill-loader |
提升 Skill 使用率：按需目录 + 关键词召唤 |
dsh-cordis-discipline |
动态插件护栏：先 define 再 run，先 stop 再 undefine |
纪律插件通过 discipline-hub 共享失败日志与提醒管道，避免各自为政。
工具层（2 个插件）¶
| 插件 | 作用 |
|---|---|
dsh-fast-locate |
并行多目录文件查找 |
dsh-env-check-tool |
环境健康检查（9 项） |
Skill 层（6 个内置 Skill）¶
README 列出的内置 Skill 包括：六步错误处理、错误速查表、快速文件定位、根因调试、本地优先、先计划后执行。运行时由 dsh-skill-provider 在包内解析注册，dsh-skill-loader 负责按需加载。
实测数据（README 自述，样本有限）¶
README 记录了一次对比实验：同一任务（分析软件打包日志），安装套件 vs 裸 DSH：
| 指标 | 安装套件 | 裸 DSH | 差异 |
|---|---|---|---|
| 总耗时 | 8.6 min | 12.8 min | 快 49% |
| LLM 调用 | 51 | 61 | -20% |
| 工具调用 | 59 | 67 | -14% |
| 估算总 token | ~41,000 | ~73,000 | 少 44% |
| 推理块 | 401 | 1,163 | -65% |
README 明确标注：每组 n=1，token 为字符估算（±20%），尚未广泛验证，具体数字有待更多样本和真实 API 账单数据。文中引用此表仅为说明方向，不作为普遍结论。
安装与启用¶
前提：已安装并初始化 DSH；本机可用 pnpm（DSH 插件管理器依赖）。
两种安装方式只能选其一。README 警告：同时安装会导致每个插件重复加载，行为重复甚至提前拒绝。
方式一：DSH 官方插件管理器（推荐）¶
适合希望一条命令完成安装的场景。插件以 inline patch 形式写入 cordis.patch.yml。
dsh plugin --profile web add github:Classicoke/cleverer-dsh
无头环境将 web 换成 headless：
dsh plugin --profile headless add github:Classicoke/cleverer-dsh
命令完成后无需构建，插件与 Skill 即可用。卸载：
dsh plugin --profile web remove cleverer-dsh
方式二：PowerShell 脚本安装¶
适合需要 board 分组架构的场景。脚本从 GitHub Release 下载 v1.2 压缩包，解压后执行 install.ps1，将插件分为 discipline-board（纪律组）和 tools-board（工具组），纪律插件与 Hub 的结构化协作更强。
在 PowerShell 7+ 中粘贴执行：
$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
卸载需先恢复安装前自动备份的 cordis.patch.yml，再按 README 列出的插件与 Skill 文件名逐项删除。完整卸载脚本见 GitHub README「Uninstall (Option 2)」一节。
典型用法¶
安装完成后，套件随 DSH 进程自动加载，无需额外启动命令。行为体现在任务执行过程中：
- 多步任务：
dsh-plan-discipline提醒先建计划，减少无结构推进。 - 命令失败：
anti-stuck拦截相同参数的重复重试；dsh-env-triage在多种方案失败后要求停止并报告。 - 查找文件：通过
dsh-fast-locate并行扫描多个目录，替代逐目录猜测。 - 环境排查：调用
dsh-env-check-tool执行 9 项健康检查，快速定位环境问题。 - 经验沉淀：
skill-evolver将失败与解法蒸馏为可复用 Skill，供后续任务加载。
README 对比实验中的可观察差异：安装套件后，智能体在关键决策点会询问用户、自动切换失效方案并把可用命令沉淀为脚本；裸 DSH 在同一问题上重试 13 次，未蒸馏经验，也未主动征询。
适用场景与注意¶
适合谁
- 日常用 DSH 跑多步开发任务，希望减少「卡死重试」和无效 token 消耗。
- 需要结构化纪律约束（计划、反思、记忆去重、Skill 自动加载），但不想改 DSH 源码。
- 愿意在 Linux/macOS 上用官方
dsh plugin add，或在 Windows 上用 board 架构脚本安装。
注意事项
- 权限：插件以当前 DSH 进程权限运行，安装前应阅读源码并确认 MIT 许可证，评估是否接受其文件访问与工具调用范围。
- 安装互斥：方式一与方式二不可并存；切换前先卸载已有安装。
- 实测数据：README 性能对比为单样本实验，不宜直接外推到所有任务类型。
- 社区目录：SkillHub（https://www.skillhub.cn）为独立社区站点，与 DeepSeek / 幻方无官方从属关系；插件分发以 GitHub 仓库为准。
结尾¶
cleverer-dsh 把 DSH 默认缺失的执行纪律、实用工具和 Skill 库打包成一套零依赖方案：11 个插件分工明确，6 个内置 Skill 按需加载，一条 dsh plugin add 命令即可启用。若你正在用 DSH 做日常智能体工作流，且受困于重复失败、计划缺失或 Skill 闲置，可以先从官方插件管理器安装，对照 README 中的架构表理解各插件职责，再按任务类型观察纪律层与工具层的实际效果。
- 社区目录：https://www.skillhub.cn/plugins/Classicoke/cleverer-dsh
- GitHub：https://github.com/Classicoke/cleverer-dsh
