# OneOS 设计规范 v2 · 设计决策

| 项 | 内容 |
|----|------|
| 日期 | 2026-07-22 |
| 状态 | 已落地文档包 |
| 产物 | `src/resources/design-system/`（DESIGN.md + chapters/00–09 + tokens.json + oneos-ds-tokens.css） |

## 背景

既有 v1 规范仅覆盖中后台列表页（筛选 / KPI / 表 / 分页）。产品需要基于当前平台重做设计规范，约束 Web 与 App 全部页面的显示与组件，实现全站统一。

## 决策

### App 范围

**原生 App + 微信小程序 + H5 现场端**（三端全含），与仓库中 `vehicle-inspection-app` / `miniprogram` / `web` 及 PC 中后台并列。

### 文档策略

在现有 [`src/resources/design-system/`](../../src/resources/design-system/) **扩写为 v2**，不另建 `design-system-v2` 目录。

- 根 `DESIGN.md`：总览与导航
- `chapters/00–09`：完整约束清单落地
- v1 列表强制规则并入 `04-patterns.md`，并继续指向 `vm-shared/DESIGN.md`

### 主色

沿用原型现行 **`#32a06e`**（`vehicle-management` / `field-theme`）。  
`oneos-web-legacy` 的 `#10b981` 标为遗留，新页禁止。

### 暗色模式

本版明确 **仅浅色**；若未来需要，须先补映射表。

### 工程入口

- `tokens.json` schemaVersion **2**
- 新增 `oneos-ds-tokens.css` 供非列表页与共享变量引用
- 列表页仍强制 `vehicle-management/style.css` + 公共组件

## 章节结构

```text
00 总则 → 01 Foundations → 02 Layout → 03 Components
→ 04 Patterns → 05 Content → 06 A11y → 07 Platform
→ 08 Tokens 附录 → 09 迁移检查清单
```

编写优先级见 `PRIORITY.md`：Foundations / Tokens → Layout 模板 → Patterns → Components → 平台差异 → Content/A11y → 检查清单。

## 成功标准

- 任意新页可定位到唯一页面模板与 Token 来源
- Web 列表验收项不弱于 v1
- App/小程序/H5 有热区、安全区、导航对照表
- AI 提示词指向 v2 章节

## 非目标（本轮）

- 不批量改既有业务页面样式代码
- 不实现暗色主题
- 不合并改造 legacy `oneos-tokens.css` 文件内容（仅在规范中标注弃用路径）