前言¶
DeepSeek Harness (DSH) 采用插件化架构。内置的 pi-ai 通道提供了 GitHub Copilot 支持，但 Web 界面缺少设备码登录入口，导致通过网页管理 Copilot 账号与模型列表较为不便。本插件复用 DSH 内置通道，通过 Web 设置页补充设备码登录/注销功能，并预置路由与管理模型列表的能力，让用户无需手动维护 API Token 即可使用 Copilot。
核心功能¶
- 设备码登录 / 注销：通过网页 + 设备码流程完成授权，凭据由 DSH 内置凭据库托管，支持注销。
- 预置提供方路由：安装后，Models 页面自动出现
GitHub Copilot路由。 - 模型目录兜底：首次登录自动填充模型列表，之后仅追加不覆盖已定制的列表。
- 管理模型列表：提供勾选式管理界面，支持新增、保留、删除模型条目。
- 多语言支持：跟随 DSH 设置自动切换中英文。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add @inventec/dsh-copilot-auth
安装完成后，需重启 DSH Web 并刷新页面。
典型用法¶
- 打开 设置 → GHC设置（英文界面为 GHC Settings，位于 Models 之后），点「授权登录」。
- 在 https://github.com/login/device 输入页面显示的设备码（可一键复制）完成授权；SSO 组织账号必须对组织点 Authorize，跳过则登录不生效。
- 回到设置页看到「已登录」：首次登录自动填充模型目录，到 Models 页选择
GitHub Copilot路由即可使用。
重要说明¶
- 路由前缀：URL 前缀
/copilot-auth硬编码，不可配置。 - 目录更新策略：模型目录采用「只增不更新」策略，合并只补充本机未见过的条目，上游对已有 ID 的元数据修正不会同步。
- 并发与恢复：并发保护为宿主单进程内 mutex，不支持多实例/多进程操作同一目录；等待超时后，旧预览与配置意图失效，需重新预览或显式结束旧意图。
- 版本兼容：依赖 DSH rc 版本，实测兼容
0.1.7-rc.2至0.2.0-rc.1/rc.2，peer 依赖@deepseek-ai/cordis@^4.0.2。 - 安全性：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
结语¶
该插件通过 Web 界面补齐了 DSH 内置 Copilot 通道的使用体验。完整文档与源码见下方链接。
