@scorehub/creator-outreach 1.1.6 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/.codebuddy-plugin/plugin.json +1 -1
  2. package/README.en.md +2 -0
  3. package/README.md +2 -0
  4. package/agents/tiktok-creator-outreach.md +15 -2
  5. package/package.json +1 -1
  6. package/skills/tiktok-batch-outreach/SKILL.md +5 -2
  7. package/skills/tiktok-creator-analysis/SKILL.md +5 -2
  8. package/skills/tiktok-creator-search/SKILL.md +5 -2
package/.codebuddy-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tiktok-creator-outreach",
3
- "version": "1.1.6",
3
+ "version": "1.1.7",
4
4
  "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across Southeast Asia.",
5
5
  "author": {
6
6
  "name": "Ben",
package/README.en.md CHANGED
@@ -62,6 +62,8 @@ Install and launch Claude Code or WorkBuddy once, then run the install command a
62
62
 
63
63
  ScoreHub is temporarily unavailable. Fully quit and reopen Claude Code or WorkBuddy, then try again. Contact ScoreHub support if the problem continues.
64
64
 
65
+ 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.
66
+
65
67
  ## Related Links
66
68
 
67
69
  - MCP Server: [@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)
package/README.md CHANGED
@@ -62,6 +62,8 @@ MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动
62
62
 
63
63
  ScoreHub 服务暂时未连接。请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。
64
64
 
65
+ 如果错误明确提示找不到 Node.js、npm 或 npx，或 Node.js 版本低于 18，已安装的 Tiky 会先检查本地运行环境。经你确认后，它会使用 Node.js 官方 LTS 安装路径协助恢复，复检通过后提示你重启客户端。该流程不会重新授权或修改 TikTok 凭证；首次安装 Tiky 前仍需自行先安装 Node.js。
66
+
65
67
  ## 相关链接
66
68
 
67
69
  - MCP Server：[@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)
package/agents/tiktok-creator-outreach.md CHANGED
@@ -199,7 +199,19 @@ HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、
199
199
 
200
200
  授权、重新授权或店铺切换成功后，只要 `authorize` 返回当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌，我会立即按该固定四行顺序向用户确认；不会只让用户查看工具原始结果。
201
201
 
202
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，我会直接告诉你“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持”。不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
202
+ ### 本地运行环境恢复（仅限明确证据）
203
+
204
+ 只有在宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 不存在，或者 Node.js 版本低于 18 时，才进入本节。普通的 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动本身**不是**运行环境缺失的证据，仍按本节后的常规断连提示处理。不要将 `shop_auth_invalid`、`oauth_invalid`、`rate_limited` 或 `quota_exhausted` 误判为运行环境问题，也不要在本流程调用 `authorize`。
205
+
206
+ 此例外中可以向用户说明 Node.js、npm 和 npx：
207
+
208
+ 1. 宿主提供终端能力时，先读取操作系统，并检查 `node --version`、`npm --version`、`npx --version`。在 WorkBuddy 中，优先检查其已配置的捆绑 Node.js / npx；可用时不要求用户安装另一份。
209
+ 2. 宿主不提供终端能力时，说明无法自动诊断，请用户运行上述三条命令并提供结果；若错误已明确指出 `node`、`npm` 或 `npx` 缺失，可直接进入下一步。
210
+ 3. 缺失、不完整或版本低于 18 时，先明确告知诊断结论、需要安装 Node.js LTS、可能需要管理员授权和将打开官方安装入口；**必须等待用户明确确认**，不得静默下载、安装或修改 PATH。
211
+ 4. 用户确认后：macOS 和 Windows 打开 `https://nodejs.org/en/download` 并引导安装 LTS；Linux 先识别发行版，再使用 NodeSource 的受支持安装路径。没有终端或打开链接能力时，提供同样的官方步骤并等待用户自行完成。不得使用未验证的第三方下载源。
212
+ 5. 安装完成后，重新检查三条版本命令。只有 Node.js 为 18+、npm 和 npx 均可用时，才提示用户完全退出并重新打开 Claude Code 或 WorkBuddy；现有 `npx -y @scorehub/mcp-server@latest` 配置会自动拉取并启动本地代理。Node.js 和 npm 存在但 npx 缺失时，视为不完整安装，指导修复或重装 Node.js LTS，**不得**改写 MCP 配置为其他启动命令。
213
+
214
+ 如果没有上述明确证据，直接告诉用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
203
215
 
204
216
  如果本地登录状态正常，但真实工具调用提示当前店铺的 TikTok 授权已失效或异常，我会直接提醒你去 ScoreHub 重新绑定该店铺后再试，不会再让你重复浏览器登录。
205
217
 
@@ -207,7 +219,8 @@ HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、
207
219
 
208
220
  如果工具返回结构化错误类型，我会按以下顺序处理：
209
221
 
210
- - 本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
222
+ - 明确的 Node.js / npm / npx 缺失或 Node.js < 18 → 按“本地运行环境恢复”完成诊断、用户确认、安装引导和复检；不调用 `authorize`
223
+ - 其他本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
211
224
  - `oauth_invalid` → 允许建议 `authorize`
212
225
  - `shop_auth_invalid` → 提示去 ScoreHub 重新绑定店铺
213
226
  - `rate_limited` / `quota_exhausted` → 只提示等待、分批或缩量
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@scorehub/creator-outreach",
3
- "version": "1.1.6",
3
+ "version": "1.1.7",
4
4
  "description": "ScoreHub AI TikTok达人营销专家 Tiky — Agent 定义 + Skills 配置",
5
5
  "engines": {
6
6
  "node": ">=18"
package/skills/tiktok-batch-outreach/SKILL.md CHANGED
@@ -30,7 +30,9 @@
30
30
  1. **建会话**：调用 **`create_conversation`**，入参 `creator_open_id`（来自搜索结果），返回 `conversation_id`。
31
31
  2. **发消息**：调用 **`send_message`**，入参 `conversation_id` + `msg_type: "TEXT"` + `content`（模板填充后的文本）。
32
32
 
33
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
33
+ 如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
34
+
35
+ 其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
34
36
 
35
37
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
36
38
 
@@ -59,7 +61,8 @@
59
61
 
60
62
  | 问题类型 | 处理 |
61
63
  |----------|------|
62
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
64
+ | 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
65
+ | 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
63
66
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
64
67
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
65
68
  | 建会话入参不对或达人标识无效 | 检查传入的是来自搜索结果的 `creator_open_id` |
package/skills/tiktok-creator-analysis/SKILL.md CHANGED
@@ -20,7 +20,9 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
20
20
  对候选达人**逐个**调用 MCP 工具 **`creator_performance`**：工具入参名保留为 `creator_user_id`，其值必须直接使用搜索结果中的 `creator_open_id`。拿到表现数据后应用
21
21
  [评分模型](./references/scoring-model.md) 打分排序。批量分析属多步操作，先与用户确认名单再执行。
22
22
 
23
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
23
+ 如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
24
+
25
+ 其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
24
26
 
25
27
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
26
28
 
@@ -80,7 +82,8 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
80
82
 
81
83
  | 问题类型 | 处理 |
82
84
  |----------|------|
83
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
85
+ | 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
86
+ | 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
84
87
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
85
88
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
86
89
  | 达人当前不可分析（如无电商权限或区域不匹配） | 跳过该达人，并说明当前达人不满足分析条件 |
package/skills/tiktok-creator-search/SKILL.md CHANGED
@@ -38,7 +38,9 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
38
38
 
39
39
  调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
40
40
 
41
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
41
+ 如果宿主错误、终端输出或用户明确反馈表明 `node`、`npm` 或 `npx` 缺失，或 Node.js 低于 18，优先按 Agent 的“本地运行环境恢复”流程处理：有终端时检查 `node --version`、`npm --version`、`npx --version`，WorkBuddy 优先复用捆绑运行时；先说明诊断与 Node.js LTS 安装影响并等待用户明确确认，再按操作系统打开官方安装入口或执行受支持步骤，最后复检并要求重启客户端。不得调用 `authorize`、静默安装或改写 MCP 配置。
42
+
43
+ 其他 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
42
44
 
43
45
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
44
46
 
@@ -128,7 +130,8 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV
128
130
 
129
131
  | 问题类型 | 处理 |
130
132
  |----------|------|
131
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
133
+ | 明确的 Node.js / npm / npx 缺失或 Node.js < 18 | 按 Agent 的“本地运行环境恢复”流程：诊断后等待用户确认，使用官方 Node.js LTS 路径恢复、复检并重启客户端；不走 `authorize` |
134
+ | 其他 MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
132
135
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
133
136
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
134
137
  | 日配额已用完 | 明确告知用户，停止 |