feat(scripts): 添加 PEP 723 脚本元数据并修复 HTTP/2 伪头过滤问题

- 为 build_studio_urls.py 和 lookup_groups.py 添加 PEP 723 依赖声明
- 修复 HTTP/2 伪头导致 requests 抛 InvalidHeader 的问题
- 添加 CDP 端口连通性预检查及启动指引

skills/yt-studio-url-builder/SKILL.md

@@ -13,6 +13,8 @@ description: "根据需求清单（CSV/Excel）批量生成 YouTube Studio 内
 - **制作输入清单**：用户有零散需求（所有者ID、实体、日期范围、国家），需先整理成脚本可读的输入文件。
 - **排查问题**：运行后出现失败行、空输出、解析错误，需要定位并修复。
 
+> **前置依赖**：URL 的 `entity_id` 必须是现成 ID。清单里只有**群组名**时，先走 `yt-studio-groupid-lookup` 技能解析出 groupId 并回填清单，再执行本技能——群组名无法直接拼 URL，这是流程顺序要求而非脚本缺陷。
+
 ## 领域词汇
 
 - **所有者（Content Owner）**：拥有内容管理器的账号实体，URL 中由 `o` 参数 + `/owner/<id>/` 路径标识。
@@ -29,8 +31,8 @@ description: "根据需求清单（CSV/Excel）批量生成 YouTube Studio 内
 
 ### 1. 定位脚本与依赖
 
-- 脚本默认位于 `scripts/build_studio_urls.py`；若缺失，用 SearchCodebase 按 `build_studio_urls.py` 定位。
-- 运行环境由 `uv-env-setup` 技能统一管理：依赖（pandas、openpyxl）在根 `pyproject.toml` 声明，`uv run` 自动同步。首次运行前先按该技能准备环境。
+- 脚本默认位于 `scripts/build_studio_urls.py`；若缺失，用代码库全局搜索按 `build_studio_urls.py` 定位。
+- 运行环境由 `uv-env-setup` 技能统一管理：项目环境走 `uv sync` + `uv run`；脱离项目时脚本头部带 PEP 723 声明，`uv run <脚本>` 自动备环境。首次运行前先按该技能选好分支。
 - 中文国家名 → ISO 代码的映射在 `scripts/countries.json`，可自行扩充。
 
 完成标准：脚本路径已确定，且第 4 步的运行命令可直接执行。
@@ -60,8 +62,8 @@ description: "根据需求清单（CSV/Excel）批量生成 YouTube Studio 内
 ### 4. 运行脚本
 
 ```bash
-# 项目根目录下
-uv run python scripts\build_studio_urls.py -i <输入文件> [-o <输出csv>]
+# 项目根目录下；路径写法用正斜杠，PowerShell / Git Bash / cmd 通用
+uv run python scripts/build_studio_urls.py -i <输入文件> [-o <输出csv>]
 ```
 
 - 输入支持 `.csv`（UTF-8 或 GBK，自动尝试）与 `.xlsx` / `.xls`。