文档
设计文档写的是各子系统的设计依据 —— 实现要跟它对齐,不是反过来。 正文由同步脚本从源码仓库整树拉过来,官网不做二次编辑; 改文档请改源码仓库,然后重跑一次同步。
呈现时有两处展示层的剥离,都不动源码仓库里的文件:文档开头的一级标题 (页面头部已用同样文字做标题,否则同屏会出现两个),以及结尾的版权行 (整站版权声明在页脚只有一处)。除此之外正文逐字一致。
全系统
总纲定边界,子系统细设以它为界。
桌面
Soke Desktop Environment 的唯一设计依据。
桌面设计规范
桌面规范文档集的入口,说明各份文档的分工与相互关系。
v1.0
desktop/README.md
桌面架构设计
输入、窗口管理、合成三大职责分属三个进程,禁止合并。各守护进程的边界与 surface 协议在这里定。
v1.0
desktop/architecture.md
交互与动效设计
全部动效时长、曲线与弹簧参数的最终规格。wmshell 与 compositord 两端数值必须一致,以这份为准。
v1.0
desktop/interaction.md
视觉语言设计
尺寸、色彩、排版、图标、层级与主题自适应的单一事实来源。本站的配色与圆角就取自这份文档的色彩 token 与几何 token。
v1.0
desktop/visual-language.md
液态玻璃材质设计
逐项复刻 shuding/liquid-glass 的折射原理并搬进 Vulkan 片元着色器 —— SDF 圆角法线场、三通道色差、镜面高光、双 Pass 模糊。Aero 是模糊加半透明,与液态玻璃是两种东西。
v1.0
desktop/liquid-glass.md
壁纸管理器设计
壁纸解码、多显示器布局、轮换,以及为主题自适应提供采样数据的完整管线。
v1.0
desktop/wallpaper.md
法律
授权条款。Soke 是专有软件,这两份是使用与分发的完整依据。