前言¶
DeepSeek Harness（DSH）採用插件化架構，允許開發者通過擴展組件接入各類模型服務。KnyazevAI 是一個獨立的 API 服務，提供多種大模型推理能力。本文介紹如何通過 KnyazevAI DSH Provider 插件，將 KnyazevAI 的模型與路由添加到 DSH 環境中，使其能在 DSH Desktop 或 Web 界面中直接使用。
插件定位¶
KnyazevAI DSH Provider 是一個 npm 包（@knyazevai/dsh-provider），旨在爲 DeepSeek Harness 及其兼容客戶端（如 DSH Desktop）增加對 KnyazevAI API 的支持。
- 維護者：knyazev741
- 許可協議：MIT
- 核心作用：添加
knyazev-ai路由，預置常用模型（如deepseek-v4-flash），並提供針對大上下文的緊湊設置。
核心功能¶
- 模型接入：將 KnyazevAI 的模型納入 DSH 可選模型列表。
- 路由配置：自動添加
knyazev-ai路由。 - 默認模型：新會話默認使用
deepseek-v4-flash。 - 代理支持：支持在
subagent和subagent_fork中調用 KnyazevAI 模型。 - 上下文優化：提供針對大上下文的緊湊設置選項。
安裝與啓用¶
插件安裝需要 DeepSeek Harness 版本 >= 0.1.5-rc.2。
1. DSH Web 環境安裝¶
在終端中執行以下命令添加插件：
npx @deepseek-ai/dsh plugin --profile web add @knyazevai/dsh-provider
npx @deepseek-ai/dsh web
2. DSH Desktop 安裝¶
- 打開 Settings → Plugin Market。
- 搜索 KnyazevAI DSH Provider 並點擊 Install。安裝完成後若提示重啓，請重啓 DSH Desktop。
- 打開 Settings → Models → KnyazevAI API。
- 在此頁面填入從 knyazevai.work 獲取的 API Key。
配置與用法¶
安裝完成後，插件會自動處理路由和模型映射。
- API Key 存儲：API Key 並不存儲在 npm 包中，而是存儲在 DSH 的憑證系統裏。在 Desktop 界面中，只需在 Models → KnyazevAI API 頁面添加即可。
- 默認會話配置：新建會話時，默認的 Provider 爲
knyazev-ai，默認 Model 爲deepseek-v4-flash。 - 子代理配置：默認情況下，
subagent和subagent_fork會繼承父會話的路由和模型設置，即使用knyazev-ai/deepseek-v4-flash。
注意事項與更新¶
- 非完整 Fork：此插件不會安裝完整的 Harness Fork，也不會替換 DSH 的系統包。它僅作爲補丁注入必要的路由和模型配置。
- 手動配置衝突：不要手動複製 provider YAML 文件或將其內容重複添加到
settings.yaml中，因爲 bundle 已經自動處理了路由注入。手動配置的數組優先級高於插件的默認配置。 - 更新行爲：插件更新後，不會覆蓋用戶手動配置的
models數組。如果遇到配置異常，建議通過界面 Fetch available models 並點擊 Adopt 來修復，這能恢復 DeepSeek 和 GLM 的 Effort 設置，同時保留手動設置的限流。 - Reasoning 設置：更新後，請檢查
settings.yaml中的reasoning設置。舊的reasoning配置可能誤影響 MiniMax 模型。 - 移除的模型：Kimi 2.6 已從目錄中移除，因爲 KnyazevAI API 不再發布該模型。
總結¶
KnyazevAI DSH Provider 是一個輕量級的集成方案，適合需要直接使用 KnyazevAI 高性能模型進行推理或開發智能體的開發者。通過標準化的 DSH 插件機制，實現了無侵入的模型接入。
- GitHub 倉庫：knyazev741/knyazevai-dsh
- 插件目錄：KnyazevAI DSH Provider
