ci: add Linux core qualification - #63
Merged
Lucas1479 merged 1 commit intoSep 9, 2026
Merged
Conversation
Lucas1479
approved these changes
Sep 9, 2026
Lucas1479
left a comment
Member
There was a problem hiding this comment.
感谢补上 Linux Core CI！改动范围清晰，Ubuntu 和现有平台检查均已通过，同意作为第一阶段 Linux 回归基线合并。
This was referenced Sep 9, 2026
Lucas1479
added a commit
that referenced
this pull request
Sep 9, 2026
## What and why Following #63, the Chinese and English READMEs lack a Linux entry point. Add matching experimental Linux sections with L1 installation, text-only configuration, environment verification, and Electron/headless launch commands. Distinguish Ubuntu CI coverage from community device reports and document the remaining AEC, PyTorch profile, and desktop/wallpaper limitations. Related to #64; this documents the existing experiment without expanding the supported platform baseline. ## Change class - [x] Routine fix, documentation, test, maintenance, or presentation-only UI - [ ] Product-semantic or public-contract change discussed in the linked Issue - [ ] Isolated, default-off experiment Owning layer: Chinese and English README setup and release-boundary documentation. User-visible effect: Linux readers can find an explicitly experimental L1 setup path and its validation limits. Compatibility or migration impact: none. ## Evidence - `git diff --check` passed before commit. - Reviewed both language versions for equivalent commands and scope. - Checked commands and settings against `.github/workflows/python-linux.yml`, `electron/package.json`, the Electron Python discovery code, `.env.example`, and `pyproject.toml`. - Documentation only; no new Linux GUI or hardware tests were run. Existing Ubuntu CI evidence is linked through #63. - [x] Documentation/examples are updated for changed settings or contracts ## Final check - [x] This PR addresses one coherent problem without unrelated cleanup - [x] It does not add a speculative API, fallback, or compatibility path - [x] No secrets, local state, model weights, voice material, or restricted assets are included - [x] Third-party notices and provenance are preserved
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述
Related to #64
为 Linux 增加第一阶段 Core CI qualification。
目前经过 Arch Linux + Wayland 实机验证，Amadeus 的 L1 Core / Backend、Electron build 和 Electron desktop 已经可以正常运行。
这个 PR 不引入新的 Linux runtime implementation，而是为当前已经能够工作的跨平台路径建立一个最小的 Linux regression baseline，避免后续修改在没有发现的情况下破坏 Linux 基础兼容性。
改动内容
新增：
使用 GitHub-hosted：
环境版本与项目现有 CI 保持一致：
当前 workflow 验证：
uv sync --locked --extra devcienvironment verifiernpm cinpm run buildScope
这个 PR 有意保持较小范围。
当前不包含：
local-cu124其中 Voice / AEC 和 Linux NVIDIA dependency profile 会作为后续独立问题处理。
本 PR 也不会修改当前 Windows / macOS runtime 行为或现有平台支持范围。
验证
提交前已在 Arch Linux 实机环境完成对应检查：
--profile ci)：通过npm ci：通过npm run build：通过GitHub-hosted Ubuntu qualification 将由本 PR 的
pull_requestworkflow 进行验证。目的
这一步主要是把：
进一步固化为：
后续再基于 tracking Issue 中的计划逐步补充其他 Linux qualification。