跳到主内容

deepseek-harness-model-config 使用指南

为 DeepSeek Harness Web UI 新增"模型高级配置"页,添加自定义 OpenAI/Anthropic 端点并按模型配置上下文与推理强度。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-model-config

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 新增自定义端点:名称、URL、API Key 和协议。
  • 支持在 provider 层配置自定义请求 Header,并应用于模型请求。
  • 支持 openai-completions、openai-responses、anthropic-messages。
  • 通过统一的 GET /models 流程获取候选模型,支持全选、反选和全不选。
  • 新增端点和已保存端点共用编辑器;已保存端点可重新拉取模型,新增模型默认不勾选,已有勾选模型在刷新后保留。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件和 DSH 自带的 Models 设置页冲突吗?

在标准 Web profile 下两者会同时可见,DSH 设计上明确把它们互斥。本插件在 profile 层禁用 ui-settings-models 那一行后即可独立运行,否则会出现两套 UI 改同一份配置(src/client.js:1232 / docs/model-config-plugin-design.md:188)。

API Key 写到哪里,会不会泄露到 settings.yaml?

不会。插件仅通过 Harness 的 credentials 服务写入凭据引用(如 MY_ENDPOINT_API_KEY),真实密钥只存在内存里提交一次,settings.yaml 和配置预览中都不会出现明文(package.json:5-7 / README.md:18)。

支持哪些 API 协议?

当前提供三种下拉选项:openai-completions、openai-responses、anthropic-messages。拉取模型候选时 anthropic-messages 会被自动改用 OpenAI 兼容 GET /models,因为模型列表普遍是 OpenAI 形态(src/client.js:1375-1377, 1181)。

models.dev 不可达时还能正常工作吗?

能。端点返回的模型仍然可手动勾选和编辑,只是上下文、输出、输入模态、推理能力不再自动补全,提交后会提示"端点结果仍可编辑"(src/client.js:136, 270, 1184 / README.md:37)。

编辑已保存端点时 API Key 字段留空,会覆盖原 Key 吗?

不会。留空表示"继续使用现有凭据",只有填了新值才会调 credentials.set 更新(docs/model-config-plugin-design.md:140)。

卸载和更新怎么操作?

都是先 remove 再 add:dsh plugin --profile web remove dsh-models-config-plugin,然后 dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config,再 dsh web(README.md:62-77)。

重新拉取模型时,已勾选的会被清掉吗?

不会。已勾选的模型保留勾选,本次新出现的模型默认不勾选,端点不再返回的模型也会保留显示,避免刷新误删(src/client.js:1171-1174 / README.md:13)。

能给一个端点配全局自定义 Header 吗?拉取模型时也会带上吗?

端点高级参数里可以加自定义 Header,但 Header 只在调用模型时附带,不会出现在 GET /models 请求里(README.md:30 / docs/llm-pi-ai-parameters.md:37)。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明(package.json 未声明 engines/peerDependencies;按设计要求宿主需装载 llm-pi-ai 适配器并支持 settings.section / credentials / settings.mutate 等扩展点)
  • Node: 未声明
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则