11# Project Overview — 创游世界资料汇总
22
3-
43## Structure
54
65``` text
@@ -9,43 +8,39 @@ cysj-data/
98│ ├── .vitepress/
109│ │ ├── config.mts # VitePress 主配置(站点名、SEO、sitemap、RSS)
1110│ │ ├── theme/
12- │ │ │ ├── index.ts # 主题入口(CSS 加载顺序、Layout 注册)
13- │ │ │ ├── Layout.vue # 根布局组件
14- │ │ │ ├── components/ # 自定义组件(AuthorCard, MetaLine, CysjTools 等)
15- │ │ │ └── styles/ # 9 层 CSS 架构
16- │ │ │ ├── cysj-design-tokens.css # 设计令牌(颜色/间距/阴影/圆角/动效)
17- │ │ │ ├── cysj-typography.css # 全局字体、标题、段落
18- │ │ │ ├── cysj-components.css # 代码块、引用块、表格
19- │ │ │ ├── cysj-layout.css # 导航栏、侧边栏、分页、页脚
20- │ │ │ ├── cysj-custom-components.css # 页面元信息、作者卡片、阅读进度条
21- │ │ │ ├── cysj-home.css # Hero、Feature 卡片、首页
22- │ │ │ ├── cysj-animations.css # 入场动画、渐变流光、背景呼吸
23- │ │ │ ├── cysj-performance.css # 硬件加速、防布局偏移、降级
24- │ │ │ └── cysj-responsive.css # 响应式断点、无障碍、打印
11+ │ │ │ ├── index.ts # 主题入口(5 个 CSS 文件)
12+ │ │ │ ├── Layout.vue # 根布局组件(无粒子动画)
13+ │ │ │ ├── components/ # 自定义组件(PageInfo, PageActions, SiteTools, ReadingProgress)
14+ │ │ │ └── styles/ # 5 层 CSS 架构(重构后)
15+ │ │ │ ├── tokens.css # 设计令牌(颜色/间距/圆角/动效/布局)
16+ │ │ │ ├── typography.css # 全局字体、标题、段落
17+ │ │ │ ├── components.css # 代码块、引用块、表格
18+ │ │ │ ├── layout.css # 导航栏、侧边栏、分页、首页区块、响应式
19+ │ │ │ └── custom.css # PageInfo、PageActions、SiteTools、ReadingProgress
2520│ │ └── public/ # 静态资源(favicon, robots.txt)
2621│ ├── index.md # 首页
27- │ ├── guide/ # 指南
28- │ ├── reference/ # 参考文档
29- │ └── ... # 其他页面
22+ │ └── ... # 210+ 个 .md 页面
23+ ├── scripts/ # 自动化脚本(25+ 个)
3024├── .serena/ # Serena 项目管理
3125└── package.json
3226```
3327
34-
3528## Key Facts
3629
37- - ** 框架** : VitePress 5.x (基于 Vue 3 + Vite)
38- - ** 内容** : 创游世界(CYWorld)游戏开发引擎的资料汇总
39- - ** 主题** : 自定义 CYSJ 设计系统,蓝紫色品牌色,Slate 色系
40- - ** CSS 架构** : 9 层分层 (令牌→排版→组件→布局→自定义组件→首页→动画→性能→响应式)
41- - ** 暗色模式** : 完整支持,每处关键变量都有暗色变体
30+ - ** 框架** : VitePress 1.6.4 (基于 Vue 3 + Vite)
31+ - ** 内容** : 创游世界(CYWorld)游戏开发引擎的中文知识库
32+ - ** 主题** : CYSJ 现代极简设计系统,中性灰 + 品牌蓝,暗色优先
33+ - ** CSS 架构** : 5 层 (令牌→排版→组件→布局→自定义组件),从旧 9 层精简
34+ - ** 暗色模式** : 独立设计系统, ` #0a0a0a ` 背景,沉稳蓝 ` #4d9de6 `
4235- ** SEO** : sitemap + RSS + Open Graph + JSON-LD
4336- ** SSR** : 元数据通过 transformPageData 注入
44-
37+ - ** 动画 ** : 完全移除粒子/流光/呼吸/扫光/脉冲,仅保留 120-200ms 状态反馈
4538
4639## Invariants
4740
4841- CSS 加载顺序固定(见 index.ts),不可颠倒
4942- 设计令牌变量统一使用 ` --cysj-* ` 命名空间
50- - 响应式断点:420px / 640px / 768px / 960px(对齐 VitePress 默认 640/960)
43+ - 响应式断点:420px / 640px / 768px / 960px
5144- 所有自定义组件类名前缀 ` .cysj- ` ,子元素用 ` __ ` ,状态用 ` .is-* `
45+ - 静态内容不用阴影,使用边框和留白区分层级
46+ - 导航栏高度 56px,侧边栏宽度 240px
0 commit comments