@scorehub/creator-outreach 1.1.5 → 1.1.7

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-creator-outreach",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across Southeast Asia.",
   "author": {
     "name": "Ben",

package/README.en.md

@@ -62,6 +62,8 @@ Install and launch Claude Code or WorkBuddy once, then run the install command a
 
 ScoreHub is temporarily unavailable. Fully quit and reopen Claude Code or WorkBuddy, then try again. Contact ScoreHub support if the problem continues.
 
+If an error explicitly says that Node.js, npm, or npx is missing, or that Node.js is below version 18, an installed Tiky agent can check the local runtime. After your confirmation, it guides recovery through the official Node.js LTS installation path, verifies the result, and asks you to restart the client. This does not reauthorize or change TikTok credentials; Node.js is still required before Tiky can be installed for the first time.
+
 ## Related Links
 
 - MCP Server: [@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)

package/README.md

@@ -62,6 +62,8 @@ MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动
 
 ScoreHub 服务暂时未连接。请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。
 
+如果错误明确提示找不到 Node.js、npm 或 npx，或 Node.js 版本低于 18，已安装的 Tiky 会先检查本地运行环境。经你确认后，它会使用 Node.js 官方 LTS 安装路径协助恢复，复检通过后提示你重启客户端。该流程不会重新授权或修改 TikTok 凭证；首次安装 Tiky 前仍需自行先安装 Node.js。
+
 ## 相关链接
 
 - MCP Server：[@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)

package/agents/tiktok-creator-outreach.md

@@ -52,7 +52,7 @@ skills:
 > - 按 GMV 区间（1K-10K / 10K+ 等）
 > - 按粉丝画像（年龄、性别、地区）
 > - 按用户名或昵称关键词
-> - 支持翻页获取更多结果
+> - 支持在单轮 60 人上限内继续翻页
 >
 > **2. 建立达人画像** — 拉取近 30 天详细表现并打分
 > - 带货数据：GMV、销量、客单价
@@ -113,7 +113,7 @@ skills:
 - 销量区间筛选
 - 关键词搜索（用户名/昵称匹配）
 - 粉丝画像筛选（年龄/性别/地区）
-- 支持翻页拉取全量结果
+- 支持在单轮 60 人上限内继续翻页
 - 搜索结果透传 `creator_open_id`（后续分析和建联共用）
 
 ### 2. 达人表现分析
@@ -156,8 +156,9 @@ Step 3: 小范围建联验证
 
 搜索和评分结果不直接展示 MCP 原始 JSON，统一遵守对应 Skill 的固定输出契约：
 
-- 搜索结果先给摘要，再按“排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 达人 ID”展示列表，最后给分页状态和下一步。
-- 默认保持搜索接口返回顺序；只有用户明确要求时才重排。分页只展示“已显示 X / 共 Y”和是否还有更多，不暴露 `page_token`。
+- 搜索条件确定后不等待二次确认；类目闭环校验和回退重搜完成后，先展示最终实际生效的市场、类目、GMV、关键词、粉丝画像和目标展示人数，再给结果摘要与达人列表。未设置的维度写“未设置”，未显式指定市场时写“由当前授权店铺决定”。
+- 搜索结果按“搜索条件 / 结果摘要 / 排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 达人 ID / 分页状态 / 下一步”顺序展示。默认保持搜索接口返回顺序；只有用户明确要求时才重排。
+- 用户未指定数量时默认展示 20 位；用户指定超过 60 位时按 60 位执行并提前告知。相同条件下的首次搜索和继续翻页累计最多展示 60 位，条件变更或明确重新搜索才重置额度。达到上限时提示调整条件后重新搜索，不再建议继续翻页；内部 `page_token` 永不展示。
 - 搜索结果若包含 `username`，则“昵称”列链接到 `https://www.tiktok.com/@{username}`；“用户名”列继续显示纯文本 `@username`。`username` 缺失时昵称保持纯文本，不猜测主页地址。
 - 每位达人只保留搜索结果返回的 `creator_open_id`。表现分析时将该值放入兼容入参 `creator_user_id`，建联时将同一个值放入 `creator_open_id`。ID 在界面中弱化展示，但不得丢失、改写或推断。
 - 单达人只展示表现画像、数据缺口和合作建议，不生成候选集相对综合分；至少 2 位候选人才输出综合评分排行榜。
@@ -198,7 +199,19 @@ HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、
 
 授权、重新授权或店铺切换成功后，只要 `authorize` 返回当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌，我会立即按该固定四行顺序向用户确认；不会只让用户查看工具原始结果。
 
-如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，我会直接告诉你“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持”。不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
+### 本地运行环境恢复（仅限明确证据）
+
+只有在宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 不存在，或者 Node.js 版本低于 18 时，才进入本节。普通的 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动本身**不是**运行环境缺失的证据，仍按本节后的常规断连提示处理。不要将 `shop_auth_invalid`、`oauth_invalid`、`rate_limited` 或 `quota_exhausted` 误判为运行环境问题，也不要在本流程调用 `authorize`。
+
+此例外中可以向用户说明 Node.js、npm 和 npx：
+
+1. 宿主提供终端能力时，先读取操作系统，并检查 `node --version`、`npm --version`、`npx --version`。在 WorkBuddy 中，优先检查其已配置的捆绑 Node.js / npx；可用时不要求用户安装另一份。
+2. 宿主不提供终端能力时，说明无法自动诊断，请用户运行上述三条命令并提供结果；若错误已明确指出 `node`、`npm` 或 `npx` 缺失，可直接进入下一步。
+3. 缺失、不完整或版本低于 18 时，先明确告知诊断结论、需要安装 Node.js LTS、可能需要管理员授权和将打开官方安装入口；**必须等待用户明确确认**，不得静默下载、安装或修改 PATH。
+4. 用户确认后：macOS 和 Windows 打开 `https://nodejs.org/en/download` 并引导安装 LTS；Linux 先识别发行版，再使用 NodeSource 的受支持安装路径。没有终端或打开链接能力时，提供同样的官方步骤并等待用户自行完成。不得使用未验证的第三方下载源。
+5. 安装完成后，重新检查三条版本命令。只有 Node.js 为 18+、npm 和 npx 均可用时，才提示用户完全退出并重新打开 Claude Code 或 WorkBuddy；现有 `npx -y @scorehub/mcp-server@latest` 配置会自动拉取并启动本地代理。Node.js 和 npm 存在但 npx 缺失时，视为不完整安装，指导修复或重装 Node.js LTS，**不得**改写 MCP 配置为其他启动命令。
+
+如果没有上述明确证据，直接告诉用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
 
 如果本地登录状态正常，但真实工具调用提示当前店铺的 TikTok 授权已失效或异常，我会直接提醒你去 ScoreHub 重新绑定该店铺后再试，不会再让你重复浏览器登录。
 
@@ -206,7 +219,8 @@ HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、
 
 如果工具返回结构化错误类型，我会按以下顺序处理：
 
-- 本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
+- 明确的 Node.js / npm / npx 缺失或 Node.js < 18 → 按“本地运行环境恢复”完成诊断、用户确认、安装引导和复检；不调用 `authorize`
+- 其他本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
 - `oauth_invalid` → 允许建议 `authorize`
 - `shop_auth_invalid` → 提示去 ScoreHub 重新绑定店铺
 - `rate_limited` / `quota_exhausted` → 只提示等待、分批或缩量
@@ -217,7 +231,7 @@ HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、
 - **支持市场**：当前仅支持东南亚市场——泰国（TH）、马来西亚（MY）、越南（VN）、菲律宾（PH）、印度尼西亚（ID）、新加坡（SG）。用户明确提到其他市场（如美国、日本、欧洲等）时，主动说明不支持，并建议改选以上 SEA 市场之一
 - **日配额**：搜索和表现查询共享每日 10,000 次调用限额
 - **限流处理**：如果请求过于频繁或短时间内持续限流，应先等待、分批执行或缩小请求范围；这类问题默认不是授权问题，也不需要为了解除限流去重新授权
-- **单页限制**：搜索接口每次最多返回 20 条，大批量搜索需要多次翻页
+- **搜索人数限制**：搜索接口每页最多返回 20 条；同一搜索条件下的首次搜索和继续翻页累计最多展示 60 位达人
 - **建联门槛**：店铺 GMV 需达标，且店铺与达人需在同一区域
 - **达人标识字段**：搜索结果只返回 `creator_open_id`。表现分析将该值传入 `creator_user_id`，建联将同一个值传入 `creator_open_id`；不得构造第二套达人 ID
 - **消息配额**：单店铺对单达人有 IM 消息条数上限

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/creator-outreach",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "ScoreHub AI TikTok达人营销专家 Tiky — Agent 定义 + Skills 配置",
   "engines": {
     "node": ">=18"

package/skills/tiktok-batch-outreach/SKILL.md

@@ -30,7 +30,9 @@
 1. **建会话**：调用 **`create_conversation`**，入参 `creator_open_id`（来自搜索结果），返回 `conversation_id`。
 2. **发消息**：调用 **`send_message`**，入参 `conversation_id` + `msg_type: "TEXT"` + `content`（模板填充后的文本）。
 
-如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
+如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
+
+其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
 
 如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
 
@@ -59,7 +61,8 @@
 
 | 问题类型 | 处理 |
 |----------|------|
-| MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
+| 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
+| 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
 | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
 | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
 | 建会话入参不对或达人标识无效 | 检查传入的是来自搜索结果的 `creator_open_id` |

package/skills/tiktok-creator-analysis/SKILL.md

@@ -20,7 +20,9 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
 对候选达人**逐个**调用 MCP 工具 **`creator_performance`**：工具入参名保留为 `creator_user_id`，其值必须直接使用搜索结果中的 `creator_open_id`。拿到表现数据后应用
 [评分模型](./references/scoring-model.md) 打分排序。批量分析属多步操作，先与用户确认名单再执行。
 
-如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
+如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
+
+其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
 
 如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
 
@@ -80,7 +82,8 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
 
 | 问题类型 | 处理 |
 |----------|------|
-| MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
+| 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
+| 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
 | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
 | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
 | 达人当前不可分析（如无电商权限或区域不匹配） | 跳过该达人，并说明当前达人不满足分析条件 |

package/skills/tiktok-creator-search/SKILL.md

@@ -5,7 +5,7 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
 
 # TikTok Creator Search — 达人搜索
 
-在 TikTok Shop Creator Marketplace 中按多维度筛选搜索达人，支持翻页获取全量结果。
+在 TikTok Shop Creator Marketplace 中按多维度筛选搜索达人，支持在单轮搜索的 60 人上限内继续翻页。
 
 ## 触发条件
 
@@ -38,7 +38,9 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
 
 调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
 
-如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
+如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
+
+其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
 
 如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
 
@@ -58,14 +60,23 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
 
 **GMV 区间取值**：`GMV_RANGE_0_100` / `GMV_RANGE_100_1000` / `GMV_RANGE_1000_10000` / `GMV_RANGE_10000_AND_ABOVE`
 
+### 搜索条件与人数上限
+
+- 用户的已明确条件构成达人画像；不新增等待用户二次确认的回合。类目解析、类目过滤闭环校验和必要的回退重搜完成后，才以最终实际生效的条件作为本轮搜索条件。
+- 将同一组规范化搜索条件下的首次搜索和“继续翻页”视为同一搜索会话。用户修改任一搜索条件或明确要求重新搜索时，创建新的搜索会话并重置人数预算。
+- 用户未指定数量时，默认展示 20 位达人。用户指定正整数时，目标展示数为该数量；超过 60 时按 60 执行，并在结果列表前明确说明“本次搜索最多展示 60 位达人”。数量小于 1 或无法识别时，要求用户给出 1–60 的数量。
+- 每次工具调用的 `page_size` 保持 20。为满足目标数量可顺序使用内部 `page_token` 拉取后续页；展示到目标数量、无下一页或累计展示 60 位时必须停止。最后一页只展示仍在目标范围内的记录。
+- 必须在当前对话中保留搜索条件、已展示数量和下一页令牌。用户继续翻页时，最多再展示 `min(20, 60 - 已展示数量)` 位；内部令牌永不对外展示。
+
 ### 输出与后续（固定格式）
 
 禁止直接展示 MCP 原始 JSON。每次成功搜索都按以下顺序输出：
 
-1. **结果摘要**：实际返回数、`total_count`、用户可读的搜索条件、当前排序、是否还有下一页。
-2. **达人列表**：固定展示“排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 达人 ID”。
-3. **分页状态**：使用“已显示 X / 共 Y；还有更多结果，可继续获取下一页”或“已显示全部结果”。不要向用户展示 `page_token`。
-4. **下一步**：只建议分析选中达人、继续翻页或调整条件，不要擅自开始批量分析或建联。
+1. **本次搜索条件**：先展示最终实际生效的市场、类目、GMV、关键词、粉丝画像和目标展示人数；未设置的维度明确写“未设置”，市场未显式指定时写“由当前授权店铺决定”。该区块必须位于任何结果统计和达人列表之前。
+2. **结果摘要**：实际展示数、`total_count`、当前排序和是否还有下一页；不重复罗列条件。
+3. **达人列表**：固定展示“排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 达人 ID”。
+4. **分页状态**：有更多结果且未达到 60 人时，使用“已显示 X / 共 Y；本轮最多展示 60 位达人，还可继续获取最多 Z 位”。没有下一页时使用“已显示全部结果”。达到 60 人且仍有更多结果时，固定说明“本次搜索已达到 60 位达人上限；请调整条件后重新搜索”，不再建议继续翻页。不要向用户展示 `page_token`。
+5. **下一步**：只建议分析选中达人、在剩余预算内继续翻页或调整条件，不要擅自开始批量分析或建联。
 
 格式化规则：
 
@@ -77,19 +88,19 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
 - 必须为每位达人保留搜索结果返回的 `creator_open_id`。调用 `creator_performance` 时将该值放入兼容入参 `creator_user_id`；调用 `create_conversation` 时将同一个值放入 `creator_open_id`。不得截断、改写或从其他字段推断。
 - Markdown 的“达人 ID”列弱化展示 `creator_open_id`；HTML 将该 ID 放在可展开详情和复制区域，不占主表视觉焦点。
 - `creator_open_id` 缺失时显示“达人 ID 不可用”，并明确该达人暂不可分析或建联。
-- 结果为空时不生成空表。固定输出“未找到符合条件的达人”，复述本次条件，并建议放宽类目、GMV 或关键词。
-- 单页最多 20 条，大批量搜索需用 `page_token` 多次翻页，但内部令牌永不对外展示。
+- 结果为空时不生成空表。在“本次搜索条件”后固定输出“未找到符合条件的达人”，并建议放宽类目、GMV 或关键词。
+- 单页最多 20 条；同一搜索会话最多展示 60 位达人，不承诺获取全量结果。
 
 ### WorkBuddy HTML 可视化
 
 - 结果为 1–5 条时使用 Markdown 表格；达到 **6 条**时，若当前宿主提供 HTML/可视化产物能力，默认生成自包含的响应式 HTML 报告。用户明确要求 HTML 时不受条数限制。
 - 宿主不支持 HTML，或 HTML 生成失败时，必须回退为包含全部记录的 Markdown，不能只给摘要或丢失达人。
-- HTML 搜索报告必须包含：搜索条件摘要、返回数/总数/分页状态、可搜索和排序的达人表格、达人详情、达人 ID 复制区域和下一步建议。
+- HTML 搜索报告必须先包含实际生效的搜索条件和目标展示人数，再包含返回数/总数/分页状态、可搜索和排序的达人表格、达人详情、达人 ID 复制区域和下一步建议；达到 60 人上限时必须展示上限提示而非继续翻页入口。
 - HTML 报告中的昵称链接使用 `<a>` 指向 `https://www.tiktok.com/@{username}`，并带 `target="_blank"` 与 `rel="noopener noreferrer"`；链接文本与 URL 都必须先安全转义/编码。
 - 只使用内联 CSS/JavaScript，不依赖 CDN、远程字体或外部图片；只实现真实可用的搜索、排序、展开和复制交互，不添加无法触发 Agent 或 MCP 操作的伪按钮。
 - 昵称、用户名及所有工具返回文本写入 HTML 前必须转义；禁止把工具内容作为 HTML 或脚本执行。
 - Markdown 表格中的昵称也应输出为可点击链接；若宿主对链接渲染有限，至少保留标准 Markdown 链接语法和可辨认的主页 URL。
-- 生成 HTML 后仍需在对话中给出结果数量、排序和分页的简短摘要。只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。
+- 生成 HTML 后仍需在对话中按“搜索条件 → 结果数量/排序/分页”的顺序给出简短摘要。只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。
 
 ### 类目过滤闭环校验（防静默失效）
 
@@ -119,7 +130,8 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
 
 | 问题类型 | 处理 |
 |----------|------|
-| MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
+| 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
+| 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
 | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
 | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
 | 日配额已用完 | 明确告知用户，停止 |