dsh-cmtoken-oauth 1.0.1 → 1.0.3

package/README.md

@@ -1,51 +1,59 @@
-# cmtoken 一键认证（DeepSeek Harness 插件）
+# dsh-cmtoken-oauth
 
-在 **DeepSeek Harness 设置**里一键认证广东移动 MaaS（cmtoken），自动发现模型并接入 DSH：
+DeepSeek Harness（DSH）插件：在 **DSH 设置页**内一键认证广东移动 MaaS（cmtoken），自动发现并接入模型，无需手动填写 API Key 或模型列表。
 
-- 🔑 **一键认证**：标准 OAuth 2.0 Device Grant (RFC 8628) + PKCE (S256)，扫码即完成
-- 📷 **二维码**：内联 QR 编码器（零依赖）生成 SVG 二维码
-- 🔄 **自动发现模型**：认证后拉取可用模型列表写入 provider 配置
-- 🗝 **安全存储**：token 存 DSH 凭据服务（OS keyring / env），不落盘明文
-- 🔁 **刷新 / 注销**：令牌过期可一键刷新，可随时注销
+## 功能
 
-零第三方运行时依赖（仅 Node 内置模块）。
+- **一键认证**：基于 OAuth 2.0 Device Authorization Grant（RFC 8628）+ PKCE (S256)，扫码或输入用户码即可完成，无需配置脚本。
+- **内联二维码**：认证流程内置 QR 生成（零依赖），无需额外安装二维码工具。
+- **自动发现模型**：认证成功后自动拉取可用模型列表，写入 `llm-pi-ai` 的 `providers.cmtoken` 配置（merge，不影响其他 provider）。
+- **安全存储**：token 存入 DSH 凭据服务（OS keyring / env），不落盘明文。
+- **自动续期 / 注销**：令牌临近过期自动 refresh；可随时注销清空凭据。
 
----
+零第三方运行时依赖（仅使用 Node 内置模块）。
 
-## 安装（分享给别人）
+## 安装
+
+在 DSH profile 目录（默认 `~/.dsh/profiles/web`）执行：
 
 ```bash
-# 在 DSH profile 目录（默认 ~/.dsh/profiles/web）执行
-dsh plugin --profile web add github:你的用户名/dsh-cmtoken-oauth
-# 或 npm：
+# npm 安装
 dsh plugin --profile web add dsh-cmtoken-oauth
+
+# 或从 GitHub 仓库安装（若已发布到 GitHub）
+dsh plugin --profile web add github:your-username/dsh-cmtoken-oauth
 ```
 
-`dsh plugin add` 会自动加入 profile 的 `dsh.profile.bundles`，重启 `dsh web` 生效。
+`dsh plugin add` 会自动：
+1. 安装依赖；
+2. 根据 `dsh.bundle.patch` 声明，自动加入 profile 的 `dsh.profile.bundles`；
+3. 重启 `dsh web` 后生效。
 
 ## 使用
 
-1. 打开 DSH Web → 设置（左下角齿轮）→ 左侧导航点「**cmtoken 认证**」。
-2. 点「开始一键认证」→ 用手机扫描二维码（或打开链接输入用户码）→ 在中国移动 IDaaS 页确认授权。
-3. 自动完成：发现模型 → 写入 `llm-pi-ai.providers.cmtoken` → 存凭据。
-4. 在 DSH 模型选择器里选用 cmtoken 模型即可。
+1. 打开 DSH Web → 设置（左下角齿轮）→ 左侧导航选择「**cmtoken 认证**」。
+2. 点击「开始一键认证」→ 用手机扫描二维码（或打开链接输入用户码），在广东移动 IDaaS 页面确认授权。
+3. 插件自动完成：发现模型 → 写入 `llm-pi-ai.providers.cmtoken` → 保存凭据。
+4. 在 DSH 的模型选择器中选择 cmtoken 模型即可使用。
 
-## 技术说明
+## 数据与配置
 
-- 协议端点（分析自 cmtoken@1.0.7）：
-  - 授权服务器 `https://agentlink.idaas.cmpassport.com/oauth2-service`
-  - 设备码 `POST /oauth/device/code`、令牌 `POST /oauth/device/token`
-  - 模型发现 `GET https://maas.gd.chinamobile.com:36007/ai/uifm/open/v1/models`
-- 凭据引用：`CMTOKEN_API_KEY` / `CMTOKEN_REFRESH_TOKEN` / `CMTOKEN_EXPIRES`
-- 写配置：`llm-pi-ai` 设置 namespace 的 `providers.cmtoken`（merge，不覆盖其他 provider）
+| 项目 | 说明 |
+|---|---|
+| 授权服务器 | `https://agentlink.idaas.cmpassport.com/oauth2-service` |
+| 设备码 / 令牌端点 | `POST /oauth/device/code`、`POST /oauth/device/token` |
+| 模型发现端点 | `GET https://maas.gd.chinamobile.com:36007/ai/uifm/open/v1/models` |
+| 凭据引用 | `CMTOKEN_API_KEY` / `CMTOKEN_REFRESH_TOKEN` / `CMTOKEN_EXPIRES` |
+| 写配置 | `llm-pi-ai` 设置 namespace 的 `providers.cmtoken`（merge，不覆盖其他 provider） |
 
 ## 开发
 
-```bash
-lib/index.js    # host：OAuth 核心（PKCE/设备码/轮询/刷新/模型发现）+ RPC
-lib/client.js   # web：设置页「cmtoken 认证」向导（二维码+轮询+完成）
-lib/qr-core.cjs # 内联 QR 编码器（提取自 qrcode-terminal，输出 SVG）
+```text
+lib/index.js    host：OAuth 核心（PKCE / 设备码 / 轮询 / 刷新 / 模型发现）+ RPC
+lib/client.js   web：设置页「cmtoken 认证」向导（二维码 + 轮询 + 完成）
+lib/qr-core.cjs 内联 QR 编码器（输出 SVG）
 ```
 
 ## License
+
 MIT

package/lib/index.js

@@ -339,10 +339,13 @@ export function apply(ctx, cfg = {}) {
   ctx.effect(() => {
     removeRpc = registerRpc(ctx);
     stopTimer = startAutoRefresh(ctx);
+    // 启动时立即补刷一次：若停机期间 access 过期、但 refresh 仍有效，马上恢复，
+    // 不必等 60 秒定时器；失败只记日志，不影响启动。
+    void autoRefresh(ctx).catch((e) => ctx.logger?.warn?.('[cmtoken-oauth] 启动补刷失败: ' + String(e?.message || e)));
     return () => {
       removeRpc();
       stopTimer();
     };
   }, 'cmtoken-oauth: host service');
-  ctx.logger?.info?.('[cmtoken-oauth] host 服务已启动（自动刷新已开启：每 1 分钟检查 + status 查询按需触发，剩余 <1 小时或已过期即刷新）');
+  ctx.logger?.info?.('[cmtoken-oauth] host 服务已启动（自动刷新已开启：启动即补刷 + 每 1 分钟检查 + status 查询按需触发，剩余 <1 小时或已过期即刷新）');
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-cmtoken-oauth",
-  "version": "1.0.1",
-  "description": "cmtoken 一键认证 — 通过 OAuth 2.0 Device Grant (RFC 8628) + PKCE 一键认证广东移动 MaaS（cmtoken），自动发现模型并写入 DSH 的 llm-pi-ai provider 配置。零第三方运行时依赖。",
+  "version": "1.0.3",
+  "description": "DeepSeek Harness 插件：在 DSH 设置页一键完成广东移动 MaaS（cmtoken）的 OAuth 2.0 Device Grant + PKCE 认证，自动发现模型并写入 llm-pi-ai provider 配置，凭据安全保存并自动续期。零第三方运行时依赖。",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/types/index.d.ts",