🚀 进击的知识库#

微信好用知识库，打通 Agent，多平台视频链接一键下载归档。

⚠️ 安装前必读#

此 Skill 需要以下前置条件，缺一不可：

#前置条件说明1腾讯文档 Skill 授权在 WorkBuddy Skill 市场安装「腾讯文档」Skill，完成 TOKEN 授权2Python 3.8+系统需安装 Python 3.8 或以上版本3yt-dlppip install yt-dlp（抖音/小红书下载依赖）

未完成以上三项，Skill 无法正常工作。详见下方「首次安装配置」。

核心能力#

接收链接 → 自动识别来源 → 下载/解析 → 提取视频描述 → 上传腾讯文档 → 写 0 号索引。

下载方案：视频号用 sph-download（自研解析方案），抖音/小红书用 yt-dlp（含视频描述提取），公众号用 web_fetch。

来源下载方式文案提取是否上传视频号parsers/sph.py（自研 sph-download 方案）—✅ 上传腾讯文档抖音yt-dlp（parsers/douyin.py）✅ 提取视频描述✅ 上传腾讯文档小红书yt-dlp（parsers/xiaohongshu.py）—✅ 上传腾讯文档公众号web_fetch 抓取 → markdown✅ 文章正文✅ 上传腾讯文档

⚙️ 首次安装配置#

此 Skill 面向新用户发布，每个用户需要自己完成以下配置。

前置依赖#

依赖安装方式腾讯文档 SkillWorkBuddy Skill 市场安装 → 完成 TOKEN 授权Python 3.8+系统自带或 python.org 下载yt-dlppip install yt-dlp 或 winget install yt-dlp.yt-dlp

1. 创建你的知识库空间#

打开 docs.qq.com，新建一个知识库空间，从 URL 中获取 space_id：

text

https://docs.qq.com/space/DS2RjWGhWZ1VyaWt
                         └────── space_id ──────┘

2. 创建 0 号索引智能表格#

在空间中新建智能表格，命名为「0号索引」，按以下字段建表：

列名类型文件名字文本文档大小(KB)数字入库时间日期时间格式单选来源类型单选来源文本是否外链复选腾讯文档链接URL等级单选

3. 配置环境变量#

从表格 URL 中获取 file_id 和 sheet_id，设置环境变量：

Windows：

cmd

setx KB_INDEX_FILE_ID "你的file_id"
setx KB_INDEX_SHEET_ID "你的sheet_id"
setx KB_TENCENT_SPACE_ID "你的space_id"

macOS / Linux：

bash

export KB_INDEX_FILE_ID="你的file_id"
export KB_INDEX_SHEET_ID="你的sheet_id"
export KB_TENCENT_SPACE_ID="你的space_id"

也可以直接编辑 agent.py 和 add_to_sheet.py 中的配置区域，修改等号右边的默认值。

4. 验证#

bash

python agent.py identify "https://mp.weixin.qq.com/s/test"
# 应输出: {"url": "...", "source_type": "微信公众号"}

⚠️ 如果未配置环境变量，脚本会打印警告但不会报错——索引写入功能会跳过。上传到腾讯文档的功能依赖腾讯文档 Skill 的 TOKEN 授权。

0 号索引字段#

列名类型字段 ID（固定）文件名字文本fkfKit文档大小数字(KB)f2cnP7入库时间日期时间fHSMJO格式单选fOVcRT来源类型单选fPoljj来源文本f6drfQ是否外链复选fcP5do腾讯文档链接URLfBW04a等级单选fWqSI6

工作流程#

步骤总览#

text

链接/文件 → 识别来源 → 下载到本地 → upload_to_docs.py → 腾讯文档 + 0号索引

各来源处理#

视频号

text

1. 下载（自研 sph-download 方案，无需 yt-dlp）：
   python parsers/sph.py <视频号链接> --output-dir <临时目录>
   → 返回 JSON {title, author, video, size_bytes}

2. 上传+索引：
   python upload_to_docs.py <video_path> \
     --name "<title>" --format mp4 --source-type 视频号 \
     --source-url "<原始链接>" --author "<作者>" --level 一般

抖音

text

1. 下载 + 视频描述提取：
   python parsers/douyin.py <链接> --output-dir <临时目录>
   → 返回 JSON {title, author, video, size_bytes, description}
   → 同时保存 <video>.caption.txt（视频描述文案文件）

2. 上传+索引：
   python upload_to_docs.py <video_path> \
     --name "<title>" --format mp4 --source-type 抖音 \
     --source-url "<原始链接>" --author "<author>" --level 一般

小红书

text

1. 下载（yt-dlp 方案，与抖音完全一致）：
   python parsers/xiaohongshu.py <链接> --output-dir <临时目录>
   → 返回 JSON {title, author, file, size_bytes, type}

2. 上传+索引：
   python upload_to_docs.py <file_path> \
     --name "<title>" --format <type> --source-type 小红书 \
     --source-url "<原始链接>" --author "<author>" --level 一般

微信公众号

text

1. web_fetch 抓取文章内容，转 markdown
2. 创建腾讯文档（smartcanvas 或 markdown）
3. 上传+索引：
   python upload_to_docs.py <markdown_file> \
     --name "<标题>" --format 文章 --source-type 微信公众号 \
     --source-url "<原始链接>" --author "<公众号名>" --level 一般

本地文件（pdf/pptx/docx/jpg/png）

text

python upload_to_docs.py <文件路径> \
  --name "<文件名>" --format <格式> --source-type 本地上传 \
  --level 一般

upload_to_docs.py 自动完成#

该脚本自动执行：

1. manage.pre_import — 获取 COS 上传凭证
2. curl PUT — 上传到 COS
3. manage.async_import — 触发导入
4. manage.import_progress — 轮询直到完成
5. add_to_sheet.py — 写入 0 号索引

bash

python upload_to_docs.py <文件路径> \
  --name "标题" \
  --format "mp4|pdf|pptx|docx|jpg|png|文章" \
  --source-type "视频号|抖音|小红书|微信公众号|本地上传" \
  --source-url "原始链接" \
  --author "作者名" \
  --level "机密|高|一般|普通"

--level 不传默认为 一般， --is-external 不传默认为 False。

文件结构#

text

knowledge-base/
├── SKILL.md              # 本文件
├── agent.py               # CLI 辅助
├── add_to_sheet.py        # 智能表格记录添加
├── upload_to_docs.py      # 一键上传（pre_import→COS→import→索引）
├── README.md              # 使用说明
└── parsers/
    ├── sph.py             # 视频号下载（自研 sph-download 方案）
    ├── douyin.py         # 抖音下载（yt-dlp）
    ├── xiaohongshu.py    # 小红书下载（yt-dlp）
    └── wechat_article.py  # 公众号文章解析

注意事项#

• 视频文件大小限制：腾讯文档单文件 < 100MB
• 小红书 yt-dlp 依赖：需要 yt-dlp + cookies（如需要登录态）
• 公众号文章过长时可能触发 CreateProcess 命令行限制，使用 upload_to_docs.py 可绕过
• 索引记录的"入库时间"字段暂不支持 API 设置，需在腾讯文档 UI 上配置自动填入

常见问题#

Q：视频上传腾讯文档后能播放吗？ A：能。腾讯文档支持 mp4 在线播放。

Q：小红书下载失败？ A：确认 yt-dlp 已更新到最新版： yt-dlp -U。个别小红书链接可能需要浏览器 cookies。

Q：怎么确认上传成功了？ A：查看 0 号索引智能表格，新记录出现即表示成功。也可以直接打开腾讯文档链接确认。