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

@@ -9,6 +9,7 @@
| `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 |
| `yt-studio-groupid-lookup` | 把一批群组名批量解析为 entity_idgroupId并标注归属的内容所有者 |
## 安装(傻瓜式)
@@ -18,7 +19,7 @@
scripts\install-skills.bat
```
看到 `全部安装成功` 及逐项 `[OK]` 即完成,按任意键关闭窗口。
看到 `全部安装成功` 及逐项 `[OK]` 即完成,按任意键关闭窗口。**默认安装全部技能**;同名旧版自动备份到 `~/.trae-cn/skills-backup/`
命令行等价方式PowerShell / cmd 均可):
@@ -26,12 +27,28 @@ scripts\install-skills.bat
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-skills.ps1
```
### 可选参数bat 与 ps1 均支持)
| 参数 | 作用 |
|---|---|
| `-Skills <名1,名2>` | 只安装指定的技能(按技能文件夹名,不区分大小写);缺省=全部 |
| `-DryRun` | 只预览将安装/覆盖/备份的技能,不实际复制 |
示例:
```powershell
scripts\install-skills.bat -Skills yt-studio-url-builder,youtube-studio-csv-download
scripts\install-skills.bat -DryRun
```
## 脚本做了什么
1. 扫描项目 `skills\` 下每个包含 `SKILL.md` 的子目录(即可安装技能)。
2. 逐个复制到 `%USERPROFILE%\.trae-cn\skills\`
3. 目标已存在同名技能时,先把旧版移动到 `%USERPROFILE%\.trae-cn\skills-backup\<技能名>-<时间戳>\` 再装新版——不直接覆盖,旧版不丢
4. 逐个校验并打印 `[OK]` / `[FAIL]`;全部成功时退出码为 0
1. 扫描项目 `skills\` 下每个包含 `SKILL.md` 的子目录(即可安装技能;缺 `SKILL.md` 的目录会提示「跳过」)。
2. **默认安装全部技能**;若带 `-Skills` 则只装指定的,并提示未找到的技能名
3. 读取每个 `SKILL.md` 顶部的 `name`,与文件夹名比对——不一致或缺 `name` 时打警告(避免技能名歧义/旧名残留)
4. 逐个复制到 `%USERPROFILE%\.trae-cn\skills\`;目标已存在同名技能时,先把旧版移动到 `%USERPROFILE%\.trae-cn\skills-backup\<技能名>-<时间戳>\` 再装新版,不直接覆盖
5. 逐个校验并打印 `[OK]` / `[FAIL]`;全部成功退出码 0失败退出码 2。
6.`-DryRun` 时只打印将安装/覆盖/备份的技能清单,不做任何修改。
安全性:脚本只处理本项目 `skills\` 中出现的技能,不会删除或改动 `.trae-cn\skills\` 下的其他技能;不修改任何 Trae CN 配置文件。