@lotaber_wang/openclaw-dc-plugin 0.1.14 → 0.1.16

package/README.md

@@ -9,7 +9,7 @@
 请这样安装：
 
 ```bash
-openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.14
+openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.16
 ```
 
 不要这样安装：
@@ -67,7 +67,7 @@ openclaw gateway restart
 ## 推荐安装流程
 
 ```bash
-openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.14
+openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.16
 openclaw plugins inspect openclaw-dc-plugin
 echo 'TapTap DC 插件已安装完成。OpenClaw 接下来如需重启 Gateway，应先通过飞书或其他通信插件通知用户；重启完成后即可使用 taptap_dc_* 工具。'
 openclaw gateway restart
@@ -77,7 +77,7 @@ openclaw gateway restart
 
 - `install` 负责把插件包装进 OpenClaw
 - `inspect` 用来确认插件元信息、skills、tools 是否已被 Gateway 识别
-- 从 `0.1.14` 开始，插件包不再声明 `openclaw` 的 `peerDependencies`，避免误用 `npm install` 时把 OpenClaw 宿主大依赖树一起拉下来
+- 从 `0.1.16` 开始，插件包不再声明 `openclaw` 的 `peerDependencies`，避免误用 `npm install` 时把 OpenClaw 宿主大依赖树一起拉下来
 - 如果有人误用 `npm install` 或 `npm install -g`，插件包会在 `postinstall` 阶段打印醒目的纠正提示
 - 如果宿主判断需要重启 Gateway，必须先通过飞书或其他通信插件通知用户，再重启
 - 如果 10-30 秒后还没生效，再手动执行 `gateway restart`
@@ -147,7 +147,7 @@ openclaw gateway restart
 
 如果安装后看不到 `taptap_dc_*` 工具，优先按这个顺序排查：
 
-1. 确认安装的是 `@lotaber_wang/openclaw-dc-plugin@0.1.14` 或更新版本
+1. 确认安装的是 `@lotaber_wang/openclaw-dc-plugin@0.1.16` 或更新版本
 2. 执行 `openclaw plugins inspect openclaw-dc-plugin`
 3. 如果宿主要求重启 Gateway，先通过飞书或其他通信插件向用户发送安装完成提示
 4. 再执行 `openclaw gateway restart`
@@ -175,7 +175,7 @@ openclaw gateway restart
 - OpenClaw 进程是否有临时目录写权限
 - OpenClaw 是否已经完成 Gateway 重启
 
-从 `0.1.14` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
+从 `0.1.16` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
 
 - 在 `package.json` 中补充 `openclaw.install.npmSpec`，让安装链路更稳定
 - 在 `package.json` 的 `openclaw.install` 中补充 `preferredCommand` / `doNotUseCommands` / `wrongInstallHint`
@@ -194,3 +194,5 @@ openclaw gateway restart
 - 如果拿到的是半截 JSON，会先继续等待后续分片，而不是立刻按失败处理
 - 过滤 PTY 场景下被回显到 stdout 的请求消息
 - 授权结果会把裸授权直链放在最前面，并在 `details.preferred_auth_url` / `details.auth_links` 中重复返回，降低宿主偶发吞链路时的影响
+- 如果原始 tool 调用直接抛出“缺少认证信息”错误，bridge 也会从错误文本里提取 `wrapped_auth_url`，并补出 `preferred_auth_url`、手机端点击链接，以及“从 code 参数 decodeURIComponent 得到直链”的解析提示
+- 从这版开始，授权提示会同时保留 `desktop_scan_url` 和 `mobile_click_url`；只要发生转发就默认保留这两条，因为飞书消息也可能在 PC 端打开。同时明确要求在飞书等 IM 中优先使用 markdown 链接格式，避免 `_` 等字符导致裸链接被截断

package/index.js

@@ -5,7 +5,7 @@ import { TapTapMcpBridge } from './lib/mcp-bridge.js';
 const RESTART_NOTICE =
   'TapTap DC 插件已安装完成。OpenClaw 接下来如需重启 Gateway，应先通过飞书或其他通信插件通知用户；重启完成后即可使用 taptap_dc_* 工具。';
 const PREFERRED_INSTALL_COMMAND =
-  'openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.14';
+  'openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.16';
 const WRONG_INSTALL_HINT =
   '这是 OpenClaw 插件包，不是普通 npm CLI 包。请不要直接用 npm install，改用 openclaw plugins install。';
 
@@ -74,6 +74,14 @@ function buildMarkdownLink(label, url) {
   return `[${label}](${url})`;
 }
 
+function buildAutolink(url) {
+  if (!url) {
+    return '-';
+  }
+
+  return `<${url}>`;
+}
+
 function tryParseUrl(value) {
   if (!value || typeof value !== 'string') {
     return null;
@@ -100,6 +108,38 @@ function decodeWrappedAuthUrl(value) {
   }
 }
 
+function extractUrlsFromText(value) {
+  if (!value || typeof value !== 'string') {
+    return [];
+  }
+
+  const matches = value.match(/https?:\/\/[^\s"'<>]+/g) || [];
+  return matches.map((item) => item.replace(/[),.;]+$/g, ''));
+}
+
+function buildAuthLinkParseHint(wrappedAuthUrl, directAuthUrl, preferredAuthUrl) {
+  const desktopScanUrl = wrappedAuthUrl || null;
+  const mobileClickUrl = preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null;
+  return {
+    desktop_scan_url: desktopScanUrl,
+    mobile_click_url: mobileClickUrl,
+    wrapped_auth_url: wrappedAuthUrl || null,
+    direct_auth_url: directAuthUrl || null,
+    desktop_scan_markdown: desktopScanUrl ? buildMarkdownLink('PC 扫码授权页', desktopScanUrl) : null,
+    mobile_click_markdown: mobileClickUrl
+      ? buildMarkdownLink('手机直接授权', mobileClickUrl)
+      : null,
+    parse_rule:
+      wrappedAuthUrl && directAuthUrl
+        ? '如果只有 wrapped_auth_url，请读取其中的 code 参数，并执行一次 decodeURIComponent(code)，得到 direct_auth_url。手机端优先打开 direct_auth_url。'
+        : '如果当前是手机端会话，请优先展示 preferred_auth_url；如果宿主吞掉超链接，就直接输出这条裸 URL。',
+    display_rule:
+      '如果需要转发给用户，默认同时保留 desktop_scan_url 和 mobile_click_url 两条链接；即使是飞书消息也这样处理，因为飞书可能在 PC 端打开。手机端对话时可以额外再单独发一次 mobile_click_url。',
+    lark_render_rule:
+      '飞书或其他 IM 中，转发时默认同时给出 [PC 扫码授权页](desktop_scan_url) 与 [手机直接授权](mobile_click_url) 两条 markdown 链接；如果 markdown 被吞掉，再分别单独发送两行 <URL>。',
+  };
+}
+
 function enrichAuthPayload(authPayload) {
   if (!authPayload || typeof authPayload !== 'object') {
     return authPayload;
@@ -154,6 +194,11 @@ function enrichAuthPayload(authPayload) {
     authorization_url: preferredAuthUrl,
     mobile_auth_url: preferredAuthUrl,
     auth_links: authLinks,
+    auth_link_parse_hint: buildAuthLinkParseHint(
+      wrappedAuthUrl,
+      directAuthUrl,
+      preferredAuthUrl
+    ),
     next_action:
       '优先打开 preferred_auth_url 完成授权；完成后调用 taptap_dc_complete_authorization。',
   };
@@ -317,30 +362,33 @@ function buildAuthGuideText(authPayload) {
   const directAuthUrl = enriched?.direct_auth_url;
   const wrappedAuthUrl = enriched?.wrapped_auth_url;
   const qrcodeUrl = enriched?.qrcode_url;
+  const desktopScanUrl = wrappedAuthUrl || qrcodeUrl || null;
+  const mobileClickUrl = preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null;
   const lines = ['当前还没有完成 TapTap 授权，请先完成一次授权。'];
 
-  if (preferredAuthUrl) {
+  if (desktopScanUrl) {
     lines.push(
       '',
-      '优先打开下面这条授权直链。这一行会同时保留裸链接，方便手机端直接点击，或在宿主吞掉超链接时复制打开：',
-      preferredAuthUrl,
-      `<${preferredAuthUrl}>`
+      'PC / 桌面端请保留下面这条扫码授权页链接，避免宿主只保留手机直链后导致电脑端链路断掉：',
+      buildMarkdownLink('PC 扫码授权页', desktopScanUrl),
+      buildAutolink(desktopScanUrl)
     );
   }
 
-  if (preferredAuthUrl || directAuthUrl || wrappedAuthUrl || qrcodeUrl) {
+  if (mobileClickUrl) {
     lines.push(
       '',
-      '可点击版本：',
-      `- ${buildMarkdownLink('直接点击授权', preferredAuthUrl || directAuthUrl)}`,
-      `- ${buildMarkdownLink('打开 TapTap 包装授权页', wrappedAuthUrl)}`,
-      `- ${buildMarkdownLink('打开授权页直链', qrcodeUrl || directAuthUrl || preferredAuthUrl)}`
+      '手机端请额外再给用户一条可直接点击的授权链接：',
+      buildMarkdownLink('手机直接授权', mobileClickUrl),
+      buildAutolink(mobileClickUrl)
     );
   }
 
   lines.push(
     '',
-    '如果你在手机上对话，优先直接点上面的第一条裸链接；如果超链接显示异常，优先使用 details.preferred_auth_url。',
+    '如果需要把授权信息转发给用户，请默认同时保留“PC 扫码授权页”和“手机直接授权”两条链接，因为飞书消息也可能在 PC 端打开。',
+    '如果你当前就是手机端对话，可以额外强调“手机直接授权”；但不要把 PC 扫码授权页删掉。',
+    '如果超链接显示异常，优先使用 markdown 链接；如果 markdown 仍被吞掉，再单独输出一行 `<URL>`。',
     '完成授权后，请继续调用 `taptap_dc_complete_authorization`，然后再次调用 `taptap_dc_quick_brief`。'
   );
 
@@ -352,6 +400,14 @@ function buildAuthGuideText(authPayload) {
     lines.push('', `preferred_auth_url：${preferredAuthUrl}`);
   }
 
+  if (desktopScanUrl) {
+    lines.push(`desktop_scan_url：${desktopScanUrl}`);
+  }
+
+  if (mobileClickUrl) {
+    lines.push(`mobile_click_url：${mobileClickUrl}`);
+  }
+
   if (directAuthUrl && directAuthUrl !== preferredAuthUrl) {
     lines.push('', `直接授权链接：${directAuthUrl}`);
   }
@@ -364,9 +420,81 @@ function buildAuthGuideText(authPayload) {
     lines.push(`授权页直链：${qrcodeUrl}`);
   }
 
+  lines.push(
+    '',
+    '给 Agent / 龙虾的额外处理提示：',
+    '- 只要发生转发，就默认同时展示 `desktop_scan_url` 和 `mobile_click_url`，不要只保留其中一条，因为飞书也可能在 PC 端打开。',
+    '- 如果当前是手机端对话，可以把 `mobile_click_url` 单独再发一条消息给用户，方便直接点击授权，但仍要保留 `desktop_scan_url`。',
+    '- 通过飞书或其他通信插件转发时，优先使用 markdown 链接格式：`[PC 扫码授权页](desktop_scan_url)` 与 `[手机直接授权](mobile_click_url)`；如果 markdown 被吞掉，再分别发两条仅包含 `<URL>` 的消息。',
+    '- 如果你只拿到了 TapTap 包装授权页（`wrapped_auth_url`），请取其中的 `code` 参数，再执行一次 `decodeURIComponent(code)`，即可得到更适合手机端直接点击的 `direct_auth_url`。',
+    '- 如果宿主把 markdown 链接吞掉了，请直接输出 `details.preferred_auth_url` 这条裸 URL，不要只说“请扫码”。'
+  );
+
   return lines.join('\n');
 }
 
+function looksLikeAuthErrorMessage(message) {
+  if (!message || typeof message !== 'string') {
+    return false;
+  }
+
+  return (
+    message.includes('缺少认证信息') ||
+    message.includes('需要 TapTap 授权') ||
+    message.includes('当前没有有效的 TapTap 认证信息') ||
+    message.includes('complete_oauth_authorization') ||
+    extractUrlsFromText(message).some((url) => url.includes('tap-qrcode'))
+  );
+}
+
+function extractAuthPayloadFromErrorMessage(message) {
+  if (!looksLikeAuthErrorMessage(message)) {
+    return null;
+  }
+
+  const urls = extractUrlsFromText(message);
+  if (urls.length === 0) {
+    return null;
+  }
+
+  const wrappedAuthUrl =
+    urls.find((url) => url.includes('tap-qrcode')) ||
+    urls.find((url) => tryParseUrl(url)?.searchParams?.has('code')) ||
+    null;
+
+  const decodedDirectUrl = decodeWrappedAuthUrl(wrappedAuthUrl);
+  const directAuthUrl =
+    urls.find((url) => url !== wrappedAuthUrl && !url.includes('tap-qrcode')) || decodedDirectUrl;
+
+  return enrichAuthPayload({
+    auth_url: wrappedAuthUrl,
+    wrapped_auth_url: wrappedAuthUrl,
+    direct_auth_url: directAuthUrl,
+    preferred_auth_url: directAuthUrl || wrappedAuthUrl,
+    source: 'bridge_error_message',
+    original_error_message: message,
+  });
+}
+
+function buildAuthRecoveryTextFromError(message) {
+  const authPayload = extractAuthPayloadFromErrorMessage(message);
+  if (!authPayload) {
+    return null;
+  }
+
+  return {
+    text: [
+      '当前工具调用失败，但桥接层已经识别到这是“缺少 TapTap 授权信息”的场景。',
+      '',
+      buildAuthGuideText(authPayload),
+      '',
+      '原始错误摘要：',
+      message,
+    ].join('\n'),
+    details: authPayload,
+  };
+}
+
 async function callJsonTool(bridge, name, args = {}) {
   const text = await bridge.callTool(name, args);
   const normalized = normalizeJsonText(text);
@@ -452,12 +580,22 @@ function registerProxyTool(api, bridge, definition) {
             parsed: normalizedParsed,
           });
         } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          const authRecovery = buildAuthRecoveryTextFromError(message);
+          if (authRecovery) {
+            return toolResult(authRecovery.text, {
+              mcpToolName: definition.mcpToolName,
+              auth_recovery: authRecovery.details,
+              original_error_message: message,
+            });
+          }
+
           return toolResult(
             JSON.stringify(
               {
                 ok: false,
                 error: 'PLUGIN_PROXY_ERROR',
-                message: error instanceof Error ? error.message : String(error),
+                message,
               },
               null,
               2

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-dc-plugin",
   "name": "TapTap DC",
   "description": "面向 OpenClaw 的 TapTap DC 插件。请使用 openclaw plugins install 安装，不要直接 npm install；如需重启 Gateway，应先通过飞书或其他通信插件通知用户。",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "enabledByDefault": true,
   "skills": ["./skills"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotaber_wang/openclaw-dc-plugin",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "description": "TapTap DC 的 OpenClaw 插件。请使用 openclaw plugins install 安装，不要直接 npm install；如需重启 Gateway，应先通过飞书或其他通信插件通知用户。",
   "main": "index.js",
@@ -13,12 +13,12 @@
     ],
     "install": {
       "npmSpec": "@lotaber_wang/openclaw-dc-plugin",
-      "preferredCommand": "openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.14",
+      "preferredCommand": "openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.16",
       "doNotUseCommands": [
         "npm install @lotaber_wang/openclaw-dc-plugin",
         "npm install -g @lotaber_wang/openclaw-dc-plugin"
       ],
-      "wrongInstallHint": "这是 OpenClaw 插件包，不是普通 npm CLI 包。请改用 openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.14。",
+      "wrongInstallHint": "这是 OpenClaw 插件包，不是普通 npm CLI 包。请改用 openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.16。",
       "postInstallMessage": "TapTap DC 插件已安装完成。OpenClaw 接下来如需重启 Gateway，应先通过飞书或其他通信插件通知用户；重启完成后即可使用 taptap_dc_* 工具。",
       "restartRequired": true,
       "restartCommand": "openclaw gateway restart",

package/scripts/postinstall.js

@@ -1,7 +1,7 @@
 import process from 'node:process';
 
 const PACKAGE_NAME = '@lotaber_wang/openclaw-dc-plugin';
-const PACKAGE_VERSION = '0.1.14';
+const PACKAGE_VERSION = '0.1.16';
 const PREFERRED_COMMAND = `openclaw plugins install ${PACKAGE_NAME}@${PACKAGE_VERSION}`;
 const DISCOURAGED_COMMANDS = [
   `npm install ${PACKAGE_NAME}`,