docs: 更新 README 和安装文档,新增 yt-studio-groupid-lookup 技能说明

This commit is contained in:
2026-08-24 14:25:59 +08:00
parent bcfe0f4a29
commit 5bc318e0cb
9 changed files with 750 additions and 21 deletions

View File

@@ -1,6 +1,6 @@
# YouTube Studio 工具集
本项目包含个 Trae CN 技能skills及配套 Python 脚本,覆盖 YouTube Studio 内容管理器Content Manager分析的完整工作流**环境准备 → 批量生成报告 URL → 脚本化下载分析数据**。
本项目包含个 Trae CN 技能skills及配套 Python 脚本,覆盖 YouTube Studio 内容管理器Content Manager分析的完整工作流**环境准备 → 批量生成报告 URL → 群组名解析实体 ID → 脚本化下载分析数据**。
仅支持 Windows。
@@ -11,6 +11,7 @@
| `uv-env-setup` | 用 uv 准备并维护 Python 运行环境(`pyproject.toml``uv sync``uv run` | 「帮我准备环境」「装依赖」 |
| `yt-studio-url-builder` | 根据需求清单CSV/Excel批量拼接 explore 报告 URL | 「根据这份清单生成 Studio URL」 |
| `youtube-studio-csv-download` | 复用已登录浏览器会话,脚本化下载分析 CSVzip | 「用我的 Chrome 会话下载这份 CSV」 |
| `yt-studio-groupid-lookup` | 把一批群组名批量解析为 entity_idgroupId并标注归属的内容所有者 | 「把这些群组名查成 Group ID」 |
## 项目结构
@@ -23,10 +24,14 @@
│ │ ├── SKILL.md
│ │ ├── references/ # input-guide.md输入清单指南、troubleshooting.md
│ │ └── scripts/ # build_studio_urls.py、countries.json
── youtube-studio-csv-download/ # CSV 下载技能
── youtube-studio-csv-download/ # CSV 下载技能
│ │ ├── SKILL.md
│ │ ├── references/troubleshooting.md
│ │ └── scripts/youtube_export_download.py
│ └── yt-studio-groupid-lookup/ # 群组名->entity_id 解析技能
│ ├── SKILL.md
│ ├── references/troubleshooting.md
│ └── scripts/youtube_export_download.py
│ ├── references/ # input-guide.md名单/套件指南)、troubleshooting.md
│ └── scripts/lookup_groups.py
├── scripts/
│ ├── install-skills.bat # 傻瓜安装入口(双击运行)
│ └── install-skills.ps1 # 安装逻辑
@@ -56,6 +61,15 @@ scripts\install-skills.bat
看到 `全部安装成功` 即完成。脚本会把 `skills\` 下全部技能复制到 `%USERPROFILE%\.trae-cn\skills\`;同名旧版自动备份到 `~\.trae-cn\skills-backup\`,不会丢数据。详细说明见 [docs/install-skills.md](docs/install-skills.md)。
**默认安装全部技能**。需要只装部分或先预览时可在命令行加参数bat 与 ps1 都支持):
```powershell
# 只安装指定的几个技能
scripts\install-skills.bat -Skills yt-studio-url-builder,youtube-studio-csv-download
# 只预览将安装/覆盖/备份的技能,不实际复制
scripts\install-skills.bat -DryRun
```
### 第 2 步:准备 Python 运行环境
项目根目录执行: