帮助中心 · 文档
使用指南
了解如何使用 RICOUI DESIGN 创建草稿、编辑 Token、沉淀设计资产，以及本地、AI 与同步的数据原则。全部内容在同一页连续阅读，右侧目录与键盘搜索随时帮你定位。
这份指南对应的是一个仍在变化的产品
RICOUI DESIGN 当前处于 Beta 阶段，功能和交互还在探索与完善。指南会随版本更新；如果页面表现与这里不同，请以当前产品为准。
章节 01 · 从这里开始
概览
RICOUI DESIGN 把 DESIGN.md 当作唯一真源：解析为结构化 Token，渲染规范预览，并提供源码、结构化、预览三种编辑视图。
推荐工作流
- 1创建或导入一份草稿
- 2编辑并验证设计 Token
- 3检查统一预览与格式诊断
- 4导出文件或保存到设计库
章节 02 · 按任务操作
使用教程
挑一个你正想完成的任务，按步骤走完。每一节都写明完成后你会得到什么。
创建并导入第一份 DESIGN.md
你会得到： 完成后，你会在工作台中得到一份自动保存、可以被结构化解析的草稿。
- 01
选择起点
打开工作台，点击“新建草稿”。可以从标准空白模板开始，也可以从设计库或品牌库复制。
- 02
导入已有文件
选择“导入”并上传一个或多个 .md 文件。单文件成功后会直接打开，批量结果会显示导入摘要。
- 03
检查诊断
编辑器会识别颜色、字体、间距和组件章节。未知区块原样保留，格式风险会在诊断面板说明。
- 04
整理草稿
修改名称、置顶常用文档或添加分类与标签。内容修改会自动保存在浏览器本地。
章节 03 · 产品结构
功能介绍
四个核心入口：写作、沉淀、参考、检索。每个都对应左侧导航的一项。
章节 04 · 写作约定
文件规范
一份 DESIGN.md 的骨架长这样。结构化视图只重写已建模区块，其余原样保留。
# Product — Style Reference
> Brand voice and rationale
**Theme:** light
## Tokens — Colors
| Name | Value | Token | Role |
## Tokens — Typography
### Type Scale
## Tokens — Spacing & Shapes
### Spacing Scale
### Border Radius
## Components
## Do's and Don'ts
## Imagery
## Layout- 颜色使用 Name、Value、Token、Role 四列
- 字号同时记录 line-height 与 letter-spacing
- 阴影保留完整、可执行的 CSS 语法
- 组件分别说明 hover、focus 与 active
- 未知章节会在结构化编辑时原样保留
章节 05 · 数据去向
数据与隐私
本地优先是默认形态。云同步与 AI 都是可选、且必须由你明确触发才会发生。
本地工作区
- 草稿与设计库保存在 IndexedDB
- 无需账户即可使用核心功能
- 导入和导出均在浏览器完成
可选云同步
- 配置 Supabase 后才启用
- 同步个人工作区实体
- 云端采用 owner-only 访问策略
AI 操作原则
- 打开面板不会发送内容
- 分析结果默认只读
- 标准化必须预览后应用
交付文件
- DESIGN.md 是运行时真源
- tokens.json 使用 DTCG
- CSS 文件用于外部实现
章节 06 · 答疑
常见问题
导入提示、隐私边界、预览来源——这里集中回答最常被问到的问题。
不会。默认保存在浏览器 IndexedDB；只有配置并登录 Supabase 后，个人工作区才会参与云同步。