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

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

README.md

@@ -48,45 +48,44 @@
 ### 前置条件
 
 - Windows
-- [Trae CN](https://www.trae.cn/) 已安装
-- [uv](https://docs.astral.sh/uv/) 已安装（未装可 `winget install astral-sh.uv`，装完重开终端）
+- agent 之一：[Trae CN](https://www.trae.cn/) 或 [ZCode](https://github.com/ZhipuAI)（技能装到对应用户级目录）
+- [uv](https://docs.astral.sh/uv/) 已安装（未装可 `winget install astral-sh.uv`，装完重开终端；当前会话不识别时先跑 `python -m uv`，详见 uv-env-setup 技能）
 
-### 第 1 步：安装技能到 Trae CN
+### 第 1 步：安装技能
 
-双击运行：
+双击运行（默认装到 Trae CN）：
 
 ```
 scripts\install-skills.bat
 ```
 
-看到 `全部安装成功` 即完成。脚本会把 `skills\` 下全部技能复制到 `%USERPROFILE%\.trae-cn\skills\`；同名旧版自动备份到 `~\.trae-cn\skills-backup\`，不会丢数据。详细说明见 [docs/install-skills.md](docs/install-skills.md)。
+或用 `-Agent` 指定目标：`trae-cn`（默认）/ `zcode` / `all`（全部目标）。脚本会把 `skills\` 下全部技能复制到对应用户级目录（trae-cn: `%USERPROFILE%\.trae-cn\skills\`；zcode: `%USERPROFILE%\.zcode\skills\`）；同名旧版自动备份到该目录旁的 `skills-backup\`，不会丢数据。详细说明见 [docs/install-skills.md](docs/install-skills.md)。
 
-**默认安装全部技能**。需要只装部分或先预览时，可在命令行加参数（bat 与 ps1 都支持）：
+**默认安装全部技能**。需要只装部分、指定目标或先预览时，可在命令行加参数（bat 与 ps1 都支持）：
 
 ```powershell
-# 只安装指定的几个技能
-scripts\install-skills.bat -Skills yt-studio-url-builder,youtube-studio-csv-download
+# 装到 ZCode
+scripts\install-skills.bat -Agent zcode
+# 全部目标只安装指定的几个技能
+scripts\install-skills.bat -Agent all -Skills yt-studio-url-builder,youtube-studio-csv-download
 # 只预览将安装/覆盖/备份的技能，不实际复制
 scripts\install-skills.bat -DryRun
 ```
 
 ### 第 2 步：准备 Python 运行环境
 
-项目根目录执行：
+两种模式按场景二选一（细节与回退链见 `skills/uv-env-setup/SKILL.md`）：
 
-```powershell
-uv sync
-```
-
-uv 自动创建 `.venv\` 并安装全部依赖（pandas、openpyxl、playwright）。本机无兼容 Python 时 uv 会自动下载托管 Python（要求 ≥3.10）。
+- **项目环境**（在项目内跑整套流程）：项目根执行 `uv sync`，之后统一 `uv run python <脚本>`。uv 自动创建 `.venv\` 并安装全部依赖（pandas、openpyxl、playwright、requests）；本机无兼容 Python 时 uv 会自动下载托管 Python（要求 ≥3.10）。
+- **单脚本模式**（技能已装到用户级目录、脱离项目使用）：什么都不用配——脚本头部带 PEP 723 内联依赖声明，直接 `uv run <脚本路径>` 即可。
 
 ### 第 3 步：开始使用
 
-重启 Trae CN（或新建会话）后，在对话中直接说需求即可触发对应技能，例如：
+重启对应 agent（或新建会话）后，在对话中直接说需求即可触发对应技能，例如：
 
 > 根据这份清单批量生成 Studio URL
 
-把需求整理成 CSV/Excel（格式见 `skills/yt-studio-url-builder/references/input-guide.md`，示例见 `assets/需求输入示例.xlsx`），技能会引导生成 URL 清单。
+把需求整理成 CSV/Excel（格式见 `skills/yt-studio-url-builder/references/input-guide.md`，示例见 `assets/需求输入示例.xlsx`），技能会引导生成 URL 清单。**清单里只有群组名时，先说「帮我把这些群组名解析成 entity_id」走 groupid-lookup 技能补 ID**，再生成 URL。
 
 > 用我的 Chrome 会话下载这份分析 CSV
 
@@ -94,9 +93,7 @@ uv 自动创建 `.venv\` 并安装全部依赖（pandas、openpyxl、playwright
 
 > 帮我准备/重建环境
 
-技能会引导走 `uv sync` 与验证流程。
-
-所有脚本统一用 `uv run python <脚本>` 执行（自动使用项目环境，免激活、免手动装依赖）。
+技能会引导选择运行分支（项目环境 / 单脚本模式）并完成验证。
 
 ## 后续优化与修改