DOCUMENTATION

从目标到实现,沿同一条事实链阅读

官网负责导航,仓库文档负责可审查的技术事实。选择你的任务,不必先读完整个项目。

文档与代码冲突时,以当前源码和可执行验证为准,并修正文档。

START HERE

了解产品边界

先从项目 README、宪法、成立决策和路线图建立共同语境。它们区分了当前候选能力与长期架构。

项目 README

定位、状态、仓库地图与首个可验证目标。

项目宪法

模型中立、多用户、可回滚和生态兼容原则。

路线图

查看正在实现、等待设计和刻意推迟的范围。

打开文档索引

BUILD & OPERATE

构建、安装与恢复

发行版文档记录 Debian 快照、运行时装配、Live ISO、安装器和恢复入口。所有整盘安装测试都必须使用可丢弃磁盘。

Live image

构建、清理、产物与可复现性说明。

Runtime

固定 Harness、Cordis、TUI 与 Profile。

Recovery

从独立目标禁用 Profile 或执行回滚。

进入发行版文档

CONTRIBUTE

按纵向切片交付

贡献应描述验收路径、失败行为、恢复边界、兼容影响和可复现输入。不要在基础能力尚未闭环时堆叠插件市场或图形桌面。

阅读贡献指南