feat(scripts): 添加批量生成 YouTube Studio 内容管理器 URL 的脚本

This commit is contained in:
2026-08-21 18:21:03 +08:00
commit c1b39e9466
29 changed files with 4020 additions and 0 deletions

63
docs/install-skills.md Normal file
View File

@@ -0,0 +1,63 @@
# 技能安装说明Windows
把本项目 `skills\` 下的技能一键安装到 Trae CN 的用户级技能目录 `%USERPROFILE%\.trae-cn\skills\`,安装后在任意项目的对话中都可触发。
## 技能清单
| 技能 | 用途 |
|---|---|
| `uv-env-setup` | 用 uv 准备并维护本项目 Python 运行环境(`uv sync` / `uv run` |
| `yt-studio-url-builder` | 根据需求清单CSV/Excel批量生成 YouTube Studio 内容管理器 explore URL |
| `youtube-studio-csv-download` | 复用已登录浏览器会话,脚本化下载 YouTube Studio 分析 CSVzip |
## 安装(傻瓜式)
双击运行:
```
scripts\install-skills.bat
```
看到 `全部安装成功` 及逐项 `[OK]` 即完成,按任意键关闭窗口。
命令行等价方式PowerShell / cmd 均可):
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-skills.ps1
```
## 脚本做了什么
1. 扫描项目 `skills\` 下每个包含 `SKILL.md` 的子目录(即可安装技能)。
2. 逐个复制到 `%USERPROFILE%\.trae-cn\skills\`
3. 目标已存在同名技能时,先把旧版移动到 `%USERPROFILE%\.trae-cn\skills-backup\<技能名>-<时间戳>\` 再装新版——不直接覆盖,旧版不丢。
4. 逐个校验并打印 `[OK]` / `[FAIL]`;全部成功时退出码为 0。
安全性:脚本只处理本项目 `skills\` 中出现的技能,不会删除或改动 `.trae-cn\skills\` 下的其他技能;不修改任何 Trae CN 配置文件。
## 验证
1. 重启 Trae CN或新建会话
2. 对话中直接提及技能名或相关意图,例如:
- 「帮我准备环境」→ `uv-env-setup`
- 「根据这份清单批量生成 Studio URL」→ `yt-studio-url-builder`
- 「用我的 Chrome 会话下载这份分析 CSV」→ `youtube-studio-csv-download`
## 更新与卸载
- **更新**:项目技能有改动后,重新双击 `install-skills.bat`(旧版自动备份)。
- **回滚**:把 `%USERPROFILE%\.trae-cn\skills-backup\<技能名>-<时间戳>\` 整个文件夹复制回 `%USERPROFILE%\.trae-cn\skills\<技能名>\`
- **卸载**:删除 `%USERPROFILE%\.trae-cn\skills\` 下对应技能文件夹。
- **清理备份**:确认新版可用后,删除 `%USERPROFILE%\.trae-cn\skills-backup\` 整个文件夹。
## 常见问题
- **双击 bat 闪退**:在 PowerShell 中手动运行 `scripts\install-skills.bat` 查看报错;最常见原因是 `install-skills.ps1` 没有和 bat 放在同一目录。
- **PowerShell 执行策略受限**bat 已带 `-ExecutionPolicy Bypass`;若组策略仍拦截,以管理员身份运行。
- **技能装了但不触发**:需重启 Trae CN 或新建会话后生效;确认对话窗口正常加载。
- **中文输出乱码**`install-skills.ps1` 必须保持 UTF-8 with BOM 编码(重新编辑保存时注意)。
## 注意
- 运行时依赖不随技能安装:两个脚本型技能的 Python 依赖pandas、openpyxl、playwright由项目根 `pyproject.toml` 统一管理,首次使用按 `uv-env-setup` 技能执行 `uv sync` 即可。
- 安装脚本仅支持 Windows路径与命令均按 Windows 编写)。