# 水利智学系统 · 标准基线清单

> 本文件是"专家系统"的唯一标准来源。
> 专家不自己定标准，只维护这里已确认的标准。
> 冲突项标【⚠️待裁决】，由用户拍板，专家不自选。

---

## 一、标准来源（权威优先级从高到低）

| 优先级 | 文件 | 说明 |
|---|---|---|
| 1（最高） | **实际运行代码** | index.html渲染结果 + 各layout模块JS实际设的style值。设计稿/CSS变量/文档都不算数 |
| 2 | `frontend/index.html` | 实际入口，运行时真实加载 |
| 3 | `frontend/modules/layout/*.js` | topbar.js/sidebar.js/statusbar.js/module-nav.js实际设的inline style |
| 4 | `frontend/css/tokens.css` | CSS设计系统变量，**但被index.html !important覆盖时以1为准** |
| 5 | `架构总控文件.md` 第六章 | UI布局参数，**但V2.0旧值已废弃，以实际运行代码为准** |
| 6 | `启动摘要.md` | 可能是V2.0旧值，冲突时全部以1为准 |

> 🚨 **铁律：V2.0效果图已废弃**。所有从V2.0继承的布局参数（48px顶栏/#3949ab主色/粉色侧栏）一律作废，以当前实际运行代码为准。不要再拿V2.0的值当标准。

---

## 二、宪法级铁律（不可改）

来源：架构总控1.3-1.7

1. **禁止"先改了再说"**：影响功能和稳定的改动，必须先定规则、写入纲领、用户确认、备份后才能动
2. **执行流程9步**：需求→专家分析→制定规则→写入纲领→用户确认→备份→执行→验证→锁定
3. **三重检查**：自检 + 交叉检查 + 用户检查（核心功能100%查）
4. **执行彻底性**：禁止"差不多"、"以后再补"、"部分完成"
5. **终极问题**：任何功能必须回答"能不能帮用户更快考过一造？" 不能→不做
6. **未入纲先改→立即回滚**

---

## 三、布局标准（锁死，以实际运行代码为准）

### 3.1 实际值（从layout模块JS和index.html直接查）

| 项 | 值 | 实际来源 |
|---|---|---|
| 侧边栏宽 | **135px**（!important） | index.html第36行 `.sidebar { width:135px !important }` |
| 顶栏高 | **56px** | topbar.js第158行 `height:56px` |
| 模块导航条高 | **48px** | module-nav.js第57行 `height:48px` |
| 底栏高 | **28px**（!important） | v2-theme.css第502/801行 `height:28px !important` |
| 输入框高 | 38px | tokens.css `--input-h` |
| 内容最大宽 | 1400px | tokens.css `--content-max-w` |

> 注意：启动摘要里写的"顶栏48px"是把模块导航条的48px错当成了顶栏。真实顶栏=56px，模块导航条=48px，底栏=28px。

### 3.2 布局铁律

- 侧边栏固定135px，!important强制，改之前必须征得用户同意
- V2.0效果图已废弃，所有V2.0旧参数（#3949ab主色/粉色侧栏/160px侧栏）作废
- 颜色/尺寸/间距优先用tokens.css变量，但index.html硬编码!important的以实际渲染为准

---

## 四、颜色Token（tokens.css为权威）

### 4.1 主色
- primary: `#1a73e8`
- primary-dark: `#1557b0`
- primary-light: `#e8f0fe`

### 4.2 功能色（tokens.css实际值）
- success: `#10b981`
- warning: `#f59e0b`
- danger: `#ef4444`
- info: `#3b82f6`

### 4.3 中性色
- bg: `#f5f7fa`
- card: `#ffffff`
- text: `#1f2937`
- text-secondary: `#6b7280`
- border: `#e5e7eb`

---

## 五、新旧融合铁律

来源：架构总控3.3-3.4

1. 新模块service补全业务逻辑
2. 旧API路由改薄壳，转发到新service
3. 前端API_BASE不变，无感知
4. 验证通过后删除旧API
5. **模块间禁止跨域import**：qb不能import mt的service，mm不能import ai的service
6. 跨模块通信：通过API路由或事件总线
7. 路由层只做参数校验和响应封装，业务逻辑下沉到service

---

## 六、修改前检查清单

来源：架构总控4.4

- [ ] 是否违反布局锁死？
- [ ] 是否违反刷题逻辑铁律？（单选选了即出解析，多选提交才出解析）
- [ ] 是否违反读取铁律？（先读总控再动手）
- [ ] 是否备份了当前版本？
- [ ] 是否分析了修改影响范围？
- [ ] 是否有明确的完成清单？

---

## 七、已裁决冲突（以实际运行代码为准）

| # | 冲突 | 裁决结果 |
|---|---|---|
| 1 | 侧栏宽度 | **135px**（index.html !important）。tokens.css的--sidebar-w=120px未生效，不是标准 |
| 2 | 顶栏高度 | **56px**（topbar.js:158）。启动摘要的48px是错把模块导航条当顶栏 |
| 3 | 底栏高度 | **28px**（v2-theme.css:502 !important）。架构总控说的40px是错的 |
| 4 | 主色 | **#1a73e8**（tokens.css --color-primary）。启动摘要的#3949ab是V2.0旧值，作废 |
| 5 | 功能色 | 以tokens.css实际值为准：success=#10b981 / warning=#f59e0b / danger=#ef4444 |

> 启动摘要.md里的布局参数（48px/28px/#3949ab/粉色侧栏）**全部是V2.0旧值**，已确认作废。后续同步修正启动摘要。

---

## 八、我之前70人专家里哪些验收标准是错的

| 专家 | 我之前写的acceptance | 真实情况 |
|---|---|---|
| 布局宪法守护 | 侧栏必须160px | 实际135px，tokens.css是120px（冲突1） |
| 颜色规范专家 | 主色#3949ab | 实际#1a73e8（冲突4） |
| 重构专家 | 巨型文件<5个 | 系统里没这条标准 |
| 性能专家 | JS<500KB | 系统里没这条标准 |
| 代码审查专家 | 无print | 这条对（架构总控有"禁止print"） |
| 错误处理专家 | 无裸except | 这条对 |
| 模块化专家 | 7个模块目录齐全 | 这条对（架构总控3.2） |
| 命名规范专家 | 新表带模块前缀 | 这条对（启动摘要代码规范） |
| 安全专家 | 无硬编码密码 | 这条对 |
| 其他60人 | 大部分是"文件存在吗" | 不是验收标准，是存在性检查 |

---

**清单版本**：V1.0
**生成日期**：2026-09-15
**下一步**：用户裁决冲突1-6后，进入第二步基线标定
