DeepSeek Harness plugin

dsh-model-aliases

为 DeepSeek Harness 提供持久化模型别名、别名选择器和设置页面

Jump to install

Source facts

Repository
ZhangZiFei/dsh-model-aliases
Latest update
Aug 20, 2026
Category
Models & Providers
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/ZhangZiFei/dsh-model-aliases
Plugin: dsh-model-aliases
Author: ZhangZiFei

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<h1 align="center">dsh-model-aliases</h1>

<p align="center">给模型配置起个好记的名字,然后在 DeepSeek Harness 会话里一键切换。</p>

在输入框旁直接选择别名,不再分别寻找提供商、模型和推理等级:

![模型别名选择器](assets/alias-selector.png)

设置 → 模型别名 中集中编辑:

![模型别名设置页面](assets/alias-settings.png)

安装

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

重启当前 dsh web 进程并刷新页面,然后打开 设置 → 模型别名

当前兼容目标为 DeepSeek Harness Web 0.1.0-rc.6。 插件已经声明 DSH Bundle,安装命令会自动把对应 Patch 加入 Web Profile,无需手工编辑 cordis.patch.yml

你会得到

  • 一个别名代表完整模型配置——名称同时绑定提供商、模型和可选推理等级
  • 单一会话选择器——用别名选择器遮蔽默认“模型 / 推理等级”控件
  • 原生模型选择链路——所有选择仍交给 DSH ModelDirectory.select() 校验和应用
  • 持久化设置——配置写入 DSH 的 model-aliases 设置命名空间,重启后继续生效
  • 目录感知——直接选择当前会话可用的提供商、模型和模型声明的推理等级
  • 安全保留失效配置——目录中暂时不存在的别名不会丢失,但会禁用并说明原因
  • 准确显示当前状态——完整选择匹配别名时显示别名,否则显示“自定义”
  • 遵守会话限制——锁定状态下禁止切换,被寻址的子代理会话不显示选择器

使用

1. 打开 设置 → 模型别名。 2. 添加别名,选择提供商、模型以及可选推理等级。 3. 调整顺序并保存。 4. 回到会话,在输入框右侧选择需要的别名。

推理等级选择“提供商默认”时,插件不会写入虚构的默认值,而是保留适配器或提供商的原始行为。

首次使用会写入预置别名;如果保存空列表,插件也会自动恢复预置值。预置路由不在当前模型目录时会保留,但不能被选择。

设置格式

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

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

规则:

  • 名称、提供商、模型以及存在的推理等级必须是首尾无空白的非空字符串
  • 别名名称必须唯一
  • 提供商、模型和推理等级组成的完整选择必须唯一
  • 省略 reasoningEffort 表示使用适配器或提供商默认行为

卸载

dsh plugin --profile web remove dsh-model-aliases

完成后重启当前 dsh web 进程并刷新页面。

开发

pnpm install
pnpm run build
pnpm test
pnpm pack --dry-run

构建产物位于 lib/

  • lib/index.js:Host 插件入口
  • lib/client.js:Web Client Bundle
  • lib/types/:TypeScript 声明

反馈

发现问题或有功能建议,请提交到 GitHub Issues

许可

MIT