前言¶
DeepSeek Harness（DSH）的插件机制允许把宿主能力拆成独立模块接入。其中一类常见需求是：不想在 DSH 里再配一组 API key 或 settings 段，而是直接复用本机已经登录的 CLI。dsh-llm-qoder 就是做这件事的适配器：它把 DSH 的 LLM 请求接到本机 qodercli，让宿主侧的模型选择、会话、工具调用与压缩恢复继续按 DSH 的插件机制运行。
这是什么¶
dsh-llm-qoder 是一个 DSH 插件，包名为 @jiamingzang/dsh-llm-qoder，许可证为 MIT。它解决的问题是：让 DSH 的 LLM 接缝可以走 qoder 与 qoder-byok 两条 provider 路由，复用本机 qodercli 的登录态，不需要 API key 或 settings 段。
核心功能¶
插件提供的能力包括：
1、无配置接入
完全复用本机 qodercli 登录态，不需要 API key 或 settings 段。
2、双路由
注册 qoder 与 qoder-byok 两个 provider 路由，供模型选择器选择。
3、长驻会话
宿主 session 对应一个 warm qodercli 会话；在 maxSessions 上限内按插入序 LRU 淘汰。
4、工具桥接
宿主工具通过进程内 MCP server dsh-host 暴露给内层模型。
5、模型目录
实时从 qodercli 拉取可用模型；拉取失败时回退静态目录。
6、思考强度与上下文窗口
上报 reasoning efforts、默认档位与 context window，供模型选择器切换。
7、旁路请求
标题生成、compaction 等 side-channel 请求走 cold 一次性调用。
8、溢出可恢复
上下文超限被映射为 CONTEXT_WINDOW_EXCEEDED，供 harness 做溢出恢复。
默认配置项如下：
maxSessions: 8
modelCacheTtlSeconds: 300
其中：
maxSessions
表示同时保持 warm 的内层 qodercli 会话上限；超出上限时按插入序 LRU 淘汰。
modelCacheTtlSeconds
表示 CLI 模型目录的缓存保鲜秒数。
安装与启用¶
前置条件¶
本机需要先安装并登录 qodercli，并且能运行：
qodercli --version
获取插件包¶
从本仓库 Releases 下载：
jiamingzang-dsh-llm-qoder-<version>.tgz
也可以在仓库根目录执行 pnpm pack 自行生成。
添加到目标 profile¶
执行：
dsh plugin --profile <profile> add jiamingzang-dsh-llm-qoder-<version>.tgz
其中 <profile> 与 <version> 需要按实际环境替换。
首次安装批准构建脚本¶
首次安装会涉及 @qoder-ai/qoder-agent-sdk 的构建脚本。pnpm 11+ 会默认拦截构建脚本并报错。
这时需要把 pnpm-workspace.yaml 中 allowBuilds 对应的值改为 true，例如：
allowBuilds:
'@qoder-ai/qoder-agent-sdk': true
然后重新执行上面的 add 命令完成安装。
验证安装¶
执行：
dsh --profile <profile> --dump-config | grep llm-qoder
如果输出中出现插件条目，说明 profile 已加载该插件。接着重启服务，模型选择器中应出现：
qoder
qoder-byok
手动挂载¶
不经过 plugin 命令时，也可以在 cordis.yml 或 patch 层直接声明：
- id: llm-qoder
name: '@jiamingzang/dsh-llm-qoder'
典型用法¶
1、选择路由
在模型选择器或 Models 设置页选择 qoder 或 qoder-byok 下的模型。
2、切换上下文窗口与思考强度
插件会上报 CLI 的 reasoning efforts、默认档位与 context window，因此这些选项可以在模型选择器中切换，并随每次请求下发。
3、模型目录恢复
如果实时模型目录拉取失败，插件会回退静态目录。拉取失败不会缓存，CLI 恢复后自动恢复实时目录，不需要重启服务。
上下文溢出与压缩¶
warm 内层会话会累积宿主历史，内层模型也可能遇到上下文超限。插件会把这类失败上报为：
CONTEXT_WINDOW_EXCEEDED
这样 harness 的溢出恢复流程可以接管，而不是让当前轮次直接失败。
溢出自动恢复需要部署中加载：
dsh-compaction-basic
dsh-token-meter
如果未安装压缩插件，上下文超限轮次仍会失败，只能新开会话或手动压缩。
适用场景与注意¶
这个插件适合本机已经安装并登录 qodercli、希望 DSH 直接复用该登录态的开发者。
安装前建议注意：
1、插件运行在 DSH 进程中，会以当前 dsh 进程权限访问本机 qodercli 及其登录态；
2、安装前应检查源码、依赖与 MIT 许可证；
3、资料中 GitHub 仓库地址与包名存在大小写和名称差异：GitHub URL 使用 JiamingZang/dsh-llm-qodersdk，包名使用 @jiamingzang/dsh-llm-qoder，安装包文件名使用 jiamingzang-dsh-llm-qoder-<version>.tgz。实际安装时以下载到的发布包文件名为准。
相关链接¶
这里给出的是社区目录页与 GitHub 仓库地址，不等同于官方应用商店。
- 社区目录：https://www.skillhub.cn/plugins/JiamingZang/dsh-llm-qodersdk
- GitHub：https://github.com/JiamingZang/dsh-llm-qodersdk
