Jyotisha/docs/tasks/PROGRESS-privacy-venv-20260920.md

门禁 .venv 符号链接与头像合同 · 执行记录

基线

• 日期：2026-09-20。
• 模式：直接执行（用户要求修复并重跑门禁）。
• 基线：origin/staging 980c77c3。
• 工作树：.worktrees/privacy-venv-20260920，分支 codex/privacy-venv-20260920。
• 不改 workflow、不提升 main、不动 DNS。主检出未跟踪文件未纳入本轮。

事故

门禁	SHA	失败点
2804–2806	eb8f5147 起	npm test：Beam 头像合同
2807	8497587e	Python 快速门：READ_ERROR .venv（858 通过 / 1 失败）

线上 /api/health 仍为上次绿灯 d6fc4fb8。

根因

1. BUG-974：9375012f 把 .venv 符号链接写进跟踪树；.gitignore 的 .venv/ 不忽略符号链接。门禁 rm -rf -- .venv && python3 -m venv --clear .venv 把链接换成目录，隐私扫描对跟踪路径读目录 → READ_ERROR。
2. BUG-975：设置弹窗头像说明已改，源码合同未改。

改动

• git rm .venv
• .gitignore：.venv/ → .venv
• tests/test_repo_privacy_markers.py：锁定 .venv 不在 git ls-files，且 check-ignore --no-index .venv 命中
• frontend/tests/beam-avatar.test.ts：对齐现行文案

断言三栏（BUG-975）

项	原值	新值	原因
beam-avatar.test.ts 头像说明	/Beam 形象由随机种子生成/	/Beam 形象会在刷新和换设备后保持一致/	组件文案已改；合同锁旧句导致 2804–2806 红

验证

• python -m pytest tests/test_repo_privacy_markers.py：62 collected / 62 passed（基线 60，本轮 +2：.venv 不得跟踪、gitignore 覆盖符号链接名）。
• tsx --test tests/beam-avatar.test.ts：6/6 通过，含原先红的第 6 条。
• 未跑全量 npm test / run_quality_gate.py --profile quick（工作树无独立依赖；以门禁为准）。
• 本轮代码提交：8dc460da。门禁结论在推送后补。