# 技能安装说明（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 分析 CSV（zip） |

## 安装（傻瓜式）

双击运行：

```
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 编写）。