Files
OneOS1.2/docs/superpowers/specs/2026-07-22-oneos-design-system-v2-design.md

2.1 KiB
Raw Blame History

OneOS 设计规范 v2 · 设计决策

内容
日期 2026-07-22
状态 已落地文档包
产物 src/resources/design-system/DESIGN.md + chapters/0009 + tokens.json + oneos-ds-tokens.css

背景

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

决策

App 范围

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

文档策略

在现有 src/resources/design-system/ 扩写为 v2,不另建 design-system-v2 目录。

  • DESIGN.md:总览与导航
  • chapters/0009:完整约束清单落地
  • v1 列表强制规则并入 04-patterns.md,并继续指向 vm-shared/DESIGN.md

主色

沿用原型现行 #32a06evehicle-management / field-theme)。
oneos-web-legacy#10b981 标为遗留,新页禁止。

暗色模式

本版明确 仅浅色;若未来需要,须先补映射表。

工程入口

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

章节结构

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

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

成功标准

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

非目标(本轮)

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