mcn-data-insight: 榜单落盘目录升级「三方数据/数据源」分层——桌面 MCNSkill项目顶层分业务账号/三方数据，榜单缓存统一下三方数据\红狐数据\抖音榜单\（后续多数据源各一文件夹，文件名不加数据源前缀保 dsh 正则兼容）；主 SKILL.md 落盘目标表+抖音数据规则 §2.1/2.2+三子技能(daily-hot/content-surge/weekly-surge) 同步；git rm --cached ai-feed 历史 output 缓存(08-07~09 json+html, 6 文件)，.gitignore 补 subskills/*/*.json

2026-09-03 11:47:20 +08:00
1 parent 22a0d25065
commit 9ca160bda0
@@ -48,19 +48,22 @@

 ### 2.1 目录结构

-数据按类型分两个子文件夹存放：
+数据按类型分三个文件夹存放；**榜单数据**因属「同日期固定快照」+ API 按调用计费，**采用业务数据目录落盘 + 查询先查本地缓存命中免 API**（09-03 定稿规范）：

-| 数据类型 | 归档目录 | 说明 |
-|---------|---------|------|
-| **榜单数据**（日榜、七日飙升榜、热榜等） | `RedFox数据\榜单数据\YYYY-MM\` | 按月分文件夹，文件名含具体日期 |
-| **信息源数据**（AI信息源、短剧信息源等） | `RedFox数据\信息源数据\YYYY-MM\` | 按月分文件夹 |
-| **作品数据**（单作品爬取、账号诊断等） | `RedFox数据\作品数据\YYYY-MM-DD\` | 按日分文件夹 |
+| 数据类型 | 归档目录（①③用户/开发机） | 归档目录（②dsh 环境） | 说明 |
+|---|---|---|---|
+| **榜单数据**（账号周榜/视频热榜/点赞榜/涨粉榜/日榜/月榜/七日飙升等） | `C:\Users\maidou\Desktop\MCNSkill项目\三方数据\红狐数据\抖音榜单\` | `D:\dshworkspace\抖音榜单\` | 桌面顶层先分「业务账号/三方数据」：三方数据统一 `三方数据\{数据源}\`（当前=红狐数据）；文件命名 `{榜名}_{赛道}_{数据日期}.json` 不加数据源前缀；详见 [SKILL.md 榜单数据落盘规范](../../SKILL.md) |
+| **信息源数据**（AI信息源、短剧信息源等） | `RedFox数据\信息源数据\YYYY-MM\` | 同（沙箱内） | 按月分文件夹 |
+| **作品数据**（单作品爬取、账号诊断等） | `RedFox数据\作品数据\YYYY-MM-DD\` | 同 | 按日分文件夹 |

 ### 2.2 日期命名规则

+> 以下示例归档目录 = 表 2.1 对应环境的目录内（①③ = `三方数据\红狐数据\抖音榜单\`；② dsh = `D:\dshworkspace\抖音榜单\`）。
+
 - 归档文件夹日期按 **数据实际日期** 命名，**不是获取日期**。
- 例：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日获取8月7日的日榜 → 存入 `抖音榜单\抖音视频热榜_美食_2026-08-07.json`
+- 例：8月8日获取8天前的七日飙升榜 → 存入 `抖音榜单\抖音七日飙升榜_美食_2026-08-01.json`
+- 例：8月8日获取账号周榜（period=week, 08-01 至 08-07）→ 存入 `抖音榜单\抖音周榜_亲子_2026-08-07.json`（采用周结束日期命名；与 dsh 工作台 RANKING_DIR 既有读取兼容）
 - 例：8月8日获取AI信息源（数据日期8月7日）→ 存入 `RedFox数据\信息源数据\2026-08\抖音AI信息源_2026-08-07.json`
 - 例：8月8日爬取某作品详情（作品发布于8月5日）→ 存入 `RedFox数据\作品数据\2026-08-05\作品详情_xxx.json`

@@ -69,6 +72,17 @@
 - 统一以 **JSON 格式**（`.json`）归档，保留 API 返回的完整结构化字段，便于后续入库与查询。
 - 输出展示时可在对话中以表格形式呈现，但落盘文件必须为 `.json`。

+### 2.4 榜单查询幂等铁律（防重复花 API 钱，09-03 定稿）
+
+> 详见主 SKILL.md 「榜单数据落盘规范（白名单例外详则）」。本节为执行摘要：
+
+1. **查询前先 `ls`** 本地 `抖音榜单/` 对应文件 → 命中直接读本地（**0 API 成本**）；未命中才调 API 并立即落盘
+2. 缓存命中需在回复中注明「缓存命中·本地读取」
+3. **同榜名+赛道+数据日期**全机器只允许一次 API 调用
+4. 缓存文件不入技能包 git（新增 `.gitignore` 忽略缓存产物）
+
+> **最后更新**：2026-09-03（榜单数据落盘规范定稿：业务数据目录+查询先查本地缓存命中免 API）
+
 ---

 ## 3. API Key 安全规则