@optima-chat/optima-agent 0.9.8 → 0.9.9
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.
- package/.claude/settings.local.json +166 -0
- package/.claude/skills/.kb-skills-managed.json +9 -9
- package/.claude/skills/ads/SKILL.md +244 -244
- package/.claude/skills/ads/template/campaign/CREATIVES.md +18 -18
- package/.claude/skills/ads/template/campaign/NOTES.md +10 -10
- package/.claude/skills/ads/template/campaign/STRATEGY.md +29 -29
- package/.claude/skills/ads/template/user/ADS.md +29 -29
- package/.claude/skills/ads/template/user/LEARNINGS.md +15 -15
- package/.claude/skills/ads/template/user/PROGRESS.md +20 -20
- package/.claude/skills/ads/template/user/README.md +25 -25
- package/.claude/skills/ads/template/user/assets/.gitignore +2 -2
- package/.claude/skills/bi/SKILL.md +131 -131
- package/.claude/skills/browser/SKILL.md +201 -201
- package/.claude/skills/channels/SKILL.md +188 -188
- package/.claude/skills/collection/SKILL.md +88 -88
- package/.claude/skills/douyin/SKILL.md +408 -408
- package/.claude/skills/ffmpeg/SKILL.md +164 -164
- package/.claude/skills/gen/SKILL.md +279 -279
- package/.claude/skills/growth/SKILL.md +90 -90
- package/.claude/skills/growth/template/ACCOUNTS.md +14 -14
- package/.claude/skills/growth/template/CALENDAR.md +7 -7
- package/.claude/skills/growth/template/COMMENTS.md +7 -7
- package/.claude/skills/growth/template/GROWTH.md +37 -37
- package/.claude/skills/growth/template/PROGRESS.md +4 -4
- package/.claude/skills/growth/template/README.md +20 -20
- package/.claude/skills/growth/template/TOPICS.md +7 -7
- package/.claude/skills/homepage/SKILL.md +177 -177
- package/.claude/skills/i18n/SKILL.md +517 -517
- package/.claude/skills/ingesting-sources/SKILL.md +94 -94
- package/.claude/skills/initializing-kb/SKILL.md +117 -117
- package/.claude/skills/instagram/SKILL.md +321 -321
- package/.claude/skills/inventory/SKILL.md +328 -328
- package/.claude/skills/kol-outreach/SKILL.md +232 -232
- package/.claude/skills/kol-outreach/template/campaign/CONFIG.md +60 -60
- package/.claude/skills/kol-outreach/template/campaign/KOLS.md +6 -6
- package/.claude/skills/kol-outreach/template/campaign/PROGRESS.md +3 -3
- package/.claude/skills/kol-outreach/template/campaign/TEMPLATES.md +88 -88
- package/.claude/skills/kol-outreach/template/merchant/BRAND.md +36 -36
- package/.claude/skills/kol-outreach/template/merchant/CAMPAIGNS.md +6 -6
- package/.claude/skills/kol-outreach/template/merchant/MERCHANT_LIMITS.md +16 -16
- package/.claude/skills/kol-outreach/template/merchant/PROGRESS.md +4 -4
- package/.claude/skills/kol-outreach/template/merchant/README.md +20 -20
- package/.claude/skills/linting-the-wiki/SKILL.md +68 -68
- package/.claude/skills/logistics/SKILL.md +180 -180
- package/.claude/skills/markdown-pdf/SKILL.md +72 -72
- package/.claude/skills/merchant/SKILL.md +110 -110
- package/.claude/skills/multigrid-poster/SKILL.md +192 -192
- package/.claude/skills/multigrid-poster/layouts/2x2.json +34 -34
- package/.claude/skills/multigrid-poster/layouts/3x3.json +43 -43
- package/.claude/skills/multigrid-poster/scripts/compose.py +116 -116
- package/.claude/skills/order/SKILL.md +452 -452
- package/.claude/skills/product/SKILL.md +379 -379
- package/.claude/skills/product-page/SKILL.md +106 -106
- package/.claude/skills/querying-the-wiki/SKILL.md +59 -59
- package/.claude/skills/reddit/SKILL.md +277 -277
- package/.claude/skills/review/SKILL.md +321 -321
- package/.claude/skills/scout/SKILL.md +575 -462
- package/.claude/skills/sentinel/SKILL.md +281 -281
- package/.claude/skills/shein/SKILL.md +246 -246
- package/.claude/skills/shipping/SKILL.md +200 -200
- package/.claude/skills/shop-content/SKILL.md +101 -101
- package/.claude/skills/shopify/SKILL.md +282 -282
- package/.claude/skills/skillify/SKILL.md +114 -114
- package/.claude/skills/taobao/SKILL.md +238 -238
- package/.claude/skills/tiktok/SKILL.md +381 -381
- package/.claude/skills/twitter/SKILL.md +302 -302
- package/.claude/skills/updating-related-pages/SKILL.md +65 -65
- package/.claude/skills/video-edit/SKILL.md +143 -143
- package/.claude/skills/video-gen/SKILL.md +548 -548
- package/.claude/skills/video-gen/templates/INDEX.md +78 -78
- package/.claude/skills/video-gen/templates/before-after-beauty.md +183 -183
- package/.claude/skills/video-gen/templates/drama-fmcg.md +183 -183
- package/.claude/skills/video-gen/templates/kol-reaction-food.md +193 -193
- package/.claude/skills/video-gen/templates/multi-point-apparel.md +185 -185
- package/.claude/skills/video-gen/templates/pain-solution-home.md +184 -184
- package/.claude/skills/video-gen/templates/pdp-360-showcase.md +189 -189
- package/.claude/skills/video-gen/templates/pdp-feature-highlight.md +182 -182
- package/.claude/skills/video-gen/templates/scene-digital.md +183 -183
- package/.claude/skills/wechat/SKILL.md +174 -174
- package/.claude/skills/xhs/SKILL.md +170 -170
- package/README.md +276 -276
- package/dist/bin/bi-cli.js +0 -0
- package/dist/bin/browser-cli.js +0 -0
- package/dist/bin/comfy.d.ts +3 -0
- package/dist/bin/comfy.d.ts.map +1 -0
- package/dist/bin/comfy.js +3 -0
- package/dist/bin/comfy.js.map +1 -0
- package/dist/bin/commerce.js +0 -0
- package/dist/bin/gen.js +0 -0
- package/dist/bin/google-ads.js +0 -0
- package/dist/bin/growth.d.ts +3 -0
- package/dist/bin/growth.d.ts.map +1 -0
- package/dist/bin/growth.js +3 -0
- package/dist/bin/growth.js.map +1 -0
- package/dist/bin/logistics.js +0 -0
- package/dist/bin/optima.js +26 -26
- package/dist/bin/scout.js +0 -0
- package/dist/bin/sentinel.js +0 -0
- package/dist/bin/serve.js +23 -23
- package/dist/bin/shopify.js +0 -0
- package/dist/src/agent.js +4 -4
- package/dist/src/hooks-loader.d.ts +6 -0
- package/dist/src/hooks-loader.d.ts.map +1 -0
- package/dist/src/hooks-loader.js +215 -0
- package/dist/src/hooks-loader.js.map +1 -0
- package/dist/src/system-prompt.d.ts.map +1 -1
- package/dist/src/system-prompt.js +173 -169
- package/dist/src/system-prompt.js.map +1 -1
- package/dist/src/tools/memory.js +10 -10
- package/dist/src/ui/App.d.ts +6 -0
- package/dist/src/ui/App.d.ts.map +1 -0
- package/dist/src/ui/App.js +164 -0
- package/dist/src/ui/App.js.map +1 -0
- package/dist/src/ui/components/Composer.d.ts +10 -0
- package/dist/src/ui/components/Composer.d.ts.map +1 -0
- package/dist/src/ui/components/Composer.js +13 -0
- package/dist/src/ui/components/Composer.js.map +1 -0
- package/dist/src/ui/components/Header.d.ts +7 -0
- package/dist/src/ui/components/Header.d.ts.map +1 -0
- package/dist/src/ui/components/Header.js +7 -0
- package/dist/src/ui/components/Header.js.map +1 -0
- package/dist/src/ui/components/Message.d.ts +12 -0
- package/dist/src/ui/components/Message.d.ts.map +1 -0
- package/dist/src/ui/components/Message.js +21 -0
- package/dist/src/ui/components/Message.js.map +1 -0
- package/dist/src/ui/components/MessageList.d.ts +9 -0
- package/dist/src/ui/components/MessageList.d.ts.map +1 -0
- package/dist/src/ui/components/MessageList.js +18 -0
- package/dist/src/ui/components/MessageList.js.map +1 -0
- package/dist/src/ui/components/Spinner.d.ts +6 -0
- package/dist/src/ui/components/Spinner.d.ts.map +1 -0
- package/dist/src/ui/components/Spinner.js +7 -0
- package/dist/src/ui/components/Spinner.js.map +1 -0
- package/dist/src/ui/components/StatusBar.d.ts +11 -0
- package/dist/src/ui/components/StatusBar.d.ts.map +1 -0
- package/dist/src/ui/components/StatusBar.js +7 -0
- package/dist/src/ui/components/StatusBar.js.map +1 -0
- package/dist/src/ui/components/index.d.ts +7 -0
- package/dist/src/ui/components/index.d.ts.map +1 -0
- package/dist/src/ui/components/index.js +7 -0
- package/dist/src/ui/components/index.js.map +1 -0
- package/dist/src/ui/headless.js +7 -7
- package/dist/src/validation/error-formatter.d.ts +21 -0
- package/dist/src/validation/error-formatter.d.ts.map +1 -0
- package/dist/src/validation/error-formatter.js +98 -0
- package/dist/src/validation/error-formatter.js.map +1 -0
- package/dist/src/validation/index.d.ts +10 -0
- package/dist/src/validation/index.d.ts.map +1 -0
- package/dist/src/validation/index.js +10 -0
- package/dist/src/validation/index.js.map +1 -0
- package/dist/src/validation/json-validator.d.ts +25 -0
- package/dist/src/validation/json-validator.d.ts.map +1 -0
- package/dist/src/validation/json-validator.js +173 -0
- package/dist/src/validation/json-validator.js.map +1 -0
- package/dist/src/validation/schema.d.ts +353 -0
- package/dist/src/validation/schema.d.ts.map +1 -0
- package/dist/src/validation/schema.js +57 -0
- package/dist/src/validation/schema.js.map +1 -0
- package/dist/src/validation/suggestions.d.ts +25 -0
- package/dist/src/validation/suggestions.d.ts.map +1 -0
- package/dist/src/validation/suggestions.js +144 -0
- package/dist/src/validation/suggestions.js.map +1 -0
- package/dist/src/validation/types.d.ts +40 -0
- package/dist/src/validation/types.d.ts.map +1 -0
- package/dist/src/validation/types.js +5 -0
- package/dist/src/validation/types.js.map +1 -0
- package/dist/src/validation/yaml-validator.d.ts +25 -0
- package/dist/src/validation/yaml-validator.d.ts.map +1 -0
- package/dist/src/validation/yaml-validator.js +177 -0
- package/dist/src/validation/yaml-validator.js.map +1 -0
- package/package.json +79 -79
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# Ads 整体策略 (用户级)
|
|
2
|
-
> 修改后 git commit. 单个 campaign 的专属策略在 campaigns/<name>/STRATEGY.md.
|
|
3
|
-
|
|
4
|
-
## 业务目标
|
|
5
|
-
<!-- 例: 提升店铺月销量 / 打响品牌认知 / 某类目拓新 -->
|
|
6
|
-
|
|
7
|
-
## 候选产品
|
|
8
|
-
<!-- 从 commerce-backend 拉的候选, 或手填. 具体哪个 campaign 推哪个产品由每个 STRATEGY.md 定 -->
|
|
9
|
-
|
|
10
|
-
## 默认目标受众
|
|
11
|
-
<!-- 可被 campaign 级 STRATEGY.md 覆盖 -->
|
|
12
|
-
- 地域:
|
|
13
|
-
- 年龄段:
|
|
14
|
-
- 设备:
|
|
15
|
-
- 时段偏好:
|
|
16
|
-
|
|
17
|
-
## 月度总预算 (软性, 超出后所有 campaign 自动暂停到下月 1 日)
|
|
18
|
-
- 月度上限: $___
|
|
19
|
-
- 付费余额低于 $___ 时自动暂停(赠送余额不可用于广告)
|
|
20
|
-
|
|
21
|
-
## 渠道偏好
|
|
22
|
-
- [x] google_ads
|
|
23
|
-
|
|
24
|
-
## 品牌禁忌
|
|
25
|
-
<!-- 不能出现的词、不能投放的关键词、必须的免责声明 -->
|
|
26
|
-
|
|
27
|
-
## 后端登记 (由 `ads init` 自动填, 不要手动改)
|
|
28
|
-
- user_ad_account_id:
|
|
29
|
-
- google_label_id:
|
|
1
|
+
# Ads 整体策略 (用户级)
|
|
2
|
+
> 修改后 git commit. 单个 campaign 的专属策略在 campaigns/<name>/STRATEGY.md.
|
|
3
|
+
|
|
4
|
+
## 业务目标
|
|
5
|
+
<!-- 例: 提升店铺月销量 / 打响品牌认知 / 某类目拓新 -->
|
|
6
|
+
|
|
7
|
+
## 候选产品
|
|
8
|
+
<!-- 从 commerce-backend 拉的候选, 或手填. 具体哪个 campaign 推哪个产品由每个 STRATEGY.md 定 -->
|
|
9
|
+
|
|
10
|
+
## 默认目标受众
|
|
11
|
+
<!-- 可被 campaign 级 STRATEGY.md 覆盖 -->
|
|
12
|
+
- 地域:
|
|
13
|
+
- 年龄段:
|
|
14
|
+
- 设备:
|
|
15
|
+
- 时段偏好:
|
|
16
|
+
|
|
17
|
+
## 月度总预算 (软性, 超出后所有 campaign 自动暂停到下月 1 日)
|
|
18
|
+
- 月度上限: $___
|
|
19
|
+
- 付费余额低于 $___ 时自动暂停(赠送余额不可用于广告)
|
|
20
|
+
|
|
21
|
+
## 渠道偏好
|
|
22
|
+
- [x] google_ads
|
|
23
|
+
|
|
24
|
+
## 品牌禁忌
|
|
25
|
+
<!-- 不能出现的词、不能投放的关键词、必须的免责声明 -->
|
|
26
|
+
|
|
27
|
+
## 后端登记 (由 `ads init` 自动填, 不要手动改)
|
|
28
|
+
- user_ad_account_id:
|
|
29
|
+
- google_label_id:
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# 优化经验沉淀
|
|
2
|
-
> 跨 campaign 的经验和洞察. 每次 optimize 之后, AI 把可泛化的发现追加到这里.
|
|
3
|
-
> 单 campaign 特有的观察不放这里, 放对应 campaigns/<name>/NOTES.md.
|
|
4
|
-
|
|
5
|
-
## 什么有效
|
|
6
|
-
<!-- 每条都用一两句话说清楚: "发现了什么" + "在哪次 optimize 时得到的" -->
|
|
7
|
-
|
|
8
|
-
## 什么无效
|
|
9
|
-
<!-- 同上 -->
|
|
10
|
-
|
|
11
|
-
## 受众洞察
|
|
12
|
-
<!-- 哪些人群、哪些地域转化高 -->
|
|
13
|
-
|
|
14
|
-
## 时段/季节规律
|
|
15
|
-
<!-- 一周/一天的高转化时段, 季节性趋势 -->
|
|
1
|
+
# 优化经验沉淀
|
|
2
|
+
> 跨 campaign 的经验和洞察. 每次 optimize 之后, AI 把可泛化的发现追加到这里.
|
|
3
|
+
> 单 campaign 特有的观察不放这里, 放对应 campaigns/<name>/NOTES.md.
|
|
4
|
+
|
|
5
|
+
## 什么有效
|
|
6
|
+
<!-- 每条都用一两句话说清楚: "发现了什么" + "在哪次 optimize 时得到的" -->
|
|
7
|
+
|
|
8
|
+
## 什么无效
|
|
9
|
+
<!-- 同上 -->
|
|
10
|
+
|
|
11
|
+
## 受众洞察
|
|
12
|
+
<!-- 哪些人群、哪些地域转化高 -->
|
|
13
|
+
|
|
14
|
+
## 时段/季节规律
|
|
15
|
+
<!-- 一周/一天的高转化时段, 季节性趋势 -->
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
# 工作日志
|
|
2
|
-
> 每次会话结束前, 在最上方追加一段. 最新的在顶部.
|
|
3
|
-
> 每段必须标注: 时间 + 动作 + 作用的 campaign (或 "all campaigns").
|
|
4
|
-
|
|
5
|
-
<!-- 示例:
|
|
6
|
-
|
|
7
|
-
## 2026-04-11 14:30 - launch (campaign: summer-promo)
|
|
8
|
-
- 基于 ADS.md 推了产品 12345 (夏季连衣裙)
|
|
9
|
-
- 生成 5 个素材变体 (minimalist / playful / elegant / beach / street)
|
|
10
|
-
- 合规预审通过, 上线
|
|
11
|
-
- 日预算 $10
|
|
12
|
-
- 异常: 无
|
|
13
|
-
- 下次待办: 7 天后 collect + optimize
|
|
14
|
-
|
|
15
|
-
## 2026-04-10 10:00 - (init)
|
|
16
|
-
- 初始化 workspace, 填 ADS.md
|
|
17
|
-
- 月度预算 $300, 品牌禁忌: 不能用 "最便宜" "全网最低" 这类绝对化词语
|
|
18
|
-
- 用户说下次会话再 launch
|
|
19
|
-
|
|
20
|
-
-->
|
|
1
|
+
# 工作日志
|
|
2
|
+
> 每次会话结束前, 在最上方追加一段. 最新的在顶部.
|
|
3
|
+
> 每段必须标注: 时间 + 动作 + 作用的 campaign (或 "all campaigns").
|
|
4
|
+
|
|
5
|
+
<!-- 示例:
|
|
6
|
+
|
|
7
|
+
## 2026-04-11 14:30 - launch (campaign: summer-promo)
|
|
8
|
+
- 基于 ADS.md 推了产品 12345 (夏季连衣裙)
|
|
9
|
+
- 生成 5 个素材变体 (minimalist / playful / elegant / beach / street)
|
|
10
|
+
- 合规预审通过, 上线
|
|
11
|
+
- 日预算 $10
|
|
12
|
+
- 异常: 无
|
|
13
|
+
- 下次待办: 7 天后 collect + optimize
|
|
14
|
+
|
|
15
|
+
## 2026-04-10 10:00 - (init)
|
|
16
|
+
- 初始化 workspace, 填 ADS.md
|
|
17
|
+
- 月度预算 $300, 品牌禁忌: 不能用 "最便宜" "全网最低" 这类绝对化词语
|
|
18
|
+
- 用户说下次会话再 launch
|
|
19
|
+
|
|
20
|
+
-->
|
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
# ~/ads/ 工作目录
|
|
2
|
-
|
|
3
|
-
这是你的广告投放工作目录, 由 optima-agent 的 `ads` skill 维护.
|
|
4
|
-
|
|
5
|
-
## 结构
|
|
6
|
-
|
|
7
|
-
- `ADS.md` — 你的整体广告策略
|
|
8
|
-
- `LEARNINGS.md` — AI 沉淀的跨 campaign 经验
|
|
9
|
-
- `PROGRESS.md` — 每次 AI 会话的工作日志
|
|
10
|
-
- `REPORTS/` — 周报和月报
|
|
11
|
-
- `assets/` — AI 生成的广告素材 (不进 git)
|
|
12
|
-
- `campaigns/<name>/` — 每个 campaign 的专属文件
|
|
13
|
-
- `.git/` — 本地版本管理, 出错可回滚
|
|
14
|
-
|
|
15
|
-
## 使用方法
|
|
16
|
-
|
|
17
|
-
不要直接在这里修改文件. 在 optima.chat 聊天里告诉 AI 你想做什么, 它会替你管理这个目录.
|
|
18
|
-
|
|
19
|
-
如果你想亲自改 `ADS.md` 的策略(例如加新产品、改预算上限), 也可以. 改完后 AI 下次会话会读到新版本.
|
|
20
|
-
|
|
21
|
-
## 工作原则
|
|
22
|
-
|
|
23
|
-
- **单会话单任务**: 每次 AI 会话只做一件事 (launch / optimize / pause / report / ...), 完成后 commit
|
|
24
|
-
- **Git 是保险**: 所有变动都有 commit, 出错可以 `git revert`
|
|
25
|
-
- **事实在后端**: 这里只有策略和 AI 的思考轨迹. 真实的 campaign 状态、花费、余额在后端, 用 `ads status` 查
|
|
1
|
+
# ~/ads/ 工作目录
|
|
2
|
+
|
|
3
|
+
这是你的广告投放工作目录, 由 optima-agent 的 `ads` skill 维护.
|
|
4
|
+
|
|
5
|
+
## 结构
|
|
6
|
+
|
|
7
|
+
- `ADS.md` — 你的整体广告策略
|
|
8
|
+
- `LEARNINGS.md` — AI 沉淀的跨 campaign 经验
|
|
9
|
+
- `PROGRESS.md` — 每次 AI 会话的工作日志
|
|
10
|
+
- `REPORTS/` — 周报和月报
|
|
11
|
+
- `assets/` — AI 生成的广告素材 (不进 git)
|
|
12
|
+
- `campaigns/<name>/` — 每个 campaign 的专属文件
|
|
13
|
+
- `.git/` — 本地版本管理, 出错可回滚
|
|
14
|
+
|
|
15
|
+
## 使用方法
|
|
16
|
+
|
|
17
|
+
不要直接在这里修改文件. 在 optima.chat 聊天里告诉 AI 你想做什么, 它会替你管理这个目录.
|
|
18
|
+
|
|
19
|
+
如果你想亲自改 `ADS.md` 的策略(例如加新产品、改预算上限), 也可以. 改完后 AI 下次会话会读到新版本.
|
|
20
|
+
|
|
21
|
+
## 工作原则
|
|
22
|
+
|
|
23
|
+
- **单会话单任务**: 每次 AI 会话只做一件事 (launch / optimize / pause / report / ...), 完成后 commit
|
|
24
|
+
- **Git 是保险**: 所有变动都有 commit, 出错可以 `git revert`
|
|
25
|
+
- **事实在后端**: 这里只有策略和 AI 的思考轨迹. 真实的 campaign 状态、花费、余额在后端, 用 `ads status` 查
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
*
|
|
2
|
-
!.gitignore
|
|
1
|
+
*
|
|
2
|
+
!.gitignore
|
|
@@ -1,131 +1,131 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: bi
|
|
3
|
-
description: "业务数据分析工具。使用场景:查看销售数据(sales/销售)、产品表现分析(product/产品)、趋势分析(trends/趋势)、高级分析(analytics/分析)、流量分析(traffic/流量)。使用 bi-cli 命令。"
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# BI 数据分析工具
|
|
7
|
-
|
|
8
|
-
## 必须遵守的规则
|
|
9
|
-
|
|
10
|
-
**命令名称是 `bi-cli`,不是 `bi`**
|
|
11
|
-
|
|
12
|
-
## 命令参考
|
|
13
|
-
|
|
14
|
-
### 销售分析 (sales)
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
bi-cli sales get [--days 7] [--pretty]
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
返回:总收入、订单数、客单价、客户数、每日明细
|
|
21
|
-
|
|
22
|
-
### 产品分析 (product)
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
# 畅销商品
|
|
26
|
-
bi-cli product best-sellers [--limit 10] [--sort revenue|quantity] [--pretty]
|
|
27
|
-
|
|
28
|
-
# ABC 库存分析(帕累托)
|
|
29
|
-
bi-cli product abc-analysis [--pretty]
|
|
30
|
-
|
|
31
|
-
# 价格区间分析
|
|
32
|
-
bi-cli product price-analysis [--pretty]
|
|
33
|
-
|
|
34
|
-
# 商品表现
|
|
35
|
-
bi-cli product performance [--days 30] [--limit 20] [--pretty]
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
### 趋势分析 (trends)
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
# 收入趋势(含移动平均)
|
|
42
|
-
bi-cli trends revenue [--days 30] [--granularity daily|hourly|weekly] [--pretty]
|
|
43
|
-
|
|
44
|
-
# 订单热力图(按日/小时)
|
|
45
|
-
bi-cli trends heatmap [--pretty]
|
|
46
|
-
|
|
47
|
-
# 季节性模式
|
|
48
|
-
bi-cli trends seasonality [--pretty]
|
|
49
|
-
|
|
50
|
-
# 收入预测
|
|
51
|
-
bi-cli trends forecast [--days 7] [--pretty]
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### 高级分析 (analytics)
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
# 周期对比
|
|
58
|
-
bi-cli analytics compare [--days 30] [--compare-to previous_period|previous_year] [--pretty]
|
|
59
|
-
|
|
60
|
-
# 增长趋势
|
|
61
|
-
bi-cli analytics growth [--period daily|weekly|monthly] [--pretty]
|
|
62
|
-
|
|
63
|
-
# 客户群分析(LTV)
|
|
64
|
-
bi-cli analytics cohort [--pretty]
|
|
65
|
-
|
|
66
|
-
# 订单状态漏斗
|
|
67
|
-
bi-cli analytics funnel [--days 30] [--pretty]
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### 流量分析 (traffic)
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
# 流量概览
|
|
74
|
-
bi-cli traffic overview [--days 30] [--product <uuid>] [--pretty]
|
|
75
|
-
|
|
76
|
-
# 流量来源
|
|
77
|
-
bi-cli traffic sources [--limit 10] [--pretty]
|
|
78
|
-
|
|
79
|
-
# 转化漏斗
|
|
80
|
-
bi-cli traffic funnel [--pretty]
|
|
81
|
-
|
|
82
|
-
# 站内搜索分析
|
|
83
|
-
bi-cli traffic search [--zero-results] [--pretty]
|
|
84
|
-
|
|
85
|
-
# 热门页面
|
|
86
|
-
bi-cli traffic pages [--limit 20] [--pretty]
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
## 工作流示例
|
|
90
|
-
|
|
91
|
-
### 示例 1:查看近期销售
|
|
92
|
-
用户:"查看最近 7 天的销售情况"
|
|
93
|
-
|
|
94
|
-
```bash
|
|
95
|
-
bi-cli sales get --days 7 --pretty
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
### 示例 2:查看畅销商品
|
|
99
|
-
用户:"哪些商品卖得最好"
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
bi-cli product best-sellers --limit 5 --pretty
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
### 示例 3:收入趋势
|
|
106
|
-
用户:"收入趋势如何"
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
bi-cli trends revenue --days 30 --pretty
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
### 示例 4:同比分析
|
|
113
|
-
用户:"和去年同期比怎么样"
|
|
114
|
-
|
|
115
|
-
```bash
|
|
116
|
-
bi-cli analytics compare --days 30 --compare-to previous_year --pretty
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
### 示例 5:流量来源
|
|
120
|
-
用户:"流量都从哪来的"
|
|
121
|
-
|
|
122
|
-
```bash
|
|
123
|
-
bi-cli traffic sources --limit 10 --pretty
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
## 注意事项
|
|
127
|
-
|
|
128
|
-
- 命令是 `bi-cli` 不是 `bi`
|
|
129
|
-
- 默认输出 JSON 格式(AI 友好)
|
|
130
|
-
- 使用 `--pretty` 获取彩色表格
|
|
131
|
-
- 默认时间范围是最近 7 天或 30 天(因命令而异)
|
|
1
|
+
---
|
|
2
|
+
name: bi
|
|
3
|
+
description: "业务数据分析工具。使用场景:查看销售数据(sales/销售)、产品表现分析(product/产品)、趋势分析(trends/趋势)、高级分析(analytics/分析)、流量分析(traffic/流量)。使用 bi-cli 命令。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# BI 数据分析工具
|
|
7
|
+
|
|
8
|
+
## 必须遵守的规则
|
|
9
|
+
|
|
10
|
+
**命令名称是 `bi-cli`,不是 `bi`**
|
|
11
|
+
|
|
12
|
+
## 命令参考
|
|
13
|
+
|
|
14
|
+
### 销售分析 (sales)
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
bi-cli sales get [--days 7] [--pretty]
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
返回:总收入、订单数、客单价、客户数、每日明细
|
|
21
|
+
|
|
22
|
+
### 产品分析 (product)
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# 畅销商品
|
|
26
|
+
bi-cli product best-sellers [--limit 10] [--sort revenue|quantity] [--pretty]
|
|
27
|
+
|
|
28
|
+
# ABC 库存分析(帕累托)
|
|
29
|
+
bi-cli product abc-analysis [--pretty]
|
|
30
|
+
|
|
31
|
+
# 价格区间分析
|
|
32
|
+
bi-cli product price-analysis [--pretty]
|
|
33
|
+
|
|
34
|
+
# 商品表现
|
|
35
|
+
bi-cli product performance [--days 30] [--limit 20] [--pretty]
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### 趋势分析 (trends)
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# 收入趋势(含移动平均)
|
|
42
|
+
bi-cli trends revenue [--days 30] [--granularity daily|hourly|weekly] [--pretty]
|
|
43
|
+
|
|
44
|
+
# 订单热力图(按日/小时)
|
|
45
|
+
bi-cli trends heatmap [--pretty]
|
|
46
|
+
|
|
47
|
+
# 季节性模式
|
|
48
|
+
bi-cli trends seasonality [--pretty]
|
|
49
|
+
|
|
50
|
+
# 收入预测
|
|
51
|
+
bi-cli trends forecast [--days 7] [--pretty]
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### 高级分析 (analytics)
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# 周期对比
|
|
58
|
+
bi-cli analytics compare [--days 30] [--compare-to previous_period|previous_year] [--pretty]
|
|
59
|
+
|
|
60
|
+
# 增长趋势
|
|
61
|
+
bi-cli analytics growth [--period daily|weekly|monthly] [--pretty]
|
|
62
|
+
|
|
63
|
+
# 客户群分析(LTV)
|
|
64
|
+
bi-cli analytics cohort [--pretty]
|
|
65
|
+
|
|
66
|
+
# 订单状态漏斗
|
|
67
|
+
bi-cli analytics funnel [--days 30] [--pretty]
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### 流量分析 (traffic)
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 流量概览
|
|
74
|
+
bi-cli traffic overview [--days 30] [--product <uuid>] [--pretty]
|
|
75
|
+
|
|
76
|
+
# 流量来源
|
|
77
|
+
bi-cli traffic sources [--limit 10] [--pretty]
|
|
78
|
+
|
|
79
|
+
# 转化漏斗
|
|
80
|
+
bi-cli traffic funnel [--pretty]
|
|
81
|
+
|
|
82
|
+
# 站内搜索分析
|
|
83
|
+
bi-cli traffic search [--zero-results] [--pretty]
|
|
84
|
+
|
|
85
|
+
# 热门页面
|
|
86
|
+
bi-cli traffic pages [--limit 20] [--pretty]
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## 工作流示例
|
|
90
|
+
|
|
91
|
+
### 示例 1:查看近期销售
|
|
92
|
+
用户:"查看最近 7 天的销售情况"
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
bi-cli sales get --days 7 --pretty
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### 示例 2:查看畅销商品
|
|
99
|
+
用户:"哪些商品卖得最好"
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
bi-cli product best-sellers --limit 5 --pretty
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### 示例 3:收入趋势
|
|
106
|
+
用户:"收入趋势如何"
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
bi-cli trends revenue --days 30 --pretty
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### 示例 4:同比分析
|
|
113
|
+
用户:"和去年同期比怎么样"
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
bi-cli analytics compare --days 30 --compare-to previous_year --pretty
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
### 示例 5:流量来源
|
|
120
|
+
用户:"流量都从哪来的"
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
bi-cli traffic sources --limit 10 --pretty
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## 注意事项
|
|
127
|
+
|
|
128
|
+
- 命令是 `bi-cli` 不是 `bi`
|
|
129
|
+
- 默认输出 JSON 格式(AI 友好)
|
|
130
|
+
- 使用 `--pretty` 获取彩色表格
|
|
131
|
+
- 默认时间范围是最近 7 天或 30 天(因命令而异)
|