@lotaber_wang/openclaw-dc-plugin 0.1.15 → 0.1.16

package/README.md

@@ -9,7 +9,7 @@
 请这样安装：
 
 ```bash
-openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.15
+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.15
+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.15` 开始，插件包不再声明 `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.15` 或更新版本
+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.15` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
+从 `0.1.16` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
 
 - 在 `package.json` 中补充 `openclaw.install.npmSpec`，让安装链路更稳定
 - 在 `package.json` 的 `openclaw.install` 中补充 `preferredCommand` / `doNotUseCommands` / `wrongInstallHint`
@@ -195,3 +195,4 @@ openclaw gateway restart
 - 过滤 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.15';
+  '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;
@@ -110,16 +118,25 @@ function extractUrlsFromText(value) {
 }
 
 function buildAuthLinkParseHint(wrappedAuthUrl, directAuthUrl, preferredAuthUrl) {
+  const desktopScanUrl = wrappedAuthUrl || null;
+  const mobileClickUrl = preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null;
   return {
-    mobile_click_url: preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null,
+    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:
-      '如果当前是手机端或移动端对话，请把 mobile_click_url 单独作为一条消息再次发给用户，便于直接点击授权。',
+      '如果需要转发给用户，默认同时保留 desktop_scan_url 和 mobile_click_url 两条链接；即使是飞书消息也这样处理，因为飞书可能在 PC 端打开。手机端对话时可以额外再单独发一次 mobile_click_url。',
+    lark_render_rule:
+      '飞书或其他 IM 中，转发时默认同时给出 [PC 扫码授权页](desktop_scan_url) 与 [手机直接授权](mobile_click_url) 两条 markdown 链接；如果 markdown 被吞掉，再分别单独发送两行 <URL>。',
   };
 }
 
@@ -345,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`。'
   );
 
@@ -380,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}`);
   }
@@ -395,7 +423,9 @@ function buildAuthGuideText(authPayload) {
   lines.push(
     '',
     '给 Agent / 龙虾的额外处理提示：',
-    '- 如果当前是手机端对话，请把 `preferred_auth_url` 或 `mobile_auth_url` 单独再发一条消息给用户，方便直接点击授权。',
+    '- 只要发生转发，就默认同时展示 `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，不要只说“请扫码”。'
   );

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