@lotaber_wang/openclaw-dc-plugin 0.1.13 → 0.1.15

package/README.md

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

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.13';
+  'openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.15';
 const WRONG_INSTALL_HINT =
   '这是 OpenClaw 插件包，不是普通 npm CLI 包。请不要直接用 npm install，改用 openclaw plugins install。';
 
@@ -100,6 +100,29 @@ 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) {
+  return {
+    mobile_click_url: preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null,
+    wrapped_auth_url: wrappedAuthUrl || null,
+    direct_auth_url: directAuthUrl || null,
+    parse_rule:
+      wrappedAuthUrl && directAuthUrl
+        ? '如果只有 wrapped_auth_url，请读取其中的 code 参数，并执行一次 decodeURIComponent(code)，得到 direct_auth_url。手机端优先打开 direct_auth_url。'
+        : '如果当前是手机端会话，请优先展示 preferred_auth_url；如果宿主吞掉超链接，就直接输出这条裸 URL。',
+    display_rule:
+      '如果当前是手机端或移动端对话，请把 mobile_click_url 单独作为一条消息再次发给用户，便于直接点击授权。',
+  };
+}
+
 function enrichAuthPayload(authPayload) {
   if (!authPayload || typeof authPayload !== 'object') {
     return authPayload;
@@ -154,6 +177,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。',
   };
@@ -364,9 +392,79 @@ function buildAuthGuideText(authPayload) {
     lines.push(`授权页直链：${qrcodeUrl}`);
   }
 
+  lines.push(
+    '',
+    '给 Agent / 龙虾的额外处理提示：',
+    '- 如果当前是手机端对话，请把 `preferred_auth_url` 或 `mobile_auth_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 +550,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.13",
+  "version": "0.1.15",
   "enabledByDefault": true,
   "skills": ["./skills"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotaber_wang/openclaw-dc-plugin",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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.13",
+      "preferredCommand": "openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.15",
       "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.13。",
+      "wrongInstallHint": "这是 OpenClaw 插件包，不是普通 npm CLI 包。请改用 openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.15。",
       "postInstallMessage": "TapTap DC 插件已安装完成。OpenClaw 接下来如需重启 Gateway，应先通过飞书或其他通信插件通知用户；重启完成后即可使用 taptap_dc_* 工具。",
       "restartRequired": true,
       "restartCommand": "openclaw gateway restart",
@@ -58,9 +58,6 @@
     "node": ">=18.14.1"
   },
   "license": "MIT",
-  "peerDependencies": {
-    "openclaw": ">=2026.1.29"
-  },
   "dependencies": {
     "@mikoto_zero/minigame-open-mcp": "^1.19.0"
   },

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.13';
+const PACKAGE_VERSION = '0.1.15';
 const PREFERRED_COMMAND = `openclaw plugins install ${PACKAGE_NAME}@${PACKAGE_VERSION}`;
 const DISCOURAGED_COMMANDS = [
   `npm install ${PACKAGE_NAME}`,