推理档位记忆器 ChimeSky/dsh-effort-keeper

EffortKeeper · 推理档位记忆器

| English

EffortKeeper 是一个独立安装的 DeepSeek Harness（DSH）Host 插件，用来解决一个具体问题：

为 Claude Sonnet 5.5 选择了 High，切到 Gemini 后再切回来，DSH 却显示 Default。

插件按 Provider ID + Model ID 记住每个模型最后一次由用户明确选择的推理档位，并在切回该模型时用同一次原生选择调用恢复。你仍然使用 DSH 原生的模型选择器和推理档位菜单，不需要打开额外页面或点击保存。

- 项目名：dsh-effort-keeper
- 中文名：推理档位记忆器
- 当前版本：1.0.5
- 已验证运行时：DSH Desktop 0.2.1-rc.3（Windows）
- 依赖：无（只使用 Node 标准库和 DSH 已提供的服务）

1. 功能

| 要求 | 实现 |
| 按模型独立记忆 | 存储键为 provider::model，显示名称不参与身份判断 |
| 切换模型自动恢复 | 拦截 Host 的 sessionController.selectModel，在一次调用内改写目标档位 |
| 自动保存手动修改 | 同一模型下的档位变化在原生调用成功后写入 |
| 持久化 | 使用 DSH 官方 ctx.storageDomain，文件位于 $DSH_HOME/storages/effort_keeper.json |
| Default 语义 | 显式 Default 存为 null，恢复时删除 reasoningEffort，不会错误套用旧档位 |
| 模型能力变化 | 恢复前通过 ctx.llm.resolveModelInfo 检查 reasoning.efforts；不支持则不传该档位 |
| 新会话 | 新建的空白会话按当前模型恢复偏好；已有对话不会在插件加载时被追溯修改 |
| 禁用/卸载 | 恢复被装饰的原方法；不修改 DSH 核心文件 |

不保存 API Key、聊天内容、工具参数或任何会话正文。

2. 为什么是 Host-only 插件

当前 DSH 的模型目录在 Client 侧（@deepseek-ai/dsh-client-ui-model-selection），但最终选择通过 Host 的公共方法提交：

Client 模型菜单 → session.selectModel (Remote) → ctx.sessionController.selectModel(request) → resolveCallConfig + session.append('model/selection')

因此 EffortKeeper 不另做一套选择器，也不操作 DOM，而是在 Host 侧装饰唯一入口 ctx.sessionController.selectModel：

1. 用户点击模型或档位时，原生调用照常发出；
2. 装饰器读取当前会话投影 modelSelection；
3. 如果是模型切换，且目标模型有已保存档位，则在同一请求对象中替换 reasoningEffort 后再执行原生实现；
4. 原生实现只执行一次，界面不会先显示错误档位再被第二次调用纠正；
5. 如果是同一模型下的档位变化，先让原生实现成功，再持久化用户选择。

插件卸载时会把原方法原样恢复。没有改 DSH 源码、node_modules 里的核心包或原生选择器。

关于全局默认模型

DSH 原生的 selectModel 本身会把当前选择写入 agent-default-model 的 profile 配置，这是 DSH 的既有行为，不是 EffortKeeper 的记忆机制。EffortKeeper 的记忆始终在独立的按模型存储中：

- 不会把某个档位批量套给所有模型；
- 不会通过反复改写全局默认来模拟「记忆」；
- 恢复一次档位与用户手动选择一次档位，都会触发 DSH 原生的 last-used 默认更新。

这一点是本插件与 DSH 当前 API 的边界，已在「已知限制」中说明。

3. 存储结构

DSH 的 storage domain 会在 $DSH_HOME/storages/effort_keeper.json 生成如下文件：

{
"unit": {
"name": "effort_keeper",
"version": 1
},
"global": {
"version": 1,
"preferences": {
"openrouter-custom::anthropic/claude-sonnet-5.5": "high",
"openrouter-custom::anthropic/claude-opus-5.5": "max",
"openrouter-custom::google/gemini-4-argon": "medium",
"openrouter-custom::anthropic/claude-sonnet-5.5-old": null
}
},
"tables": {}
}

- 字符串：明确的档位 ID；
- null：用户明确选择了 Default；
- 键不存在：从未为该模型保存过偏好，恢复时保持 DSH 原生行为。

文件是独立 domain 文件，不覆盖 Provider、模型定义、package.json 或其他插件的配置。存储写入由 DSH storage domain 串行化并原子落盘。

4. 安装

4.1 准备

1. 完整退出 DSH Desktop（托盘也退出）。
2. 确认 DSH 版本在 >=0.2.1-rc.3 <0.3.0-0 范围内。
3. 使用本仓库的 vendor/dsh-effort-keeper-1.0.5.tgz，或先重新打包：

pnpm pack --pack-destination vendor

4.2 用 DSH 命令行安装

把 <DSH 安装目录> 换成本机的 DSH 安装路径，把 <repo> 换成插件仓库路径 $dsh = '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' & $dsh plugin --profile desktop add '<repo>\vendor\dsh-effort-keeper-1.0.5.tgz'

也可以直接从 GitHub 安装（纯 JS 包，无需构建，已钉在 v1.0.5 tag）：

& $dsh plugin --profile desktop add
'github:ChimeSky/dsh-effort-keeper#v1.0.5'

命令行会把包加入 profile 依赖和 dsh.profile.bundles，再由 DSH 自己的 pnpm 安装。也可以用 tools/install.ps1：

pwsh -File .\tools\install.ps1

4.3 也可以在插件管理器里安装

在 DSH 的「插件」页面选择「添加插件 → 安装第三方插件」，指向本目录或 tarball。安装后确认 dsh-effort-keeper 出现在插件列表中。

4.4 启动与验证

重新打开 DSH。验证接口：

需要 DSH 页面同源 Cookie；在页面 DevTools Console 中执行：
fetch('/effort-keeper/status').then(r => r.json()).then(console.log)

预期：

{
"ok": true,
"version": 1,
"persistence": "storage-domain",
"preferences": { "version": 1, "preferences": {} },
"stats": { "restores": 0, "saves": 0, "unsupported": 0, "failures": 0 },
"restoredSessions": 1
}

这个接口只返回模型路由键和档位 ID，不返回凭据、提示或聊天内容。

4.5 手工检查安装副本

pwsh -File .\tools\verify-install.ps1
或
node .\tools\verify-install.mjs --profile desktop

会检查：

- profile 依赖与 bundle 列表；
- 已安装 package.json 名称/版本；
- 已安装 index.js、lib/.js 与工作区源码逐字节一致；
- bundle patch 中的 effort-keeper 行。

5. 使用

不需要任何新操作：

1. 选择 Sonnet 5.5，把推理档位改为 High；
2. 切到 Gemini 4 Argon，把档位改为 Medium；
3. 切回 Sonnet 5.5；
4. 原生选择器应显示 High，接下来的请求头也使用 reasoningEffort: "high"。

切到从未设置过档位的模型时，保持 DSH 原生默认，不会错误恢复。

新建会话时，当前模型已有的偏好会被应用到新会话；已经开始的旧会话不会被追溯修改。

6. 禁用与卸载

禁用

- 在 DSH「插件」页面关闭 EffortKeeper；或
- 在 profile 的 cordis.patch.yml 中加：

- id: effort-keeper
disabled: true

禁用后装饰器会随 Cordis fiber 卸载而恢复，DSH 回到原生选择行为。

卸载

$dsh = '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' & $dsh plugin --profile desktop remove dsh-effort-keeper

然后确认 profile 的 dsh.profile.bundles 中不再有 dsh-effort-keeper（新版命令行会自动清理；没有则手工删除）。重启 DSH。

偏好文件 $DSH_HOME/storages/effort_keeper.json 可以保留。重新安装后会继续使用；如果不希望保留，确认没有其他插件使用该 domain 后删除该文件。

也可以用：

pwsh -File .\tools\install.ps1 -Uninstall

7. 项目结构

EffortKeeper/
├── index.js Host 入口、可选状态路由 ├── lib/ │ ├── core.js 纯状态/选择规则（单元测试覆盖） │ └── bridge.js 存储 domain、selectModel 装饰器、新会话恢复 ├── cordis.patch.yml bundle 插入行 ├── locale/{zh,en}.json 插件显示元数据 ├── icon.svg 原创新图标 ├── tests/ │ ├── core.test.mjs 13 个纯逻辑测试 │ └── bridge.test.mjs 8 个桥接/生命周期测试 ├── tools/ │ ├── build-vendor.mjs 打包 │ ├── install.ps1 安装/卸载/校验 │ └── verify-install.mjs 安装副本校验 ├── vendor/ 冻结 tarball ├── LICENSE MIT ├── README.md └── TEST_REPORT.md 真实测试记录与已知限制

8. 配置

MVP 没有独立设置页，优先把行为合并进原生选择器。启用或禁用请使用 DSH 插件管理器或 profile patch。

如需关闭自动记忆，直接禁用插件即可，不会影响其他配置。

9. 已知限制

1. DSH 原生会更新全局默认：sessionController.selectModel 的设计就是「保存 Session 选择 + 后台保存默认」。EffortKeeper 不把全局默认当作存储，但恢复动作仍会像手动选择一样更新它。这是 DSH 0.2.1-rc.3 的公共 API 语义。
2. Host 方法装饰：插件包装的是公开服务方法，不改源码。DSH 若在未来版本改变 sessionController.selectModel 的签名或存在性，插件会明确失败，不会静默写坏会话。升级大版本前请重新跑测试。
3. 已有会话不追溯：插件安装或重启时，只对「没有已提交 turn」的空白会话应用偏好；已经有对话的会话保持其历史选择。
4. 不发送未声明档位：模型当前未声明的已保存档位会被忽略，并记录非侵入式 debug 日志；原偏好保留，等模型能力恢复后仍可使用。
5. 不支持按模型自定义任意档位名：只使用 adapter 公告的 reasoning.efforts。
6. 状态路由：/effort-keeper/status 是只读诊断接口，只暴露模型路由键和档位 ID。它和其他本地 DSH 页面路由一样，只在 Web 宿主存在时注册。

10. 开发

node --test tests/.test.mjs
node --check index.js
node --check lib/core.js
node --check lib/bridge.js

改完源码后按「版本纪律」升 package.json 的 version，再重新打包：

pnpm pack --pack-destination vendor

因为 DSH profile 使用 pnpm lockfile 的 file: tarball integrity，同名同版本但内容不同不会被重新读取。

11. License

MIT。icon.svg 为本项目原创绘制。