dsh-cmtoken-oauth 1.5.2 → 1.5.3

package/README.md

@@ -69,6 +69,21 @@ lib/client.js   web：设置页「cmtoken 认证」向导（视觉模型标 👁
 lib/qr-core.cjs 内联 QR 编码器（输出 SVG）
 ```
 
+## 变更记录
+
+### 1.5.3（2026-09-11）
+
+- 修复 DSH 0.1.5+（desktop 0.1.5-rc.1 起）下插件树加载失败：
+  `cannot get property "webServer" without inject`。
+- 根因：新版 `connection.rpc.handle(channel, handler)` 在注册时执行
+  `owner.webServer.register(route)`，而 `owner` 恒为 connection 插件自身的 ctx
+  （其 inject 只有 `credentials`），第三方插件调用必然抛错。
+- 改法：在 `ctx.inject(['webServer'])` 子上下文用
+  `ctx.webServer.register({ kind: 'prefix', path: '/cmtoken-oauth', handler })`
+  自注册 RPC 前缀路由，并沿用 connection 的
+  `client-request` / `server-response` 信封协议，客户端代码无需改动；
+  另加 loopback 来源校验。
+
 ## License
 
 MIT

package/lib/index.js

@@ -218,8 +218,81 @@ function errorResult(e) {
   return { ok: false, error: { code: 'bad-request', message, details: {} } };
 }
 
+/**
+ * DSH 0.1.5+ 兼容的 RPC 传输层。
+ *
+ * 旧版通过 `ctx.connection.rpc.handle(channel, handler)` 注册通道；新版
+ * connection 服务把路由挂到「调用方 fiber」的 webServer 上
+ * （dsh-client-connection/lib/index.js `owner.webServer.register(route)`），
+ * 而 owner 恒为 connection 插件自身的 ctx（其 inject 只有 credentials），
+ * 因此第三方插件调用必然抛 `cannot get property "webServer" without inject`。
+ *
+ * 改为在声明了 webServer 的子上下文里自注册一条 prefix 路由，并沿用
+ * connection 的 RPC 信封协议（client-request / server-response），
+ * 客户端代码无需改动。
+ */
+function registerHttpRpc(ctx, channel, dispatch) {
+  const webServer = ctx.get?.('webServer') ?? ctx.webServer;
+  if (webServer === undefined || typeof webServer.register !== 'function') {
+    ctx.logger?.warn?.(`[cmtoken-oauth] webServer 服务不可用，${channel} 通道未注册`);
+    return () => {};
+  }
+  const isLoopback = (req) => {
+    const addr = req.socket?.remoteAddress ?? '';
+    return addr === '127.0.0.1' || addr === '::1' || addr === '::ffff:127.0.0.1';
+  };
+  return webServer.register({
+    name: 'cmtoken-oauth-rpc',
+    kind: 'prefix',
+    path: channel,
+    handler: async (req, res) => {
+      const reply = (status, payload) => {
+        res.writeHead(status, { 'content-type': 'application/json' });
+        res.end(payload === undefined ? '' : JSON.stringify(payload));
+      };
+      if (req.method !== 'POST' || !isLoopback(req)) return reply(404);
+      let endpoint;
+      try {
+        const pathname = new URL(req.url ?? '/', 'http://dsh.internal').pathname;
+        if (!pathname.startsWith(channel + '/')) return reply(404);
+        endpoint = decodeURIComponent(pathname.slice(channel.length + 1));
+      } catch {
+        return reply(400);
+      }
+      if (endpoint === '' || endpoint.includes('/')) return reply(404);
+
+      const abort = new AbortController();
+      res.on('close', () => { if (!res.writableEnded) abort.abort(); });
+      const chunks = [];
+      try {
+        for await (const chunk of req) chunks.push(chunk);
+      } catch {
+        return reply(400);
+      }
+      let envelope;
+      try {
+        envelope = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+      } catch {
+        return reply(400);
+      }
+      const rpcId = typeof envelope?.rpcId === 'string' ? envelope.rpcId : 'unknown';
+      const method = typeof envelope?.method === 'string' ? envelope.method : endpoint;
+      let result;
+      try {
+        result = await dispatch(method, envelope?.payload, abort.signal);
+      } catch (e) {
+        result = errorResult(e);
+      }
+      if (result === null || typeof result !== 'object' || typeof result.ok !== 'boolean') {
+        result = { ok: true, value: result ?? {} };
+      }
+      reply(200, { type: 'server-response', rpcId, result });
+    },
+  });
+}
+
 function registerRpc(ctx) {
-  return ctx.connection.rpc.handle('/cmtoken-oauth', async (endpoint, rawPayload, signal) => {
+  return registerHttpRpc(ctx, '/cmtoken-oauth', async (endpoint, rawPayload, signal) => {
     try {
       if (signal?.aborted) throw new Error('请求已取消。');
       const payload = (rawPayload && typeof rawPayload === 'object') ? rawPayload : {};
@@ -347,7 +420,7 @@ function registerRpc(ctx) {
     } catch (e) {
       return errorResult(e);
     }
-  }, { authority: 'loopback' });
+  });
 }
 
 async function writeConfigAndCreds(ctx, token, models) {
@@ -609,7 +682,7 @@ function registerVisionTool(ctx) {
   const tool = {
     name: VISION_TOOL_NAME,
     description:
-      '通过 cmtoken 视觉模型读取图片，仅作为纯文本模型的视觉补足：当前模型原生支持识图（input 声明含 image 或可用 read_image）时不要调用本工具，直接看图即可。当对话中出现当前模型无法查看的图片时使用，典型形态是 [Image: <本地路径>] 行（粘贴/拖入的图片由插件自动落盘）或裸的本地绝对路径、http(s) URL：截图、照片、图表、扫描件等。返回结构化取证结果（summary、ocr_full_text、layout、semantics、uncertainty），请引用证据而不是猜测。需要已完成 cmtoken 一键认证。',
+      '通过 cmtoken 视觉模型读取图片。当对话中出现当前模型无法查看的图片时使用，典型形态是 [Image: <本地路径>] 行（粘贴/拖入的图片由插件自动落盘）或裸的本地绝对路径、http(s) URL：截图、照片、图表、扫描件等。返回结构化取证结果（summary、ocr_full_text、layout、semantics、uncertainty），请引用证据而不是猜测。需要已完成 cmtoken 一键认证。',
     parameters: {
       type: 'object',
       properties: {
@@ -825,16 +898,13 @@ function modelLabelToName(label) {
   return s.replace(/\s*\(视觉回退\)\s*$/i, '').trim();
 }
 
-/** 在已认证模型列表里查找（id 或显示名）。只做「相等」匹配（忽略大小写与分隔符），
- * 绝不做子串包含——否则其他 provider 的同名系模型（如 zai-coding-cn 的
- * glm-5.3-flash 包含 cmtoken 组 "glm-5" 的字样）会被误判为 cmtoken 模型而遭到
- * 拖图接管，违背「本插件只服务 cmtoken 提供方」的设计边界；找不到返回 undefined。 */
+/** 在已认证模型列表里查找（id 或显示名，忽略大小写；兜底子串匹配）；找不到返回 undefined。 */
 function findConfiguredModel(ctx, name) {
   if (!name) return undefined;
   const models = ctx.settings?.get?.(settingsNamespace('llm-pi-ai'))?.providers?.cmtoken?.models ?? [];
-  const norm = (s) => String(s ?? '').toLowerCase().replace(/[-_\s.]+/g, '');
-  const target = norm(name);
-  return models.find((m) => norm(m.id) === target || norm(m.name) === target);
+  const lower = String(name).toLowerCase();
+  return models.find((m) => String(m.id).toLowerCase() === lower || String(m.name ?? '').toLowerCase() === lower)
+    ?? models.find((m) => lower.includes(String(m.id).toLowerCase()) || lower.includes(String(m.name ?? '').toLowerCase()));
 }
 
 // ---------------- 视觉回退模型选择（~/.dsh/cmtoken-oauth.json） ----------------
@@ -1082,8 +1152,12 @@ export function apply(ctx, cfg = {}) {
   let removeRpc = () => {};
   let stopTimer = () => {};
   let disposeVisionAdapter = () => {};
+  // 在声明了 webServer 的子上下文里注册 RPC 前缀路由（DSH 0.1.5+）。
+  const rpcScope = ctx.inject(['webServer'], (scope) => {
+    removeRpc = registerRpc(scope);
+  });
+  void rpcScope;
   ctx.effect(() => {
-    removeRpc = registerRpc(ctx);
     stopTimer = startAutoRefresh(ctx);
     registerVisionTool(ctx);
     registerPasteRoute(ctx);
@@ -1102,3 +1176,6 @@ export function apply(ctx, cfg = {}) {
   }, 'cmtoken-oauth: host service');
   ctx.logger?.info?.('[cmtoken-oauth] host 服务已启动（自动刷新已开启：启动即补刷 + 每 1 分钟检查 + status 查询按需触发，剩余 <1 小时或已过期即刷新）');
 }
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cmtoken-oauth",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "DeepSeek Harness 插件：在 DSH 设置页一键完成广东移动 MaaS（cmtoken）的 OAuth 2.0 Device Grant + PKCE 认证，自动发现模型并写入 llm-pi-ai provider 配置（视觉模型自动声明图片输入模态）；粘贴识图让纯文本模型直接收图（Qwen3.8 / Qwen3.x / Kimi K2.x / MiniMax M3 自动识读），另有 cmtoken_read_image 工具与可选的 cmtoken-vision 包装路由；凭据安全保存并自动续期。零第三方运行时依赖。",
   "type": "module",
   "main": "./lib/index.js",