# 新会话启动SOP

> 📌 **落地状态唯一真源**：`docs/落地对账总表.md`（机读 `docs/landing_registry.json`），由 `tools/doc_landing_audit.py` 自动核验刷新。开工先跑 `tools/startup_verify.py` 看基线；各 md 的"已完成/未落地"均为一方陈述，一律以对账总表为准。

## 启动必读清单

新会话开始，按顺序全部读完，才开始干活：

### 必读文件
1. **工作总控.md**——索引+10条硬规则+变更记录（唯一真源）
2. **专家系统现状.md**——101专家、11warning
3. **标准基线清单.md**——标准值核对（布局/颜色/业务规则）
4. **系统交付级诊断报告.md**——144专家交付级诊断+12周路线图（查交付差距时翻，不用全读）
5. **AI_WORK_PLAN.md**——6周推进计划（当前周次/本周任务/验收标准）
6. **架构总控文件.md**——细节问题查这个（35000行，不读全文）

### 必跑脚本
5. **latest_report.py**——专家最新warning
   `D:\Python311\python.exe backend/core/experts/latest_report.py`
6. **查待办需求**——78条待办改到哪了
   `from core.requirement_tracker import get_pending_requirements`
7. 确认Ollama起着没（没起就起）
8. 确认后端起着没（没起就双击start.bat）

### 必知事实
- 布局锁死：侧栏135px/顶栏56px/模块导航48px/底栏28px/主色#1a73e8
- 注意：#3949ab 为 V2.0 旧主色，已作废（见《标准基线清单.md》冲突4）；现行主色以 #1a73e8 为准，旧代码残留 #3949ab 不得当标准
- 101个专家，PASS:True，11个warning
- 用户报48个问题#31~#78已录需求记录
- Python用D:\Python311\python.exe
- 项目根：F:\水利智学系统\可运行版（解压即用，双击start.bat）

### 必读标准分块
9. backend/core/layout/dimensions.py——布局尺寸
10. backend/core/layout/colors.py——颜色
11. backend/core/standards/9块——业务规则/代码规则/数据质量/安全/运行时/工作流/功能状态/探针深度

### 必做对比（文档≠事实，小心求证）
- 文档说"未落地"的功能 → 先跑`python tools/feature_audit.py` + 浏览器真点，别按文档盲做（如O03考点图谱文档说gap实际已接线）
- 文档说"已完成"的 → 实测验证后才打钩销项，不允许"改了代码就算完"
- 布局值/数字/API → 以实际运行代码和实测为准，文档过时了改文档不改代码
- 销项五步：改代码→浏览器实测→feature_audit/待办清单打钩→总控记变更→重跑专家
- 详细对比矩阵见 工作总控.md「〇·六、对比与销项机制」

## 硬规则11条

1. 布局锁死不许动（135px/56px/48px/28px/#1a73e8）
2. 改完代码必须重跑专家对比warning
3. 不可逆操作（删表/清数据）先问用户
4. 可逆操作（建表/补render/灌数据）直接做
5. 专家自己不能报错（别把return HTML当空render、别写错表名、别拿V2.0旧值）
6. 实际运行代码 > tokens.css > 文档
7. 标准分块不混入（layout/和standards/各管各的）
8. git已装，改前commit，改坏checkout
9. 需求变更先读需求记录
10. 改代码先Read看现状，别凭记忆改
11. 文档≠事实：所有md结论必须实测验证；改完功能按销项五步走，不允许"改了代码就算完成"
