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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则