feat: add sites/ directory and scene routing with priority

- sites/tacit0924/v1/: 新增数据源目录，描述 Tacit0924 资源文档 - intro.md: 文档介绍、更新规律、资源范围 - urls.md: 文档链接、file_id、授权要求 - toc.md: 内容结构、日期范围、搜索关键词参考 - SKILL.md: 重写场景路由，增加数据源优先级规则和触发词匹配 - 明确"每日更新"→ 腾讯文档路线、"特定资源"→ 先文档后搜索的降级策略 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-16 18:29:14 +08:00
parent 750f981c7e
commit e8a6fc4ca2
4 changed files with 194 additions and 49 deletions
@@ -11,73 +11,101 @@ description: 资源中心——从多渠道获取资源链接，转存到夸克
 media-center/
 ├── SKILL.md                              # 入口 + 场景路由
 │
-├── sources/                              # 获取途径（独立模块）
+├── sites/                                # 数据源（去哪儿找）
+│   └── tacit0924/                        #   Tacit0924 资源分享文档
+│       └── v1/
+│           ├── intro.md                  #     文档介绍
+│           ├── urls.md                   #     链接 + file_id
+│           └── toc.md                    #     内容结构
+│
+├── sources/                              # 获取技术（怎么读）
 │   ├── tencent-doc/                      #   腾讯文档读取
-│   │   └── v1/
-│   │       ├── install.md                #     安装配置
-│   │       ├── usage.md                  #     使用方法
-│   │       └── maintain.md               #     维护&来源
+│   │   └── v1/{install,usage,maintain}.md
 │   └── search/                           #   网盘搜索
-│       └── v1/
-│           ├── install.md
-│           ├── usage.md
-│           └── maintain.md
+│       └── v1/{install,usage,maintain}.md
 │
-├── storage/                              # 存储后端（独立模块）
-│   └── quark/                            #   夸克网盘
-│       └── v1/
-│           ├── install.md
-│           ├── usage.md
-│           └── maintain.md
+├── storage/                              # 存储后端（存到哪）
+│   └── quark/
+│       └── v1/{install,usage,maintain}.md
 │
-└── ref/                                  # 参考项目归档（来源 skill 的完整副本）
-    ├── tencent-docs/                     #   腾讯文档官方 MCP skill
-    │   ├── SKILL.md
-    │   ├── references/                   #     官方参考文档
-    │   └── setup.sh                      #     安装脚本
-    ├── tx-doc-large-reader/              #   大文档读取方案
-    │   └── SKILL.md
-    ├── netdisk-mcp-server/               #   netdisk MCP 源码+文档
-    │   ├── SKILL.md
-    │   └── src/                          #     源码（API 端点参考）
-    ├── quark-netdisk-helper/             #   夸克 API 补全方案
-    │   └── SKILL.md
-    └── resource-pipeline/                #   旧版管线设计（思路参考）
-        └── SKILL.md
+└── ref/                                  # 参考归档
+    ├── tencent-docs/
+    ├── tx-doc-large-reader/
+    ├── netdisk-mcp-server/
+    ├── quark-netdisk-helper/
+    └── resource-pipeline/
 ```

+## 快速入口
+
+### 已知数据源
+
+| 源 | 说明 | 文档 |
+|----|------|------|
+| **Tacit0924 资源文档** | 每日更新的影视/动漫资源，含夸克/迅雷链接 | `sites/tacit0924/v1/intro.md` |
+
+### 技术模块速查
+
+| 操作 | 文档 |
+|------|------|
+| 读取腾讯文档（含大文档） | `sources/tencent-doc/v1/usage.md` |
+| 安装腾讯文档 MCP | `sources/tencent-doc/v1/install.md` |
+| 夸克网盘-转存/建目录/移动/删除 | `storage/quark/v1/usage.md` |
+| 安装夸克网盘 MCP | `storage/quark/v1/install.md` |
+| 跨平台搜索资源 | `sources/search/v1/usage.md` |
+
 ## 场景路由

-| 需求 | 流程 |
-|------|------|
-| 从腾讯文档找链接→存夸克 | `sources/tencent-doc/v1/usage.md` → `storage/quark/v1/usage.md` |
-| 搜索资源→存夸克 | `sources/search/v1/usage.md` → `storage/quark/v1/usage.md` |
-| 整理夸克网盘文件 | `storage/quark/v1/usage.md`（整理章节） |
+### 第一步：确定数据源
+
+先看需求匹配哪个已知数据源，再看需求匹配哪个技术模块。
+
+| 用户需求 | 触发词 | 数据源 | 技术操作 |
+|---------|--------|--------|---------|
+| 今天/每日更新的资源 | "今天"、"每日"、"最新"、"YYYY.MM.DD" | `sites/tacit0924/v1/` | → `sources/tencent-doc/v1/usage.md` |
+| 某个剧/电影的资源 | "遮天"、"流浪地球"等具体名称 | 先 `sites/tacit0924/` 查 → 找不到再 search | → `sources/tencent-doc/` 或 `sources/search/` |
+| 通用搜索（无特定源） | 任意关键词 | `sources/search/v1/` | → `netdisk.search()` |
+| 整理夸克网盘已有文件 | "整理"、"归类"、"分段" | — | → `storage/quark/v1/usage.md`（整理章节） |
+
+### 第二步：转存到夸克
+
+无论用哪个数据源找到链接，存储环节统一走：
+
+→ `storage/quark/v1/usage.md`
+
+### 优先级规则
+
+```
+1. 找"每日更新" → 优先走 Tencent Doc 路线（Tacit0924 文档）
+2. 找"特定资源" → 先在 Tacit0924 文档搜，找不到再走 PanSou search
+3. 通用搜索 → 走 PanSou search（需配置 PANSOU_URL）
+4. PanSou 不可用 → 降级到 web search 获取信息，或告知用户配置
+```

 ## 端到端示例

-以下是一个完整流程的实例（从腾讯文档找"遮天"资源 → 存到夸克 → 整理归档）：
+场景：找今天更新的动漫 → 存到夸克 → 整理

 ```
-Step 1: 读腾讯文档
-  sources/tencent-doc/v1/usage.md
-  → doc.resolve_document_structure → 提取全文 → grep "遮天"
-  → 找到分享链接 https://pan.quark.cn/s/xxx
+Step 0: 确定数据源
+  sites/tacit0924/v1/intro.md  → 这是每日更新的文档
+  sites/tacit0924/v1/urls.md   → file_id = DR2xUcFdrSVhJTkZu

-Step 2: 存到夸克
+Step 1: 读取文档搜关键词
+  sources/tencent-doc/v1/usage.md
+  → doc.resolve_document_structure → 提取全文
+  → grep "2026.05.16" + "动漫/动画" → 找到分享链接
+
+Step 2: 转存到夸克
  storage/quark/v1/usage.md
-  → netdisk.view() 确认内容（205文件/191GB，1-162集）
-  → netdisk.list() 发现已有目录 /动漫/国漫2024/遮.天（2023）
-  → Quark API 创建子目录 151-162
-  → netdisk.transfer() 转存新集数
-  → Quark API 删除混入的杂文件
+  → netdisk.view() 确认内容
+  → Quark API 建目录
+  → netdisk.transfer()
+  → Quark API 清理杂文件

 Step 3: 整理归档
  storage/quark/v1/usage.md（文件整理流程）
-  → netdisk.list() 获取文件列表
-  → Quark API 创建 101-120/121-140/141-150 子目录
-  → Quark API move 分批移动文件
-  → netdisk.list() 验证最终结构
+  → 按集数分段 → 建子目录 → 移动文件 → 验证
 ```

 ## 版本策略
@@ -0,0 +1,30 @@
+# Tacit0924 资源分享文档 — 介绍
+
+## 是什么
+
+Tacit0924 是一个个人资源分享博主，在腾讯文档上维护了一份**每日更新的影视/动漫/软件资源分享文档**，内容量约 85 万字。
+
+## 更新规律
+
+- **频次**：每天更新，标注日期如 `2026.05.16 周六更新的`
+- **内容**：热门电影/剧集/动漫的夸克网盘、迅雷网盘分享链接
+- **时段**：每日更新分多个时段（如 `【12点】`、`【17点】`）
+
+## 资源范围
+
+| 分类 | 说明 |
+|------|------|
+| 热门电影 | 院线新片、经典电影，约 10TB |
+| 国漫/日漫 | 连载动画 4K 更新 |
+| 电视剧 | 国产/韩/日/欧美剧 |
+| 综艺/纪录片 | 热门综艺 |
+| 短剧 | 每日付费+精选短剧 |
+| 软件 | 每日软件分享 |
+| 音乐/演唱会/有声书 | 阿里云盘 |
+
+## 文档特点
+
+- 按日期倒序排列，最新更新在最前面
+- 每条资源包含：名称 + 夸克链接 + 迅雷链接
+- 部分链接带提取码
+- 有总索引目录，方便搜索
@@ -0,0 +1,56 @@
+# Tacit0924 资源分享文档 — 内容结构
+
+## 页面顶部
+
+- 京东/淘宝 618 红包领取入口
+- 美团/饿了么外卖红包
+- 支付宝红包推广
+- 微博 / 抖音 / 微信 / QQ 频道 / 防走丢 link3
+
+## 分区索引
+
+文档顶部有固定的分类合集（链接指向子文档）：
+
+| 分类 | 说明 |
+|------|------|
+| 阿里【总合集】 | 国剧/动漫/电影/综艺/韩日剧/欧美剧/音乐等 |
+| 夸克 合集 | 分月归档的合集 |
+| 热门电影 | 容易和谐的热门资源，约 10TB |
+
+## 每日更新结构
+
+文档主体是按日期倒序排列的每日更新，每条记录含：
+
+```
+# YYYY.MM.DD 周X更新的
+【时段】
+资源名称 画质【备注】
+[普通链接: 夸克网盘链接]
+[普通链接: 迅雷网盘链接]
+```
+
+### 示例
+
+```
+# 2026.05.16 周六更新的
+【12点】
+遮天 动画版 4K更新至162
+[普通链接: https://pan.quark.cn/s/0762b0d500f3]
+[普通链接: https://pan.xunlei.com/s/VOH68cejTTWEYLmNU8]
+```
+
+## 日期范围
+
+文档包含从 **2025.03.01** 到 **2026.05.16** 的每日更新。
+
+## 常见资源分类关键词
+
+搜索文档时使用的关键词参考：
+
+| 想要找 | 搜索关键词 |
+|--------|-----------|
+| 当日更新动漫 | `YYYY.MM.DD` + 动漫/动画/国漫 |
+| 特定剧集 | 剧名（如"遮天"、"完美世界"） |
+| 电影 | `YYYY.MM.DD` + 电影/4K |
+| 短剧 | `付费+精选短剧` |
+| 软件 | `每日软件分享` |
@@ -0,0 +1,31 @@
+# Tacit0924 资源分享文档 — 链接
+
+## 文档信息
+
+| 项目 | 内容 |
+|------|------|
+| 标题 | Tacit0924 的 500T 资源分享文档 |
+| URL | https://docs.qq.com/doc/DR2xUcFdrSVhJTkZu?dver= |
+| file_id | `DR2xUcFdrSVhJTkZu` |
+| 文档类型 | tencentdoc（传统文档） |
+| 总字数 | ~853,231 字 / 28,449 段落 |
+| 授权方式 | 只能查看（只读模式） |
+
+> 该文档需要腾讯文档 OAuth 授权才能通过 MCP 读取，参见 `sources/tencent-doc/v1/install.md`
+
+## file_id 提取方法
+
+URL `https://docs.qq.com/doc/DR2xUcFdrSVhJTkZu` 中 `/doc/` 后面的部分即为 file_id。
+
+## 关联文档
+
+文档中还引用了其他腾讯文档子文档：
+- https://docs.qq.com/doc/DQlVGenVJVE9j...
+- https://docs.qq.com/doc/DQkRORUNmUUN5...
+- https://docs.qq.com/doc/DQmJCdG56a0hEa1Np...
+- https://docs.qq.com/doc/DQmx1WEdTRXpGe...
+- https://docs.qq.com/doc/DQnZaEFjYUpnV...
+- https://docs.qq.com/doc/DQmdjdHp4dUdEWGJp...
+- https://docs.qq.com/doc/DR3ZyaVd1dXNuZW5L...
+
+这些子文档为跳转分流页，主文档包含了全部实际内容。