前言¶
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
