DSH Connect Qoder

dsh-connect-qoder

English · 安装 · 工作原理 · 配置 · 账号池 · 更新日志 · 问题反馈

一个独立的 DeepSeek Harness (DSH) bundle 插件。它把 Qoder 账号的模型接到 DSH 的模型选择器，同时提供模型管理与只读的用量概览。国内版与国际版是两个并行的供应商（`qoder` / `qoder-global`），可同时使用；插件设置卡片以 tab 区分两者，方便统一管理。

Qoder 官方不提供 OpenAI 兼容端点（其官方 SDK 只是 agent 启动器），因此本插件直连 Qoder 的 cosy 网关，实现了协议的最小客户端，无需在 Qoder 桌面端登录——只需一个 PAT（Personal Access Token）。

功能特性

• 双供应商并行接入（国内版 + 国际版） —— 国内版注册为 qoder provider（gateway.qoder.com.cn），国际版注册为 qoder-global provider（api1.qoder.sh）。配置了 PAT 的区域其模型会出现在 DSH 模型选择器里：两个区域都有 PAT 时两组同时可选，不同会话可以各选一边，互不干扰。没有 PAT 的区域不列出任何模型（一个请求也发不出去，列出来只会点到就失败）；配置 PAT 后「刷新模型」即可让模型自动出现——provider 本身始终注册着，因为它的设置卡片正是配置入口。模型名内嵌上游积分倍率（如 Qwen3.8-Flash · x0.00），与 Qoder 自身模型菜单一致。
• 插件卡片 tab 切换 —— 设置卡片顶部为「国内版 / 国际版」两个 tab，各含独立的 PAT、模型管理与用量概览；每个 tab 的目录、勾选与状态完全隔离。
• 正文按「账号 / 模型 / 诊断」分栏 —— 每个区域 tab 之下再把正文分成三栏。账号栏是账号池、积分读数开关与关于凭据的每一条说明（点一下即生效）；模型栏是勾选、上下文档位、思考强度与逐模型测试（草稿，点「保存」才落地）——两者的提交语义本来就不同，分开之后保存按钮就挨着它保存的东西。切栏不重新拉取、不丢未保存的草稿（非活动栏仍挂载）。诊断栏是一张只读的事实表：区域、上游域名（与真正发请求的主机名同一处事实）、服务账号、凭据来源、积分读取时刻、目录模型数、已启用数、账号池开关，以及上游最近一次错误的原文——它存在的唯一理由是被整段贴进问题反馈，所以里面没有任何会改设置的控件。
• 可单独关闭任一版本供应商 —— 每个 tab 右侧有一个勾选框（默认都勾选）。取消勾选即把该供应商从 DSH 模型选择器里彻底撤掉（不是只藏起 tab）：它的路由与「设置 → 模型」页的目录条目一并摘除。PAT、用量与勾选全部保留，重新勾选即完整恢复。注意：若某会话此前选中的正是被关闭供应商的模型，该会话再调用会报 NO_ADAPTER。
• 模型管理 —— 从上游刷新完整模型目录，逐项勾选启用或禁用；模型行显示倍率（(0.50x)）、上下文/输出上限、思考强度档位与免费标记，行右有「图片」「可关闭思考」开关、上下文档位选择器与「测试」按钮。勾选状态写入本地配置，立即同步到模型选择器。目录里有几个模型就排几行，列表自己不设高度上限、不出内滚动条——这条列表的用途是「看见并勾选模型」，只露七八行、把其余的藏进第二条滚动条（面板本身已经在滚）会让「有这个模型吗」变成一个需要先发现、再去拖的动作；要看全就滚页面。上游的 `auto` 不列出来：它是该区的默认路由，网关在请求时才决定把它解析成哪个模型，所以价格与上下文都由别人临时决定，插件无法如实描述——它不是模型，不该占一行让你勾选。
• 活动优惠徽标 —— 上游在模型目录里自带活动规则（promotion：文案、时段、时区），模型行就在名字旁画一枚小胶囊，如「错峰 4 折」。文案原样来自上游（中文界面取 badge.zh，英文界面取 badge.en），插件不翻译也不改写；悬停给出上游的说明、时段与时区，以及活动文档链接原文。什么时候画由渲染时刻决定：有上游声明的墙钟时段（支持跨零点、按上游时区算）就按时段现算，没有时段才退回上游的 active——所以夜里读到的目录不会把徽标冻结到第二天早上，早上启动的进程也不会因此整晚不显示；没有活动字段的模型什么都不画。同一枚徽标也画在宿主的模型选择器里（conversation.input.model.label 槽位，issue #12）——选择器才是做选择的地方，与卡片共用同一套判定、文案与样式。取证与判定规则见 docs/PROMO_BADGE.md。
• 模型可用性测试 —— 每个模型行有一个「测试」按钮，直达上游确认该模型此刻能否使用：限流（429）报「被限流」、凭据无效报「凭据无效」、内容审核拒绝报「内容被审核拒绝」、额度耗尽报「额度已耗尽」，其余上游瞬时故障如实分类。探测在后台发起，凭据不会传到页面；结果不写入设置，也不改变你已保存的勾选。它发的是真实请求（会消耗少量上游额度），因此只能按单个模型手工点，没有「测试已勾选」这类批量按钮。
• 每日签到 —— Qoder 有官方每日签到活动（个人用户每天可领 100 Credits，30 天有效）。账号池提供「一键签到所有账号」：逐账号领取、已领过的按幂等处理（不重复领取、不算失败），签到后积分自动刷新。国内版与国际版都已接通（国际版需要本机 Qoder 客户端的设备风控组件，取不到时如实报错而不是假装「今天没有活动」）。
• 活动（只读） —— 卡片在区域作用域内、额度读数之下多一条「活动」列表，逐条列出上游当前下发的活动：每日 100 Credits 签到行（带额度与「可领取 / 已领取」状态）与「1024 创造力集结」「首月订阅 Credits 翻倍」这类 banner（VIEW_DETAILS）。标题与描述原样来自上游（按界面语言取 zh / en，缺哪边用另一边），「查看详情」是真正的链接（上游的 detailUrl，缺失时退回活动落地页）；只读，不签到、不改账号。上游没下发就显示「当前没有活动」，读不到则显示原因（不是装作没有）。此前本插件只读签到用的那一小片活动数据，banner 行被整行跳过（用户实拍 2026-10-25），现已整份读取。
• 积分（只读） —— 账号池逐账号显示剩余积分与最近积分包的到期时间（来自 Qoder 的 sash/api/v2/me/usage，凭 jt- jobToken 查询）；临期的积分包会高亮。查询是只读的、不消耗积分；读不到时（凭据被拒 / 上游未响应）如实说明原因并给出路，不留一片空白。
• 安全 loopback shim —— 每区域一个随机端口 + 进程内随机 secret，真实 Qoder PAT 不交给 pi-ai：pi-ai 只与本地 shim 对话，shim 用 cosy 会话（jobToken）做上游请求。
• 多账号池（PAT） —— 每区域一个本地 vault $DSH_HOME/.qoder-accounts..json（0600），把设置 PAT、环境变量与 vault 账号三源去重合并；卡片可新增（粘贴 pt-…，经 JobToken 交换校验并取显示名，也可自填备注名）/ 改名账号，也可显式选择某一账号服务（regions..accountId，留空自动按 settings → env → vault 选取）。移出池与删除是两件事：移出池 = 在池表格里取消勾选并保存（凭据留着，随时勾回）；删除 = 池表格行内的「删除」按钮，二次确认后抹掉 vault 里的 PAT 并自动退出池与区域选择（不可恢复；设置/环境变量里的 PAT 不归本插件管，不提供删除按钮）。
• 按实测排序与自动换号 —— 「一键测试所有账号」对池内每个成员发真实请求（目标模型默认自动挑本区域倍率为 0 的免费模型），结果落 $DSH_HOME/.qoder-pool..json；开启账号池后，聊天流在首字节前按 rankPool（可用性 → 快过期的积分优先 → 到期最近 → 积分高 → id）选出服务账号，失败时依次换下一个可用账号重试，失败回写 live-request 探测。关掉开关则插件不替你选、也不替你换，失败如实报错。上游报额度耗尽必显示：对话路径上一旦上游的业务码命中配额族（110 当日用量 / 113 配额 / 118 Credits 耗尽等），该区域卡片就出现一条「上游报额度耗尽」通知（最近一次时刻 + 业务码，悬停是脱敏后的上游原文）——与账号池开关无关，因为逐账号的 out-of-credit 明细只活在池视图里，池关着时这条通知是那次失败唯一可见的出口（0.7.x 的「今日额度疑似已用尽」胶囊拆掉后留下的缺口）。限流（HTTP 429 短窗）不会被标成耗尽——那是冷却，不是没额度。
• 账号转移（导入 / 导出） —— 按区域把 vault 账号导出为传输文件，预览后按索引导入；跨区域域名（qoder.com.cn / qoder.sh）正向匹配，不匹配的记录计入 skipped。
• 思考强度与上下文预算 —— 上游按模型声明 thinking_config.efforts，卡片只列出真实存在的档位（Qwen 系 low/medium/xhigh、DeepSeek/GLM 系 low/high/max），选定即保存、每个请求自动带上（与 Qoder 客户端同一发送字段，双写顶层与 parameters）；上下文档位同样只来自上游 context_config 声明的档位，未声明时不渲染控件、不编造选项。
• 诚实的模型能力 —— 上游的 is_vl 是平台的图片输入声明而非模型原生能力（内置目录里几乎全是 true，连纯文本模型也是）。图片输入按精确 model id 的人工核对表只对文档确认多模态的模型预勾选，未核实的一律不勾，并在开关 tooltip 里说明「为什么没勾」；「关闭思考」同样只对上游显式声明、且不在已知拒绝集里的模型提供。宁可少给一个选项，也不要让用户按下去就失败。
• 缓存命中如实上报 —— 上游的 usage 带 prompt_tokens_details.cached_tokens，插件把它一路透传到宿主，所以 GUI 轮次统计里的「缓存命中」是真实比例（修复前这里恒显 0%：字段在归一路径上被丢掉了，那个 0% 是不可信的读数，不是缓存没生效的证据）。命中数是 `prompt_tokens` 的子集，不是额外增量——所以它不会被加进总数（那会把命中的前缀算两遍）。上游没报这个字段时就不写，不会用 0 顶替「不知道」。
• composer 积分读数（位置可选） —— 会话输入区按区域显示 QD CN / QD AI 与当前计费账号的余额（如 QD CN · 92；池接管时是接管者的余额，悬停写明归属），点开是逐账号的余额表，点某一行即切换到该账号；受每区域「在对话框显示积分」开关控制（默认开，opt-out）。读数可放在两个位置之一（卡片上的二选一下拉，每区域独立，默认不变）：输入框工具栏（conversation.input.left，更近、更易扫一眼）或输入框下方（conversation.composer.dock，即 shell 渲染轮次 / tok/s / token / 缓存命中那一行的常驻栏，读数是追加在自带统计之后）。之所以可选：输入框工具栏是共享的 list 插槽，另一个把东西停在那里的插件可能把读数挤到看不见——此时切到「输入框下方」即可（对齐 workbuddy issue #62）。
• 命令行诊断与现场验证 —— dsh-connect-qoder doctor|status|logout [--json] [--region cn|global]：doctor 报 PAT 来源、cosy 指纹派生、pi-ai 代际、宿主心跳存活与 vault 账号计数；status 报凭据来源、上游可达性与当前剩余积分；logout 清除指定区域的 vault 账号与账号池测量副本。另有 pnpm run probe:cosy（不依赖宿主直连 cosy 链路验证）与 pnpm run probe:vault（只读 dump vault / 账号池测量，PAT 只显示掩码）。

工作原理

DSH PiAiAdapter（每个 provider 一套）
  -> 安全 loopback shim（每区域一个随机端口 + 进程内随机 secret）
  -> QoderUpstreamClient（cosy 协议最小客户端）
  -> 国内版 https://gateway.qoder.com.cn/algo/api/v2/...
  -> 国际版 https://api1.qoder.sh/algo/api/v2/...
  -> Qoder SSE（OpenAI 形状增量）
  -> DSH 本地执行工具并回传结果

国内版与国际版各持一套完整的运行时栈——上游客户端、模型 catalog、回环 shim、adapter——按区域配置（网关 / openapi / 目录路径）隔离，所以两个区域的模型可以同时可选、被不同会话使用。

凭据是 PAT（设置卡片 regions..pat 或环境变量，见配置），设置项优先。每次会话按需惰性交换 jobToken：PAT 只在这个交换请求里使用一次，之后的对外请求全部携带 cosy bearer（自定义 Base64 载荷 + MD5 签名）与「机器指纹」会话头。PAT 从不进入 pi-ai，也从不外发到网关之外；本插件不读不写 Qoder 桌面端的本地登录文件。

模型的 cosy 编码与签名细节（自定义字母表、n/3 重排、cosy&& 签名、RSA/AES 会话封装）见 src/cosy.ts 的头部注释；错误分类（内容审核 / 限流 / 额度耗尽 / 瞬时故障）与 DSH 重试语义的对应见 src/upstream.ts。

安装

从发布包安装（推荐）

dsh plugin --profile desktop add @dmh2002/dsh-connect-qoder   # Desktop
dsh plugin --profile web add @dmh2002/dsh-connect-qoder       # Web

装完重启该 profile 的 DSH 进程（bundle 的 host 半边在启动时加载）。也可以在 DSH 的「插件市场 / Bundles」里搜 dsh-connect-qoder 一键安装。

`dsh` 命令报 `Cannot find module .../DSH NEXT.app/...`？ 那是宿主换代留下的旧 shim：宿主 app 目录名已从 DSH NEXT.app 变为 DeepSeek Harness.app，而 ~/.local/bin/dsh 仍指向被移除的旧路径。把 shim 改指新宿主自带的 CLI 入口即可：

```bash

exec "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" "$@"

`

新入口内部以 ELECTRON_RUN_AS_NODE 运行 app.asar 里的 dsh/lib/bin.js，profile 仍由 --profile 决定。

npm 包名带 @dmh2002/ 作用域。插件在 DSH 内的配置标识不带作用域——设置命名空间、/plugins/dsh-connect-qoder/… 路由与命令行程序名都仍是 dsh-connect-qoder，所以 0.2.0 之前装过的用户升级后配置照旧生效，不用重填 PAT。但浏览器 bundle 的模块 id、以及设置卡片两个槽位的 key 都按带作用域的包名建（plugins.bundle.config 用裸包名，plugins.row.config 用 #，行 id 仍不带作用域），这几处由构建期从 package.json 注入，改包名不会漏下它们。

从源码构建（开发）

git clone https://github.com/dingminhua/dsh-connect-qoder.git
cd dsh-connect-qoder
pnpm install
pnpm run check        # typecheck + test + build 全绿后再安装

以 link: 安装进当前 profile，改码后重启 DSH 即生效（不会重装依赖树）：

dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-qoder

验证安装

• 打开「设置 → 插件」应能看到 dsh-connect-qoder 的配置卡片（国内版 / 国际版两个 tab）。
• 在该 profile 目录里 pnpm exec dsh-connect-qoder doctor 应输出两个区域的 PAT 状态与指纹派生。
• 配置 PAT 后，「从 Qoder 刷新」应拉出该区域的真实模型清单；模型选择器出现 Qoder / Qoder Global 两个分组。

配置

PAT（Personal Access Token）

在 Qoder 账户设置里创建 PAT（pt-… 开头）。两种提供方式，设置卡片优先于环境变量：

区域 · 发证入口 · 设置项 · 环境变量 国内版（qoder.com.cn） · 控制台 → 设置 → API 令牌 · 卡片「国内版」tab → 添加 PAT · QODERCN_PERSONAL_ACCESS_TOKEN 国际版（qoder.sh） · 控制台 → Settings → Personal Access Tokens · 卡片「国际版」tab → 添加 PAT · QODER_PERSONAL_ACCESS_TOKEN

• PAT 只保存到本地插件配置（regions..pat），从不上传、不进入任何网络请求。
• 未配置 PAT 的区域不列出任何模型；doctor 命令会指出哪个区域缺 PAT。
• 逐步操作说明见 `docs/PAT.md`（含创建流程、验证机制、优先级与常见问题）。

区域启停

卡片每个 tab 右侧的勾选框控制该区域是否参与模型选择（opt-out：显式取消勾选才停用）。停用只摘除路由与目录条目，配置全部保留。

多账号池与凭据来源

除设置 PAT 与环境变量外，每区域还有一个本地 vault（$DSH_HOME/.qoder-accounts..json，权限 0600）保存多个 PAT 账号。三源按 settings → env → vault 的优先级去重合并（同一个 PAT 只在最高优先级的来源里列出一次）。

• 卡片可新增（粘贴 pt-…，经 JobToken 交换校验并取回显示名，也可自填备注名）/ 改名 vault 账号，也可显式选择某一账号服务（regions..accountId，留空自动）。删除 vault 账号在池表格的行内「删除」按钮（需二次确认）；取消勾选并保存只是把它移出轮换，PAT 仍留在本地。
• 选中的凭据只用于会话的 jobToken 交换与后续 cosy 请求，从不进入 pi-ai 或页面。
• logout [--region cn|global] 会清除指定区域的 vault 账号与账号池测量副本（$DSH_HOME/.qoder-accounts..json 与 .qoder-pool..json）。
• 勾选成员、一键签到、一键测试与自动换号的规则见账号池。

账号池

一台机器上往往有多个 Qoder 账号（多个 PAT）。账号池把这些账号收成一次点击：勾进池子，然后「一键签到所有账号」或「一键测试所有账号」；再打开启用账号池，插件就会在请求失败时自动换号接着跑。

每个区域（国内版 / 国际版）各有独立的一池：成员、目标模型、积分与签到状态互不影响——两边的账号本来就属于不同的供应商。两个区域都有每日签到：国际版的签到活动只下发给带设备风控头的请求，插件按区域读取本机 Qoder 客户端自带的设备身份组件；取不到时如实报错，不会把「拿不到设备身份」伪装成「今天没有活动」。

自动换号（开启账号池即生效）

• 谁来服务由排序决定：开启后每一次请求都发给池内排序最靠前的可用账号，所以「当前使用」显示的是排序的结果，不一定是你手动选的那个。
• 失败时继续往下试：某个请求在上游失败时，插件依次用池内其他可用账号重试，直到有一个接手、或全部不可用为止才把错误报出来。
• 哪些失败会换号：429 限流、额度耗尽、401/403 凭据被拒、5xx 网关与网络故障——这些都是某个账号的状态，换一个很可能就过了。
• 哪些不会：请求本身不合法（HTTP 400）——同一个请求体换谁都是同样的 400，重试只是让你多等几轮；流已开始之后也不会重放（字节已经发出去了）。
• 已知不可用的账号会被跳过：处于限流冷却期内、或凭据已被上游拒绝的成员不参与选择。从没测过的账号按「默认可用」参与——刚添加的账号不该因为「还没测」就被排除。
• 手动选择从不被改写：池子通过运行时覆盖决定「谁服务」，不写回你保存的选择；关掉开关，你选定的账号立刻完全生效。
• 失败会被记下来：一次失败会写成该账号的测量（含上游报文中给出的恢复时间），下一个请求直接从可用账号开始，不必每次先撞一遍同一个限流账号。
• 换号会告诉你：换号是插件替你做的决定，所以它会说出来——回答开头带一条引用块提示，例如 > [dsh-connect-qoder] 「450702134816」被限流，已改用池中另一个账号回答。。提示说的是失败的那个账号（你选中的那个），不点名接管者；连换多次只写一条，说的是紧邻换号的那次失败。没换号就一个字都不写。

这个开关到底控制什么

它只控制「插件要不要自己决定」，不控制「你能不能操作」。

· 账号池 开启 · 账号池 关闭 谁服务 · 由排序自动选出（可用优先 → 积分包快过期 → 到期最近 → 积分高 → id） · 你在设置区的「使用哪个账号」里选定 请求失败 · 自动换下一个可用账号重试 · 不换号，如实报错 一键签到 / 一键测试 · 可用 · 仍然可用 目标测试模型 · 可改 · 仍然可改

最后两行是刻意的：签到与测试是手动动作，作用于你勾选的成员，与「插件是否自动路由」是两件事。

唯一的硬约束：池里一个成员都没勾选时，批量动作一律拒绝。空的池绝不退化成「那就对全部账号执行」——那是唯一会花掉你没授权过的积分的解读。

排序规则（开启账号池后决定谁服务）

1. 可用优先 —— 被测量判定为不可用（限流未到恢复时间、凭据被拒等）的排到最后；
2. 积分高者优先 —— 只在有新鲜读数时参与（卡片轮询、批量测试或保存时读到的那份，10 分钟内有效）：请求路径不会为了排序去打上游，否则一页对话就变成 N 个额外请求；
3. 快过期的积分包优先 —— 3 天内到期的先花，过期即作废；
4. 最后按账号 id 收尾，保证顺序是全序、可复现。

两个批量动作

• 一键签到所有账号 —— 逐个账号领取当日的官方签到活动。先查状态再领取，已领过的直接标「已签到」而不发写入请求（幂等，不重复领取）；任何单个账号失败只标记该行，不中断整批。签到会改变余额，因此批次结束后作废该区域的积分缓存，卡片不会继续显示领取前的数字。
• 一键测试所有账号 —— 对每个成员发一次真实请求，得出「这个账号此刻能不能用这个模型」。目标模型默认由「自动」挑本区域倍率为 0 的免费模型（多个候选取上下文窗口最大的），你也可以显式指定——但在免费模型出现之前测试保持关闭，避免在你不知情的情况下花掉积分。测试走的是与模型行同一套探测，因此有真实成本。

两种批量动作都不锁住界面：按钮自己变成「签到中… / 测试中…」，每处理完一个账号，那一行立刻落位、活动日志也逐条写下（时间戳是各自完成的那一刻，不是整批结束的那一秒）；其余界面照常可用。只有保存配置与删除账号会挡一道——前者在写盘、后者不可逆。

设置卡片的排布：顶部是两格独立的供应商卡片（国内版 / 国际版），每格自带边框与底色、右端有自己的开关，选中的那格描品牌色边——一格就是一个单位，点名字切 tab、点开关启用该供应商。再往下是「在对话框显示积分」与「显示位置」两行（整行可点，主标题下一行是说明），然后是账号池、模型管理。那两行管的是积分读数显不显示、显示在哪里，立即生效，不需要点保存。

不提供自动签到：签到会真实领取奖励，只在你点按钮时执行。

命令行诊断

在已装本插件的 profile 目录里跑（推荐，无需全局安装）：

cd ~/.dsh/profiles/desktop
pnpm exec dsh-connect-qoder doctor    # PAT 来源 + cosy 指纹派生 + pi-ai 代际 + 心跳 + vault 计数（纯本地，不发请求）
pnpm exec dsh-connect-qoder status    # 每区域凭据来源 + 上游模型目录可达性 + 剩余积分（需 PAT）
pnpm exec dsh-connect-qoder logout --region cn   # 清除指定区域的 vault 账号与账号池测量副本
pnpm exec dsh-connect-qoder doctor --json        # 机器可读输出

status 会真实交换一次 jobToken 并拉取模型目录（随后只读查询一次用量），因此需要对应区域的环境变量或 vault PAT；doctor 完全离线。

两条实测过的注意事项：

1. 别用 `node node_modules/dsh-connect-qoder/lib/bin.js` 这种裸路径——0.3.0 起包名带作用域，软链在 node_modules/@dmh2002/dsh-connect-qoder，写旧路径只会得到 MODULE_NOT_FOUND（缺的是入口文件，不是 peer）。

2. CLI 依赖宿主提供的 peer 包（@deepseek-ai/dsh-atomic-write / dsh-home-paths）。本机实测：pnpm 会随包把它们装进 profile 的依赖树，pnpm exec 与 npm 装的 tarball 都能跑通。但这取决于 pnpm 版本与 `auto-install-peers` 配置——如果在你机器上报 Cannot find package '@deepseek-ai/dsh-atomic-write'，那是这一层没装上；设置卡片与 provider 不受影响（它们在宿主进程内，宿主自己解析这些名字）。同族 workbuddy 的 issue #47 是同一个形状，其修复方案（宿主优先、按需回落自带实现）适用于本项目，尚未移植。

平台支持

平台 · 状态 macOS · ✅ 已验证（开发与 CI） Windows · ✅ CI 测试通过（上游请求走标准 fetch，无平台专属路径） Linux · ✅ CI 测试通过

受支持的宿主范围

宿主 · peer 范围 DSH（@deepseek-ai/*） · >=0.1.7-rc.1 =0.2.0-rc.1 =0.2.1-rc.1 =0.85.0 =1.0.0 =24.0.0

范围由 tests/dsh-line.spec.ts 强制。DSH 至今只发预发布，而 node-semver 只有当范围里*某个*比较符与该版本的 major.minor.patch 元组完全一致、且自身也带预发布标签时，才会放行预发布版本。所以每开一条新线就得加一条分支：只写 >=0.1.7-rc.1 =0.2.0-rc.1 这一支不含 `0.2.1-rc.1`（桌面端 0.2.1-rc.1 已发布）。上界仍须带 -0（<0.3.0 不挡任何东西）。

两套语义并存（1.1.2 实测更正）：npm / pnpm 安装走 node-semver 标准语义，新补丁号的 rc（如 0.2.2-rc.1）确实仍需手工追加一条分支 —— UNGATED_PRERELEASES 就是这份可见的待办表。但宿主的插件兼容门禁不是标准语义：dsh-app-boot 用 semver.satisfies(v, range, { includePrerelease: true })，在这个语义下 >=0.2.1-rc.1 <0.3.0-0 一支就覆盖整条 `0.2.x` 线（0.2.2-rc.1、0.2.9 都放行），0.3.0-rc.1 仍被上界拦住。1.1.0/1.1.1 曾断言「没有任何静态范围能覆盖任意 0.2.x 预发布」，那句话只对 npm 成立，对宿主门禁不成立，已更正。GA 版本（如 0.2.1）对既有分支本来就判 true。

pi-ai 单独列一行是因为它换了主版本：0.2.1-rc.1 宿主把 pi-ai 从 0.85 换到 1.x，而两代的上下文契约不同（1.x 在 Models 层归一化）。声明与检测必须一致，否则就是 1.1.0 修掉的那个静默丢工具缺陷 —— 详见 docs/DSH-0.2.1-RC1-FOLLOWUP.md。

当前宿主基线：0.2.1-rc.3（2026-10-24 实测）

宿主升到 0.2.1-rc.3（DeepSeek Harness.app，nightly 通道；app.asar 内全部 @deepseek-ai/dsh-* 均为 0.2.1-rc.3，内置 pi-ai 1.1.0）。本插件不需要任何运行时代码改动，理由逐条如下：

检查项 · 结论 插件依赖的宿主包（dsh-llm / dsh-llm-pi-ai / dsh-settings / dsh-atomic-write / dsh-attachment / dsh-host-webserver / dsh-home-paths / dsh-client-ui-slots / dsh-client-ui-settings / dsh-client-ui-settings-plugins / dsh-client-ui-renderer / dsh-client-locale） · 与 rc.2 逐字节相同（仅 package.json 的版本号不同） rc.3 的客户端改动 · 全部增量：View 标签页置顶与 conversation.session.header.views.actions 新槽位、草稿接管新增 whenDraftExists（replace / append / keep）、primitives 的 Tooltip 支持 left 与自动翻转、Menu 新增 current 与 minWidthFromAnchor、新增两个图标。插件用到的槽位与 owner props 没有一条被改动 peer 范围 · >=0.2.1-rc.1 <0.3.0-0 在 npm 标准语义与宿主门禁语义下都放行 0.2.1-rc.3（宿主门禁用 includePrerelease: true，覆盖整条 0.2.x 线） 插件在 rc.3 上的实际加载 · Config 目录里 include:dsh-connect-qoder 状态 schema；客户端 conversation.input.model.label 槽位由 dsh-connect-qoder-client（priority -1）占据，conversation.input.left 槽位有 dsh-connect-qoder-composer-credits —— 宿主 dsh plugin list 不再对本插件报兼容性告警 回归 · pnpm run typecheck 与 pnpm test（948 passed / 8 skipped）全绿

rc.3 带来的环境变化（不是插件的问题）：宿主 app 目录名从 DSH NEXT.app 变为 DeepSeek Harness.app，旧路径上的 dsh shim 会失效 —— 见安装一节的说明。

安全说明

• PAT 只写入本地插件配置（或环境变量），从不进入任何网络请求；对外请求一律使用 cosy 会话令牌（jobToken）+ 机器指纹头。
• 本地 shim 用随机端口的 loopback 服务 + 进程内 secret 鉴权，并校验 Host / Origin / Content-Type，请求体有 64MB 上限。
• 本插件只读你显式提供的 PAT；不读取、不修改 Qoder 桌面端的本地登录/凭据文件。
• 诊断输出（doctor / status 与卡片探测）均脱敏，不打印任何令牌样式的字符串。

市场收录与展示

本插件声明了可安装的 dsh.bundle manifest（dsh.bundle.patch: ./cordis.patch.yml），因此可以用 dsh plugin add 安装。社区市场通常从 Awesome DSH Plugin 注册表同步条目；仓库内的提交草稿位于 awesome-dsh-plugin-submission/dingminhua__dsh-connect-qoder.yml。

收录目录规范（依据 contributing.md）：

• 每个插件一个 YAML：data/plugins/__.yml，字段为 url（与仓库地址完全一致）、name（owner/repo）、category（有效值之一，本项目为 model）、description.en（必填，以句号结尾）/ description.zh（可选）；描述中含 : 必须加引号。
• 仓库需声明 dsh.bundle manifest、被 dsh-plugin topic 标记、创建满 1 天且处于活跃维护；描述必须属实、不带营销词——它会被逐条对照代码核对。
• 注册表的两个 README 由脚本生成，不得手工编辑；修改 YAML 后在其仓库执行 npm ci + node scripts/generate-readme.mjs 重新生成。
• 一个 PR 最多收录 3 条；只改自己的条目。

市场卡片中的截图与 GitHub README 徽章是两套机制：

• 市场截图按当前约定由插件自己仓库根目录的 `screenshots.json` 声明（本项目声明了 screenshots.json）；注册表的 data/screenshots.json 是旧约定下的回退，不再添加新键。
• GitHub 徽章由本 README 顶部的 Shields 图片链接生成；市场图标/占位图由具体市场的展示规则决定，不是 npm 字段，也不是 README 徽章。