前言¶

在 DeepSeek Harness（DSH）里配置模型时，常见情况是：供应商和模型 ID 已经填好，但显示名、上下文窗口、输出上限、是否支持图片输入、推理档位等字段仍要手工查文档；单价若按 USD 或 CNY 维护，还要和外部参考目录对齐。社区里已有面向 Models.dev 或价格的独立插件，dsh-model-kit 把「查参数、预览冲突、写价格、从上游拉列表、覆盖内置模型」收进 设置 → 模型信息助手 同一界面，并通过 DSH 官方 Settings 接口写入当前 profile，而不是直接改旧版 settings.yaml。

下面介绍该插件的定位、能力与安装用法；事实以 GitHub 仓库 README 为准。

这是什么¶

dsh-model-kit（npm 包名 dsh-model-kit）由 PerseusNana7mi 维护，分类属于 模型推理 相关能力：在 DSH Desktop 0.2.x（自 0.2.0-rc.2 起）中提供模型信息助手。一句话定位：查询模型参数与参考价格，核对后保存到 DSH。

模型参数默认来自 Models.dev；价格可选 Models.dev（USD） 或 basellm（原生 USD / CNY）。缺失价格保持未知，明确的零价格保留，插件不自动换汇。目录页：SkillHub 插件条目。

核心功能¶

README 中的能力表可概括为以下几类（仅列资料已写明项）：

1. 模型信息补全：从 Models.dev 拉取显示名、上下文窗口、输出上限、文本/图片输入模态，以及可识别的推理档位。
2. 预览与比较：自动推荐先填入草稿；可比较候选来源、对冲突字段做选择，并撤销本次参数填入。
3. 自定义价格：编辑输入、输出、缓存读取与缓存写入单价；支持 USD / CNY，以及「参考价 × 倍率」。
4. 记住参考来源：按目标模型、数据源和币种保存已确认的价格来源，支持别名、替换与清除；下次可主动获取最新参考报价。
5. 上游模型导入：通过 DSH 已配置的供应商获取模型列表，选择并预览后追加新模型。
6. 内置模型覆盖：按字段覆盖继承目录中的模型参数，也可恢复上层继承。
7. 搜索与刷新：按供应商、模型名称或 ID 搜索；宿主列表变更时自动刷新，目标仍存在时保留草稿。
8. 批量核对与保存：最多选择 100 个已配置模型，共享最新目录，逐字段核对并保存；倍率按整份参考快照确认，分别报告参数与价格保存结果。

匹配与定价细节见仓库内 推荐规则、价格说明。

安装与启用¶

插件已发布到 npm：dsh-model-kit。使用与桌面端配套的 DSH CLI 安装（命令来自 README，勿自行拼接 GitHub 安装串）：

dsh plugin --profile desktop add dsh-model-kit

若使用独立 Web profile，将命令中的 desktop 改为 web。安装完成后，从托盘完整退出并重新打开 Desktop，在 设置 → 模型信息助手 中确认页面出现。单独执行 npm install dsh-model-kit 不会将插件挂载到 DSH profile。

需要离线安装时，可在 Desktop 插件管理界面选择本地预构建 .tgz 包。从源码自行打包需 Node.js ≥ 22.19：

npm ci
npm pack

npm pack 会先构建；不要直接把未构建源码作为插件安装。

项目采用 MIT 许可证。插件以当前 DSH 进程权限运行；安装前可在 GitHub 查看源码与第三方声明（THIRD_PARTY_NOTICES.md）。

典型用法¶

快速开始流程（与 README 一致）：

1. 在 DSH 原生模型设置中添加供应商、协议、API 地址及凭据。
2. 打开 设置 → 模型信息助手，依次选择供应商和模型。
3. 点击 填入模型信息，核对参数草稿；有分歧时展开 高级比较。
4. 需要设置价格时展开 编辑价格，选择币种、数据源和定价模式。
5. 点击 保存，查看结果。需要新增模型或修改内置模型时展开 更多模型操作。

保存通过 DSH 官方 Settings 接口完成；若配置已被其他操作修改，会拒绝旧版本写入，需重新读取后再编辑。模型参数与价格写入当前 profile 的 cordis.patch.yml。

适用场景与注意¶

适合谁：已在 DSH 0.2.x 桌面端（或对应 Web profile）维护多供应商、多模型，希望用 Models.dev / basellm 对齐参数与单价，并需要从上游列表导入或批量核对保存的开发者。

使用前建议了解（README「使用前了解」摘要）：

• 显式保存 maxTokens 会设置每次请求的默认输出上限，最大输出会影响请求行为。
• 已有名称、容量和具体推理档通常保留；图片能力以及 false/空推理档可被可靠建议补入草稿。
• 推理支持为部分识别：仅有思考开关或预算信息时不推断档位；手动首次启用默认 medium，不代表已验证接口支持。
• 界面显示的是单价，不是会话账单；价格保存在插件配置，当前不计算会话费用，也不接入 DSH 原生费用统计；复杂计费不会自动压成固定价格。
• 更换币种会替换该模型原币种价格，不同时保留两套，也不做汇率换算。

数据与隐私：启动不自动联网、不自动改写模型；目录按操作需要在宿主端查询；上游发现由 DSH 官方服务使用已有凭据，插件不向前端返回 API Key，也不将其发送给参考目录。

其他宿主版本的完整功能需单独验证，见仓库 兼容策略。更完整说明见 editor.md。

结尾¶

dsh-model-kit 把模型目录查询、冲突预览、USD/CNY 定价编辑、上游导入与批量保存集中到 DSH 设置里的「模型信息助手」，适合在 0.2.x 上系统化维护模型元数据与参考单价。社区插件目录与 DeepSeek / 幻方无官方从属关系，安装与使用前请自行核对版本与许可证。

• 目录页：https://www.skillhub.cn/plugins/PerseusNana7mi/dsh-model-kit
• GitHub：https://github.com/PerseusNana7mi/dsh-model-kit