chore: 更新技能引用名称并新增 yt-studio-auth-prep 登录脚本

docs/install-skills.md

@@ -14,7 +14,8 @@
 
 | 技能 | 用途 |
 |---|---|
-| `uv-env-setup` | 用 uv 准备并维护 Python 运行环境（项目环境 / 单脚本 PEP 723 模式） |
+| `yt-download-place` | 在当前目录或指定路径创建 uv 项目工作区，承载各技能脚本的 uv 运行环境（项目环境 / 单脚本 PEP 723 模式） |
+| `yt-studio-auth-prep` | 在工作区预置登录态与鉴权套件：调试用户目录 `.profile`（YouTube 登录）+ 内容所有者套件 `bundles.json` |
 | `yt-studio-url-builder` | 根据需求清单（CSV/Excel）批量生成 YouTube Studio 内容管理器 explore URL |
 | `yt-studio-groupid-lookup` | 把一批群组名批量解析为 entity_id（groupId），并标注归属的内容所有者 |
 | `youtube-studio-csv-download` | 复用已登录浏览器会话，脚本化下载 YouTube Studio 分析 CSV（zip） |
@@ -71,15 +72,17 @@ scripts\install-skills.bat -Agent trae-cn -DryRun
 
 - **Trae CN**：用户级技能目录即上表；重启 Trae CN 或新建会话后生效。
 - **ZCode**：技能落在 `~\.zcode\skills\` 后由 ZCode 自动发现（本机会话中已验证）；新建会话后生效。zcode 环境里的同名工程技能可能遮蔽用户级技能，排查时注意优先级。
-- **终端方言**：两个 agent 都可能在 PowerShell 或 Git Bash 里执行命令。所有 SKILL.md 的示例统一用正斜杠路径 + 引号写法，两边通用；uv-env-setup 提供 PATH 刷新的两种方言写法。
-- **通用兜底**：无论哪个 agent，跑脚本前都先按 `uv-env-setup` 技能确认 uv 分支（项目环境 / 单脚本模式 / python -m uv 回退）。
+- **终端方言**：两个 agent 都可能在 PowerShell 或 Git Bash 里执行命令。所有 SKILL.md 的示例统一用正斜杠路径 + 引号写法，两边通用；yt-download-place 提供 PATH 刷新的两种方言写法。
+- **通用兜底**：无论哪个 agent，跑脚本前都先按 `yt-download-place` 技能备好 uv 环境（工作区 / 单脚本模式 / python -m uv 回退）。
 
 ## 验证
 
 1. 重启对应 agent（或新建会话）。
 2. 对话中直接提及技能名或相关意图，例如：
-   - 「帮我准备环境」→ `uv-env-setup`
+   - 「帮我准备工作区」→ `yt-download-place`
+   - 「帮我准备 YouTube 登录目录和所有者套件」→ `yt-studio-auth-prep`
    - 「根据这份清单批量生成 Studio URL」→ `yt-studio-url-builder`
+   - 「把这些群组名查成 Group ID」→ `yt-studio-groupid-lookup`
    - 「用我的 Chrome 会话下载这份分析 CSV」→ `youtube-studio-csv-download`
 
 ## 更新与卸载
@@ -98,5 +101,5 @@ scripts\install-skills.bat -Agent trae-cn -DryRun
 
 ## 注意
 
-- 运行时依赖不随技能安装：脚本型技能的 Python 依赖由两层机制承接——项目根 `pyproject.toml`（项目环境）或脚本头部 PEP 723 内联声明（单脚本模式），首次使用按 `uv-env-setup` 技能执行即可。
+- 运行时依赖不随技能安装：脚本型技能的 Python 依赖由两层机制承接——工作区 `pyproject.toml`（项目环境）或脚本头部 PEP 723 内联声明（单脚本模式），首次使用按 `yt-download-place` 技能建好工作区即可。
 - 安装脚本仅支持 Windows（路径与命令均按 Windows 编写）。

docs/usage-guide.md

@@ -4,10 +4,11 @@
 
 如果你需要完成上面这个常见的应用场景，那么，本技能组中的所有技能都是必须的，包括：
 
-- `uv-env-setup`：用于设置必要的 Python 运行环境，以便下面的技能所带的脚本可以正确运行。
+- `yt-download-place`：用于在当前或指定目录创建 uv 项目工作区，为下面的技能所带的脚本提供运行环境。
+- `yt-studio-auth-prep`：用于在工作区预置登录态与鉴权套件——调试用户目录 `.profile`（完成一次 YouTube 账号登录）与内容所有者鉴权套件 `bundles.json`，供后续所有任务复用。
+- `yt-studio-groupid-lookup`：用于从群组名称中提取实体 ID（已预置 `bundles.json` 时离线回放）。
 - `yt-studio-url-builder`：用于构建 YouTube Studio 分析页面 URL。
 - `youtube-studio-csv-download`：用于下载 YouTube Studio 分析数据。
-- `yt-studio-groupid-lookup`：用于从群组名称中提取实体 ID。
 
 对于这样一个任务，对于只有一个群组数据需要下载的情况，这组技能并没有人工下载来的快，更适合批量下载众多群组的数据。也就是，你需要Agent帮你从YouTube Studio的分析页面中，下载众多群组的众多情况的数据时，这组技能可以更好的指导Agent完成工作，也能很好的加速下载。
 
@@ -20,7 +21,14 @@
 
 这里，数据需求，就是你需要下载哪些指标的数据，以及你需要哪些时间段的数据，也包括需要筛选什么信息，同时，你需要的是什么细分的数据，例如：频道数据、内容数据还是其他的数据。
 
-下一步，是获取群组的实体 ID（groupid）。你可以让Agent使用 `yt-studio-groupid-lookup` 技能，来从群组名称中提取实体 ID。这样，前期的准备就算基本完成了。
+有了上面这些东西之后，先做一次环境预置（每个工作区只需一次）：
+
+1. 指示Agent用 `yt-download-place` 创建下载工作区（uv 项目环境，各技能脚本统一以 `uv run` 运行）。
+2. 指示Agent用 `yt-studio-auth-prep` 完成两项预置：在工作区创建调试用户目录 `.profile` 并完成一次 YouTube 账号登录；再提供内容所有者分析页 URL，把鉴权套件捕获到工作区的 `bundles.json`。
+
+预置完成后，后续所有任务都在同一个工作区里复用这份登录态与套件。只有当登录态失效（下载时跳到 Google 登录页）或套件过期（查 Group ID 时全量 401）时，才需要回到这一步刷新。
+
+下一步，是获取群组的实体 ID（groupid）。你可以让Agent使用 `yt-studio-groupid-lookup` 技能，来从群组名称中提取实体 ID；已预置 `bundles.json` 时走离线回放，全程无需打开浏览器。这样，前期的准备就算基本完成了。
 
 然后，指示Agent基于你的需求与获取的实体ID，创建符合需求的分析页面 URL。
 
@@ -30,6 +38,8 @@
 
 ### 检查与确认
 
+预置阶段的检查：`.profile` 登录完成后技能会打印「登录成功」；`bundles.json` 中套件数量应与你提供的所有者分析页 URL 数量一致，可以要求Agent列出每个套件的 ownerId 清单供你核对。
+
 常用的检查就是，需要下载的文件数量需要对应于生成的URL数量。如果数量不对应，那么，就需要检查Agent是否正确生成了URL，或者是否有任何错误或异常情况发生。
 
 另外，在URL生成过程中，也需要检查Agent是否正确解析了群组名称，以及是否有任何错误或异常情况发生。可以要求Agent抽样几个URL打开浏览器进行浏览确认。这个方式也可以确认Agent当前是否正确的读取了浏览器的登录状态，以避免因为登录状态过期而导致的下载失败。