JiamingZang/dsh-llm-qodersdk

README 摘要

dsh-llm-qodersdk 中文 English 将 DeepSeek Harness 的 LLM 接缝（ ctx.llm ）路由到本机 Qoder CLI 的适配器插件（ @deepseek-ai/dsh-llm-qoder ），基于 @qoder-ai/qoder-agent-sdk 。 它注册 qoder / qoder-byok 两个 provider 路由，让 harness 的模型请求复用本机 qodercli 的登录态—— 无需任何凭据或设置项 。模型与账号自定义模型都从 qodercli 实时拉取。 特性 - 无配置接入 ：完全复用本机 qodercli 登录态，不需要 API key 或 settings 段。 - 长驻会话 ：每个宿主 session id 对应一个 warm 内层 query() 子进程，对话延续、工具轮次都发生在会话内部。 - 工具桥接 ：宿主工具通过进程内 MCP server（ dsh-host ）暴露给内层模型；qodercli 一次执行一个调用、宿主一次回传整轮结果，二者通过 callId 配对。 - 模型目录 ：实时从 CLI 拉取可用模型，TTL 缓存 + 并发共享，失败回退静态目录；另提供 deepseek-v4-flash / deepseek-v4-pro 别名。 - 双 provider 分组 ： qoder 出 qodercli 内置模型， qoder-byok 出账号自定义模型（ source === 'user' ），各自独立路由。 - 思考强度 ： resolveModel 上报 CLI 的 reasoning efforts 与默认档位，产品模型选择器自动显示思考强度选项；所选档位通过 model-policy 参数随每次请求下发。 - 上下文窗口 ：上报 CLI 的 availableContextWindows / defaultContextWindow ，模型选择器可直接切换上下文窗口（如 200K/400K/1M），并通过 model-policy 参数下发。 - 旁路请求 ：标题生成、compaction 等 side-channel 请求走冷启动一次性调用，不占用 warm 会话。 适配原理 这一节说明本插件把 harness 的 LLM 接缝映射到 qodercli 时， 每一层是怎么适配的、为什么这么设计 。 1. LLM 接缝适配（ ctx.llm → qodercli） harness 通过 ctx.llm.registerAdapter(['qoder', 'qoder-byok'], adapter) 注册 QoderAdapter ，实现 harness 的 LlmAdapter 契约： harness 接缝 本插件实现 providerInfo(prov…

分类