dsh-qoder-plugin
把 Qoder 模型接入 DeepSeek Harness：用 PAT 调用与 Qoder CLI 同源的模型服务，支持国内版 / 国际版双区域、模型开关、上下文窗口与每日签到，并提供只读的额度概览。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-qoder-plugin@0.6.4Qoder Plugin 以 dsh-qoder-plugin 发布，当前版本为 0.6.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
把 Qoder 订阅的模型以个人访问令牌（PAT）接入 DeepSeek Harness（DSH）的社区插件。
更新日志见 CHANGELOG.md（英文）。
一个插件同时服务两条 Qoder 产品线，各自一套凭证、一个 provider、一份模型目录，互不混用：
| 变体 | provider id | PAT 生成站点 |
|---|---|---|
| 国内版 | qoder | qoder.com.cn |
| 国际版 | qoder-global | qoder.com |
只需要哪一版就只配哪一版：未保存 PAT 的变体不显示模型分组，另一版完全不受影响。流式输出、推理内容、工具调用走插件内置的 Qoder 传输层；对话循环、压缩与权限始终由 DSH 本体掌控。
dsh-qoder-plugin 是 DeepSeek Harness（DSH）的社区插件：用个人访问令牌（PAT）把 Qoder 的模型接入 DSH，国内版与国际版各自一套凭证、provider 与模型目录，互不混用。
本插件的标识（安装、排障、看数据目录时会用到）：
| 项 | 值 |
|---|---|
| 包名 | dsh-qoder-plugin |
| profile 行 id | qoder-plugin |
| 数据目录 | <profile>/.dsh-qoder-plugin/ |
| HTTP 路由前缀 | /plugins/dsh-qoder-plugin/* |
| CLI 命令 | dsh-qoder-plugin |
为什么行 id 与包名不一致：DSH 的插件配置槽 key 是 `${包名}#${行id}`，包名来自 package.json、行 id 来自插件 patch 声明的 id。两者都写全名，是为了让这个 key 在任何 profile 里都唯一、不与其它 Qoder 插件相撞。详见设置界面与 DSH 版本。
qoder（china）与 qoder-global（global）各有自己的凭证文件、路由与已保存目录——qoder.com 生成的令牌对中国区无效，反之亦然，两套永不互串。Qoder · 剩余额度 读数，只在当前会话选用 Qoder 模型时出现（切到别的模型立即让位，不占工具栏）。点击在读数上方展开一枚紧凑面板：只显示当前模型所属版本的那一行，含套餐标签、剩余 / 总量、实心进度条、百分比与到期时间，底部注明自动刷新间隔，面板里可手动刷新；数值按账号实际持有的资源包合计（credits.unlimited 不再遮掩真实剩余）。侧栏小卡与中间额度面板已取消，额度只在「用得到的地方」出现。读数本身在「高级设置」最上方用一个「在对话框显示积分」开关收起或打开（作为本机浏览器偏好保存，不写插件设置文件）。x<priceFactor>：模型名后直接拼 Qoder 报价的价格倍率（模型选择器里显示为 某模型 · x0.79，免费为 x0.0），来自目录接口的 price_factor 字段，仅作展示、不影响请求；Qoder 未报倍率的模型不显示后缀，不会凭空补一个数。整数倍率统一补一位小数（x1.0），非整数倍率按 Qoder 原值显示（x0.79、x1.6）。卡片内的模型列表把同一数字写成 0.5x 的形式，两处数值一致、只是排版方向不同。设置页是三张紧凑设置卡：账号（登录状态、套餐、剩余积分 / 签到状态 / 一键签到、版本切换与整版开关、凭证来源、更换/清除 PAT）、模型（目录来源与刷新、逐模型开关、上下文窗口滑块、统一保存）、高级设置（在对话框显示积分、自动签到、签到时间、刷新间隔）。额度展示已移到输入框读数与账号卡片的摘要行，页面不再堆叠空卡片。所有数值来自 Qoder 接口，未声明的条目不凭空出现。
账号卡片顶部是国内版 / 国际版分段切换，每个页签右侧的方框用来整版启用或关闭该版本的全部模型；下方摘要行给出当前账号的剩余积分、今日签到状态与「当前使用」，右侧是「一键签到」：
「模型」卡片按 Qoder 官方顺序逐行开关模型并标出推理档位，滑块选择该模型的上下文窗口（拖到哪算哪，松手吸附到最近的可用档位）；改动先暂存，点「保存」一次提交，关闭的模型会从 DSH 的模型选择器中消失：
输入框工具条上的额度读数（仅当会话选用 Qoder 模型时出现），点开是锚定在读数上方的小面板，两版额度、套餐与到期时间一屏看完：
DSH 0.1.7 起把插件配置统一收进**「插件」页**（0.2.x 沿用同一套槽位）。装好后它出现在「插件」页的**「已安装」**分组里：
点它进入包详情页，设置正文直接内联在包描述下方——这就是本插件的设置界面：
卡片本身不自绘外壳（标题、图标、面包屑、版本与开关都由「插件」页绘制），只渲染配置正文：三张设置卡自上而下排列，没有折叠、没有二级页签，任何一次点击都不会把内容藏起来。深色主题、紧凑侧栏与键盘焦点均由 DSH 主题令牌接管，插件不自带配色；按钮也沿用宿主的三种官方形态——保存是实心主按钮（浅色主题近黑、深色主题近白），清除凭证是官方「卸载」同款描边危险按钮（不带垃圾桶图标，以便与真正的卸载区分），其余操作是无框白字按钮。
找不到设置入口时：本插件的卡片只出现在「插件」页。若你在「设置」里翻找过，那里没有本插件的入口——插件配置自 DSH 0.1.7 起统一收归「插件」页。
前置条件：
>=0.1.7-rc.1 <0.3.0（0.1.7 与 0.2.x 均可；区间以 peerDependencies 声明，这是 DSH 安装时实际校验的字段——app-boot 的兼容性预检只读 peer 依赖，不读 engines.dsh）；^22.19.0 || >=24.0.0（package.json engines）；DSH 版本支持范围
本插件注册在 DSH 0.1.7 起的插件配置槽位上，因此要求 DSH ≥ 0.1.7： 在 0.1.5 / 0.1.6 上宿主功能（模型、PAT、目录、签到）照常可用， 但设置卡片不会出现（那两个版本没有
plugins.row.config槽）。上限为
<0.3.0：已核对dsh-v0.1.7-rc.2→dsh-v0.2.0-rc.1两个 tag， 本插件所依赖的全部 9 个包零源文件变更，故 0.2.x 无需改动即可运行。 区间写在peerDependencies——DSH 安装时校验的就是这个字段。
# 从 GitHub 安装
dsh plugin --profile web add github:road-kid/dsh-qoder-plugin
按你使用的 profile 换 --profile 的值（web / desktop / tui）。装到哪个 profile，数据就落在哪个 profile 目录里，各自独立。
与其它 Qoder 插件共存：本插件的包名、行 id、路由前缀与数据目录都是独立命名，因此可以与其它 Qoder 插件同时安装、配置互不干扰。（同一个插件装两次则不行——profile 里同名的行只应存在一个。）
从 0.4.x 升级：本插件已从
dsh-connect-qoder-x更名为dsh-qoder-plugin（包名、模块 id、路由前缀、数据目录与仓库名一起改）。0.6.0 起 profile 行 id 也 从llm-qoder-x改为qoder-plugin，重装后请在插件管理器里重新点一次「配置」， provider（qoder/qoder-global）与已选模型不受影响。重新执行上面的安装命令即可， 数据目录<profile>/.dsh-qoder-plugin/原地不动。
lib/，直接取源码即可用，不需要额外的构建脚本许可。dsh plugin --profile web add dsh-qoder-plugin 会拿到预构建产物，同样不需要构建许可（参见 DSH 的插件发布指南）。npm 上的包与 GitHub 上的 v* 标签同源同版本，pnpm add dsh-qoder-plugin@<version> 可锁定到某个历史版本。index.json）检索，并不直接搜索 npm：只发布 npm、但包未被任何索引收录时，市场里仍然搜不到。想让它可被搜索，需要发布到 npm 后用 DSH 自带的 plugin-market-generator 生成索引，或把自建索引的 URL 添加进「自定义插件市场」。按上一节的路径打开设置界面，把 PAT 粘贴进密码输入框，点「保存」（期间显示「校验并保存中…」）。保存动作会先经 Qoder 校验令牌对该变体的区域有效，失败则不落盘。两类失败分别提示：Qoder 明确拒绝 → 「PAT 无效或已过期 — 请到账号设置重新生成后再试。」；连不上 Qoder（超时/网络/5xx）→ 「无法连接 Qoder 校验该 PAT（…）。令牌未保存 — 请检查网络后重试。」——网络问题不会把可用令牌说成坏令牌。两版各填各的卡片即可两组并存。
不方便走卡片的场景可用环境变量：未保存过凭证文件时插件读取 env 兜底——
| 变体 | 环境变量 |
|---|---|
qoder（china） | QODER_CN_PERSONAL_ACCESS_TOKEN |
qoder-global | QODER_PERSONAL_ACCESS_TOKEN |
优先级为 文件 > env：只要该变体保存过有效的凭证文件，环境变量就不再生效。
插件的全部自有文件收在数据目录一处：<profile>/.dsh-qoder-plugin/（凭据在根，可重建的缓存在 state/ 子目录）：
<profile>/.dsh-qoder-plugin/
├── .qoder-auth.json # 中国版 PAT（{version:2, pat, region, savedAt}）
├── .qoder-global-auth.json # 国际版 PAT
├── settings.json # 刷新间隔 / 签到时间 / 整版开关等自有配置
├── checkin-status.json # 签到状态（今日是否已领/领取时刻），不含台账
└── state/
├── .qoder-catalog.json # 中国版按账号保存的模型目录
├── .qoder-global-catalog.json
├── .qoder-probe.json # 中国版推理档位探测记录
├── .qoder-global-probe.json
├── .qoder-host-heartbeat.json
└── .qoder-machine-id
环境变量 DSH_QODER_DATA_DIR 可显式覆盖数据目录。
国际版签到的设备身份：Qoder 国际服务只对携带「设备风控身份」的请求下发每日活动，
该身份无法伪造，只能由本机安装的 Qoder 桌面客户端自带的签名组件（runtime-info）
现场生成——它指纹的是这台机器的真实硬件/虚拟化状态。返回的三个风控头
（Cosy-MachineToken/Code/Type）只随签到相关的两个请求（活动列表、领取）发出，
不写盘、不缓存，每次签到现取现用。未装客户端时插件如实报告「需要本机安装
Qoder 客户端」并跳过国际签到（国内版不受影响）。另注意：模型目录/对话/图片请求
携带的是插件自己的稳定机器码（.qoder-machine-id，一个持久化的随机 UUID），
与上面签到用的风控身份是两回事，互不派生。
DSH 0.1.7 起，插件配置改由 ui-plugin-manager 的键控槽承载：settings.section 下不再有第三方可用的插件设置子槽，「内置插件」页也改建为只认 settings.plugins.tab 的 tab 容器，旧的 settings.plugin.item 已从 SlotMap 移除。本插件据此注册两个槽：
| 槽 | key | 作用 |
|---|---|---|
plugins.row.config | dsh-qoder-plugin#qoder-plugin | 行列表出现「配置」按钮，点开是本卡片 |
plugins.bundle.config | dsh-qoder-plugin | 包详情页内联渲染同一张卡片 |
行 key 是 `${包名}#${行id}`：包名来自 package.json，行 id 来自本插件 patch 声明的 id。两者都写全名，正是为了让这个 key 在任何 profile 里唯一，不与其它 Qoder 插件相撞。
卡片组件遵循宿主的 view 契约：
view === 'summary' → 只返回一行简介（卡片列表的副标题）view === 'page' → 返回设置正文，不自绘标题与折叠外壳（宿主已经画了）pnpm install
pnpm run build # tsdown 产出 lib/（宿主 bundle + client bundle）
pnpm test # vitest run
pnpm run test:qoder # node --test（Qoder 传输层用例）
pnpm run typecheck # tsc：宿主 + client 两份 tsconfig
pnpm run check # typecheck + test + test:qoder + build
已知失败用例：全量共 496 条用例，每轮 489
490 passed / 68 failed。失败集中在 3 个文件：tests/adapter.spec.ts1 条（代码与测试期望本身不一致）、tests/catalog-lifecycle.spec.ts1 条（模块级状态在用例间泄漏）、tests/reasoning-merge.spec.ts5 条（boot()后 5 秒超时的偶发失败，各轮在 46 条间波动，故 failed 数在 68 之间摆动）。这 3 个文件属于既有基线失败，非本版本引入。另：test:qoder（node --test 的 Qoder 传输层用例）131/131 全绿。
lib/ 与 package.json 里的版本号是唯一真相，发版流程固定四步：
pnpm run check # 闸门：typecheck + test + test:qoder + build
npm version <patch|minor|major> --no-git-tag-version
npm publish --registry https://registry.npmjs.org # prepack 会重跑 build，tarball 只含 files 白名单
git tag -a v<version> -m "v<version>" && git push origin main --tags
.npmrc 里若把默认源指向镜像（如 registry.npmmirror.com），发布时必须显式带 --registry https://registry.npmjs.org —— 镜像是只读的，不能发布。prepack 脚本已固定为 npm run build：从源码 clone 出去发布也会带上最新的 lib/，与本仓库提交的产物一致。v* 标签与 npm 版本号一一对应，回滚时按标签检出即可重建。本项目的实现参考了以下开源项目，在此致谢：
以上项目均以 MIT 许可发布；本项目同样按 MIT 发布。本项目与 Qoder、DeepSeek 官方均无关联，是社区适配器——非官方实现。