本目录是 YYC³ 全部文档资产的唯一入口。 架构分层：
| 目录 | 定位 | 维护策略 |
|---|---|---|
| developer/ | ★ 现行开发文档（10 篇，唯一被维护的文档集） | 随代码变更持续更新 |
| archive/ | 历史归档（白皮书/方案/审计/创作/快照） | 只读，不再维护 |
面向开发者的完整技术文档套，以 developer/README.md 为入口：
| 文档 | 内容 |
|---|---|
| 01 · 快速上手 | 环境要求、安装、启动、常见问题 |
| 02 · 可视化架构体系 | 系统分层 / 混合路由 / 数据流 / AI 链路 / 徽章评估（Mermaid） |
| 03 · 数据模型 | SQLite 九张表、JSON 列约定、种子数据、备份 |
| 04 · API 参考 | 全部 REST 端点：请求/响应/错误码约定 |
| 05 · 前端组件体系 | 目录组织、UI 基建、状态管理、主题与角色系统 |
| 06 · AI 引擎与安全 | 服务端代理模式、密钥管理、AI 引擎模块清单 |
| 07 · 测试与质量门禁 | tsc / lint / test / audit 四道门禁 |
| 08 · 部署 | 本地生产、脚本、Docker 注意事项 |
| 09 · 贡献指南 | 分支模型、提交规范、徽章系统扩展指南 |
仅作追溯参考，内容可能过期，与当前代码不一致时以
developer/ 为准：
| 目录 | 内容 | 规模 |
|---|---|---|
| architecture/ | 旧版架构/方案/白皮书（合并初期归档） | 63 篇 |
| audit/ | 审计报告与 UI 方案 | 9 篇 |
| creative/ | 沫语创作集（爱之细语等） | 40 篇 |
| history-snapshots/ | 多版本合并前的项目快照 | 16 篇 |
| plans/ | 历次开发规划 | 19 篇 |
2026-08-19 文档架构规范化时移除（git
历史可完整找回，git checkout <commit> -- <path>）：
| 目录 | 原规模 | 清除原因 |
|---|---|---|
docs/library/ |
~13k 文件 / 130M | generate-docs.py 产物 + 多版本复制品，内容重复 |
docs/xy-02-microservices/ |
~2,850 文件 / 14M | 合并前微服务文档库，与统一基线无关 |
assets/ |
3 文件 | 无代码引用，内含过期 monorepo CI（apps/server、MongoDB） |