@inventec/dsh-copilot-auth 1.0.0 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 iasi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 iasi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,114 +1,120 @@
-# @inventec/dsh-copilot-auth
-
-为 DSH（DeepSeek Harness）内置的 GitHub Copilot LLM provider 补上 Web 端设备码（device flow）登录/注销入口，并预置一条开箱即用的 GitHub Copilot 提供方路由。
-
-## 这是什么
-
-用公司分配的 GitHub 账号（带 Copilot 订阅）登录 DSH 的方式，和其他 Copilot 客户端一致：**网页 + 设备码**，全程不填 API Token。
-
-本插件**复用 DSH 内置通道**（pi-ai 的 github-copilot provider），不实现任何 GitHub 协议代码——token 自动轮换、模型发现、协议适配全部由内置实现负责。插件本身只做三件事：挂载 DSH 内置但默认未启用的授权服务、提供「登录/注销」设置页、预置 `GitHub Copilot` 路由。
-
-## 特性
-
-- 🔐 **设备码登录/注销**：网页 + user code，免 API Token；SSO 组织授权友好
-- 🧩 **预置提供方路由**：安装即出现在 Models 页，无需手动配置
-- 📦 **模型目录自动同步**：登录成功或插件启动时，自动把账号全部可用模型写入模型目录，开箱即用
-- 🌐 **中/英双语界面**：跟随 DSH 语言设置自动切换
-- 🔑 **凭据安全托管**：存入 DSH 内置凭据库（文件强制 0600 权限），Copilot 临时 token 到期自动刷新
-- 🧪 **测试与 CI**：13 条单元测试；GitHub Actions 构建测试 + tag 触发自动发布（provenance）
-
-## 前置要求
-
-- DSH `0.1.2-rc.1`（实测版本）
-- 有效的 GitHub Copilot 订阅（公司分配的 github.com 组织账号，SSO 登录）
-- `pnpm` 可用（`dsh plugin` 是 pnpm 转发器）
-
-## 安装
-
-```bash
-dsh plugin --profile web add @inventec/dsh-copilot-auth
-```
-
-然后**重启 dsh web 并刷新浏览器**。
-
-### 故障排查
-
-- 企业镜像/私有源环境下 pnpm 解析 peer 失败：`export npm_config_auto_install_peers=false` 后重试（profile 自带的 pnpm workspace 默认已关闭 peer 自动安装）。
-- registry 的 `latest` dist-tag 可能落后于 `next`：显式按版本号安装/排查时勿被 `latest` 误导。
-
-## 登录
-
-1. 打开设置，进入侧栏「**GHC设置**」（英文界面为 *GHC Settings*，位于 Models 之后）
-2. 点「登录」，页面显示一串**代码**（user code，可一键复制）与 `https://github.com/login/device` 链接
-3. 新标签打开链接，用公司 GitHub 账号输入代码
-4. **SSO 用户必须对组织点 Authorize**（授权页会出现该步骤，跳过则登录不生效）
-5. 回到设置页看到「已登录」即成功；模型目录此时已自动同步
-
-> 设备码有时效（约 15 分钟），请拿到代码后尽快完成授权。若超时，页面会显示失败原因，重新点「登录」即可。
-
-## 使用
-
-- Models 页选择 `GitHub Copilot` 路由，模型目录已在登录/启动时自动同步账号全部可用模型，无需手动「添加模型」
-- **配额说明**：base 模型（GPT-4o/4.1 一类）不耗 premium requests；premium 模型（Claude、Gemini、o 系列等）每次调用消耗月度配额。日常建议 base 档，premium 模型按需手动选
-
-## 注销与卸载
-
-- 注销：设置页「注销」按钮（清除本机凭据记录）
-- 卸载：`dsh plugin --profile web remove @inventec/dsh-copilot-auth` 后重启 dsh web
-
-## 工作原理
-
-- 通过 `cordis.patch.yml` 三段生效：
-  1. 挂载 `@deepseek-ai/dsh-authorization` 服务（DSH 内置 bundle 未挂载，不挂则内置登录流不存在）
-  2. 注册本插件（host 侧在 webserver 上开 4 条本地路由：`/copilot-auth/start|state|status|logout`，跨站 Origin 拒绝）
-  3. 以 settings base 层预置 `github-copilot` 路由（用户 `settings.yaml` 可逐字段覆盖）
-- 登录走 GitHub 设备码流；凭据存 `~/.dsh/.credentials.yaml`（强制 600 权限）的 `llm-pi-ai/github-copilot` 记录，Copilot 临时 token 到期自动刷新
-- **模型目录自动同步**：登录成功或插件启动时，取「账号可用模型 ∩ pi-ai 内置目录」写入该路由的模型目录，同步失败经 `/copilot-auth/status` 的 `syncError` 字段暴露
-
-## 开发
-
-```bash
-npm install
-npm test        # node:test：patch 结构 + host 行为共 13 条
-npm run build   # esbuild 打包 client 到 lib/client.js（__ModuleLoader__ 信封）
-npm pack --dry-run
-```
-
-| 路径 | 职责 |
-|---|---|
-| `cordis.patch.yml` | 三段 patch（authorization 挂载 / 本插件 entry / 预置路由） |
-| `src/host.mjs` · `src/shared.mjs` | host 半区：登录状态机、4 条本地路由、模型目录同步 |
-| `src/client.jsx` | client 半区：settings.section 插槽 + 设备码交互 + 双语文案 |
-| `scripts/build-client.mjs` | client 打包（`__ModuleLoader__` CJS 工厂信封） |
-| `lib/client.js` | 构建产物（入库，使 git 安装免构建） |
-
-从源码安装：`dsh plugin --profile web add /path/to/dsh-copilot-auth`
-
-## 风险与合规
-
-- 通道为社区通用路线（基于 pi-ai 内部实现），**非 GitHub 官方支持 API**，可能随服务端变更失效
-- GitHub AUP 禁止批量自动化滥用；**公司账号请正常强度使用**
-
-## 已知边界
-
-- Models 页的凭据状态圆点只反映 API Key 引用，OAuth 登录成功后圆点仍可能显示未配置（外观问题，功能不受影响）
-- 自行在 `cordis.patch.yml` patch `llm-pi-ai` 整段 config 会覆盖预置路由
-- `settings.yaml` 的 `llm-pi-ai:` 节只能稀疏覆盖字段，无法删除预置路由本身（移除须卸载本插件）
-- 路由前缀 `/copilot-auth` 两侧硬编码，不可配置
-- DSH rc 版本耦合：实测 `0.1.2-rc.1`，peer 仅 `@deepseek-ai/cordis@^4.0.2`
-- 每次登录成功或插件启动，会用账号最新发现的可用模型**全量覆盖** GitHub Copilot 路由的模型目录——对目录的手工定制（如模型显示名）会在下次同步时被重置为裸模型 id
-- 模型目录只写入 pi-ai 内置目录已描述的模型：目录快照外的新模型暂不写入（catalog 路由的校验要求模型协议可解析），pi-ai 升级目录后会随同步自动出现
-
-## 维护者发布
-
-本项目使用 npm **Trusted Publishing（GitHub Actions OIDC）** 发布，不在仓库或 GitHub Secrets 中保存 `NPM_TOKEN`。
-
-- 发布 workflow：`.github/workflows/release.yml`
-- 触发方式：推送 `v*` tag，或在 GitHub Actions 手动触发
-- npm Trusted Publisher 配置：GitHub Actions；owner `iasiv5`；repository `dsh-copilot-auth`；workflow filename `release.yml`；environment 留空；允许 `npm publish`
-- workflow 使用 GitHub-hosted runner、`id-token: write`，npm CLI 自动使用 OIDC 并生成 provenance
-- npm Trusted Publisher 是按 package 配置的。首次发布前如果 package 尚不存在，需要先完成 npm 要求的一次性 bootstrap，再在 package settings 中配置 Trusted Publisher；bootstrap 不应通过长期 GitHub secret 实现。详见 [npm Trusted Publishing 文档](https://docs.npmjs.com/trusted-publishers)
-
-## License
-
-MIT
+# @inventec/dsh-copilot-auth
+
+[![Release](https://img.shields.io/github/v/release/iasiv5/dsh-copilot-auth?label=Release&sort=semver)](https://github.com/iasiv5/dsh-copilot-auth/releases)
+[![npm](https://img.shields.io/npm/v/%40inventec%2Fdsh-copilot-auth?label=npm)](https://www.npmjs.com/package/@inventec/dsh-copilot-auth)
+[![CI](https://img.shields.io/github/actions/workflow/status/iasiv5/dsh-copilot-auth/ci.yml?branch=main&label=CI)](https://github.com/iasiv5/dsh-copilot-auth/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/iasiv5/dsh-copilot-auth?label=License)](https://github.com/iasiv5/dsh-copilot-auth/blob/main/LICENSE)
+[![DSH Web](https://img.shields.io/badge/DSH%20Web-0.1.2--rc.1%20verified-2563eb)](#前置要求)
+
+为 DSH（DeepSeek Harness）内置的 GitHub Copilot LLM provider 补上 Web 端设备码（device flow）登录/注销入口，并预置一条开箱即用的 GitHub Copilot 提供方路由。
+
+## 这是什么
+
+用公司分配的 GitHub 账号（带 Copilot 订阅）登录 DSH 的方式，和其他 Copilot 客户端一致：**网页 + 设备码**，全程不填 API Token。
+
+本插件**复用 DSH 内置通道**（pi-ai 的 github-copilot provider），不实现任何 GitHub 协议代码——token 自动轮换、模型发现、协议适配全部由内置实现负责。插件本身只做三件事：挂载 DSH 内置但默认未启用的授权服务、提供「登录/注销」设置页、预置 `GitHub Copilot` 路由。
+
+## 特性
+
+- 🔐 **设备码登录/注销**：网页 + user code，免 API Token；SSO 组织授权友好
+- 🧩 **预置提供方路由**：安装即出现在 Models 页，无需手动配置
+- 📦 **模型目录兜底填充**：登录成功时，若 GitHub Copilot 路由还没有模型目录，自动填入账号全部可用模型；你已精简/定制过的目录**永不覆盖**（重启、重新登录均不重置）
+- 🌐 **中/英双语界面**：跟随 DSH 语言设置自动切换
+- 🔑 **凭据安全托管**：存入 DSH 内置凭据库（文件强制 0600 权限），Copilot 临时 token 到期自动刷新
+- 🧪 **测试与 CI**：15 条单元测试；GitHub Actions 构建测试 + tag 触发自动发布（provenance）
+
+## 前置要求
+
+- DSH `0.1.2-rc.1`（实测版本）
+- 有效的 GitHub Copilot 订阅（公司分配的 github.com 组织账号，SSO 登录）
+- `pnpm` 可用（`dsh plugin` 是 pnpm 转发器）
+
+## 安装
+
+```bash
+dsh plugin --profile web add @inventec/dsh-copilot-auth
+```
+
+然后**重启 dsh web 并刷新浏览器**。
+
+### 故障排查
+
+- 企业镜像/私有源环境下 pnpm 解析 peer 失败：`export npm_config_auto_install_peers=false` 后重试（profile 自带的 pnpm workspace 默认已关闭 peer 自动安装）。
+- registry 的 `latest` dist-tag 可能落后于 `next`：显式按版本号安装/排查时勿被 `latest` 误导。
+
+## 登录
+
+1. 打开设置，进入侧栏「**GHC设置**」（英文界面为 *GHC Settings*，位于 Models 之后）
+2. 点「登录」，页面显示一串**代码**（user code，可一键复制）与 `https://github.com/login/device` 链接
+3. 新标签打开链接，用公司 GitHub 账号输入代码
+4. **SSO 用户必须对组织点 Authorize**（授权页会出现该步骤，跳过则登录不生效）
+5. 回到设置页看到「已登录」即成功；首次登录会自动填充模型目录（已定制过的目录不会被覆盖）
+
+> 设备码有时效（约 15 分钟），请拿到代码后尽快完成授权。若超时，页面会显示失败原因，重新点「登录」即可。
+
+## 使用
+
+- Models 页选择 `GitHub Copilot` 路由，模型目录已在首次登录时自动填充账号全部可用模型，无需手动「添加模型」；之后可自由增删精简，重启 / 重新登录都不会重置你的列表
+- **配额说明**：base 模型（GPT-4o/4.1 一类）不耗 premium requests；premium 模型（Claude、Gemini、o 系列等）每次调用消耗月度配额。日常建议 base 档，premium 模型按需手动选
+
+## 注销与卸载
+
+- 注销：设置页「注销」按钮（清除本机凭据记录）
+- 卸载：`dsh plugin --profile web remove @inventec/dsh-copilot-auth` 后重启 dsh web
+
+## 工作原理
+
+- 通过 `cordis.patch.yml` 三段生效：
+  1. 挂载 `@deepseek-ai/dsh-authorization` 服务（DSH 内置 bundle 未挂载，不挂则内置登录流不存在）
+  2. 注册本插件（host 侧在 webserver 上开 4 条本地路由：`/copilot-auth/start|state|status|logout`，跨站 Origin 拒绝）
+  3. 以 settings base 层预置 `github-copilot` 路由（用户 `settings.yaml` 可逐字段覆盖）
+- 登录走 GitHub 设备码流；凭据存 `~/.dsh/.credentials.yaml`（强制 600 权限）的 `llm-pi-ai/github-copilot` 记录，Copilot 临时 token 到期自动刷新
+- **模型目录兜底填充**：登录成功时，取「账号可用模型 ∩ pi-ai 内置目录」写入该路由的模型目录——仅当该路由尚未配置 `models` 且无 `modelOverrides` 时写入；目录已存在（含空列表）一律让路，插件启动/重启也绝不触碰用户 settings。同步失败经 `/copilot-auth/status` 的 `syncError` 字段暴露
+
+## 开发
+
+```bash
+npm install
+npm test        # node:test：patch 结构 + host 行为共 15 条
+npm run build   # esbuild 打包 client 到 lib/client.js（__ModuleLoader__ 信封）
+npm pack --dry-run
+```
+
+| 路径 | 职责 |
+|---|---|
+| `cordis.patch.yml` | 三段 patch（authorization 挂载 / 本插件 entry / 预置路由） |
+| `src/host.mjs` · `src/shared.mjs` | host 半区：登录状态机、4 条本地路由、模型目录同步 |
+| `src/client.jsx` | client 半区：settings.section 插槽 + 设备码交互 + 双语文案 |
+| `scripts/build-client.mjs` | client 打包（`__ModuleLoader__` CJS 工厂信封） |
+| `lib/client.js` | 构建产物（入库，使 git 安装免构建） |
+
+从源码安装：`dsh plugin --profile web add /path/to/dsh-copilot-auth`
+
+## 风险与合规
+
+- 通道为社区通用路线（基于 pi-ai 内部实现），**非 GitHub 官方支持 API**，可能随服务端变更失效
+- GitHub AUP 禁止批量自动化滥用；**公司账号请正常强度使用**
+
+## 已知边界
+
+- Models 页的凭据状态圆点只反映 API Key 引用，OAuth 登录成功后圆点仍可能显示未配置（外观问题，功能不受影响）
+- 自行在 `cordis.patch.yml` patch `llm-pi-ai` 整段 config 会覆盖预置路由
+- `settings.yaml` 的 `llm-pi-ai:` 节只能稀疏覆盖字段，无法删除预置路由本身（移除须卸载本插件）
+- 路由前缀 `/copilot-auth` 两侧硬编码，不可配置
+- DSH rc 版本耦合：实测 `0.1.2-rc.1`，peer 仅 `@deepseek-ai/cordis@^4.0.2`
+- 模型目录只在「尚不存在」时由登录成功兜底填充一次，填充后归用户所有：账号新增的模型不会自动出现，需在 Models 页手动添加，或删掉 `settings.yaml` 里该路由的 `models` 列表后**重新登录**重新填充全量（插件启动不触发填充）
+- 模型目录只写入 pi-ai 内置目录已描述的模型：目录快照外的新模型暂不写入（catalog 路由的校验要求模型协议可解析），pi-ai 升级目录后重新登录即可纳入
+
+## 维护者发布
+
+本项目使用 npm **Trusted Publishing（GitHub Actions OIDC）** 发布，不在仓库或 GitHub Secrets 中保存 `NPM_TOKEN`。
+
+- 发布 workflow：`.github/workflows/release.yml`
+- 触发方式：推送 `v*` tag，或在 GitHub Actions 手动触发
+- npm Trusted Publisher 配置：GitHub Actions；owner `iasiv5`；repository `dsh-copilot-auth`；workflow filename `release.yml`；environment 留空；允许 `npm publish`
+- workflow 使用 GitHub-hosted runner、`id-token: write`，npm CLI 自动使用 OIDC 并生成 provenance
+- npm Trusted Publisher 是按 package 配置的。首次发布前如果 package 尚不存在，需要先完成 npm 要求的一次性 bootstrap，再在 package settings 中配置 Trusted Publisher；bootstrap 不应通过长期 GitHub secret 实现。详见 [npm Trusted Publishing 文档](https://docs.npmjs.com/trusted-publishers)
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -1,20 +1,20 @@
-# 1) 前置：0.1.2-rc.1 的全部 6 个内置 bundle 均未挂载 authorization 服务；
-#    dsh-llm-pi-ai 的登录流注册是被动 ctx.inject（lib/index.js L2501），不挂此行则 flow 不存在。
-- insert:
-    - id: copilot-authorization
-      name: '@deepseek-ai/dsh-authorization'
-    # 2) 本插件 host 半区（web 树有 webServer 服务才会激活）
-    #    路由前缀固定 /copilot-auth、不做配置项：client 侧 fetch 硬编码同一路径，
-    #    配置一旦漂移 client 即 404（见附录 B）
-    - id: copilot-auth
-      name: '@inventec/dsh-copilot-auth'
-# 3) 预置 GitHub Copilot 路由：entry config 作为 settings base 层，
-#    用户 settings.yaml 的 llm-pi-ai: 节逐字段递归覆盖其上。
-#    不写 apiKeyEnv → 认证走 OAuth 凭据记录（llm-pi-ai/github-copilot）。
-#    带 name 做 mismatch 防御：未来 base 若改名，patch 警告而非错挂他行。
-- id: llm-pi-ai
-  name: '@deepseek-ai/dsh-llm-pi-ai'
-  config:
-    providers:
-      github-copilot:
-        displayName: GitHub Copilot
+# 1) 前置：0.1.2-rc.1 的全部 6 个内置 bundle 均未挂载 authorization 服务；
+#    dsh-llm-pi-ai 的登录流注册是被动 ctx.inject（lib/index.js L2501），不挂此行则 flow 不存在。
+- insert:
+    - id: copilot-authorization
+      name: '@deepseek-ai/dsh-authorization'
+    # 2) 本插件 host 半区（web 树有 webServer 服务才会激活）
+    #    路由前缀固定 /copilot-auth、不做配置项：client 侧 fetch 硬编码同一路径，
+    #    配置一旦漂移 client 即 404（见附录 B）
+    - id: copilot-auth
+      name: '@inventec/dsh-copilot-auth'
+# 3) 预置 GitHub Copilot 路由：entry config 作为 settings base 层，
+#    用户 settings.yaml 的 llm-pi-ai: 节逐字段递归覆盖其上。
+#    不写 apiKeyEnv → 认证走 OAuth 凭据记录（llm-pi-ai/github-copilot）。
+#    带 name 做 mismatch 防御：未来 base 若改名，patch 警告而非错挂他行。
+- id: llm-pi-ai
+  name: '@deepseek-ai/dsh-llm-pi-ai'
+  config:
+    providers:
+      github-copilot:
+        displayName: GitHub Copilot

package/package.json

@@ -1,51 +1,55 @@
-{
-  "name": "@inventec/dsh-copilot-auth",
-  "version": "1.0.0",
-  "description": "Device-code sign-in UI and preconfigured route for the built-in GitHub Copilot provider of DeepSeek Harness (DSH)",
-  "type": "module",
-  "license": "MIT",
-  "author": "iasi",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/iasiv5/dsh-copilot-auth.git"
-  },
-  "main": "./src/host.mjs",
-  "exports": {
-    ".": "./src/host.mjs",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "src/host.mjs",
-    "src/shared.mjs",
-    "lib/client.js",
-    "cordis.patch.yml",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node scripts/build-client.mjs",
-    "test": "node --test",
-    "prepack": "npm run build"
-  },
-  "engines": { "node": ">=20" },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
-  },
-  "devDependencies": {
-    "esbuild": "^0.24.0",
-    "react": "^18.2.0",
-    "yaml": "^2.5.0"
-  },
-  "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-api-remotes"
-      ]
-    }
-  }
-}
+{
+  "name": "@inventec/dsh-copilot-auth",
+  "version": "1.0.2",
+  "description": "Device-code sign-in UI and preconfigured route for the built-in GitHub Copilot provider of DeepSeek Harness (DSH)",
+  "type": "module",
+  "license": "MIT",
+  "author": "iasi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iasiv5/dsh-copilot-auth.git"
+  },
+  "main": "./src/host.mjs",
+  "exports": {
+    ".": "./src/host.mjs",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src/host.mjs",
+    "src/shared.mjs",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "test": "node --test",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.0",
+    "react": "^18.2.0",
+    "yaml": "^2.5.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-remotes"
+      ]
+    }
+  }
+}

package/src/host.mjs

@@ -1,185 +1,207 @@
-// host 半区：cordis 插件。注册 4 条 exact 路由，把内置 github-copilot 的
-// OAuth 设备码流（ctx.authorization）暴露给 Web client。零 GitHub 协议代码。
-import { existsSync, readFileSync, realpathSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { CREDENTIAL_KEY, emptyState, routes } from "./shared.mjs";
-
-export const name = "copilot-auth";
-export const inject = ["webServer", "authorization", "credentials", "settings", "llm"];
-
-// 读取 pi-ai 内置目录的 github-copilot 模型 id → 协议映射。数据文件位于 dsh
-// 安装树内的 @earendil-works/pi-ai；从进程入口（dsh 可执行文件）逐级向上定位，
-// 只读不改。定位/解析失败返回 null（调用方回退 listModels 交集，见下）。
-function readCatalogModelIds() {
-  try {
-    let dir = dirname(realpathSync(process.argv?.[1] ?? ""));
-    for (let depth = 0; depth < 8; depth++) {
-      const dataFile = join(dir, "node_modules", "@earendil-works", "pi-ai", "dist", "providers", "data", "github-copilot.json");
-      if (existsSync(dataFile)) {
-        const data = JSON.parse(readFileSync(dataFile, "utf8"));
-        const byId = {};
-        for (const [api, section] of Object.entries(data)) {
-          for (const id of Object.keys(section ?? {})) byId[id] ??= api;
-        }
-        return byId;
-      }
-      const parent = dirname(dir);
-      if (parent === dir) return null;
-      dir = parent;
-    }
-  } catch { /* 安装树结构变化时回退 */ }
-  return null;
-}
-
-// 登录成功（或挂载时已登录）后，把账号可用模型写入用户 settings 的模型目录
-// （turnkey，用户新增需求 2026-09-04）。
-// 可写集合取交集：凭据 payload.availableModelIds（账号可用）∩ 内置目录已描述。
-// 目录快照外的 id 必须排除——catalog 路由校验要求模型的 wire 协议可解析
-// （api = 路由设置 ?? 目录条目 ?? 路由共享协议），目录外 id 三者皆空会被整体
-// 拒绝；pi-ai 目录更新后它们会自然进入可写集合。
-// 注意：每次登录/挂载会用最新列表覆盖该目录，手工定制会被重置。
-async function syncAvailableModels(ctx) {
-  const record = await ctx.credentials.readRecord(CREDENTIAL_KEY);
-  const available = record?.payload?.availableModelIds;
-  if (!Array.isArray(available) || available.length === 0) return;
-  const catalog = readCatalogModelIds();
-  let ids;
-  if (catalog) {
-    ids = available.filter((id) => catalog[id] !== undefined);
-  } else {
-    // 回退：listModels 反映当前已配置列表，存在「已配置→只见已配置」自锁，
-    // 仅作目录定位失败时的降级。
-    const served = new Set((await ctx.llm.listModels("github-copilot")).map((m) => m?.id).filter(Boolean));
-    ids = available.filter((id) => served.has(id));
-  }
-  if (ids.length === 0) return;
-  await ctx.settings.mutate("llm-pi-ai", [
-    { op: "set", path: ["providers", "github-copilot", "models"], value: ids.map((id) => ({ id })) },
-  ]);
-}
-
-function sameOrigin(req) {
-  const origin = req.headers?.origin;
-  if (origin === undefined || origin === null || origin === "") return true;
-  try {
-    return new URL(origin).host === req.headers.host;
-  } catch {
-    return false;
-  }
-}
-
-function json(res, code, payload) {
-  res.writeHead(code, { "content-type": "application/json" });
-  res.end(JSON.stringify(payload));
-}
-
-function guard(req, res, method) {
-  if (!sameOrigin(req)) {
-    json(res, 403, { ok: false, error: "forbidden origin" });
-    return false;
-  }
-  if (req.method !== method) {
-    json(res, 405, { ok: false, error: "method not allowed" });
-    return false;
-  }
-  return true;
-}
-
-export function apply(ctx) {
-  const r = routes();
-  let attempt = emptyState();
-  let lastSyncError;
-
-  // 挂载时若已登录，同步一次模型目录（凭据持久化在本地，模型列表随账号刷新）。
-  // 失败不静默：错误经 /status 的 syncError 字段暴露，便于诊断。
-  const sync = () => syncAvailableModels(ctx).then(() => { lastSyncError = undefined; }).catch((err) => {
-    lastSyncError = String(err?.message ?? err);
-    ctx.logger?.warn?.("copilot-auth: model sync failed: %s", lastSyncError);
-  });
-  void sync();
-
-  ctx.webServer.register({
-    kind: "exact",
-    path: r.start,
-    handler: (req, res) => {
-      if (!guard(req, res, "POST")) return;
-      if (attempt.status === "running") {
-        json(res, 409, { ok: false, error: "already running" });
-        return;
-      }
-      attempt = emptyState();
-      attempt.status = "running";
-      const interaction = {
-        notify: (notice) => {
-          attempt.notices.push(notice);
-        },
-        prompt: (p) => {
-          // 企业域名提问答空串（公司是普通 github.com 组织账号）；
-          // 其余任何 prompt 都是未预期的，拒绝并使 attempt 失败。
-          if (p && typeof p.message === "string" && p.message.includes("Enterprise")) {
-            return Promise.resolve("");
-          }
-          return Promise.reject(new Error("unexpected prompt: " + (p?.message ?? String(p))));
-        },
-      };
-      // 响应先行：begin 以后台任务执行，handler 返回路径不得 await begin。
-      void ctx.authorization
-        .begin({ key: CREDENTIAL_KEY, method: "oauth", interaction })
-        .then((outcome) => {
-          // AuthorizationOutcome.status: 'authorized' | 'cancelled'（types.d.ts L68-71）
-          if (outcome && outcome.status === "authorized") {
-            attempt.status = "authorized";
-            void sync();
-          } else {
-            attempt.status = "failed";
-            attempt.error = "登录已取消";
-          }
-        })
-        .catch((err) => {
-          attempt.status = "failed";
-          attempt.error = String(err?.message ?? err);
-        });
-      json(res, 202, { ok: true });
-    },
-  });
-
-  ctx.webServer.register({
-    kind: "exact",
-    path: r.state,
-    handler: (req, res) => {
-      if (!guard(req, res, "GET")) return;
-      json(res, 200, attempt);
-    },
-  });
-
-  ctx.webServer.register({
-    kind: "exact",
-    path: r.status,
-    handler: async (req, res) => {
-      if (!guard(req, res, "GET")) return;
-      // describeRecord 只回传 presence，不把含 token 的 GrantRecord 拉进内存。
-      let configured = false;
-      try {
-        const info = await ctx.credentials.describeRecord(CREDENTIAL_KEY);
-        configured = info?.configured === true;
-      } catch {
-        configured = false;
-      }
-      json(res, 200, { configured, syncError: lastSyncError });
-    },
-  });
-
-  ctx.webServer.register({
-    kind: "exact",
-    path: r.logout,
-    handler: async (req, res) => {
-      if (!guard(req, res, "POST")) return;
-      // 幂等契约：deleteRecord 对不存在记录是 no-op 且正常 resolve，
-      // 真实删除与否由随后的 /status 反映。
-      await ctx.credentials.deleteRecord(CREDENTIAL_KEY);
-      json(res, 200, { ok: true });
-    },
-  });
-}
-
-export default { name, inject, apply };
+// host 半区：cordis 插件。注册 4 条 exact 路由，把内置 github-copilot 的
+// OAuth 设备码流（ctx.authorization）暴露给 Web client。零 GitHub 协议代码。
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { CREDENTIAL_KEY, emptyState, routes } from "./shared.mjs";
+
+export const name = "copilot-auth";
+export const inject = ["webServer", "authorization", "credentials", "settings", "llm"];
+
+// 读取 pi-ai 内置目录的 github-copilot 模型 id → 协议映射。数据文件位于 dsh
+// 安装树内的 @earendil-works/pi-ai；从进程入口（dsh 可执行文件）逐级向上定位，
+// 只读不改。定位/解析失败返回 null（调用方回退 listModels 交集，见下）。
+function readCatalogModelIds() {
+  try {
+    let dir = dirname(realpathSync(process.argv?.[1] ?? ""));
+    for (let depth = 0; depth < 8; depth++) {
+      const dataFile = join(dir, "node_modules", "@earendil-works", "pi-ai", "dist", "providers", "data", "github-copilot.json");
+      if (existsSync(dataFile)) {
+        const data = JSON.parse(readFileSync(dataFile, "utf8"));
+        const byId = {};
+        for (const [api, section] of Object.entries(data)) {
+          for (const id of Object.keys(section ?? {})) byId[id] ??= api;
+        }
+        return byId;
+      }
+      const parent = dirname(dir);
+      if (parent === dir) return null;
+      dir = parent;
+    }
+  } catch { /* 安装树结构变化时回退 */ }
+  return null;
+}
+
+// 登录成功后，把账号可用模型写入用户 settings 的模型目录
+// （turnkey，用户新增需求 2026-09-04；目录保护，用户反馈 2026-09-05）。
+// 可写集合取交集：凭据 payload.availableModelIds（账号可用）∩ 内置目录已描述。
+// 目录快照外的 id 必须排除——catalog 路由校验要求模型的 wire 协议可解析
+// （api = 路由设置 ?? 目录条目 ?? 路由共享协议），目录外 id 三者皆空会被整体
+// 拒绝；pi-ai 目录更新后它们会自然进入可写集合。
+// 目录保护（2026-09-05）：该路由已配置模型目录（models 键存在，含空列表）或
+// modelOverrides 时视作用户所有，同步直接让路——用户在 Models 页精简过的目录
+// 不会被重置。只有目录尚不存在时才填充一次；想重置全量，删掉 settings.yaml
+// 里该路由的 models 列表后重新登录即可。
+
+// 读取解析后的 github-copilot 路由配置（base 层 + 用户层的最终值）。
+// settings 未注入 / 未注册 / 读取失败一律按空处理——回退到可写入分支，
+// 保持既有 turnkey 行为不变。
+function readConfiguredRoute(ctx) {
+  try {
+    const section = ctx.settings?.get?.("llm-pi-ai");
+    return section?.providers?.["github-copilot"] ?? {};
+  } catch {
+    return {};
+  }
+}
+
+async function syncAvailableModels(ctx) {
+  const record = await ctx.credentials.readRecord(CREDENTIAL_KEY);
+  const available = record?.payload?.availableModelIds;
+  if (!Array.isArray(available) || available.length === 0) return;
+  const route = readConfiguredRoute(ctx);
+  const modelsConfigured = route.models !== undefined && route.models !== null;
+  const overridesConfigured = !!route.modelOverrides
+    && typeof route.modelOverrides === "object"
+    && Object.keys(route.modelOverrides).length > 0;
+  if (modelsConfigured || overridesConfigured) return;
+  const catalog = readCatalogModelIds();
+  let ids;
+  if (catalog) {
+    ids = available.filter((id) => catalog[id] !== undefined);
+  } else {
+    // 回退：listModels 反映当前已配置列表，存在「已配置→只见已配置」自锁，
+    // 仅作目录定位失败时的降级。
+    const served = new Set((await ctx.llm.listModels("github-copilot")).map((m) => m?.id).filter(Boolean));
+    ids = available.filter((id) => served.has(id));
+  }
+  if (ids.length === 0) return;
+  await ctx.settings.mutate("llm-pi-ai", [
+    { op: "set", path: ["providers", "github-copilot", "models"], value: ids.map((id) => ({ id })) },
+  ]);
+}
+
+function sameOrigin(req) {
+  const origin = req.headers?.origin;
+  if (origin === undefined || origin === null || origin === "") return true;
+  try {
+    return new URL(origin).host === req.headers.host;
+  } catch {
+    return false;
+  }
+}
+
+function json(res, code, payload) {
+  res.writeHead(code, { "content-type": "application/json" });
+  res.end(JSON.stringify(payload));
+}
+
+function guard(req, res, method) {
+  if (!sameOrigin(req)) {
+    json(res, 403, { ok: false, error: "forbidden origin" });
+    return false;
+  }
+  if (req.method !== method) {
+    json(res, 405, { ok: false, error: "method not allowed" });
+    return false;
+  }
+  return true;
+}
+
+export function apply(ctx) {
+  const r = routes();
+  let attempt = emptyState();
+  let lastSyncError;
+
+  // 模型目录同步只在登录成功后执行（2026-09-05 对齐结论：挂载不再同步）。
+  // 插件启动/重启绝不触碰用户 settings，用户精简过的目录不会被动重置。
+  // 失败不静默：错误经 /status 的 syncError 字段暴露，便于诊断。
+  const sync = () => syncAvailableModels(ctx).then(() => { lastSyncError = undefined; }).catch((err) => {
+    lastSyncError = String(err?.message ?? err);
+    ctx.logger?.warn?.("copilot-auth: model sync failed: %s", lastSyncError);
+  });
+
+  ctx.webServer.register({
+    kind: "exact",
+    path: r.start,
+    handler: (req, res) => {
+      if (!guard(req, res, "POST")) return;
+      if (attempt.status === "running") {
+        json(res, 409, { ok: false, error: "already running" });
+        return;
+      }
+      attempt = emptyState();
+      attempt.status = "running";
+      const interaction = {
+        notify: (notice) => {
+          attempt.notices.push(notice);
+        },
+        prompt: (p) => {
+          // 企业域名提问答空串（公司是普通 github.com 组织账号）；
+          // 其余任何 prompt 都是未预期的，拒绝并使 attempt 失败。
+          if (p && typeof p.message === "string" && p.message.includes("Enterprise")) {
+            return Promise.resolve("");
+          }
+          return Promise.reject(new Error("unexpected prompt: " + (p?.message ?? String(p))));
+        },
+      };
+      // 响应先行：begin 以后台任务执行，handler 返回路径不得 await begin。
+      void ctx.authorization
+        .begin({ key: CREDENTIAL_KEY, method: "oauth", interaction })
+        .then((outcome) => {
+          // AuthorizationOutcome.status: 'authorized' | 'cancelled'（types.d.ts L68-71）
+          if (outcome && outcome.status === "authorized") {
+            attempt.status = "authorized";
+            void sync();
+          } else {
+            attempt.status = "failed";
+            attempt.error = "登录已取消";
+          }
+        })
+        .catch((err) => {
+          attempt.status = "failed";
+          attempt.error = String(err?.message ?? err);
+        });
+      json(res, 202, { ok: true });
+    },
+  });
+
+  ctx.webServer.register({
+    kind: "exact",
+    path: r.state,
+    handler: (req, res) => {
+      if (!guard(req, res, "GET")) return;
+      json(res, 200, attempt);
+    },
+  });
+
+  ctx.webServer.register({
+    kind: "exact",
+    path: r.status,
+    handler: async (req, res) => {
+      if (!guard(req, res, "GET")) return;
+      // describeRecord 只回传 presence，不把含 token 的 GrantRecord 拉进内存。
+      let configured = false;
+      try {
+        const info = await ctx.credentials.describeRecord(CREDENTIAL_KEY);
+        configured = info?.configured === true;
+      } catch {
+        configured = false;
+      }
+      json(res, 200, { configured, syncError: lastSyncError });
+    },
+  });
+
+  ctx.webServer.register({
+    kind: "exact",
+    path: r.logout,
+    handler: async (req, res) => {
+      if (!guard(req, res, "POST")) return;
+      // 幂等契约：deleteRecord 对不存在记录是 no-op 且正常 resolve，
+      // 真实删除与否由随后的 /status 反映。
+      await ctx.credentials.deleteRecord(CREDENTIAL_KEY);
+      json(res, 200, { ok: true });
+    },
+  });
+}
+
+export default { name, inject, apply };

package/src/shared.mjs

@@ -1,11 +1,11 @@
-// 两半区共享的 HTTP API 契约。路由前缀固定、不做配置项：
-// client 侧 fetch 硬编码同一路径，配置一旦漂移 client 即 404（见计划附录 B）。
-export const CREDENTIAL_KEY = "llm-pi-ai/github-copilot";
-export const ROUTE_PREFIX = "/copilot-auth";
-export const routes = () => ({
-  start: `${ROUTE_PREFIX}/start`,
-  state: `${ROUTE_PREFIX}/state`,
-  status: `${ROUTE_PREFIX}/status`,
-  logout: `${ROUTE_PREFIX}/logout`,
-});
-export const emptyState = () => ({ status: "idle", notices: [], error: undefined });
+// 两半区共享的 HTTP API 契约。路由前缀固定、不做配置项：
+// client 侧 fetch 硬编码同一路径，配置一旦漂移 client 即 404（见计划附录 B）。
+export const CREDENTIAL_KEY = "llm-pi-ai/github-copilot";
+export const ROUTE_PREFIX = "/copilot-auth";
+export const routes = () => ({
+  start: `${ROUTE_PREFIX}/start`,
+  state: `${ROUTE_PREFIX}/state`,
+  status: `${ROUTE_PREFIX}/status`,
+  logout: `${ROUTE_PREFIX}/logout`,
+});
+export const emptyState = () => ({ status: "idle", notices: [], error: undefined });