DSH Rename
Give DeepSeek Harness models names you can remember.
DSH Rename changes provider group and model names and controls which models appear in the composer
picker, while keeping the real provider, model route, reasoning effort, authentication, and logs untouched.
Compatibility target: DSH Desktop 2.0.2 / DeepSeek Harness 0.1.1-rc.2.
DSH Rename model menu
中文
功能
- 在输入框的原生两级模型菜单中自定义提供商分组和模型名称
- 按提供商分组勾选模型，隐藏不希望出现在下拉框中的项目
- 新发现的模型默认显示；全部隐藏后对应分组自动从下拉框消失
- 未配置分组和模型继续显示原名，并保留原分组与模型排序
- 思考强度完全使用模型适配器提供的原生名称和选项
- 所有选择继续通过 DSH 的
ModelDirectory.select() 提交真实路由
- 在 设置 → 模型别名 中新增、编辑、排序和删除映射
- 路由暂时不可用时保留配置并标记，不自动删除
- 名称映射和隐藏列表都为空时不接管选择器，自动恢复 DSH 原生界面
DSH Rename 只改变输入框选择器的显示投影。它不会把一个模型变成另一个模型，也不会
改写 /model、日志、认证页、当前会话或实际请求。
安装
从 GitHub 源码安装：
git clone https://github.com/kermars39-web/dsh-rename.git
cd dsh-rename
pnpm install
pnpm run build
pnpm pack
dsh plugin --profile desktop add ./dsh-rename-0.3.0.tgz
也可以从 GitHub Releases
下载打包好的 .tgz 文件后安装：
dsh plugin --profile desktop add ./dsh-rename-0.3.0.tgz
当前尚未发布 npm 包。
重启 DSH Desktop，然后打开 设置 → 模型别名。
如果 DSH Desktop 没有把 dsh 命令加入终端路径，可以在应用内的插件页
安装打包生成的 .tgz 文件；插件本身不要求安装任何订阅接入。
配置格式
设置写入 DSH 的 dsh-rename 命名空间：
dsh-rename:
groups:
- name: Kimi
provider: codex
models:
- name: Kimi-K3
provider: codex
model: actual-model-id
hiddenModels:
- provider: codex
model: model-id-not-shown-in-picker
规则：
groups 通过真实 provider ID 修改分组标题，不改变分组排序models 通过真实 provider 和 model ID 修改模型名称hiddenModels 只隐藏输入框下拉框中的模型；不切换当前会话，也不改变真实路由- 未列入
hiddenModels 的现有或新增模型默认显示
name、provider、model 必须是首尾无空白的非空字符串- 分组显示名称和 provider 映射必须各自唯一
- 模型显示名称必须唯一
provider 和 model 组成的真实路由必须唯一- 思考强度不属于名称映射，始终在原生菜单里独立选择
卸载
dsh plugin --profile desktop remove dsh-rename
卸载不会删除会话、订阅配置或第三方插件保存的 OAuth 令牌。
可选订阅接入
DSH Rename 与模型来源无关。本项目在本地联调时组合使用了
dsh-plugin-subscriptions@0.5.2（Codex、Grok）和
dsh-antigravity-auth@0.1.1（Gemini/Antigravity），但它们不是本包的
依赖，也不由 DSH Rename 读取或管理登录令牌。第三方订阅接入并非服务商
官方 API，可能受账号规则和上游变化影响，请自行评估后使用。
English
What it does
- Shows custom provider group and model names in the native two-level composer picker
- Lets each provider group choose which models remain visible in the picker
- Keeps newly discovered models visible by default and removes an all-hidden group from the menu
- Keeps unmapped groups and models, ordering, and effort labels native
- Sends the original provider/model/effort through DSH's model directory
- Provides a Settings page for adding, editing, reordering, and removing names
- Preserves temporarily unavailable routes instead of deleting them
- Withdraws itself when rename mappings and the hidden list are empty, restoring the native picker
DSH Rename changes only the composer picker's display projection. It does not
change model provenance, authentication, logs, /model, the current session,
or the route used for a request.
Configuration
dsh-rename:
groups:
- name: Research
provider: codex
models:
- name: Daily
provider: codex
model: actual-model-id
hiddenModels:
- provider: codex
model: model-id-not-shown-in-picker
Group names and provider mappings must each be unique. Model display names and
provider/model routes must each be unique. Reasoning effort is intentionally
not part of a rename and remains a separate native choice. hiddenModels is a
denylist for the composer picker only; routes not listed there remain visible.
Development
pnpm install
pnpm test
pnpm run build
pnpm pack --dry-run
The npm package has not been published yet. Source and packaged releases are
available from GitHub.
Uninstall
dsh plugin --profile desktop remove dsh-rename
Removing DSH Rename restores the native picker and does not remove sessions,
subscription configuration, or OAuth tokens owned by other plugins.
Security
DSH Rename has no OAuth flow, network client, credential dependency, or token
storage. Authentication remains the responsibility of the installed model
provider plugins. Never include credentials in a display-name configuration.
License
MIT. The selector is adapted from the MIT-licensed DeepSeek Harness native
selector; see THIRD_PARTY_NOTICES.md.
