项目总览
本 wiki 讨论每个项目的大体设计流程:为什么存在、职责边界、何时用哪个、权限模型。
具体项目的内部设计、数据结构与实现决策不在本 wiki,在各项目自己仓库的 document/ 目录。
本页是全表。日常只需要记住几个直接面向用户的入口:
- Config CLI —— 改设置、查网络与 SSH、镜像源、守护的启用入口
- Components —— 装软件与一切需要 root 的事务
- Welcome —— 首次启动与状态入口
- 更新助手 —— 检查与应用系统更新、托盘提醒、快照一体化的更新侧
- 恢复诊断 —— 系统出问题时先取只读证据
- 崩溃监视 —— 捕获崩溃现场、写文本证据,用户选动作后才唤起 agent
- 工作区守护 —— 跨项目机制,防 agent 误删工作区
用户软件索引
| 分组 | 页面 |
|---|---|
| 系统入口 | Config CLI、Components、Welcome、更新助手、恢复诊断、崩溃监视、工作区守护 |
| 软件管理 | Package Center、Component Manager、Completion Agent、Gaming Manager |
| 硬件与内核 | HWD Detector、Hardware Driver Manager、Kernel Manager |
| 数据与签名 | Catalog、Keyring |
| 平台与 Agent | WSL 发行版、Agent 工作区、Agent 技能 |
| 外部产品 | Zeta、Bio SDK(文档以各自仓库为准,本 wiki 只保留入口页) |
构建/发布仓库(packages、linxira-packages、linxira-iso-direct)与品牌资产不是终端用户软件,不单列使用页;品牌资产见 品牌系统。Zeta 与 Bio SDK 属外部产品,本 wiki 只保留入口页并指向其仓库与 GitHub Wiki 里的权威文档,不在此复制它们的安装与用法。
全表
下表的 owns 与 lifecycle 来自 linxira-os/governance/repositories.yaml,
本包内的 ai/manifest.json 由该文件生成,不手工维护。
| 仓库 | owns | lifecycle |
|---|---|---|
linxira-os |
product-architecture、repository-governance、support-matrix、release-manifests | active |
linxira-iso-direct |
live-profile、installer-configuration、target-manifests、iso-build | active |
packages |
pkgbuilds、package-ci、signed-repository-publication | active |
linxira-packages |
package-repository-hosting、repository-metadata | active |
linxira-keys |
signing-keys、keyring-distribution | active |
linxira-catalog |
catalog-schema、applications、capabilities、presets、desktop-metadata | active |
linxira-components |
transaction-planning、confirmation、privileged-apply、receipts | active |
linxira-package-center |
package-center-ui、installed-state-presentation | active |
linxira-component-manager |
component-manager-ui、capability-state-presentation | active |
linxira-gaming-manager |
gaming-library、compatibility-launch、user-backup | active |
linxira-update |
system-update、update-status、update-tray | active |
linxira-completion-agent |
first-online-plan-presentation、completion-state、transaction-delegation | active |
linxira-hwd-detector |
read-only-hardware-detection、hardware-fact-contract | active |
linxira-hardware-driver-manager |
driver-policy-ui、kernel-dkms-report、driver-plan | active |
linxira-kernel-manager |
kernel-policy-ui、boot-state-report、kernel-plan | active |
linxira-recovery-diagnostics |
recovery-readiness、repair-plan、private-support-bundle | active |
linxira-crash-watch |
crash-diagnosis、crash-window、debug-workspace | active |
linxira-welcome |
welcome-status、lifecycle-guidance、fixed-tool-routing | active |
linxira-config-hub |
linxira-cli、diagnostics、runtime-adapters、source-adapters、ssh-network-plans | active |
linxira-artwork |
brand-assets、terminal-artwork、visual-policy | active |
linxira-hooks |
pacman-hooks、reboot-state | review-required |
linxira-wiki |
user-documentation | active |
Linxira-OS.github.io |
public-website、publication-endpoint | active |
linxira-wsl |
wsl-distribution-image、wsl-rootfs-build | active |
linxira-hello |
— | deprecated |
linxira-iso |
— | deprecated |
extendai-lab-cli |
extendai-cli | independent |
extendai-lab-Studio |
extendai-studio | independent |
linxira-pulse |
ai-assistant | independent |
linxira-skills |
skill-platform | independent |
linxira-fish-config |
fish-shell-configuration | paused |
linxira-zsh-config |
zsh-shell-configuration | paused |
linxira-gnome-settings |
gnome-desktop-defaults | paused |
linxira-kde-settings |
kde-plasma-defaults | paused |
linxira-hypr-noctalia |
hyprland-desktop-defaults | paused |
linxira-niri-noctalia |
niri-desktop-defaults | paused |
linxira-mangowc-dms |
mangowc-desktop-defaults | paused |
linxira-settings |
system-settings-defaults | paused |
linxira-wallpapers |
wallpaper-assets | paused |
怎么读 lifecycle
- active —— 在维护,功能承诺有效。
- review-required —— 归属待复核。
linxira-hooks是当前唯一一个。 - independent —— 自有节奏,不随系统发布走。
- paused —— 归档暂停:仓库在 GitHub 上只读,仅为防误触;取消归档即可继续改,随时能重新激活。
- deprecated —— 已被取代,不要在新工作里使用。
怎么读这张表
一个能力只有一个拥有者。看到两个仓库都「管」同一件事时,以 owns 为准:
linxira-config-hub 拥有诊断与设置入口,linxira-components 拥有事务与提权执行。
UI 项目(linxira-package-center、linxira-component-manager)不重新实现提权逻辑。
何时需要 root
本页的表本身不需要任何授权。linxira-wiki 全部子命令都是只读免 root 的:
linxira-wiki show ownership
linxira-wiki manifest
深入设计
各项目的内部设计见其仓库的 document/ 目录。归属数据的源头是
linxira-os/governance/repositories.yaml。