跳转至

项目总览

本 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。