前言¶
如果你在 DeepSeek Harness(DSH)里接入过自定义 API 模型,大概率遇到过两个问题:一是官方设置里没有针对自定义模型的思考等级配置入口,想开 high 或 max 档位只能手动改配置;二是每次切换渠道或新建会话,模型和思考强度都会回退到默认值,之前的偏好记不住。渠道级重试策略同理,默认行为不一定符合自己的网络环境。
下面介绍的 dsh-model-memory 就是为解决这几个问题而写的 DSH 插件。它在 DSH 官方「设置 -> 模型」中为自定义 API 模型挂载思考等级配置栏,同时跨会话记住每个渠道最后选用的模型与思考强度,并提供渠道级重试策略配置。
这是什么¶
dsh-model-memory 是一款 DSH 插件,定位是「自定义 API 模型思考等级管理、渠道重试策略与偏好持久记忆」,由 Mutx163 维护,基于 TypeScript 编写,采用 MIT 协议开源,当前版本为 0.1.12,要求 Node.js >= 20,客户端平台为 web。
DSH 的理念是「一切皆插件」,这款插件就是按这个思路做的:不改主界面结构,功能嵌入到官方设置项里。它基于独立本地工程与 DSH Profile 软链接机制挂载,升级 DSH 全局脚手架不会丢失插件与配置。
核心功能¶
自定义模型思考等级配置¶
- 在 DSH 官方「设置 -> 模型」中,展开自定义 API 模型时,自动挂载思考等级配置栏。
- 支持为模型一键开启
supportsReasoningEffort,并勾选思考档位:low/medium/high/max。 - 点击保存后原子化写入
~/.dsh/settings.yaml,即时热重载,无需重启。
配置写入路径有一个容错设计:优先走宿主的 settings 服务,宿主服务缺失时回退到原子文件直写,保证配置一定能落盘。
跨会话偏好记忆¶
- 按渠道精准记录:跨会话记录每个渠道最后选用的模型及其配置的思考强度。
- 自动回填:切换渠道或新建会话时,自动恢复该渠道的历史模型与思考强度偏好,不再回退到默认基本强度。
持久化存储由独立存储引擎负责,磁盘路径为 ~/.dsh/model-memory.json。
渠道级请求重试策略¶
三种模式可选:
- 渠道默认:失败后最多重试 5 次。
- 无限重试:失败后一直重试,直到成功或手动取消。
- 自定义次数:自行指定次数,
0表示不重试。
retryPolicy 按渠道配置,渠道内所有模型共享。更新时会保留该渠道已有的 backoff 退避参数,写入路径与思考等级配置一致(宿主 settings 服务优先,缺失时回退原子文件直写)。
界面与升级¶
- 插件不添加多余按钮,主界面保持原生样式。
- 基于独立本地工程与 DSH Profile 软链接机制,升级 DSH 全局脚手架后插件与配置不丢失。
安装与启用¶
推荐从 NPM 安装,执行下面的命令把插件挂载到 DSH 的 Web Profile:
dsh plugin --profile web add dsh-model-memory
安装后思考等级配置栏会出现在 DSH 官方「设置 -> 模型」中,展开自定义 API 模型即可看到。
本地开发与调试¶
如果你想在本地改代码或做二次开发,可以走软链接方式挂载。先克隆仓库、安装依赖并完成一次完整验证:
git clone https://github.com/Mutx163/dsh-model-memory.git
cd dsh-model-memory
pnpm install
pnpm run verify
pnpm run verify 会依次执行类型检查、单元测试和打包构建,产物输出至 lib/。之后把本地目录以软链接形式挂载到 DSH Web Profile:
dsh plugin --profile web add link:/path/to/dsh-model-memory
日常开发中常用的几个命令:
# TypeScript 类型检查
pnpm run typecheck
# 运行全套 Vitest 单元测试
pnpm run test
# 完整验证与打包构建
pnpm run verify
项目还依赖 js-yaml ^5.3.0,peer 依赖包括 @deepseek-ai/cordis(>=4.0.1 <4.1.0)与 @deepseek-ai/dsh-agent(>=0.1.1-rc.1 <0.2.0)。
适用场景与注意事项¶
适合这几类用户:
- 在 DSH 中接入自定义 API 模型,需要手动指定思考档位(如
max)的人。 - 多渠道使用者,希望每个渠道各自记住上次选用的模型和思考强度,而不是每次新会话都从头设置。
- 对请求重试行为有明确要求的场景,比如不稳定网络下想要无限重试,或计费敏感场景想设为不重试。
安装前有几点需要确认:
- 插件以当前 dsh 进程的权限运行,会读写
~/.dsh/settings.yaml与~/.dsh/model-memory.json等本机文件,安装前应检查源码与许可证,确认行为符合预期。 - 该插件客户端平台为 web,需要挂载到 Web Profile 使用。
- 项目采用 MIT 协议开源,协议信息在 README 徽章、LICENSE 文件与 package.json 中均有一致声明。
结尾¶
dsh-model-memory 做的事情不复杂:把 DSH 自定义模型缺的思考等级配置补上,把渠道与思考强度偏好跨会话记住,把重试策略开放到渠道级。三件事都落在官方设置界面内,配置写入走原子操作,升级脚手架也不丢数据。
项目地址:https://github.com/Mutx163/dsh-model-memory
社区目录页:https://www.skillhub.cn/plugins/Mutx163/dsh-model-memory(社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。)