DeepSeek Harness 插件：zhangzifei/dsh-model-aliases

前言¶

DeepSeek Harness（DSH）采用插件化架构，允许用户和开发者扩展功能。zhangzifei/dsh-model-aliases 是一个模型推理类插件，它为 DeepSeek Harness Web 提供持久化模型别名功能。通过将提供商、模型与推理等级绑定为易记名称，用户可以在输入框旁通过单一选择器快速切换，而无需每次重新配置。

核心功能¶

完整配置绑定：一个别名代表完整的模型配置，名称同时绑定提供商、模型和可选推理等级。
双向同步：别名选择器与原生“模型 / 推理等级”控件并存。选择别名会改写原生控件内容；在原生控件手动操作会更新别名显示。
持久化与目录感知：配置写入 DSH 的 model-aliases 命名空间，重启后继续生效。支持从当前会话目录下拉选择，或直接在同一字段输入自定义 ID。
安全容错：目录中暂时不存在的别名不会丢失，但会被禁用并说明原因。锁定状态下禁止切换，被寻址的子代理会话不显示选择器。
原生校验：所有选择最终通过 DSH ModelDirectory.select() 校验和应用，保证配置的有效性。

安装与启用¶

执行安装命令：

dsh plugin --profile web add github:ZhangZiFei/dsh-model-aliases

重启 dsh web 进程并刷新页面。
打开 设置 → 模型别名 进行初始化。

使用流程¶

打开 设置 → 模型别名。
添加别名，可从下拉菜单选择或直接输入提供商、模型以及可选推理等级。
调整顺序并保存。
回到会话，在输入框右下角使用别名选择器切换；旁边的原生模型选择器会同步显示当前模型和推理等级，也可以直接在那里手动选择。

配置说明¶

配置保存在 DSH 设置文档的 model-aliases 分节：

model-aliases:
  aliases:
    - name: 日常
      provider: deepseek
      model: deepseek-chat
    - name: 深度推理
      provider: openai
      model: o3
      reasoningEffort: high

配置规则：
* 名称、提供商、模型以及存在的推理等级必须是首尾无空白的非空字符串。
* 别名名称必须唯一。
* 提供商、模型和推理等级组成的完整选择必须唯一。

兼容性与注意事项¶

兼容目标：当前兼容 DeepSeek Harness Web 0.1.2-rc.1。
自动注入：插件已声明 DSH Bundle，安装命令会自动将 Patch 加入 Web Profile，无需手工编辑 cordis.patch.yml。
默认行为：推理等级选择“提供商默认”时，插件不会写入虚构的默认值，而是保留适配器或提供商的原始行为。
预置逻辑：首次使用会写入预置别名；如果保存空列表，插件也会自动恢复预置值。预置路由不在当前模型目录时会保留，但不能被选择。

总结¶

该插件通过别名机制降低了 DeepSeek Harness Web 中模型配置的切换成本，适合需要频繁调整模型参数的用户。更多技术细节请访问 GitHub。