sharewiner/dsh-model-management

English README

这是一个用于 DSH Web Profile 的模型管理插件，支持管理 OpenAI 兼容 Provider、选择默认模型、控制模型可见性，并可让联网搜索自动使用当前默认的 OpenAI Responses Provider。

功能

• 在设置页面增加“模型管理”分区。
• 按 Provider 分组展示 DSH 当前已注册的全部模型。
• 设置默认 Provider、模型以及支持的推理强度。
• 隐藏单个模型，使其不再显示在输入框模型选择器和 /model 命令中。
• 关闭整个 Provider，使该 Provider 的所有模型不再显示在输入框模型选择器和 /model 命令中。
• 当前会话正在使用的模型会暂时保留显示；切换到其他模型后才会遵守隐藏规则，避免会话失去当前路由。
• 注册 model-management-openai-responses 联网搜索 Provider，根据当前默认 OpenAI Responses 模型、服务地址和凭据引用执行搜索。

Beta 状态与兼容性

项目仍处于早期使用阶段，但 npm 0.2.3 按 DSH 托管市场要求使用稳定 SemVer。该版本已基于 DeepSeek Harness 0.1.1-rc.2 的包 API 与 2026-08-25 当天的 DSH Desktop Web Profile 完成验证。

由于 DSH 暂未暴露公开的模型目录过滤 API，模型可见性同步会通过独立兼容层访问客户端 modelDirectories 服务。兼容层会在安装前探测目录契约、缓存可见性设置、在插件停止或更新时恢复所有被包装的方法；如契约不兼容，则保持原生模型选择器不变并输出一次诊断告警。每次升级 DeepSeek Harness 后，请重新验证输入框模型选择器和 /model 命令；兼容性问题请在本仓库 Issue 中反馈。

运行要求

• DSH Web Profile，且包含 settings、credentials、agentDefaultModel、llm 和 web 服务。
• Node.js 22.19 或更高版本。
• 与 package.json 中 peer dependencies 兼容的 DSH Host 包版本。
• 已配置可用的 OpenAI 兼容模型服务。

安装

可通过 DSH 插件市场安装已发布版本，或将精确 npm 版本添加到 DSH Desktop 实际启动的 Profile：

dsh plugin --profile web add @sharewiner/dsh-model-management@0.2.3

本地开发时，可在目标 Profile 中执行 pnpm add "file:/绝对路径/dsh-model-management" 安装当前源码。确认该 Profile 的 dsh.profile.bundles 包含 @sharewiner/dsh-model-management。插件的 bundle patch 会插入 model-management Host 条目。安装或更新后必须完全重启 DSH Desktop。

使用方法

打开 DSH 设置，选择 模型管理。

1. 先在 DSH 原生的 模型 设置页配置 OpenAI 兼容 Provider、模型和 API 凭据。
2. 在 模型管理 中选择默认模型。
3. 点击模型的 隐藏，该模型会从输入框模型选择器与 /model 列表中移除。
4. 点击 Provider 的 关闭提供方，该 Provider 下所有模型会从两个模型列表中移除。
5. 点击 显示 或 开启提供方 可以恢复对应模型或 Provider。

Provider 标题栏支持展开与收起：点击标题、空白区域或箭头均可切换；“开启提供方”或“关闭提供方”按钮只切换 Provider 状态，不会误触发展开或收起。

联网搜索

当当前默认模型属于已配置的 openai-responses Provider 时，插件会注册 model-management-openai-responses。将 DSH 的 web 服务配置为使用它后，联网搜索会自动跟随当前默认模型的 Provider、模型、服务地址与凭据引用。

对应服务端需要支持：

• openai-responses：POST {baseURL}/responses
• openai-completions：由 pi-ai 转换的 OpenAI 兼容 Chat Completions 请求
• 模型发现：GET {baseURL}/models

验证

cd ~/.dsh/profiles/desktop
pnpm exec node --input-type=module -e "import('@sharewiner/dsh-model-management').then(() => console.log('host entry loaded'))"
node --check node_modules/@sharewiner/dsh-model-management/lib/client.js

cd /绝对路径/dsh-model-management
node --check lib/index.js
node --check lib/client.js
pnpm pack --pack-destination /tmp .

重启 DSH Web Profile 后，确认设置中出现 模型管理 分区。关闭 Provider 或隐藏模型后，分别检查输入框中的模型选择器和 /model 命令是否同步更新。

安全说明

插件只有在执行 OpenAI Responses 联网搜索时，才会通过 DSH 的凭据服务或启动环境读取 Provider 凭据。插件源码及模型管理设置不会保存 API Key、Token 或端点密钥。

不要将本机 DSH settings、凭据文件或完整 Profile 目录提交到这个仓库。