前言¶
DeepSeek Harness（DSH）把对话循环、压缩和权限留在宿主里，模型提供方则通过社区插件接入。若你已有 Qoder 订阅，希望在 DSH 里选用与 Qoder CLI 同源的模型服务，又不想单独维护一套 CLI 工作流，就需要一条「PAT 校验 → 注册 provider → 出现在模型选择器」的通路。
下面介绍社区插件 dsh-qoder-plugin（维护者 road-kid，分类：模型推理）。它用个人访问令牌（PAT）把 Qoder 模型挂进 DSH，国内版与国际版各自一套凭证与模型目录，互不混用；流式输出、推理内容与工具调用走插件内置传输层，对话与权限仍由 DSH 本体掌控。
这是什么¶
dsh-qoder-plugin 是 DSH 的社区插件，包名 dsh-qoder-plugin，profile 行 id 为 qoder-plugin。同一安装包内服务两条 Qoder 产品线：
| 变体 | provider id | PAT 生成站点 |
|---|---|---|
| 国内版 | qoder |
qoder.com.cn |
| 国际版 | qoder-global |
qoder.com |
只配置需要的变体即可：未保存 PAT 的变体不会显示模型分组，另一版不受影响。仓库说明：本插件已从 dsh-connect-qoder-x 更名为 dsh-qoder-plugin；0.6.0 起 profile 行 id 由 llm-qoder-x 改为 qoder-plugin，重装后需在插件管理器里重新进入「配置」，provider 与已选模型一般不受影响。
常用标识（安装、排障、查数据目录时会用到）：
| 项 | 值 |
|---|---|
| 数据目录 | <profile>/.dsh-qoder-plugin/ |
| HTTP 路由前缀 | /plugins/dsh-qoder-plugin/* |
| CLI 命令 | dsh-qoder-plugin |
核心功能¶
PAT 与双区域¶
- 在设置卡片粘贴 PAT 并「保存」：插件先对该变体区域实时校验，通过才落盘，模型分组立即出现，无需重启 DSH。
- 支持「更换 PAT」（新令牌校验通过才覆盖）与「清除 PAT」。
- 环境变量兜底（仅在该变体未保存过凭证文件时生效）：国内版
QODER_CN_PERSONAL_ACCESS_TOKEN，国际版QODER_PERSONAL_ACCESS_TOKEN；优先级为文件 > env。
模型目录与开关¶
模型列表采用 live → saved → fallback 三级降级：卡片会标明列表来自实时拉取、上次成功保存的目录，或内置兜底名单；失败时可看原因并手动「刷新模型列表」。
「模型」卡片按 Qoder 官方顺序列出该变体全部模型，可逐行开关；关闭的模型会从 DSH 模型选择器中隐藏。每行可拖动上下文窗口滑块（松手吸附到 200K / 400K / 1M 等声明档位），改动先暂存，与开关一并由「保存设置」提交；未保存时底部出现「未保存 N 项」栏。
模型名旁可展示 Qoder 目录中的价格倍率（如 x0.79），仅展示，不影响请求。
每日签到与额度¶
- 每日可领 100 Credits；领取窗口为 10:00 → 次日 10:00（UTC+8）。自动签到默认关闭，可在「高级设置」开启；「签到时间」统一控制国内版与国际版窗口。
- 国际版签到要求本机已安装 Qoder 桌面客户端（国际服务需客户端生成的设备风控身份）；未安装时插件会提示需安装客户端，而不是误报「今日无活动」。国内版无此要求。
- 选用 Qoder 模型时，输入框工具条可出现
Qoder · 剩余额度读数；点击展开只读额度面板（套餐、剩余/总量、到期等）。是否在对话框显示积分由「高级设置」中的本机偏好开关控制。
安装与启用¶
前置条件（以插件 package.json 与 README 为准）：
- DSH 核心
>=0.1.7-rc.1 <0.3.0（0.1.7 与 0.2.x 均可；安装时校验peerDependencies）。 - Node.js
^22.19.0 || >=24.0.0。 - Qoder 账号及至少一枚 PAT。
DSH 0.1.7 起插件配置在「插件」页的「已安装」分组中；点进包详情，设置正文内联在描述下方。若在旧版「设置」里找不到入口，属于版本差异——0.1.5 / 0.1.6 上宿主能力可能仍可用，但设置卡片槽位不存在。
从 GitHub 安装（按 profile 替换 web / desktop / tui）：
dsh plugin --profile web add github:road-kid/dsh-qoder-plugin
也可从 npm 安装：
dsh plugin --profile web add dsh-qoder-plugin
装到哪个 profile，数据就落在哪个 profile 目录，彼此独立。与其它 Qoder 类插件可共存（包名、行 id、路由与数据目录独立命名）。
典型用法¶
1、生成 PAT¶
- 国内版：登录 qoder.com.cn → 账号设置 → 个人访问令牌；也可使用文档中的直达链接 qoder.cn/account/integrations。
- 国际版：登录 qoder.com → 账号设置 → 个人访问令牌；qoder.com/account/integrations。
2、在插件页保存并选模型¶
- 打开 DSH「插件」页 → 已安装 → dsh-qoder-plugin → 配置。
- 在「账号」卡片切换国内版/国际版，粘贴对应 PAT，点「保存」（显示「校验并保存中…」）。
- 在「模型」卡片开启需要的模型、调整上下文窗口，点「保存设置」。
- 在会话里从 DSH 模型选择器选用
qoder或qoder-global下的模型开始对话。
校验失败时：Qoder 拒绝会提示 PAT 无效或过期；网络或 5xx 会提示无法连接且不会误保存令牌。
3、可选：环境变量与服务端场景¶
无法在 UI 填 PAT 时，可在尚未写入该变体凭证文件的前提下设置上文环境变量。数据与凭据默认位于 <profile>/.dsh-qoder-plugin/；可用 DSH_QODER_DATA_DIR 覆盖数据目录。
适用场景与注意¶
适合谁：已在 Qoder 订阅模型、希望在 DSH 统一界面里对话，并需要国内/国际双区域、模型开关、上下文窗口与签到/额度概览的开发者。
运行方式：与其它 DSH 插件一样，代码以当前 DSH 进程的权限运行；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证，确认 PAT 与本地数据目录（含 .qoder-auth.json 等）是否符合你的安全策略。
生态说明：DSH 社区插件目录（如 SkillHub）是独立收录站点，与 DeepSeek / 幻方无官方从属关系；市场里能否搜到插件取决于 DSH 配置的市场索引，并非仅发布 npm 即可被「发现」检索到。
结尾¶
dsh-qoder-plugin 把 Qoder 订阅以 PAT 方式接入 DSH：双 provider 隔离、目录降级、模型开关与窗口、签到与输入框额度读数，都在「插件」页三张设置卡里完成。需要详情、变更记录与 issue 时，见仓库 README 与 CHANGELOG.md。
- 社区目录页：skillhub.cn/plugins/road-kid/dsh-connect-qoder-x（收录名可能仍为旧仓库路径，安装以 README 中的
dsh-qoder-plugin为准） - 源码与文档：github.com/road-kid/dsh-qoder-plugin
