@scorehub/creator-outreach 1.0.3 → 1.0.5

package/README.md

@@ -6,30 +6,32 @@ TikTok 达人建联 WorkBuddy 智能体。支持按 GMV/类目/粉丝画像搜
 
 ## 安装
 
-### Claude Code / Claude Desktop（一键安装）
+### 一键安装（Claude Code + WorkBuddy）
 
 ```bash
 npx @scorehub/creator-outreach
 ```
 
-自动完成：
+自动检测并安装到已安装的 AI 客户端：
+
+**Claude Code / Claude Desktop：**
 - 将 Tiky Agent 定义复制到 `~/.claude/agents/`
 - 将 ScoreHub MCP Server 配置写入 `~/.claude.json`
 
-重启 Claude Code 后，通过 `@tiktok-creator-outreach` 唤起 Tiky。
+**WorkBuddy 桌面版（检测到 `~/.workbuddy/` 时自动安装）：**
+- 将插件文件复制到 `~/.workbuddy/plugins/.../`
+- 将 ScoreHub MCP Server 配置写入 `~/.workbuddy/mcp.json`
 
-### WorkBuddy 桌面版
+重启客户端后使用 Tiky：
+- Claude Code：`@tiktok-creator-outreach`
+- WorkBuddy：在 Agent 列表中选择 "Tiky — TikTok Creator Outreach"
 
-在插件安装入口输入以下任意一种地址：
+### WorkBuddy 插件市场（备选）
 
-**npmjs（推荐）**
-```
-@scorehub/creator-outreach
-```
+在插件安装入口输入地址：
 
-**GitHub**
 ```
-https://github.com/ScoreHub-AI/creator-outreach
+@scorehub/creator-outreach
 ```
 
 ## 前提条件

package/agents/tiktok-creator-outreach.md

@@ -31,12 +31,17 @@ skills:
 
 ### 1. 达人搜索与发现
 在多维筛选条件下，从 TikTok Creator Marketplace 精准搜索达人。
-- **类目筛选（两步走，务必遵守）**：
+- **类目筛选（父类目优先，务必遵守）**：
   1. 当用户提到品类/类目关键词（如"美妆"/"3C"/"beauty"/"electronics"）时，**先调用 `get_categories`** 解析为类目 ID。传入 `keyword`（品类名），并根据语言设置 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`），建议同时传 `category_version: "v2"`。
-  2. 从返回结果中筛选 `is_leaf=true` 的叶子类目，按 `parent_id` 分组。
-  3. 构造 `category` 参数：`[{parent_category_id: "父类目ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`。
-  4. 将 `category` 参数传给 `search_creators` 进行达人搜索。
-  - **注意**：如果 `get_categories` 返回多个匹配结果，用表格展示让用户确认。绝不要凭空猜测类目 ID。
+  2. **优先匹配父类目（`is_leaf=false`）**：从返回结果中筛选 `is_leaf=false` 的非叶子类目（即品类大类/父类目）。如果匹配到父类目：
+     - 构造 `category` 参数：`[{parent_category_id: "父类目ID"}]` —— **不要传 `child_category_id_list`**。API 会搜索该父类目下所有子类目的达人，覆盖面最广。
+     - 如果匹配到多个父类目，用表格展示让用户确认想要筛选哪些（或全部）。
+  3. **兜底匹配子类目**：仅当返回结果中**没有任何 `is_leaf=false` 的父类目**时，才降级使用叶子类目：
+     - 筛选 `is_leaf=true` 的叶子类目，按 `parent_id` 分组。
+     - 构造 `category` 参数：`[{parent_category_id: "父类目ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`。
+     - 如果匹配到多个子类目，同样用表格展示让用户确认。
+  - **核心原则**：父类目覆盖 > 子类目精确。宁愿多搜到一些达人（由后续 GMV/粉丝画像等条件进一步筛选），也不要因为子类目划分过细而漏掉潜在合适的达人。
+  - **注意**：绝不要凭空猜测类目 ID。
 - GMV 区间筛选（0-100 / 100-1K / 1K-10K / 10K+）
 - 销量区间筛选
 - 关键词搜索（用户名/昵称匹配）

package/install.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+// === Claude Code 路径 ===
 const CLAUDE_DIR = path.join(os.homedir(), '.claude');
 const AGENTS_DIR = path.join(CLAUDE_DIR, 'agents');
 const CLAUDE_JSON = path.join(os.homedir(), '.claude.json');
@@ -11,6 +12,14 @@ const CLAUDE_JSON = path.join(os.homedir(), '.claude.json');
 const AGENT_SRC = path.join(__dirname, 'agents', 'tiktok-creator-outreach.md');
 const AGENT_DEST = path.join(AGENTS_DIR, 'tiktok-creator-outreach.md');
 
+// === WorkBuddy 路径 ===
+const WORKBUDDY_DIR = path.join(os.homedir(), '.workbuddy');
+const WORKBUDDY_PLUGIN_DIR = path.join(
+  WORKBUDDY_DIR, 'plugins', 'marketplaces', 'my-experts', 'plugins', 'tiktok-creator-outreach',
+);
+const WORKBUDDY_MCP_JSON = path.join(WORKBUDDY_DIR, 'mcp.json');
+
+// === 共享 MCP 配置 ===
 const MCP_CONFIG = {
   type: 'stdio',
   command: 'npx',
@@ -20,26 +29,75 @@ const MCP_CONFIG = {
   },
 };
 
+// 工具函数：合并 MCP Server 配置到 JSON 文件
+function mergeMcpConfig(configPath, serverName, serverConfig, extraFields) {
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch {
+      console.warn(`警告：${configPath} 解析失败，将重新写入`);
+    }
+  }
+
+  config.mcpServers = config.mcpServers || {};
+  config.mcpServers[serverName] = Object.assign({}, serverConfig, extraFields);
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+
+// ========== Claude Code ==========
+
 // 1. 复制 Agent 定义文件
 fs.mkdirSync(AGENTS_DIR, { recursive: true });
 fs.copyFileSync(AGENT_SRC, AGENT_DEST);
-console.log(`✓ Agent 已安装: ${AGENT_DEST}`);
+console.log(`✓ Claude Code: Agent 已安装 → ${AGENT_DEST}`);
 
 // 2. 合并 MCP Server 配置到 ~/.claude.json
-let claudeConfig = {};
-if (fs.existsSync(CLAUDE_JSON)) {
-  try {
-    claudeConfig = JSON.parse(fs.readFileSync(CLAUDE_JSON, 'utf8'));
-  } catch {
-    console.warn(`警告：${CLAUDE_JSON} 解析失败，将重新写入`);
+mergeMcpConfig(CLAUDE_JSON, 'scorehub', MCP_CONFIG, {});
+console.log(`✓ Claude Code: MCP Server 已配置 → ${CLAUDE_JSON}`);
+
+// ========== WorkBuddy ==========
+
+const hasWorkBuddy = fs.existsSync(WORKBUDDY_DIR);
+
+if (hasWorkBuddy) {
+  // 3. 复制插件文件到 WorkBuddy 插件目录
+  const pluginDirs = ['.codebuddy-plugin', 'agents', 'skills', 'avatars'];
+  const pluginFiles = ['package.json', 'README.md'];
+
+  fs.mkdirSync(WORKBUDDY_PLUGIN_DIR, { recursive: true });
+
+  for (const dir of pluginDirs) {
+    const src = path.join(__dirname, dir);
+    const dest = path.join(WORKBUDDY_PLUGIN_DIR, dir);
+    if (fs.existsSync(src)) {
+      fs.cpSync(src, dest, { recursive: true });
+    }
+  }
+
+  for (const file of pluginFiles) {
+    const src = path.join(__dirname, file);
+    const dest = path.join(WORKBUDDY_PLUGIN_DIR, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, dest);
+    }
   }
+
+  console.log(`✓ WorkBuddy: 插件文件已安装 → ${WORKBUDDY_PLUGIN_DIR}`);
+
+  // 4. 合并 MCP Server 配置到 ~/.workbuddy/mcp.json
+  mergeMcpConfig(WORKBUDDY_MCP_JSON, 'scorehub', MCP_CONFIG, { disabled: false });
+  console.log(`✓ WorkBuddy: MCP Server 已配置 → ${WORKBUDDY_MCP_JSON}`);
 }
 
-claudeConfig.mcpServers = claudeConfig.mcpServers || {};
-claudeConfig.mcpServers.scorehub = MCP_CONFIG;
+// ========== 完成 ==========
 
-fs.writeFileSync(CLAUDE_JSON, JSON.stringify(claudeConfig, null, 2) + '\n');
-console.log(`✓ MCP Server 已配置: ${CLAUDE_JSON}`);
+const platforms = ['Claude Code'];
+if (hasWorkBuddy) platforms.push('WorkBuddy');
 
-console.log('\n安装完成！重启 Claude Code 后，使用 @tiktok-creator-outreach 唤起 Tiky。');
+console.log(`\n安装完成！重启 ${platforms.join(' / ')} 后使用 Tiky。`);
+if (!hasWorkBuddy) {
+  console.log('提示：未检测到 WorkBuddy，仅安装了 Claude Code。如需 WorkBuddy 支持请先安装 WorkBuddy 后重新运行本命令。');
+}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/creator-outreach",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "ScoreHub Tiky 智能体 — Agent 定义 + Skills 配置",
   "files": [
     ".codebuddy-plugin",

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

@@ -18,10 +18,17 @@
 如果用户提到了品类/类目关键词（如"美妆"、"3C"、"beauty"、"electronics"），**必须**先调用 `get_categories` 获取类目 ID，再调用 `search_creators`：
 
 1. **`get_categories`** — 传入 `keyword`（品类名关键词），建议同时传 `category_version: "v2"` 和合适的 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`）
-2. 从返回的 `categories` 数组中，筛选出 `is_leaf: true` 的叶子节点
-3. 按 `parent_id` 分组叶子节点
-4. 构造 `category` 参数：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`
-5. 传给 `search_creators`
+2. **优先匹配父类目（`is_leaf=false`）** — 从返回的 `categories` 数组中筛选 `is_leaf=false` 的非叶子节点（即品类大类/父类目）。如果匹配到父类目，直接使用父类目 ID：
+   - 构造 `category` 参数时 **只传 `parent_category_id`，不传 `child_category_id_list`**：`[{parent_category_id: "父ID"}]`
+   - 这样 API 会搜索该父类目下**所有**子类目的达人，覆盖面最广
+   - 如果匹配到多个父类目，用**表格展示**让用户确认要筛选哪些
+3. **兜底匹配子类目** — 仅当返回结果中**没有任何 `is_leaf=false` 的父类目**时，才降级使用子类目匹配：
+   - 筛选 `is_leaf=true` 的叶子节点，按 `parent_id` 分组
+   - 构造 `category` 参数：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`
+   - 如果匹配到多个子类目，同样用**表格展示**让用户确认
+4. 将构造好的 `category` 参数传给 `search_creators`
+
+> **核心原则**：父类目覆盖 > 子类目精确。宁愿多搜到一些达人（由后续 GMV/粉丝画像等条件进一步筛选），也不要因为子类目划分过细而漏掉潜在合适的达人。
 
 调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
 
@@ -30,7 +37,7 @@
 | 参数 | 说明 |
 |------|------|
 | `keyword` | 用户名/昵称搜索（可选） |
-| `category` | 品类筛选数组（可选）。格式：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1"]}]`。多个对象 OR 关系，单个对象内 child_category_id_list AND 关系。类目 ID **必须先通过 `get_categories` 获取**，不要硬编码或猜测。 |
+| `category` | 品类筛选数组（可选）。支持两种格式：① **父类目模式（推荐优先使用）**：`[{parent_category_id: "父ID"}]`，不传 `child_category_id_list`，搜索该父类目下所有子类目；② **子类目模式（仅兜底使用）**：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1"]}]`。多个对象 OR 关系，单个对象内 child_category_id_list AND 关系。类目 ID **必须先通过 `get_categories` 获取**，不要硬编码或猜测。 |
 | `gmv_ranges` | GMV 区间数组，取值见下表（可选） |
 | `page_size` | 每页条数，默认/上限 20 |
 | `page_token` | 翻页令牌，首次不传，用上一页返回的 `next_page_token` 续拉 |