前言¶
DeepSeek Harness（DSH）里 compaction 阈值、缓存策略、模型侧重试与工具调用开销，并没有一套放之四海皆准的配置：长会话和短问答不同，500k 窗口与 1M 窗口模型的「甜点」也不一样。手工翻日志、对照 preset 改 cordis.patch.yml，既费时间，也很难按模块把「现状—要不要改—改成什么」说清楚。
下面介绍社区插件 dsh-tuner（维护者 doctorllll，分类：工作流）。它只读取本机 profile 下的会话数据，在本地计算建议，默认不改你的配置；需要时可在 compaction 策略上 一键 把按模型的阈值写入当前 agent preset。
这是什么¶
dsh-tuner 面向已在用 DSH 桌面端或 dsh web 的开发者：基于你自己的 session，按模块回答三个问题——现在怎样、要不要动、动成什么样。面板 UI 为中文；无 UI 时可用 /tuner 斜杠命令输出与面板相同的文本报告。
当前 release 为 v0.5.2（MIT 许可证）。在 DSH 0.2.2-rc.1 上已验证（桌面 desktop profile 与 dsh web）。
核心功能¶
概览页一屏展示各模块；点击卡片可看结论、数据表、重放拆解与术语说明，并跟随应用明暗主题。
| 模块 | 回答的问题 | 产出 |
|---|---|---|
| Compaction policy | 各模型应在什么比例触发 compact？会不会刚压完又立刻再压（「跑步机」）？ | 一键写入活动 agent preset 的 compaction-basic.modelPolicies |
| Compaction health | 真实 compact 的失败与原因、耗时；按当时生效的阈值评判，区分已修复问题与当前问题 | 配置片段建议 |
| Cache | 缓存命中率与请求间隔；保活是否值得做 | 结论 |
| Model side | 按模型看重试原因、推理力度、生成速度；高力度下是否 idle 超时集中 | 建议（力度在模型选择器里改） |
| Tools | 各工具调用次数、失败原因、输出体积；hook 开销 | 可复制的 AGENTS.md 句式 |
默认行为与写入范围（来自官方说明）：
- 默认只读：通过 DSH 的 session 查询服务读本会话，本地计算；不调用模型、不上传、不走外网。
- 仅在点击「应用」时写入：改 profile 的
cordis.patch.yml中默认 agent preset 的一行compaction-basic；写回校验，失败则回滚；preset 上你的其它修改保留。 - 不改：模型选择、reasoning effort、AGENTS.md、hook 配置——这些仅给建议和可复制文案。
- 启动时：若 preset 覆盖里含有当前 DSH 已不再自带的行（升级后常见），会在新默认上重建覆盖，保留你改过的行，面板会提示被丢弃或新增的行。
安装与启用¶
安装前请注意：插件在 当前 dsh 进程的权限 下运行，安装前应自行查看 GitHub 仓库 源码与 MIT 许可证。
通用命令（将 <profile> 换成你的 profile，例如 desktop）：
dsh plugin --profile <profile> add github:doctorllll/dsh-tuner#v0.5.2
桌面应用在 macOS 上仅接受应用内自带的 CLI；PATH 上的 dsh 会提示由 Electron 应用独占管理。可先退出应用，执行：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:doctorllll/dsh-tuner#v0.5.2
再重新打开应用。在 dsh web 中安装后需刷新页面。侧栏会出现 「调优 v0.5」（Tuner）入口。
卸载：
dsh plugin --profile <profile> remove dsh-tuner
已写入 preset 的阈值不会随卸载自动恢复；若需默认值，先在面板点 「恢复 preset 默认」 再卸载。
典型用法¶
- 在侧栏打开 「调优」，选择统计窗口（最近 7 / 14 / 30 天）。
- 看概览配色：橙色表示值得调整，蓝色表示数据尚不足，绿色表示现状可接受。
- 打开 Compaction policy 卡片，查看各模型的 replay 表；若认同建议，点 「应用按模型建议」。
- 写入的配置 仅对新会话生效；已打开的会话需执行
/compact或重新打开。 - 随时可在面板 恢复 preset 默认。
无界面时，执行 /tuner 可得到与面板一致的文本报告。
适用场景与注意¶
适合谁：长期用同一 DSH profile、会话形态多样（长任务 vs 快问），希望用本机真实用量校准 compaction 阈值，并顺带审视 cache、模型侧与工具侧指标的人。
局限（README 原文要点）：
- Replay 为估算而非重跑；摘要质量变化未建模；压档后的 floor 取实测中位数，异常大的 turn 可能偏高。
- 不含 subagent 会话；含 fork（共享历史只计一次）；少于 3 次 request 的会话跳过。
- Preset 覆盖在 DSH 语义下是完整配置：上游仅改既有行的默认值时，覆盖不会自动跟随。
- 不提供 cache 保活实现，只判断「是否值得装」这类插件。
建议如何算出来、preset 覆盖为何会重建，见仓库内 docs/DESIGN.zh.md（中文）。
结尾¶
dsh-tuner 把「按真实 session、分模块、本地算建议」和 compaction 阈值的一键落盘放在一起，减少猜配置的成本；其它模块仍以只读建议与可复制文案为主。DSH 生态理念是「一切皆插件」，社区目录由独立站点维护，与 DeepSeek / 幻方无官方从属关系。
- 目录页：https://www.skillhub.cn/plugins/doctorllll/dsh-tuner
- GitHub：https://github.com/doctorllll/dsh-tuner
- 问题反馈：https://github.com/doctorllll/dsh-tuner/issues
