@scorehub/creator-outreach 1.0.6 → 1.0.8

package/README.md

@@ -1,53 +1,44 @@
-# creator-outreach — Tiky TikTok 达人建联
+# @scorehub/creator-outreach
 
-TikTok 达人建联 WorkBuddy 智能体。支持按 GMV/类目/粉丝画像搜索达人、
-带货表现分析评分、两步会话建联（create_conversation → send_message），
-通过 ScoreHub MCP 调用 TikTok API。
+**Tiky** — TikTok 达人建联 AI 智能体。一条命令装进 Claude Code 和 WorkBuddy。
 
-## 安装
+按类目 / GMV / 粉丝画像搜索 TikTok Shop 达人，分析带货表现并打分排名，批量发送建联消息（`create_conversation` → `send_message`）。所有 TikTok API 调用通过 ScoreHub MCP 完成。
 
-### 一键安装（Claude Code + WorkBuddy）
+## 安装
 
 ```bash
 npx @scorehub/creator-outreach
 ```
 
-自动检测并安装到已安装的 AI 客户端：
-
-**Claude Code / Claude Desktop：**
-- 将 Tiky Agent 定义复制到 `~/.claude/agents/`
-- 将 ScoreHub MCP Server 配置写入 `~/.claude.json`
+命令会自动检测本机已安装的 AI 客户端并完成配置：
 
-**WorkBuddy 桌面版（检测到 `~/.workbuddy/` 时自动安装）：**
-- 将插件文件复制到 `~/.workbuddy/plugins/.../`
-- 将 ScoreHub MCP Server 配置写入 `~/.workbuddy/mcp.json`
+| 客户端 | 安装内容 |
+|--------|----------|
+| **Claude Code / Claude Desktop** | Agent 定义 → `~/.claude/agents/`；MCP 配置 → `~/.claude.json` |
+| **WorkBuddy**（检测到 `~/.workbuddy/` 时） | 插件文件 → `~/.workbuddy/plugins/.../`；MCP 配置 → `~/.workbuddy/mcp.json` |
 
-重启客户端后使用 Tiky：
-- Claude Code：`@tiktok-creator-outreach`
-- WorkBuddy：在 Agent 列表中选择 "Tiky — TikTok Creator Outreach"
+MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动时自动拉取，无需单独安装。
 
-### WorkBuddy 插件市场（备选）
+安装完成后重启客户端，即可唤起 Tiky：
 
-在插件安装入口输入地址：
+- **Claude Code**：输入 `@tiktok-creator-outreach`
+- **WorkBuddy**：在 Agent 列表中选择 "Tiky — TikTok Creator Outreach"
 
-```
-@scorehub/creator-outreach
-```
+> 也可在 WorkBuddy 插件市场直接搜索 `@scorehub/creator-outreach` 安装。
 
-## 前提条件
+## 首次使用：授权
 
-插件依赖 ScoreHub MCP Server 调用 TikTok API，安装插件前需先配置：
+Tiky 首次调用 TikTok 工具时会自动打开浏览器引导登录 ScoreHub。登录一次后 Token 缓存在本地（`~/.scorehub/`），Claude Code 与 WorkBuddy 共享，无需重复授权。
 
-```bash
-npm install -g @scorehub/mcp-server
-```
+## 快速开始
 
-配置说明见 [@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)。
+直接对 Tiky 说：
 
-## 快速开始
+- 帮我搜索适合合作的 TikTok 达人，类目是美妆，GMV 在 1000-10000 美元区间
+- 分析这 10 个达人的带货表现，帮我打分排名
+- 用我的建联话术模板，给这 50 个达人批量发送合作消息
 
-安装完成后，可以直接对 Tiky 说：
+## 相关链接
 
-- 帮我搜索适合合作的TikTok达人，类目是美妆，GMV在1000-10000美元区间
-- 分析这10个达人的带货表现，帮我打分排名
-- 用我的建联话术模板，给这50个达人批量发送合作消息
+- MCP Server：[@scorehub/mcp-server](https://www.npmjs.com/package/@scorehub/mcp-server)
+- 仓库：[ScoreHub-AI/creator-outreach](https://github.com/ScoreHub-AI/creator-outreach)

package/install.js

@@ -4,6 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+const pkg = require('./package.json');
+console.log(`${pkg.name} v${pkg.version}\n`);
+
 // === Claude Code 路径 ===
 const CLAUDE_DIR = path.join(os.homedir(), '.claude');
 const AGENTS_DIR = path.join(CLAUDE_DIR, 'agents');
@@ -29,19 +32,22 @@ const MCP_CONFIG = {
   },
 };
 
-// 工具函数：解析 WorkBuddy 捆绑的 npx 全路径（WorkBuddy PATH 中不含系统 npx）
-function resolveNpxPath() {
+// 工具函数：解析 WorkBuddy 捆绑的 node bin 目录
+// WorkBuddy spawn 子进程的 PATH 不含 node，npx 及其下载的包依赖 #!/usr/bin/env node，
+// 找不到 node 会秒退导致 "Connection closed"。返回 npx 全路径 + bin 目录用于注入 PATH。
+function resolveWorkBuddyNode() {
   const versionsDir = path.join(WORKBUDDY_DIR, 'binaries', 'node', 'versions');
   try {
     const versions = fs.readdirSync(versionsDir);
     if (versions.length > 0) {
-      const npxPath = path.join(versionsDir, versions[0], 'bin', 'npx');
-      if (fs.existsSync(npxPath)) return npxPath;
+      const binDir = path.join(versionsDir, versions[0], 'bin');
+      const npxPath = path.join(binDir, 'npx');
+      if (fs.existsSync(npxPath)) return { npx: npxPath, binDir };
     }
   } catch {
-    // 目录不存在或无权限，fallback 到 "npx"
+    // 目录不存在或无权限
   }
-  return 'npx';
+  return { npx: 'npx', binDir: null };
 }
 
 // 工具函数：合并 MCP Server 配置到 JSON 文件
@@ -102,7 +108,15 @@ if (hasWorkBuddy) {
   console.log(`✓ WorkBuddy: 插件文件已安装 → ${WORKBUDDY_PLUGIN_DIR}`);
 
   // 4. 合并 MCP Server 配置到 ~/.workbuddy/mcp.json
-  const wbMCPConfig = Object.assign({}, MCP_CONFIG, { command: resolveNpxPath() });
+  //    - 去掉 type 字段（WorkBuddy 不识别）
+  //    - command 用 npx 全路径（WorkBuddy PATH 不含系统 npx）
+  //    - env.PATH 注入 node bin 目录（否则 npx 及其子进程的 shebang 找不到 node，秒退报 Connection closed）
+  const { npx, binDir } = resolveWorkBuddyNode();
+  const { type: _, ...baseMCPConfig } = MCP_CONFIG;
+  const wbEnv = binDir
+    ? Object.assign({}, MCP_CONFIG.env, { PATH: `${binDir}:/usr/local/bin:/usr/bin:/bin` })
+    : MCP_CONFIG.env;
+  const wbMCPConfig = Object.assign({}, baseMCPConfig, { command: npx, env: wbEnv });
   mergeMcpConfig(WORKBUDDY_MCP_JSON, 'scorehub', wbMCPConfig, { disabled: false });
   console.log(`✓ WorkBuddy: MCP Server 已配置 → ${WORKBUDDY_MCP_JSON}`);
 }

package/package.json

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