@scorehub/creator-outreach 1.8.1 → 1.10.0

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-creator-outreach",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across 13 markets in Southeast Asia, the United States, and Europe.",
   "author": {
     "name": "Ben",
@@ -13,21 +13,22 @@
     "./skills/tiktok-creator-search",
     "./skills/tiktok-creator-analysis",
     "./skills/tiktok-batch-outreach",
-    "./skills/tiktok-similar-creators"
+    "./skills/tiktok-similar-creators",
+    "./skills/tiktok-affiliate-analytics"
   ],
   "expertType": "agent",
   "agentName": "tiktok-creator-outreach",
   "displayName": {
-    "en": "ScoreHub AI TikTok Creator Marketing Expert",
-    "zh": "ScoreHub AI TikTok达人营销专家"
+    "en": "ScoreHub Tiky",
+    "zh": "ScoreHub Tiky"
   },
   "profession": {
-    "en": "Tiky · TikTok Creator Marketing Expert",
-    "zh": "Tiky · TikTok达人营销专家"
+    "en": "TikTok Creator Marketing Expert",
+    "zh": "TikTok 达人营销专家"
   },
   "displayDescription": {
-    "en": "Tiky is ScoreHub AI's TikTok creator marketing expert, helping sellers build clear creator profiles, evaluate collaboration potential, and validate focused shortlists through targeted outreach.",
-    "zh": "Tiky 是 ScoreHub AI 打造的 TikTok 达人营销专家，帮助卖家建立清晰准确的达人画像、评估合作价值，并通过精选名单的小范围建联快速验证。"
+    "en": "Tiky is ScoreHub AI's TikTok creator marketing expert for creator profiles, shop analytics, and focused outreach.",
+    "zh": "Tiky 是 ScoreHub AI TikTok 达人营销专家，达人画像、小范围建联验证及经营分析"
   },
   "avatar": "avatars/scorehub-ai-white.png",
   "categoryId": "07-SalesCommerce",
@@ -48,24 +49,20 @@
     {
       "en": "Creator Marketing",
       "zh": "达人营销"
-    },
-    {
-      "en": "Southeast Asia",
-      "zh": "东南亚"
-    },
-    {
-      "en": "United States",
-      "zh": "美国"
-    },
-    {
-      "en": "Europe",
-      "zh": "欧洲"
     }
   ],
   "quickPrompts": [
     {
       "en": "What can Tiky help me do?",
       "zh": "我想了解 Tiky 能帮我做什么"
+    },
+    {
+      "en": "Find TikTok creators for my store category",
+      "zh": "帮我找一批适合我店铺品类的 TikTok 达人"
+    },
+    {
+      "en": "Analyze my shop's affiliate performance and product results for the previous calendar month",
+      "zh": "分析我店铺上个月的联盟经营和商品表现"
     }
   ]
 }

package/README.en.md

@@ -4,6 +4,10 @@ Chinese version: [README.md](./README.md)
 
 **ScoreHub AI TikTok Creator Marketing Expert · Tiky** is ScoreHub AI's creator marketing expert for TikTok Shop sellers. Tiky discovers suitable creators by category, GMV, units sold, follower count and age/gender profile, content performance, and collaboration traits, then combines recent commerce, content, category, and audience data into clear, comparable creator profiles. Sellers can use those profiles to select a focused shortlist and quickly validate collaboration hypotheses through targeted outreach. Tiky is not a mass-messaging tool for contacting thousands of creators. TikTok operations run through ScoreHub MCP, and ScoreHub manages the TikTok API credentials so users do not need to configure them.
 
+## Shop Analytics
+
+Tiky's fifth Skill provides read-only analysis of authorized shops, including shop overview, affiliate contribution, product performance, product affiliate orders, and top creators by product. It checks authorization and data readiness before querying a single day or month.
+
 ## Supported Markets
 
 Tiky currently covers 13 country markets: Indonesia (ID), Thailand (TH), Malaysia (MY), Vietnam (VN), the Philippines (PH), Singapore (SG), the United States (US), the United Kingdom (GB), Germany (DE), Italy (IT), France (FR), Spain (ES), and Ireland (IE). The Agent specification is authoritative for this market boundary.
@@ -23,7 +27,7 @@ For the public release, end users only need to:
 
    `https://www.workbuddy.cn/work/launch/?sharecode=lNM8H05BRKoV-dw2gac3ZwQ-p01o3C3KVz1gXJ_CwvtX02-mSRqBB3xepE4V0gr7&expertname=Tiky+%C2%B7+TikTok%E8%BE%BE%E4%BA%BA%E8%90%A5%E9%94%80%E4%B8%93%E5%AE%B6&buddy_type=workbuddy`
 
-3. Return to WorkBuddy and open the “Tiky · TikTok Creator Marketing Expert” conversation
+3. Return to WorkBuddy and open the “ScoreHub Tiky” conversation
 
 Tiky uses `npx -y @scorehub/creator-outreach@latest` to run a bootstrap check before every new conversation. When the machine is uninitialized, Tiky explains that the ScoreHub local component is required and waits for explicit confirmation. It then prefetches and self-checks `@scorehub/mcp-server@latest` before updating Tiky's files and the WorkBuddy `scorehub` MCP configuration. WorkBuddy must be fully restarted after the initial installation.
 
@@ -43,13 +47,31 @@ The installer configures WorkBuddy only. If it does not find WorkBuddy, it exits
 
 | Client | Detection | Installed content | How to use |
 |---|---|---|---|
-| WorkBuddy | `~/.workbuddy/` exists | Plugin files in `~/.workbuddy/plugins/.../`; MCP configuration merged into `~/.workbuddy/mcp.json` | Restart, then select “ScoreHub AI TikTok Creator Marketing Expert” from the Agent list |
+| WorkBuddy | `~/.workbuddy/` exists | Only the MCP configuration is merged into `~/.workbuddy/mcp.json` by default; `--dev` additionally writes a self-test plugin directory | Restart, then select “ScoreHub Tiky” from the Agent list |
 
 Before writing the configuration, Tiky verifies the MCP server with `--self-check --json`, then WorkBuddy starts it automatically. macOS and Linux use `npx -y @scorehub/mcp-server@latest`. Windows reuses WorkBuddy's managed `node.exe` to load the matching npm `npx-cli.js` directly, avoiding `.cmd` / `.bat` process-launch compatibility problems. Tiky only guides users to the official Node.js LTS installer when the managed runtime is explicitly missing or too old.
 
+## Two Delivery Channels
+
+| | Platform channel (end users) | Local self-test channel (developers) |
+|---|---|---|
+| Source | Listing package on the open platform, downloaded by WorkBuddy | This repository's source, written by `bootstrap --dev` |
+| Marketplace / plugin | `experts` / `tiktok-creator-outreach` | `my-experts` / `tiktok-creator-outreach-dev` |
+| Display name | ScoreHub Tiky | ScoreHub Tiky (local dev) |
+| Skill ids | `tiktok-creator-search`, etc. | The same ids with a `-dev` suffix |
+
+A default install (`bootstrap --install`) **only configures MCP** and never creates a second expert. Add `--dev` to register the local source as a self-test copy and validate new features before release. The self-test copy ships its own `-dev` skill ids, so the two channels no longer shadow each other when both are present — WorkBuddy resolves skills by name and silently skips duplicates, and the `enabledPlugins` flag does not stop loading, so distinct ids are the only reliable isolation.
+
+```bash
+# Self-test: write local source, register it under "My Experts", and advance the load position
+node packages/creator-outreach/install.js bootstrap --dev --install --json
+```
+
+`--dev` rewrites the versioned cache every time, so each run requires a full WorkBuddy restart to take effect. The self-test copy records its source root (this repository), so even a silent update triggered by the published npm package later refreshes it from that repository instead of overwriting your unpublished changes with release code. Disable or uninstall “ScoreHub Tiky (local dev)” on the plugin management page when you are done; both copies still share the same agent name, so disable the platform copy first if you ever see cross-talk. Installs and silent updates also clean up the legacy same-named `my-experts` copy left by older installers, which used to load duplicate skill names alongside the platform build.
+
 ## First Use and Authorization
 
-At the start of every new conversation, Tiky first checks one of four bootstrap states: `uninitialized`, `restart_required`, `ready`, or `repair_required`. Only `ready` permits the capability introduction, account or shop switching, and business operations. The first TikTok tool call then opens ScoreHub login when authorization is needed. After authorization, reauthorization, or a shop switch, Tiky confirms the login phone number, authorized shop, country, and bound brands. Tokens remain under `~/.scorehub/` and are not removed by bootstrap or updates.
+At the start of every new conversation, Tiky first checks one of five bootstrap states: `uninitialized`, `restart_required`, `activation_required`, `ready`, or `repair_required`. Only `ready` goes straight into the capability introduction, account or shop switching, and business operations; `activation_required` means the **local self-test copy** still loads an older version from the versioned cache (a restart does not help), so Tiky re-runs `bootstrap --update` and lets the installer advance the cache itself while the current turn continues with the loaded version — end users have no local self-test copy and never see this state. The first TikTok tool call then opens ScoreHub login when authorization is needed. After authorization, reauthorization, or a shop switch, Tiky confirms the login phone number, authorized shop, country, and bound brands. Tokens remain under `~/.scorehub/` and are not removed by bootstrap or updates.
 
 If Tiky says that the current shop's TikTok authorization is invalid or unavailable, your local ScoreHub login is usually still valid. Rebind the shop in ScoreHub and try again; do not repeat browser login.
 
@@ -63,6 +85,7 @@ Ask Tiky:
 - Find 20 beauty creators with 10K-100K followers, at least 60% female followers aged 18-34, GMV of $1K+, 5K+ average shoppable-video views, independent status, and fast growth.
 - Analyze the sales performance of these 10 creators and rank them.
 - From the top five, select the three best-matched creators, choose one benefit-first offer, preview its first 15 notification characters, and start a focused outreach validation.
+- Analyze my shop's affiliate performance and product results for the previous calendar month.
 
 ## Troubleshooting
 

package/README.md

@@ -4,6 +4,10 @@ English version: [README.en.md](./README.en.md)
 
 **ScoreHub AI TikTok达人营销专家 · Tiky** 是 ScoreHub AI 面向 TikTok Shop 卖家打造的达人营销专家。Tiky 可按类目、GMV、销量、粉丝量级与年龄/性别、内容表现和合作特征发现合适的达人，结合近 30 天带货、内容、品类和受众数据建立清晰可比较的达人画像，并通过精选后的小范围建联快速验证合作假设。Tiky 不是面向成千上万达人的海量群发工具。TikTok 操作通过 ScoreHub MCP 完成，TikTok API 凭证由 ScoreHub 托管，使用者无需配置。
 
+## 数据分析
+
+Tiky 的第五个 Skill 支持只读复盘已授权店铺的经营总览、联盟贡献、商品表现、商品联盟订单和商品 TOPN 出单达人。分析会先检查店铺授权和数据是否就绪，再按单日或单月范围查询。
+
 ## 支持市场
 
 Tiky 当前覆盖 13 个国家市场：印度尼西亚（ID）、泰国（TH）、马来西亚（MY）、越南（VN）、菲律宾（PH）、新加坡（SG）、美国（US）、英国（GB）、德国（DE）、意大利（IT）、法国（FR）、西班牙（ES）和爱尔兰（IE）。市场边界以 Agent 规范为准。
@@ -23,7 +27,7 @@ Tiky 当前覆盖 13 个国家市场：印度尼西亚（ID）、泰国（TH）
 
    `https://www.workbuddy.cn/work/launch/?sharecode=lNM8H05BRKoV-dw2gac3ZwQ-p01o3C3KVz1gXJ_CwvtX02-mSRqBB3xepE4V0gr7&expertname=Tiky+%C2%B7+TikTok%E8%BE%BE%E4%BA%BA%E8%90%A5%E9%94%80%E4%B8%93%E5%AE%B6&buddy_type=workbuddy`
 
-3. 回到 WorkBuddy，打开 “Tiky · TikTok达人营销专家” 对话
+3. 回到 WorkBuddy，打开 “ScoreHub Tiky” 对话
 
 Tiky 每个新会话都会通过 `npx -y @scorehub/creator-outreach@latest` 执行 bootstrap 检查。未初始化时，她会说明需要安装 ScoreHub 本地组件，并等待你明确确认；确认后预拉取并自检 `@scorehub/mcp-server@latest`，再更新 Tiky 本地文件和 WorkBuddy 的 `scorehub` MCP 配置。安装完成后需要完全重启 WorkBuddy。
 
@@ -43,13 +47,31 @@ npx -y @scorehub/creator-outreach
 
 | 客户端 | 检测条件 | 安装内容 | 使用方式 |
 |---|---|---|---|
-| WorkBuddy | `~/.workbuddy/` 存在 | 插件文件写入 `~/.workbuddy/plugins/.../`；MCP 配置合并到 `~/.workbuddy/mcp.json` | 重启后在 Agent 列表选择“ScoreHub AI TikTok达人营销专家” |
+| WorkBuddy | `~/.workbuddy/` 存在 | 默认只把 MCP 配置合并到 `~/.workbuddy/mcp.json`；加 `--dev` 时才额外写入自测插件目录 | 重启后在 Agent 列表选择“ScoreHub Tiky” |
 
 MCP Server（`@scorehub/mcp-server`）在写入配置前会先通过 `--self-check --json` 验证可执行性，之后由 WorkBuddy 自动拉起。macOS / Linux 使用 `npx -y @scorehub/mcp-server@latest`；Windows 复用 WorkBuddy 托管的 `node.exe` 直接加载同版本 npm 的 `npx-cli.js`，避免 `.cmd` / `.bat` 的进程启动兼容问题。只有在托管运行时明确缺失或版本过低时，Tiky 才会引导你安装官方 Node.js LTS。
 
+## 两条交付通道
+
+| | 平台通道（终端用户） | 本地自测通道（开发者） |
+|---|---|---|
+| 来源 | 开放平台上架包，WorkBuddy 自动下载 | 本仓库源码，`bootstrap --dev` 写入 |
+| 市场 / 插件名 | `experts` / `tiktok-creator-outreach` | `my-experts` / `tiktok-creator-outreach-dev` |
+| 显示名 | ScoreHub Tiky | ScoreHub Tiky（本地自测） |
+| 技能 id | `tiktok-creator-search` 等 | 同上但统一带 `-dev` 后缀 |
+
+默认安装（`bootstrap --install`）**只配置 MCP**，不会创建第二份专家；用 `--dev` 才会把本地源码注册成自测副本，用来在发布前验证新功能。自测副本另有一套 `-dev` 技能 id，两条通道共存时不会互相遮蔽 —— WorkBuddy 对同名技能是「先加载者占用、后者静默跳过」，且 `enabledPlugins` 开关拦不住加载，所以 id 隔离是唯一的可靠手段。
+
+```bash
+# 自测：写入本地源码、注册到「我的专家」并推进加载位
+node packages/creator-outreach/install.js bootstrap --dev --install --json
+```
+
+`--dev` 每次都会重写版本化缓存，因此每次都需要完全重启 WorkBuddy 才生效。自测副本的代码来源（本仓库根）会记进登记表，因此后续连 agent 会话里来自 npm 发布包的静默更新也只从这个仓库取材，不会用发布版覆盖你还没发布的改动。自测完成后可到插件管理页停用或卸载“ScoreHub Tiky（本地自测）”；两者 agent 名仍相同，若发现行为串味先停用平台版。安装与静默更新还会自动清掉旧版安装器留下的同名 `my-experts` 残留（它曾与平台版同时加载同名技能）。
+
 ## 首次使用与授权
 
-每个新对话的第一轮，Tiky 都先检查 `uninitialized` / `restart_required` / `ready` / `repair_required` bootstrap 状态。只有 `ready` 才进入能力介绍、账号/店铺切换或业务操作。首次 TikTok 工具调用时会打开浏览器引导你登录 ScoreHub。授权、重新授权或店铺切换成功后，Tiky 会依次确认当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌。Token 缓存在 `~/.scorehub/`，不会被 bootstrap 或升级清除。
+每个新对话的第一轮，Tiky 都先检查 `uninitialized` / `restart_required` / `activation_required` / `ready` / `repair_required` 五个 bootstrap 状态。只有 `ready` 才直接进入能力介绍、账号/店铺切换或业务操作；`activation_required` 表示**本地自测副本**的加载位仍停在旧版本（重启无效），Tiky 会重跑 `bootstrap --update` 由安装器自己把缓存推进到新版本并允许本轮继续使用已加载版本 —— 终端用户没有本地自测副本，不会遇到这个状态。首次 TikTok 工具调用时会打开浏览器引导你登录 ScoreHub。授权、重新授权或店铺切换成功后，Tiky 会依次确认当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌。Token 缓存在 `~/.scorehub/`，不会被 bootstrap 或升级清除。
 
 如果提示当前店铺的 TikTok 授权已失效或异常，本地 ScoreHub 登录通常仍然有效。请先到 ScoreHub 重新绑定店铺，再重试；不要反复进行浏览器登录。
 
@@ -64,6 +86,8 @@ MCP Server（`@scorehub/mcp-server`）在写入配置前会先通过 `--self-che
 - 分析这 10 个达人的带货表现，帮我打分排名
 - 从排名前 5 位中选出最匹配的 3 位，选择一种利益前置 Offer，预览通知栏前 15 字后发起建联验证
 
+- 分析我店铺上个月的联盟经营和商品表现
+
 ## 故障排查
 
 ### 找不到受支持的客户端

package/agents/tiktok-creator-outreach.md

@@ -2,17 +2,18 @@
 name: tiktok-creator-outreach
 description: ScoreHub AI's TikTok creator marketing expert. Builds clear, comparable creator profiles, evaluates collaboration potential, and validates focused shortlists through targeted outreach. Not a mass-messaging tool.
 displayName:
-  en: "ScoreHub AI TikTok Creator Marketing Expert"
-  zh: "ScoreHub AI TikTok达人营销专家"
+  en: "ScoreHub Tiky"
+  zh: "ScoreHub Tiky"
 profession:
-  en: "Tiky · TikTok Creator Marketing Expert"
-  zh: "Tiky · TikTok达人营销专家"
+  en: "TikTok Creator Marketing Expert"
+  zh: "TikTok 达人营销专家"
 maxTurns: 100
 skills:
   - tiktok-creator-search
   - tiktok-creator-analysis
   - tiktok-batch-outreach
   - tiktok-similar-creators
+  - tiktok-affiliate-analytics
 ---
 
 # ScoreHub AI TikTok达人营销专家 · Tiky
@@ -33,8 +34,9 @@ skills:
 
 - `uninitialized`：只告知用户 Tiky 需要安装 ScoreHub 本地组件才能使用达人能力，且不会清除现有授权数据；**必须等待用户明确确认**。确认后执行 `npx -y @scorehub/creator-outreach@latest bootstrap --install --json`。返回 `restart_required` 后提示完全退出并重启 WorkBuddy，本轮结束。这次确认同时代表用户允许后续静默更新，不再对每个 creator-outreach 新版本重复询问。
 - `restart_required`：仅为确认重启是否生效调用本地 `status`。若返回 `config_source.managed_by = "@scorehub/creator-outreach"`、`config_source.client_host = "workbuddy"`，且 `config_source.creator_outreach_version` 与本次 bootstrap 检查返回的 `installed_creator_outreach_version` 一致，执行 `npx -y @scorehub/creator-outreach@latest bootstrap --mark-ready --json` 清除重启标记并继续；若 `status` 不可用、版本不一致、返回其他托管信息或调用失败，只提示完全退出并重启 WorkBuddy，不进入业务流程。
+- `activation_required`：本地自测通道的加载位仍停在旧版本（源码位已写入新版本），**重启无效**。执行 `npx -y @scorehub/creator-outreach@latest bootstrap --update --json`，安装器会把本地自测通道的版本化缓存推进到新版本并重新登记；返回 `restart_required` 或 `ready` 后按对应分支处理。此时不得提示用户去插件管理页点「更新」（自测通道不经市场升级），不得自行改写 `installed_plugins.json` 或缓存目录。仅当重跑 `--update` 后仍返回 `activation_required` 时，才回退为提示重新打开分享链接覆盖安装。本轮可继续使用已加载版本，并在末尾简短提示这一步。
 - `repair_required`：说明结果中的可恢复原因。若明确是 Node.js / npm / npx 问题，进入“本地运行环境恢复”；其他情况经用户确认后重试 `bootstrap --install --json`。修复前不进入业务流程。
-- `ready`：仅当结果同时返回 `update_due = true` 时，执行 `npx -y @scorehub/creator-outreach@latest bootstrap --update --silent --json`；否则直接继续。更新返回 `ready` 时继续；返回 `restart_required` 时可继续使用当前已加载版本，但需在首轮末尾简短提示重启后使用新版本。网络检查失败但现有 MCP 仍可用时，保留当前版本并继续，不误判为 OAuth 问题。
+- `ready`：仅当结果同时返回 `update_due = true` 时，执行 `npx -y @scorehub/creator-outreach@latest bootstrap --update --silent --json`；否则直接继续。更新返回 `ready` 时继续；返回 `activation_required` 时按该分支处理（重跑 `bootstrap --update --json`，可继续使用已加载版本）；返回 `restart_required` 时可继续使用当前已加载版本，但需在首轮末尾简短提示重启后使用新版本。网络检查失败但现有 MCP 仍可用时，保留当前版本并继续，不误判为 OAuth 问题。
 
 宿主不支持执行本地命令时，回退为提示用户重新打开分享链接 `https://www.workbuddy.cn/work/launch/?sharecode=lNM8H05BRKoV-dw2gac3ZwQ-p01o3C3KVz1gXJ_CwvtX02-mSRqBB3xepE4V0gr7&expertname=Tiky+%C2%B7+TikTok%E8%BE%BE%E4%BA%BA%E8%90%A5%E9%94%80%E4%B8%93%E5%AE%B6&buddy_type=workbuddy` 进行覆盖安装；不要让终端用户手工编辑 `mcp.json`。
 
@@ -57,7 +59,7 @@ bootstrap 返回 `ready` 后，再识别以下明确意图：
 
 > 你好，我是 Tiky，ScoreHub AI 的 TikTok 达人营销专家。我先帮你建立清晰准确的达人画像，评估合作价值，再对精选候选人进行小范围建联验证。我不是面向成千上万达人的海量群发工具。以下是我能帮你做的事情：
 >
-> ## 四大核心能力
+> ## 五大核心能力
 >
 > **1. 搜索达人** — 从 TikTok Creator Marketplace 多维度筛选
 > - 按品类、用户名或昵称
@@ -79,6 +81,18 @@ bootstrap 返回 `ready` 后，再识别以下明确意图：
 > - 用于验证精选名单，不以海量发送为目标
 > - 智能控制发送频率，降低触发频率限制的风险
 >
+> **4. 相似达人推荐** — 以目标达人为模板，寻找带货表现特征相似的其他达人
+> - 从搜索结果中选择一位目标达人，拓展新的合作候选
+> - 支持按需调整推荐数量，实际返回以可用候选为准
+> - 按相似度排序，并展示相似度、数据置信度和差异化亮点
+> - 推荐结果可继续用于达人画像分析和精选建联验证
+>
+> **5. 数据分析** — 按单日或单月复盘已授权店铺的联盟经营和商品结果
+> - 查看店铺整体经营、趋势变化和联盟渠道贡献
+> - 分析商品表现、商品联盟订单以及重点商品的出单达人
+> - 结合有效历史关联，整理达人贡献、订单结果和可识别的风险与机会
+> - 只读取已授权且完成同步的数据，不会自动同步、修改业务数据或发起建联
+>
 > ## 支持的市场
 >
 > 当前覆盖 13 个国家市场：东南亚的印度尼西亚（ID）、泰国（TH）、马来西亚（MY）、越南（VN）、菲律宾（PH）、新加坡（SG），美国（US），以及欧洲的英国（GB）、德国（DE）、意大利（IT）、法国（FR）、西班牙（ES）、爱尔兰（IE）。
@@ -129,6 +143,11 @@ bootstrap 返回 `ready` 后，再识别以下明确意图：
 - 默认返回 20 位相似达人，可按需调整为 1–50。
 - 外部评分、候选筛选、召回策略和结果展示完整遵循 `tiktok-similar-creators` Skill，不在 Agent 中重复定义。
 
+### 5. 店铺联盟经营数据分析
+复盘已授权店铺在单日或单月范围内的店铺经营、联盟贡献、商品表现、商品联盟订单和商品 TOPN 出单达人。
+- 分析准入、日期规则、五个分析场景和只读工具编排完整遵循 `tiktok-affiliate-analytics` Skill，不在 Agent 中复制指标或 SQL。
+- 分析结果中的本店历史事实与官方达人当前画像分开表达；分析不会自动同步数据、建联、发消息或修改业务数据。
+
 ## 标准工作流程
 
 当你找到我时，通常走这三步：
@@ -193,6 +212,9 @@ Step 3: 小范围建联验证
 - `create_conversation` — 创建达人会话（建联前置，用 `creator_open_id`）
 - `send_message` — 发送建联消息
 - `find_similar_creators` — 以目标达人为模板寻找相似达人
+- `get_analytics_readiness` — 查询分析店铺、数值 ID 映射和同步准入
+- `analyze_shop_overview` / `analyze_affiliate_contribution` / `analyze_product_performance` — 店铺、联盟和商品经营分析
+- `analyze_product_affiliate_orders` / `analyze_product_top_creators` — 商品联盟订单和出单达人分析
 - `authorize` — OAuth 授权；切换店铺时传 `{ "switch_shop": true }`，切换账号时传 `{ "force": true }`
 - `status` — 连接状态