docs: phase2_log 追加 Task 2 收尾记录(2026-05-20)

logs/phase2_log.md

@@ -315,4 +315,78 @@ CREATE INDEX idx_episodes_broadcast_date ON episodes (date_part('year', broadcas
 |--------|------|
 | 442d52f | feat: 完善批量导入逻辑，8步冒烟全绿 |
 
-*本日志由 MiniMax M2.7(Cline Act 模式)于 2026-05-15 持续追加，2026-05-19 追加 Task 2 完工坑与红线澄清。*
+*本日志由 MiniMax M2.7(Cline Act 模式)于 2026-05-15 持续追加，2026-05-19 追加 Task 2 完工坑与红线澄清，2026-05-20 追加 Task 2 收尾记录。*
+
+---
+
+## 十一、Task 2 收尾完工记录(2026-05-20)
+
+### 11.1 Git 安全卫生:token 从 URL 剥离
+
+**背景**:`.git/config` 里 origin 远程 URL 含明文 token(`cline-tps-dashboard`),
+存在被 Cline 误贴日志、截图泄露、备份带出等风险。
+
+**改动**:
+- `git remote set-url origin` 改成干净 URL(去掉 `user:token@`)
+- token 改由 Windows Git Credential Manager (manager) 加密存储
+- 两次 fetch 静默通过,push 走 GCM 透明工作
+- 旧 token `cline-tps-dashboard` 继续使用,不吊销
+
+**纪律备注**:以后任何凭证(密码、API key、token)都不许写进 URL、不许写进 .py 文件、
+不许写进任何会被 commit 的文件。
+
+### 11.2 小尾巴 1:补录 2024 真值
+
+**操作**:制片人手动 psql 直接 INSERT(绕过 API,因 API 权限收紧待办未做)。
+
+**当前 yearly_targets 真值**:
+- 2024: base=0.6448 / stretch=0.8290 (issued_date=2024-01-01, 补录说明在 notes)
+- 2025: base=0.6448 / stretch=0.8989
+- 2026: base=0.6448 / stretch=0.8989
+
+### 11.3 小尾巴 3:backups/ 进 .gitignore
+
+**commit**:20c0a1d(chore: backups/ 进 .gitignore)
+**push**:已成功
+
+### 11.4 小尾巴 4:schema 类名自查通过
+
+类名与 Task 2 Plan 一致,无漂移。`ImportError` / `ImportResult` 命名正确。
+
+发现 2 个隐患,**暂不处理,记为待办**:
+- 隐患 A:`ImportError` 与 Python 内置同名,当前未撞,未来若在导入逻辑里 raise 才会冲突
+- 隐患 B:`ExcelService.import_episodes()` 返回 dict 而非 Pydantic 对象,
+  API 层手动构造 `ImportResult`,缺一次 Pydantic 校验层。8 步冒烟已验证业务正确,
+  仅代码洁癖问题
+
+### 11.5 小尾巴 2:Python PATH 根治坑 4
+
+**改动**:从系统 PATH 删除 `C:\Python314\Scripts\` 和 `C:\Python314\` 两行。
+用户 PATH 中 Python 3.12 自动顶上来。
+
+**验证**:
+- `where.exe python` 第一行变成 3.12 路径
+- `python --version` = Python 3.12.10
+- `sys.executable` 指向 3.12
+
+**遗留**:E:\tps-dashboard\backend\ 下没有 venv,Python 依赖装在系统 3.12 全局
+site-packages 里。**记入待办**,Phase 4 部署前或 Task 3 启动前评估是否补 venv。
+
+### 11.6 待办清单(Task 3 启动前或后续 Phase 处理)
+
+| 待办 | 触发时机 | 优先级 |
+|---|---|---|
+| `yearly_targets` 写权限收紧到 `zhipianren` + `zebian`,`biandao` 只读 | Task 3 启动前 | 高(业务红线) |
+| backend/ 补 venv,把全局依赖搬进去 | Task 3 启动前评估 | 中 |
+| 隐患 A:`ImportError` 同名冲突预防 | 真要 raise 时再说 | 低 |
+| 隐患 B:`ExcelService` 返回 Pydantic 化 | 代码洁癖,有空时做 | 低 |
+
+### 11.7 Task 2 完整 commit 链(2026-05-19 → 2026-05-20)
+
+| commit | 内容 |
+|---|---|
+| 442d52f | feat: 完善批量导入逻辑,8步冒烟全绿(2026-05-19) |
+| 6de8111 | docs: Task 2 完工记录,坑7/8/纪律3/Q1-Q4 写入(2026-05-19) |
+| 20c0a1d | chore: backups/ 进 .gitignore(Task 2 收尾)(2026-05-20) |
+
+**Task 2 完整收尾,Phase 2 Task 2 状态:✅ 完工。**