maogeigei
c1083c06ea
- mv .workbuddy/scripts scripts；mv .workbuddy/skills subskills（13 子技能）；.workbuddy 仅留 memory 历史存档 - 21 个文件路径引用同步（setup_redfox_key 命令/报错提示/命令示例/存放路径规则），保护 ~/.workbuddy 用户级路径 - root SKILL.md：技能清单目录列加 subskills/ 前缀、结构树重写、更新记录追加 2026-09-03
5.5 KiB
抖音数据规则
本文件定义所有 douyin-* 技能获取数据时必须遵守的规则。 最后更新：2026-08-08
1. 赛道过滤规则
所有抖音榜单/数据获取时，按以下配置过滤赛道。
保留赛道（共 7 个）：
| # | 赛道 | # | 赛道 | |
|---|---|---|---|---|
| 1 | 生活 vlog | 5 | 情感 | |
| 2 | 小剧场 | 6 | 颜值造型 | |
| 3 | 亲子 | 7 | 旅行 | |
| 4 | 美食 |
排除赛道（共 20 个）：
| # | 赛道 | # | 赛道 | |
|---|---|---|---|---|
| 1 | 动物 | 11 | 健康医学 | |
| 2 | 明星娱乐 | 12 | 汽车 | |
| 3 | 音乐 | 13 | 个人才艺 | |
| 4 | 游戏 | 14 | 财富理财 | |
| 5 | 人文 | 15 | 学习教育 | |
| 6 | 体育 | 16 | 潮流风尚 | |
| 7 | 影视 | 17 | 身体锻炼 | |
| 8 | 舞蹈才艺 | 18 | 居家装修 | |
| 9 | 数码科技 | 19 | 化妆美容 | |
| 10 | 三农 | 20 | 二次元 |
保留赛道 JSON：
["生活 vlog", "小剧场", "亲子", "美食", "情感", "颜值造型", "旅行"]排除赛道 JSON：
["动物", "明星娱乐", "音乐", "游戏", "人文", "体育", "影视", "舞蹈才艺", "数码科技", "三农", "健康医学", "汽车", "个人才艺", "财富理财", "学习教育", "潮流风尚", "身体锻炼", "居家装修", "化妆美容", "二次元"]获取数据后，在输出表格中剔除赛道属于排除列表的作品，并重新排列名次。 赛道为空或
-（未分类）的作品保留。赛道名体系更新于 2026-08-19（对齐红狐 API 27 赛道标准名；08-19 二次调整：剔除个人才艺/财富理财/学习教育/潮流风尚/身体锻炼/居家装修，保留 9 个；09-01 第三次调整：剔除化妆美容，保留 8 个；09-01 第四次调整：剔除二次元，保留 7 个）。
2. 数据归档规则
2.1 目录结构
数据按类型分两个子文件夹存放：
| 数据类型 | 归档目录 | 说明 |
|---|---|---|
| 榜单数据（日榜、七日飙升榜、热榜等） | RedFox数据\榜单数据\YYYY-MM\ |
按月分文件夹，文件名含具体日期 |
| 信息源数据（AI信息源、短剧信息源等） | RedFox数据\信息源数据\YYYY-MM\ |
按月分文件夹 |
| 作品数据（单作品爬取、账号诊断等） | RedFox数据\作品数据\YYYY-MM-DD\ |
按日分文件夹 |
2.2 日期命名规则
- 归档文件夹日期按 数据实际日期 命名，不是获取日期。
- 例：8月8日获取8月7日的日榜 → 存入
RedFox数据\榜单数据\2026-08\抖音日榜TOP50_2026-08-07.json - 例：8月8日获取8天前的七日飙升榜 → 存入
RedFox数据\榜单数据\2026-08\抖音七日飙升榜TOP50_2026-08-01.json - 例：8月8日获取AI信息源（数据日期8月7日）→ 存入
RedFox数据\信息源数据\2026-08\抖音AI信息源_2026-08-07.json - 例：8月8日爬取某作品详情（作品发布于8月5日）→ 存入
RedFox数据\作品数据\2026-08-05\作品详情_xxx.json
2.3 格式
- 统一以 JSON 格式（
.json）归档，保留 API 返回的完整结构化字段，便于后续入库与查询。 - 输出展示时可在对话中以表格形式呈现，但落盘文件必须为
.json。
3. API Key 安全规则
- 红狐Hub API Key 仅通过环境变量
REDFOX_API_KEY读取（os.getenv("REDFOX_API_KEY")）。 - 禁止硬编码到代码中。
- 禁止从系统文件读取。
- 未配置 Key 时：脚本报错退出，提示「获取地址 + 运行
python scripts/setup_redfox_key.py交互式输入」；引导用户输入自己的 Key，不要代填、不要硬编码。 - 一键配置（推荐）：
python scripts/setup_redfox_key.py（交互式输入，自动写入用户级环境变量）；--check检查配置状态。 - 临时设置（仅当前终端有效）：
REDFOX_API_KEY=xxx python script.py
3.1 部署到新电脑：让用户输入自己的 key
技能分发/部署到其他用户电脑时，必须由用户配置自己的 key（每个账号的 key 不同，禁止共用/预置）：
-
运行配置引导脚本（推荐，自动写入用户级环境变量）：
python scripts/setup_redfox_key.py # 交互式输入自己的 key python scripts/setup_redfox_key.py --key ak_xxx # 部署脚本/CI 直传 python scripts/setup_redfox_key.py --check # 检查是否已配置- Windows：自动写入用户级环境变量（HKCU\Environment）并广播刷新，新开终端即可生效
- macOS/Linux：打印
export REDFOX_API_KEY=...指引，由用户追加到~/.zshrc或~/.bashrc
-
手动配置（等价做法）：Windows 用
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY","<自己的key>","User")；macOS/Linux 把 export 追加到 shell 配置文件。
脚本不包含任何真实 key，可随仓库分发；key 仅写入当前系统用户环境，不落入技能目录/仓库文件。
4. 技能存放路径
- 13 个子技能统一存放在
subskills/目录下（随 mcn-data-insight 技能包分发）。 - 技能包根目录结构：
SKILL.md（技能索引）+references/（统一规则）+scripts/（共享工具）+subskills/（子技能）。 - 共享工具以技能包根目录为工作目录执行，例如
python scripts/setup_redfox_key.py。 - 运行数据统一输出到
RedFox数据/（相对技能包根目录，不存在则创建）。 .workbuddy/memory/保留原项目历史工作日志（存档，不参与运行）。