@lotaber_wang/openclaw-dc-plugin 0.1.15 → 0.1.17

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.17
 ```
 
 不要这样安装：
@@ -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.17
 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.17` 开始，插件包不再声明 `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.17` 或更新版本
 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.17` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
 
 - 在 `package.json` 中补充 `openclaw.install.npmSpec`，让安装链路更稳定
 - 在 `package.json` 的 `openclaw.install` 中补充 `preferredCommand` / `doNotUseCommands` / `wrongInstallHint`
@@ -195,3 +195,5 @@ 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 链接格式，避免 `_` 等字符导致裸链接被截断
+- 同时，bridge 会返回 `forward_message_markdown` / `forward_message_autolink` 模板，并显式提示 Agent：禁止把 `[text](url)` 改写成 `**text：** url` 或 HTML

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.17';
 const WRONG_INSTALL_HINT =
   '这是 OpenClaw 插件包，不是普通 npm CLI 包。请不要直接用 npm install，改用 openclaw plugins install。';
 
@@ -74,6 +74,36 @@ function buildMarkdownLink(label, url) {
   return `[${label}](${url})`;
 }
 
+function buildAutolink(url) {
+  if (!url) {
+    return '-';
+  }
+
+  return `<${url}>`;
+}
+
+function buildExactAuthForwardTemplate(desktopScanUrl, mobileClickUrl) {
+  const markdownLines = [];
+  const autolinkLines = [];
+
+  if (desktopScanUrl) {
+    markdownLines.push(buildMarkdownLink('PC 扫码授权页', desktopScanUrl));
+    autolinkLines.push(buildAutolink(desktopScanUrl));
+  }
+
+  if (mobileClickUrl) {
+    markdownLines.push(buildMarkdownLink('手机直接授权', mobileClickUrl));
+    autolinkLines.push(buildAutolink(mobileClickUrl));
+  }
+
+  return {
+    markdown_lines: markdownLines,
+    autolink_lines: autolinkLines,
+    markdown_block: markdownLines.join('\n'),
+    autolink_block: autolinkLines.join('\n'),
+  };
+}
+
 function tryParseUrl(value) {
   if (!value || typeof value !== 'string') {
     return null;
@@ -110,16 +140,36 @@ function extractUrlsFromText(value) {
 }
 
 function buildAuthLinkParseHint(wrappedAuthUrl, directAuthUrl, preferredAuthUrl) {
+  const desktopScanUrl = wrappedAuthUrl || null;
+  const mobileClickUrl = preferredAuthUrl || directAuthUrl || wrappedAuthUrl || null;
+  const forwardTemplate = buildExactAuthForwardTemplate(desktopScanUrl, mobileClickUrl);
   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,
+    forward_message_markdown_lines: forwardTemplate.markdown_lines,
+    forward_message_autolink_lines: forwardTemplate.autolink_lines,
+    forward_message_markdown: forwardTemplate.markdown_block,
+    forward_message_autolink: forwardTemplate.autolink_block,
     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>。',
+    forbidden_rewrites: [
+      '**PC 扫码授权页：** URL',
+      '**手机直接授权：** URL',
+      '<a href="URL">文本</a>',
+      '仅保留一条链接',
+    ],
   };
 }
 
@@ -345,30 +395,34 @@ 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 forwardTemplate = buildExactAuthForwardTemplate(desktopScanUrl, mobileClickUrl);
   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 +434,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,11 +457,34 @@ 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>` 的消息。',
+    '- 格式强制：必须原样保留 `[文本](URL)` markdown 链接，禁止改写成 `**文本：** URL`、HTML `<a>`，或其它“标题 + 裸 URL”格式。',
     '- 如果你只拿到了 TapTap 包装授权页（`wrapped_auth_url`），请取其中的 `code` 参数，再执行一次 `decodeURIComponent(code)`，即可得到更适合手机端直接点击的 `direct_auth_url`。',
     '- 如果宿主把 markdown 链接吞掉了，请直接输出 `details.preferred_auth_url` 这条裸 URL，不要只说“请扫码”。'
   );
 
+  if (forwardTemplate.markdown_block) {
+    lines.push(
+      '',
+      '请优先原样转发下面这段 markdown，不要自行改写格式：',
+      '```md',
+      forwardTemplate.markdown_block,
+      '```'
+    );
+  }
+
+  if (forwardTemplate.autolink_block) {
+    lines.push(
+      '',
+      '如果 markdown 链接在当前宿主里仍然被改写，再退回到下面这段逐行 `<URL>` 文本，同样两条都要保留：',
+      '```text',
+      forwardTemplate.autolink_block,
+      '```'
+    );
+  }
+
   return lines.join('\n');
 }
 

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

package/skills/taptap-dc-ops-brief/SKILL.md

@@ -20,6 +20,9 @@ description: 生成 TapTap 当前游戏 DC 运营简报与结论解读（商店/
    - 如果用户给了 `app_id`，直接把 `app_id` 传进去
 2. 如果未授权
    - `taptap_dc_quick_brief` 会直接返回授权信息，其中最前面的裸链接和 `details.preferred_auth_url` 都应视为首选授权入口
+   - 当工具结果里给出 `details.auth_link_parse_hint.forward_message_markdown` 时，优先**原样复用**这段 markdown 发送给用户
+   - 禁止把 `[PC 扫码授权页](URL)` / `[手机直接授权](URL)` 改写成 `**PC 扫码授权页：** URL`、`**手机直接授权：** URL`、HTML `<a>`，或任何“标题 + 裸 URL”格式
+   - 如果 markdown 链接在当前宿主里仍然会被改写，再退回到 `details.auth_link_parse_hint.forward_message_autolink`，并逐行原样发送 `<URL>`
    - 如果用户当前在手机上对话，优先引导用户直接点击第一条裸链接，不要先强调扫码
    - 如果用户当前在桌面端对话，再引导用户打开授权页直链并扫码或转发到手机
    - 用户确认后调用 `taptap_dc_complete_authorization`
@@ -46,6 +49,10 @@ description: 生成 TapTap 当前游戏 DC 运营简报与结论解读（商店/
 
 - 这些 plugin tools 返回的是 **raw JSON**，你要自己完成解读，不要把 JSON 原样长篇贴回给用户
 - 当授权工具已经返回授权链接时，优先直接复用第一条裸直链；如果文本里链接缺失，就从 `details.preferred_auth_url` 取值，不要直接退化成“去扫二维码”
+- 只要发生转发，就默认同时保留 PC 扫码授权页和手机直接授权两条链接，因为飞书消息也可能在 PC 端打开
+- 如果工具结果里已经给出了 `forward_message_markdown`，必须原样复用，不要自行“优化格式”
+- 严禁把 markdown 链接 `[text](url)` 改写成 `**text：** url`
+- 严禁把 markdown 链接改写成 HTML `<a href="...">text</a>`
 - `page_view_count` 应写成“详情页访问量（PV）”，不要偷换成别的口径
 - `taptap_dc_like_review` / `taptap_dc_reply_review` 只能在用户明确确认后调用
 - 如果回复结果里出现 `need_confirmation=true`，必须先把草稿给用户确认，再决定是否带 `confirm_high_risk=true` 重试