Latest release v0.1.0. This page is rendered from the repository's
CHANGELOG.md; version, ISO size, line counts and test counts are injected from the code itself,
so they cannot go stale.
# 2026-10-15:发布 v0.1.1(首次真正上传资产 + 首次真正部署生产站)
| 步骤 | 结果 |
| 上传资产 | aetheros-0.1-amd64.iso · 42,991,616 字节(41.0 MB) · tag v0.1.1(prerelease,同 v0.1.0) |
| 校验 | GitHub 自己算的 asset digest = sha256:eea68da9…;把资产下载回来重算,与本地构建逐字节一致 ✓ |
| 同步发布事实 | site/release.json(tag/字节/体积/哈希/日期)· README 中英各 2 处体积 · try-aether.sh/.ps1 的内置哈希与注释 · docs/index.html(GitHub Pages)· CHANGELOG 新增 v0.1.1 段 |
| 站点门禁 | 抓出 try-aether.* 里还是旧哈希(用户校验会失败)→ 已换;又抓出两处注释里的旧字节数 → 已同步 |
https://aether.cbnac.com/ 从 v0.1.0 的事实更新到 v0.1.1 · 41.0 MB · eea68da9…,
5 项安全响应头全部实际下发 ✓,既有业务(cbnac.com / school / api / dili / teach …)状态码全未变 ✓。
重载方式是给 master 发 HUP(优雅、零停机),并用"worker 进程是否换代"证明真的重载了。
scripts/deploy-site.py)① 校验与 dump 用错了二进制。 这台机器上 PATH 里的 nginx 是 1.24.0(没编 stream 模块),
而正在跑的是 /www/server/nginx/sbin/nginx -c /www/server/nginx/conf/nginx.conf(宝塔构建,有 stream)。
拿 PATH 里那个去测宝塔配置 → unknown directive "stream" —— 一个根本不存在的故障。
→ 改成从 master 进程命令行里取 (二进制, 配置),校验与 dump 都用它们。
② vhost 写进了不会被加载的目录。 宝塔的 nginx.conf 只 include /www/server/panel/vhost/nginx/*.conf,
不读 /etc/nginx/conf.d/;而 nginx -t/-T 默认测的又是 /etc/nginx/nginx.conf(它 include conf.d)。
两者不是同一个文件 → 老逻辑形成两层假绿:nginx -t 说 OK、站点照开、脚本打印"部署成功",
而写进去的配置永远不会生效。
→ 改成问运行中的 nginx:<它的二进制> -T -c <它的配置>,从输出里的
# configuration file <路径>: 注释头认出真正生效的那个 vhost 文件。
③ reload 只有两种方式,这机器两种都不成立。 nginx 不在 systemd 下(systemctl is-active = inactive),
/run/nginx.pid 是 0 字节(2026-10-03 留下的)→ systemctl reload 与 nginx -s reload 双双失败
(invalid PID number "" in "/run/nginx.pid")。
→ 加第三条路:直接给 master 发 HUP,并用 worker 换代作为"真的生效"的判据;
三种都不成立时显式拒绝(生产机上盲重启会与既有实例抢端口)。
另外加了一条保护:生效的 vhost 若已带 TLS 段(certbot 管理),脚本绝不覆盖它
(那里面有 certbot 插的 listen 443 与证书路径,覆盖=把 HTTPS 弄没),
改为校验它与本站一致(root、安全头片段),不一致就报错让人工处理 —— 脚本不猜。
判据:scripts/deploy-site.py --selftest(9 项:生效 vhost 识别 + 运行中进程识别,不需要服务器与凭据)
已进 gates.py(34 → 35 项)。
1. 真机验收(#32):45 项要走物理机(U 盘 dd、装盘、断电、ALSA、真实键鼠)。
2. M-13 端到端多行粘贴:前置已在 guest 实测(bash 5.2.21 + pty.rs 优先 bash ⇒ 括号粘贴生效),
但真在 GUI 里粘一次还没做(需要终端窗口 + 宿主剪贴板共享)。
3. 生产机上那个 /etc/nginx/conf.d/aether.cbnac.com.conf 现在是历史遗留的死文件
(脚本已不再依赖它;本次部署仍会写它以保证脚本自身完整)。要不要删掉由你定 —— 删了不影响线上。
# 2026-10-14:装机验证 + 依赖 CVE 收口 + 审计文档纠偏
此前 ISO 重建好了、isohybrid 也验证了,但没有人真的装过一次机。今天做了:
| 步 | 判据 | 实测 |
| ① 起 ISO | 系统起来、五服务 ✓ | 巡检#1 … 服务=aetherd=✓ compositor=✓ getty=✓ network=✓ ops=✓ |
| ② 安装器 | 目标盘出现分区、持久化分区建好 | sda: sda1 sda2 + EXT4-fs (sda2): mounted … / unmounting … |
| ③ 从盘引导 | 拔掉光驱也能独立引导 | [aether-init] 持久化分区已挂载: /dev/sda2 -> /var(nodev,nosuid,errors=remount-ro) |
| ④ 持久化 | 重启后 /var 的写入仍在 | 探针 probe-1014 重启后仍在盘上;/var/boot.log 记录 第 1 次 → 第 2 次 递增 |
证据:装机验证(INSTALL-VERIFY)-2026-10-14.md
在哪做的、以及为什么不是构建机(如实记):
* 构建机内的 QEMU 是三层嵌套(Hyper-V → VirtualBox → QEMU)。QEMU 一起来,
guest 的 sshd 就饿到无法完成认证(paramiko 与 OpenSSH 都报
Connection timed out during banner exchange);把构建机 2 vCPU 加到 4 vCPU 也没救。
* 于是改在宿主上的 VirtualBox(headless)做:按键注入可用、串口落盘(全部观测都是文本)、
启动只要 10 秒。复现命令写进了证据文件。
* 顺带得到一条自动化经验:注入的按键会被合成器(evdev 直读)与 tty1 的 getty 同时看到 ——
安装命令既进了 AI 指令条、也进了 root shell。所以"AI 栏有没有收到"不能当按键送达的判据。
没覆盖的(别当全绿):真机(#32)仍要物理机;安装器的交互式路径与 --wipe 破坏性路径本次没走。
"离线环境无法核对"这句只对构建机成立:这台开发机 crates.io 可达、RustSec advisory-db 能拉。
| 项 | 结果 |
| 扫描规模 | 1310 条公告 · 154 个依赖 |
| 漏洞 | rustls 0.23.43 · RUSTSEC-2026-0285(TLS 1.3 握手跨加密层级,medium 5.3) |
| 处置 | cargo update -p rustls → 0.23.46 + cargo fetch --locked(否则 --offline 构建会报"要发 HTTP 请求") |
| 复验 | cargo audit → 0 vulnerabilities;cargo build/test --offline --locked → 768 项全绿 |
| 残留 | 2 条 unmaintained 警告(instant、ttf-parser)已评估并接受;故意不写进 ignore 名单,让每次审计都能重新看到 |
两条踩过的坑:① cargo install cargo-audit 在本机必然失败(没有 MSVC Build Tools、
mingw 又缺 libgcc_eh,仓库靠 rust-lld 才能编译自己)→ 改用官方预编译包;
② 本机代理对 GitHub 是抖动的(同一条下载出现过 schannel: handshake failed、
也出现过"HTTP 200 但只下了 587 KB")→ 下载后必须比大小,别信状态码。
证据:依赖CVE(CVE-AUDIT)-2026-10-14.md + 原始 JSON。
审计报告里有两张状态表:前面那张"汇总表"停在轮次 B,后面那张"按轮次表"是最新的。
H-5 与 M-4…M-9 在汇总表里还写着 ❌ 未修,而代码与轮次表都已是 ✅(M-6/M-7 我逐行核对了代码:
aether-ops/src/monitor.rs:245-269 已按字节读 + 有损解码;aether-install/src/main.rs:129/:153
已有 canonicalize_disk + same_device 含回归测试)。
处置:逐条对齐汇总表、加一条"本表是快照,权威状态以轮次表为准"的警示、并更新 H-6
(产物已重建并验证、尚未上传)。这正是本项目反复吃过的亏 —— 同一事实两处记录、一处过期。
* a75dd9c 批次 HI-1:通知正文双语全量收口 + ISO 构建链 4 处缺陷 + 3 条新门禁(38 文件 / +3249 −394)
* 1c223e3 批次 HI-2:站点发布事实与门禁证据对齐(generated 跟随最近提交日期 + gate-count 记全量 33)
* 顺带发现:本地比 origin/main 领先 233 个提交 —— 远端最后一次是 2026-10-02,
也就是说两周的提交一个都没推上去("GitHub 记录不对"的真正原因)。
* 推送踩坑:本机 git 走代理 127.0.0.1:7897,第一次握手被中断
(schannel: server closed abruptly),直连又是不通的 —— 原样重试一次就成功。
* scripts/vm-install-verify.sh(新):构建机内一键跑完装机验证四步并输出
install-verify.log(含 RESULT=PASS/FAIL 与逐条判据)。本次没用上它(构建机不可用),
但它是"构建机可用时"的正规路径,判据阈值与手册 §4 一一对应。
* scripts/mkfont.py(改):加产等宽字体 NotoSansMonoCJKsc-Regular.otf
(台账 #46)。原先只产正文两个字重,而 text.rs:99 的等宽候选表里那三个名字
一个都不存在 → 终端一直回退成非等宽。字符集故意只要 ASCII + 制表符:
text.rs:358 是 mono && has_glyph(ch),缺字形会逐字回退到正文字体,
所以塞汉字纯属浪费 ISO 体积;缺源字体只警告、不阻塞构建。
新增 --selftest(命名契约 + 字符集逻辑,不需要 fontTools/源字体)并进门禁。
* 判据 33 → 34 项全绿;测试 768 项;规模 51,138 行 / 71 文件。
text.rs:99 的等宽候选表第一项 NotoSansMonoCJKsc-Regular.otf,构建期从来没产出过 →
终端一直悄悄回退成非等宽。这次四层做完:
1. scripts/mkfont.py 加产等宽字体,字符集只要 ASCII + 制表符(136 字 / 47 KB)——
因为 text.rs:358 是 mono && has_glyph(ch),缺字形会逐字回退,塞汉字是浪费 ISO 体积;
源字体缺失只警告不阻塞构建;新增 --selftest(9 项,不需要 fontTools)并进门禁(34 项)。
2. 构建机上真跑:[mkfont] 完成:正文 2 个字重合计 5.69 MB + 等宽 47 KB。
3. 重构建 ISO:RESULT=PASS · 42,991,616 字节 · sha256=eea68da9… · 55aa(isohybrid 仍在)。
4. guest 串口实测:字体已加载 …/NotoSansMonoCJKsc-Regular.otf ✓ 且"无可用字体"彻底消失 ✓。
过程中踩到一个真陷阱(已写进手册):改了 Cargo.lock 之后构建机的离线缓存不够用 ——
CVE 修复把 rustls 提到 0.23.46,而构建机只有 0.23.43、host-only 又没外网 →
Could not resolve host: index.crates.io。修法:从宿主 SFTP crate + 索引缓存(只传 crate 不够)。
反面教训:我原想用"在 ISO 字节里 grep 字体名"来验证,得到 0 次;但拿已知在镜像里的
NotoSansSC-Regular.otf 做对照也是 0 次 —— rootfs 是压缩的,这条判据本身不成立。
没有对照组的"通过/不通过"都是噪声。
1. 发布:最新 ISO(41.0 MB · sha256=eea68da9…)未上传 Release,site/release.json
仍指旧资产(38.5 MB / 2026-09-29)。顺序见《镜像重建手册》§5(先上传、再算资产哈希、再改 release.json)。
2. 真机验收(#32):45 项要走物理机(U 盘 dd、装盘、断电、ALSA、真实键鼠)。
3. M-13 端到端多行粘贴:前置已在 guest 实测(/bin/bash 5.2.21 + pty.rs:29 优先 bash ⇒ 括号粘贴生效),
但真在 GUI 里粘一次还没做(需要终端窗口 + 宿主剪贴板共享)。
# 2026-10-03 ~ 2026-10-11 更新(补记)
>
| 能力 | 之前 | 现在 |
| 关机 / 重启 / 注销 | 界面里关不了机,只能按电源键 | 控制中心与设置各三个入口;不可逆动作要打一遍动作名才执行 |
| 声音 | 完全没有音频栈 | 提示音(三种主题可试听)+ 控制中心真实音量滑块;没有声卡时如实写"无音频设备",不画假滑块 |
| 登录 / 锁屏 | 开机直接进桌面 | Super+L 锁屏 + 口令解锁(自研 SHA-512 crypt)+ 失败限流;设置里能改口令 |
| 设置真的能改 | 设置页基本只读 | 壁纸、恢复默认、DNS 可改;整体缩放 100% / 125% / 150% 可切 |
| 通知中心 | 只有 toast,错过就没了 | 有界历史(50 条)+ 未读计数 + 连续重复合并;设置里可关记录 / 清空 |
| 对时与时区 | 时钟只是本地偏移 | SNTP 对时;时区写入 /etc/localtime 与 /etc/timezone |
| 系统更新 | 装好之后无法升级 | 文件级离线更新包:哈希校验 + 白名单 + 拒降级 + 暂存,由 PID 1 在启动服务前应用 |
| 权限策略 | 权限模型很强,但用户改不了 | 设置里逐工具四态(每次询问 / 允许 / 禁止),真的接进闸门判定并留审计 |
| 桌面交互 | — | Aero Snap、虚拟桌面(默认 4,可增删到 8)、Ctrl+K 真搜索命令面板、Ctrl+Z 撤销 AI 动作、配置快照回滚、应用商店装/卸、首启四步向导、快捷键总览、性能 HUD |
还有几条"看不见但你会依赖"的:自动 e2e 运行器(--e2e,无界面也能跑)、
性能门禁(P50/P99/最差 + 阈值退出码)、一键诊断包(aether-ops --bundle)、
蓝牙/打印/可移动设备的只读如实报告。
功能(59 次提交)
92cd621、2f97936、763b270b8830c5;声音界面(真实滑块 + 无设备如实显示)4bc1482c180623a247f46;§5.10 性能 HUD 4009720;§5.7 一键诊断包 96149d86d6de26 · 67a1112 · 25f2c1c · b8f8374fbbb8e4;§5.2 审计导出 287e8b9;§4.1 自动 e2e ec0abc3F-1、共享校验器 G-1、界面接线 H-1)939d032 → 认证策略层 290d416 → Super+L 锁屏 + 吞键守卫 f94aef492637c4;§3.5 语言可切换 796dad6dd9b259;§5.5 命令面板 87b64d7 · 80465ca5c942b3 · 520094c · 157c7aa + 界面 9396ab4853c986;§5.8 首启向导 60c0c16;§5.11 应用商店 666d6e2c673224 · 09879d4PageCtx bf24cda;卸载入口 + 修一个"测试与生产语义不一致"的坑 26708f3e5e12d7;§4.2 性能门禁(含纠正一个不该照抄的阈值)e60e219;§4.3 硬件清单 70917ff安全审计 S-1 ~ S-7(对着审计报告逐条处置,每条都要"回滚即变红"的测试)
| 处置 | 提交 |
fsck 的 fail-open 收窄为"只有工具确实缺失" | 230f01d |
| aetherd 侧补对端身份校验,判据统一到一处 | d5ae35e |
| 给 H-6 的时机加一条回滚即变红的测试 | d1f97dd |
| 分区身份绑定到所在磁盘的 MBR 随机签名 | 0ac2ab3 |
| 给 H-4 的符号链接防护加"回滚即变红"的测试 | 3d91e3d |
| 粘贴回退路径与括号粘贴逃逸的不变量测试 | 7ffc360 |
顺带:docs/ 全部文件改成「中文名(英文名)-日期」、图片移出 docs/ → assets/(f673b48…99d6428)。
这一天最该被记住的是三个"等于没有防护"的高危:
| 问题 | 为什么严重 | 提交 |
| 锁屏拦不住键盘输入 | 守卫顺序错了 —— 锁屏之后照样能把字打进 AI 指令条 | df47549 |
passwd -l 后回车即解锁 | 被锁定的账户反而更容易进 —— 锁屏的最坏形态 | 14f77de |
| 一次伪造 NTP 回复就能改系统时钟 | 时间被任意操纵,会连带影响审计时间线 | 1676414 |
还有:回收站"删了但谁都能看" f3d21e7;我自己的新代码里的权限降级(自审抓到)e9bfa61。
更新机制三批:aetherd 侧核心(哈希校验 + 白名单 + 拒降级 + 暂存)5ca7e7e →
PID 1 在启动服务前应用 ea1811f → 设置页「系统更新」e03d215。
外设与显示:可移动设备只读挂载 102be8a + 界面入口 481365e;
多显示器如实报告(不假装支持)9a928d4;蓝牙/打印只读检测 28e2dc5。
i18n 大批(约 30 批,AX-1 ~ BU-1):审计页 → 设置页网络 → 五个页面 → 窗口类界面
→ 通知正文 → 音频状态 → aetherd 拒绝/协议层 → 工具权限/关于/快捷键 → 16 个设置页全双语
→ llm 通道错误 → modelcfg 中性化 + 全库终扫。
一个关键定案:审计日志的 level/verdict 存结构化 token,显示层取词,
兼容旧日志(a94eb91)。
整体缩放(§2.4 的地基,四批):布局尺寸表 239 处接入 bde0386 →
间距阶梯 + 不变量测试(累计 286 处)9062210 → 控件高度与内边距(累计 323 处)ef6424b
→ 逐像素验证。关键前提:先让 --shot 可复现 —— 修掉"渲染不是输入的纯函数"这个真 bug 1d35421。
e2e 三批:注入脚本格式 6e626f2 → 键盘注入接进既有脚本 d9ac56d →
坐标点击跑通(用真实二进制调试)112bad9。
账户:后端列出账户 + 改口令 3ed55b6 → 口令策略移到 aether-ipc(两侧共用一份)75f9694
→ 界面(列表 + 遮显口令框)609fe38。
整体审计三遍(附录 T / U / V):访问控制 26/26 合规、注入面干净、一处低危;
数据流与边界条件未发现新问题;第 3 遍做了复现式取证并新增一条永久不变量。
另有一次性能门禁飘红的同条件 A/B 对照,证明是宿主负载不是回归 a485d90。
收尾报告第 2 / 3 / 4 版:7b2618b · 672398d · 8b65ca9,
以及一次文案核对 —— 报告里 5 处数字失实/自相矛盾,并清掉 3 个改名前的旧副本 0ef4324。
主题是逐个界面看 150% 到底什么样,然后按发现修:
41de708;终端字距的根因与一次可证明失败的尝试 abe9f4ca080f57;给音乐列表加命中区向量 34db4da30e4be1 → 滚轮滚动 1de62a6 → 滚动后的裁剪缺口(两次可证明无效,第三次才对)fd6e4ed3b4fbb3d7fc7d6edd67be0168efc6e88ce5e138f730c7bae9两处诚实的记录:41de708 注明"一处我自己搞错的判断";fd6e4ed 留着两次失败的原因。
69a5e4d,逐项修完(窗口标题/Dock/侧栏/终端/音乐)4f3918028bedae87e4097 —— 实现过、评估过、不采用,理由留档cbf880a;修完剩余超宽 0f349f3 · 76c7d37525c70b85ccaae44c34a6b182cd4;第一次实战就抓到 4 处源码扫描看不见的漏译 0c8f2f6177a257;加英文设置页(29 → 48 档)607901c274da17;英文也补到中英各三档 ec4259eif 里)cbfeff46721f2a41548fa18fab7c;并给它做正向对照(注入一处中文,它判红)d31daf4c05e61e;还清 41 处欠账(41 → 0)2d9ef7bf756bde;重测扫描范围(结论不变,理由更精确)00b9e635646cc7; 12 处是同一个根因,一处修好全部 d879446;覆盖所有窗口(108 → 0)0e2bde9
2fb3c13fe41f898127619e06182a;收尾报告被"自我延续的孤立行"污染 → 给数字判据加「恰好一处」4db9b17
55416a047f1fad 第 1 遍加固了确认令牌的随机源 194258a,第 2、3 遍未发现新问题 970c539 · 3e681db
f857b7c26138f3d93fbbac3e83d8fbf0bab;修好"默默不生效的同步" e6f43b163783006977b6524ac102c9ebe018e885bfaether-ops 日志告警无节流 6054b59/var/diag 加目录上限(200 个文件,超了按最旧删);把「Windows 0 告警」也纳入门禁 fd0a0b9 提取要按形态触发,而且要先算会碰到什么(/var/diag 三处轮转逻辑据此决定不提取)9eeea5c
| 项 | 结果 |
| 测试 | 768 项全绿(0 失败) |
| 门禁 | 30 项全过 |
| Windows 构建 | 0 告警 |
| musl 目标 | 6/7 crate 能编译 + 0 告警(aetherd 因 ring 需 musl-gcc,不在检查范围) |
| 判据 | ① ② ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ ⑪ 全部有正向对照,且全部 = 0 |
| 像素回归 | 57 档 --shot 逐字节一致 |
| 归档走查图 | 20 张逐像素一致 |
| 审计附录 | 153 篇 |
| ISO | 约 38.5 MB |
必须说清楚的三条口径:
1. 实机验证一项都没做 —— 本机是 Windows,无 PID 1、无 ALSA、无显示/输入设备。
所有"能跑"的结论都建立在"编译 + 单测 + 无界面运行器 + 像素回归"上,
不等于真机上能用。清单见台账 §9 的 #32、#33。
2. ISO 未重构建:isohybrid 与 MBR 自检代码已补,但没有重新构建并装机验证过
—— 所以 v0.1.0 那版"不能 dd 到磁盘引导"的更正仍然有效,不能因为代码补了就当作已修好。
> 已处理:本条在 §十二 落地 —— 2026-10-11 真的重建了镜像并独立验证
> offset 510 = 55aa(isohybrid 生效)+ VMware 启动进桌面。装机验证与发布仍未做,
> 所以"v0.1.0 那版不能 dd"这句对已发布的旧资产依然成立(新产物尚未上传)。
3. 依赖的已知 CVE 无法核对(离线环境)。
> 2026-10-14 已做:这句只对构建机成立 —— 这台开发机(Windows 宿主)
> crates.io:443 可达(已实测),所以台账 #49 的核对是可以做的,不该记成"环境阻塞"。
> 实跑结果:1 条真漏洞(rustls 0.23.43 · RUSTSEC-2026-0285 · medium)→ 升级到
> 0.23.46 修掉,复验 0 漏洞;另 2 条 unmaintained 警告已评估接受。
> 见 依赖CVE(CVE-AUDIT)-2026-10-14.md。
待办里最该先处理的一条(2026-10-11 新发现,登记在台账 §9.3):
aether-compositor/src/widgets.rs:22 的 #![allow(dead_code)] 挂着一条已经到期的承诺
("P3 完成后必须删掉这一行"),而 P3 已经完成。
实测删掉它会产生 10 条告警:其中 WHEEL_LINES、scroll_apply 是 Linux 专属调用点
(Windows 上误报),另外 slider/slider_value_at/badge/scrollbar/HitTable/States::Danger
在生产代码里确实没有调用点(只被自己的测试引用)。
所以"删掉 allow"这个动作现在还不能执行,需要先决定这 5 个原语是接调用点、删除、还是保留待用;
同时把注释从空头承诺改成当前仍成立的理由。
基线(批次开始前实测):HEAD=c6874ad · 761 项测试 · 25 项门禁 ·
像素基线 sha256=801b0e2d…(57 档)· 归档图 20 张。
| 处置 | 内容 |
| 一处台账失真 | #42「Alt+Tab 跳过/恢复最小化窗口」原登记为 📋 待办(说"现在会切到不可见的窗口")——代码早就修了:apply_nav 在切到最小化窗口时恢复它,单测 window_mgmt_tests::tab_restores_minimized_target 通过(064892d)。已改为 ✅ |
| 4 处过期数字 | README:36/:53 的「750 项单测」、INDEX:4 的「45 个 .rs」、收尾报告:20/:139 的 50,528 与 750 —— 全部对齐权威来源(51,111 行 / 71 文件 / 768 项) |
| 判据覆盖扩写 | doc-numbers-check.py 新增 ③f:同一事实的其余写法(「除 N 项单测外」「Windows N 项」「N 个 .rs」、收尾报告的代码行数与测试数注释)。原先这些写法完全在判据之外 |
--fast 假红 | gates.py --fast 一直退出码 1:子集步数(14)与文档声明的全量步数(25)天然不等。现在 gate-count.txt 带模式行,判据据此 [SKIP] 子集模式 ——验收:--fast 退出码 0,全量语义不变 |
| 新的台账门禁 | scripts/ledger-count-check.py:§9.1 表头那句「由脚本按上表实际统计」此前没有那个脚本(复核时确认),现在补上并进 gates.py;改错任一类别数即判红 |
| 判据自检 | i18n-check.py --selftest(13 例,含 5 条正向对照)、ledger-count-check.py --selftest(6 例,含 5 条)、toast-i18n-audit.py --selftest(16 例,逐条比对分类) |
做法:把通知正文从"各发送方写好的 String"改成结构化双语类型 ToastMsg
(i18n.rs),于是 "忘了英文"在编译期不成立:
| 步 | 内容 |
| 类型 | ToastMsg { zh, en } + new / new_1 / from_external;text() 按当前语言取词 |
| 落点 | push_toast(msg: ToastMsg);通知历史存两种语言(Notice.msg),切语言后历史跟着重渲染 |
| 合并语义 | 合并判定改成两种语言都比 —— 只比中文会让"中文一样、英文不同"的两条并成一条,英文界面少一条而中文界面看起来正常(新增单测钉住) |
| 净化 | 两种语言各自压成一行、去控制字符(只净化中文会让英文侧撑坏布局,新增单测) |
| 调用点 | 117 个生产调用点全部改造:直接双语 51 · 外部来源 29(from_external:文案由 aetherd 按其连接语言渲染,不得再翻一层) · 裸标识符 37(类型即保证) |
| 修掉的真漏译 | 改造前有 5 处只有中文(音量、默认 DNS、向导状态保存失败等)—— 英文界面会冒中文 |
| 门禁 | i18n-check.py 的英文位判据扩到 toast_msg* / ToastMsg::new(扫描 274 → 379 处);toast-i18n-audit.py --check 作为覆盖复检(裸标识符算通过,不把类型正确的东西报成缺陷) |
| 端到端 | --e2e 新增 lang 动作与 query: toast;两个相反命题的场景真跑:英文下不含中文且非空 / 中文下有中文(防"空串蒙过去")。e2e 场景 5 → 7 个全过 |
零渲染回归:像素回归 57/57 逐字节一致、归档走查图 20/20 一致 ——
因为中文文案逐字未动,英文文案不出现在任何走查档位里。
widgets.rs 的到期承诺(#45,路 A)保留 #,
但把「P3 完成后必须删掉这一行」改写成当前仍成立的事实与触发条件:
模块已被大量使用(draw.rs 122 处)、slider/slider_value_at/badge/scrollbar
暂无生产调用点、WHEEL_LINES/scroll_apply 是平台误报别乱删、
HitTable 与 settings.rs 各有一份判定(下次改命中判定时合并)。
main.rs 的同一句承诺一并改写(同一事实不留两种说法)。
| 手册 | 消哪笔账 |
实机验收手册(RUNBOOK) | #32:附录 B 约 30 项 → 逐项"怎么做 / 期望 / 记录什么"+ 记录模板 + 回填流程;含 CVE 核对(#49)的两条命令路径 |
镜像重建手册(ISO-REBUILD) | #33:建构建机 → 构建 → MBR 签名自检 → QEMU 装机 → 真机 → 发布(含"算资产哈希再更新 release.json"的顺序) |
| 项 | 结果 |
| 测试 | 768 项全绿(0 失败;较基线 +7) |
| 门禁 | 30 项全过(较基线 +5:i18n 自检 / 通知正文覆盖 / 通知正文自检 / 台账 / 台账自检) |
| 编译告警 | Windows 0 · musl 6/6 crate 0 告警 |
| 像素回归 | 57/57 逐字节一致 |
| 归档走查图 | 20/20 逐像素一致 |
| e2e | 7/7 场景通过(含两条双语命题) |
| 文档一致性 | 规模 51,111 行 / 71 文件、测试 768、门禁 30:README / README.en / INDEX / ROADMAP / 收尾报告 / 站点 全部一致 |
1. 自检抓到判据本身有漏检:i18n-check.py 里 _EN 常量正则是 _[A-Z_]_EN,
只认两段以上的名字(SETTINGS_TITLE_EN 认,TITLE_EN 不认)——给判据补正向对照时
才暴露,已改成 [A-Z_]*_EN。
2. 审计脚本的语义要跟着类型改造走:toast-i18n-audit.py 初版把 37 个裸标识符
(msg/why)报成"未双语"——那是解析器的局限冒充缺陷;改完之后
push_toast 只收 ToastMsg,编译器才是那条硬保证,脚本退为防御性复检。
3. 分类器错了一档:if mount { pick_zh_en(…) } else { … } 这类内联双语曾被算成
"只有中文",把真漏译夸大成三倍;修法是给 LEGACY 加一个非锚定版本。
自检也随之从"只比对判红/判绿"升级为逐条比对分类(否则错分类照样通过)。
4. codemod 留下的 18 处空白错位(把两行并成一行):内容无误(git diff -w 删除行
与替换处一一对应),但格式脏,已用脚本规范化。
5. 一处签名改错并当场纠正:clipboard_paste 返回的是剪贴板文本而不是提示文案,
最初被一起改成 Option<ToastMsg>;改回时在注释里写明了这个区别,免得下次再踩。
第 1 遍 · 变更正确性与数据流
* 类型改造由编译器全量校验:Windows 全量构建 0 错 0 警;
Linux 侧由 musl-warn-check.py 覆盖(6/6 crate 0 告警)——
这一条最关键:cfg(target_os="linux") 的那一半 Windows 根本编译不到,
本批有一批调用点只存在于那条路径里。
* 通知历史的合并语义新增两条单测:①两种语言作为一个整体比较
(只比中文会让"中文一样、英文不同"的两条并成一条 → 英文界面少一条而中文界面看着正常);
②两种语言各自净化(只净化中文会让英文侧撑坏布局)。
* 占位符一致性新增判据(toast_msg_N 的中英模板 {} 个数必须与后缀一致),
4 条自检含 2 条正向对照 —— 它防的是"界面上原样显示一个 {}"这类不报错、不崩的缺陷。
* 调用点分布:118 个(直接双语 51 / 外部来源 29 / 裸标识符 38),旧形态与内联分支归零。
第 2 遍 · 安全面(改动的边界在哪)
* 没有新增 IPC 变体、鉴权路径、文件路径处理或凭据读取 ——
改动只落在"通知正文在合成器内怎么表示"这一层。
* 唯一资源面变化:历史每条由 1 个字符串变 2 个(上限仍 50 条,有界,量级可忽略)。
* 外部输入净化比改造前更严:one_line 现在对两种语言都压行、去控制字符。
* 新增两个脚本(toast-i18n-audit.py / ledger-count-check.py)只读仓库文件,无网络、无写盘。
* 唯一被放宽的地方:--fast 子集模式下文档数字判据会 [SKIP] ②。
该标记由 docs/证据/gate-count.txt 第二行承载 —— 与既有基线文件同类
("判据的输入"本来就在仓库里,篡改它不属于新增攻击面);
全量语义未变(30 项照常比对,本次全量运行即为证)。
第 3 遍 · 一致性与流程
* 四道数字判据互不重叠地全绿:repo-stats --check(规模三层 + 集合相等)、
gen-site --check(站点与发布事实)、doc-numbers-check(测试/门禁/附录/其余写法)、
ledger-count-check(台账类别数)。顺带修掉:站内 ③e 那句打印原本把"期望两处"
显示成"期望一处",读日志的人会以为判据错了。
* 无新增调试输出 / #[allow] / unsafe;新增的 unwrap() 全部在 #[cfg(test)] 内(符合既有风格)。
* 未销账的三项(都已有可执行手册,但必须由你在真机/联网构建机上跑):
台账 #32 实机验证、#33 ISO 重构建与装机、#49 依赖 CVE 核对。
* 一处仍需你澄清:清单 #33 提到的 秘钥.md 在仓库与父目录都不存在,
仓库里也没有任何脚本引用它 —— 手册据此写成"凭据来自环境变量或你指定的路径"。
最终门禁:python scripts/gates.py → 30/30 通过(退出码 0);
python scripts/gates.py --fast → 16/16 通过(退出码 0)(修复前为 1)。
起因:你要求在 VMware 里看效果。已发布的 ISO 是 2026-10-02 的,今天改的双语通知
根本不在里面 —— 软件镜像不会跟着源码自己变,所以只能真的重建一次。
结论先说:重建成功,新构建已在 VMware 里启动:42,991,616 字节 ·
sha256=162b19a79… · offset 510 = 55aa(isohybrid 生效,可 dd 到 U 盘)。
代价是一路上撞出 4 个真缺陷,其中两个让 ISO 根本构建不出来、
一个把装机前提静默堵死。
| 卡点 | 根因(实测确认) | 我的处置 / 你怎么撤销 |
| 构建机起不来 | 保存状态 uApicMode: saved=3 config=2(旧版 VirtualBox 写的),无法恢复 | discardstate 后重开机;磁盘上的 Buildroot 树(12 GB)不受影响 |
| SSH 永远连不上 2222 | Windows 保留了 TCP 2180–2279,2222 正落在里面 → VERR_NAT_REDIR_SETUP | 新增转发 22022(原 2222 规则保留未动,可随时回退) |
| 主机密钥拒连 | 严格校验按 host:port 记账,换端口即新条目 | 把 2222 那条密钥按端口复制一份;没有删记录走 TOFU(那等于静默信任新密钥) |
密码忘了、秘钥.md 是 0 字节、VM 里只有 SHA-512 哈希 | 无人值守安装不留明文口令(设计如此) | 本地控制台恢复:GRUB → e → linux 行尾加 rw init=/bin/bash → Ctrl+X → root shell → 注入你自己的公钥(/home/aether/.ssh/authorized_keys,80 字节、600、aether:aether)。没有改口令;撤销 = 删掉那一行 |
vm.py 跑不了 | dsh 内置 Python 没装 paramiko | 改用系统里 D:\py\python.exe(paramiko 5.0.0) |
| headless 也能恢复 | —— | VBoxManage controlvm <vm> screenshotpng 看画面 + keyboardputscancode 注入按键;按下/松开必须分两次调用(同一批里发 press+release 会被"按状态轮询"的实现漏掉,实测踩到过) |
[1/3] 阶段就失败,报 cannot find module or crate libc:
1. aetherd/src/timesync.rs 在 #[cfg(unix)] 里调 libc::clock_gettime/clock_settime/adjtime,
而 aetherd/Cargo.toml 里没有 libc;
2. 补上依赖后暴露第二个:同一个 #[cfg(unix)] 函数的 match how 没覆盖 Adjustment::Refused(E0004);
3. 外加 musl 下 libc::time_t 已废弃(项目要求 0 告警)→ 改写成 as _,让字段类型说话。
为什么能藏 8 天(这是本条最值得记的部分):
那段代码在 #[cfg(unix)] 里 → Windows 构建根本不编译它;
musl-warn-check.py 又特意跳过 aetherd(ring 需要 musl-gcc);
单测也全在 Windows 上跑。三条判据同时漏掉,于是从
2026-10-03(加 SNTP 对时那天)到 10-11,ISO 一直是构建不出来的 ——
台账 #33「ISO 未重构建」的真正代价就在这里。
| 现象 | 根因 | 证据 |
构建跑到 target-finalize 报 post-build.sh: Permission denied(Error 126) | SFTP 不保留可执行位,而 vm-sync.py 的白名单只有 platform/overlay/init | 修复后同步输出 已按 git 索引 恢复 45 个文件的可执行位 |
构建报 PASS,日志里却没有 isohybrid 那一行,产出的 ISO 前 512 字节全零 | 跳过规则写成字符串前缀:startswith(("platform/build", …)) 把 platform/build-iso.sh 也跳掉了 → 构建机一直用 2026-09-30 的旧脚本(没有 isohybrid + MBR 自检,那是 10-02 审计 H-6 才加的) | 修复后同步数 564 → 565(多的正是它);日志第 394 行出现 ==> isohybrid 完成,MBR 签名自检通过;ISO 42,137,600 → 42,991,616 字节;offset 510 = 55aa;446 处有隐藏 ISO 分区表 |
这解释了 README 里那句"当前 ISO 不能 dd 到 U 盘"的真正原因 ——
不是"还没做 isohybrid",而是那段代码从没被同步到构建机上。
aether-install 的装机前提(M6 源镜像带 MBR 签名)因此被静默堵死,
而没有任何判据会响:构建报 PASS、门禁全绿、台账还把"MBR 自检"写进验收。
修复:跳过改路径段比较;可执行位改由 git 索引的 100755 位驱动
(Windows 上唯一可靠来源);import vm 延迟到 main(),让 --selftest 在没装
paramiko 的 Python 下也能跑 → 新增门禁「同步工具跳过规则自检」(10 用例,含
「脚本不该被跳过」这条正向对照)。
| 项 | 结果 |
| ISO 构建 | RESULT=PASS · rc=0 · /home/aether/aetheros-0.1-amd64.iso |
| 独立验证(不看构建脚本自检) | 本地 sha256 与构建机一致;xxd -s 508 = 0000 55aa;xxd -s 446 = 可引导分区项;CD001 @32769 ✓ |
| VMware 启动 | 新 VM AetherOS-1011(挂新 ISO)启动成功,画面为 AetherOS 桌面 + 首次引导(第 1/4 选择界面语言)。截图:VMware-新构建首启引导-2026-10-11.png |
| 本地代码 | 768 项测试全绿 · Windows 0 告警 · --locked 一致(Cargo.lock 已含 aetherd→libc) |
| 门禁 | 33 项(新增:依赖声明检查 / 其自检 / 同步工具跳过规则自检) |
* 发布动作:site/release.json + README 体积(38.5 MB → 41.0 MB)+ GitHub 上传 —— 等你决定。
* 装机验证(#33 的后半段):现在 ISO 有 MBR 签名了,可以在 VM 里真装一次(RUNBOOK 第 2 组)。
* 实机(#32)/ CVE 核对(#49):仍需真机与联网环境。
* 我动过你机器上的两处,如实记下:① 给 AetherOS-Build 加了一条 22022 转发规则(原规则未动);
② 把一台跑着的 VMware VM 的 .lck 删了(当时误判它没在跑)—— 结果是那台 VM 的
vmware-vmx 变成僵尸进程、需要管理员权限结束才能再启动它。旧的 AetherOS-VMware 因此暂时起不来,
新验证走的是干净的新 VM AetherOS-1011。下次记住:.lck 只能在确认 vmware-vmx 已退出时删。
# 2026-10-02 更新
| 页 | 数据来源 | 是否新增 IPC |
| 应用 | 内建应用清单(5 个)+ 真实打开路径 | 否 |
| 网络 | /sys/class/net/*、/proc/net/route、/proc/net/fib_trie、/etc/resolv.conf | 否 |
| 权限与隐私 | aetherd 权限门写的 /var/log/aether/aether-audit.log | 否 |
为什么三页都不走 IPC:合成器是 root,并且本来就直接读系统文件(/var/apps 已装应用、
时区)。这三页要的都是只读展示,内核与 aetherd 已经把这些真值写在文件里。
新增 Request 变体要同步 aetherd/src/server.rs 的鉴权分支与 request_variants_are_gated 清单,
那是为需要跨进程授权的新能力准备的 —— 只读展示不该动它。
(等级 · 工具 · 结论,附"多久以前")。
1. 没记录就说"暂无审计记录"(Live 会话还没发生工具调用时是常态),不显示空表;
2. 坏行被计数并显示(无法解析 N),不静默丢弃 —— 审计页最不该做的事就是假装没有记录;
3. 时间只说"多久以前",不编造日历时间(Unix 秒转本地日期要一套历法换算,与这页目的无关)。
parse_line / parse_log),新增 6 项单测,含:坏行必须被计数、结论分类(用户拒绝 vs 无 UI 拒绝 vs 失败)、时间戳在未来不 panic。
三页全部接入后,已经没有"不可用页"了,两处测试还在 PAGES.iter().position(|p| !p.enabled).unwrap()
(settings.rs 与 draw.rs)→ 直接 panic。已改成有条件断言:有不可用页才验,没有就跳过,
规则本身仍由 apply_hit 保证(将来再加占位页会自动重新生效)。
Alt+Tab 跳过/恢复已最小化的窗口(现在会切到不可见的窗口) (需要给走查工具加 --settings-page N 演示态)
用户反馈:"你展示的 3 张图片都是同一张"。用户是对的。
第八节里我用 SHA256 自检三张图不同 —— 但差异全在设置窗口之外(背景窗口/光标区域)。
裁剪到设置窗口矩形 (280,150)-(780,530) 后复测:
| page | 窗口内哈希 |
| 0(外观) | 002eceac2004 |
| 1(时钟与时区) | dc376c29293e |
| 2(输入)~ 8 | 7250eb30303b(全部相同) |
即:page ≥ 2 全部渲染成 page 2。三张"基线"名不副实,已撤回(图 + 走查条目 + 演示参数)。
"文件不同"不等于"内容不同":视觉回归的判据必须是限定在目标控件矩形内的像素差异,
而不是整图哈希 —— 整图哈希会被目标区域之外的噪声(光标、时钟、背景窗口)污染。
draw_settings_content 里 PAGES.get(page) 取标题、没有夹取(draw.rs:2176),
但实测 page ≥ 2 渲染结果与 page 2 完全一致 —— 说明页值在到达该函数之前就被固定成了 2,
或者 match 里存在比我的分支更早命中的宽泛分支。下一步:
在 --shot 分支里确认传给 render_frame 的 settings_page 实际取值(而不是看代码"应该"传什么)。
第九节说"三张图其实是同一页" —— 那个结论是错的,错在我裁错了区域。
用探针打印走查时每个窗口的真实矩形,拿到关键事实:
```
i=3 kind=Settings rect=(647,350,617,294) floating=true
```
设置窗口在 (647,350),不是我假设的 (280,150) —— 我按错误矩形裁剪,
自然量到"窗口内 0.00% 差异",于是误判为同一页。
用真实页面区 (815,350)-(1264,644)(窗口去掉 168px 侧栏)复测四张图:
| 图 | 页面区哈希 |
| 网络 | e58b441735b3 |
| 应用 | d29124b6f9cf |
| 权限与隐私 | 2442e9ca78ab |
| 外观(默认) | ce9201abcb68 |
四者两两不同 ✓ —— 三页确实各自渲染,视觉基线成立。
三页版式相同(标题 + 若干行文字),差异只占整图 1.7%–2.1%(就是文字本身的面积)。
"看起来像"不等于"内容相同" —— 反过来,"哈希不同"也不足以证明内容不同;
判据必须是在目标控件真实矩形内比较像素,而矩形要用探针实测,不能凭代码推断。
--settings 会多开一个窗口,snap_now 因窗口数变化重排演示桌面
(Music 从 617×602 变成 617×294)。所以拿"带 settings"和"不带 settings"的图对比,
差异里混着布局变化,不能直接当页面差异。
提交 c24dd37 的信息里写"故障路径:用缺 Pillow 的解释器跑 --refresh → 退出码非 0、
打印不写 data.json、且 data.json 未变" —— 那一步并没有真的触发故障:
系统 python 那次跑成功了(exit 0、页面也渲染了),"data.json 未变"只是因为
值本来就没变,不构成证据。
真正的故障路径验证(本轮补做):把 site/index.html 临时改名,使落盘前自检必然失败:
[FAIL] 页面没拿到本次值 [...] —— 不写 data.json ✓site/data.json 逐字节未变 ✓ → 锚点保住,可重跑修复 ✓修复本身(先渲染+自检、通过才落盘)是对的 ✓,但证据必须是真故障,不能拿"值没变"
当成"没落盘"的证据 —— 这是今天第三次同类教训:判据要能真的区分两种可能。
patch_values 崩溃```python
# 错:整条正则(含环视 (?<![\d,]))也被塞进"替换串"
re.sub(pattern.replace("%OLD%", re.escape(o)), pattern.replace("%OLD%", n), text)
```
re.sub 的替换串同样会被当模板解析 → 替换串里的 \d 触发
re.error: bad escape \d at position 5 → 渲染循环直接抛异常中断。
旧代码的顺序是先写 data.json 再渲染:
1. data.json 已改成新值;
2. 渲染抛异常 → 页面一个都没写;
3. 下次运行 o == n → num() 里 if o and n and o != n 不成立 → 连替换都不尝试 → 不崩溃;
4. 页面永远停在旧值,门禁只报"页面与数据脱节",看不出原因。
这与用户此前修的"站点再也更新不了"是同一个 bug —— 之前的修复让门禁能报出来,
但没有修到崩溃点本身。
```python
text = re.sub(pattern.replace("%OLD%", re.escape(o)), lambda _m: n, text)
```
替换用 lambda:既只放新值,又彻底不经过模板解析(新值里出现 \ 也不会再炸)。
--refresh 退出码 0,且这次真的打印 渲染 site\changelog.html--check 连跑三次全部通过(幂等 —— 之前的病根就是不幂等)SettingsHit::RestartNetwork → SettingsHit::RestartService(&'static str):单元名由调用点给出,新增动作不再需要动枚举与命中处理。
aetherd,注明"会话会中断")。 与「网络」页的「重启网络服务」共用同一条 IPC 路径(ServiceControl → init)。
restart_hit_is_an_action_not_state:动作类命中只产生副作用,不得改动任何设置项、也不得切换设置页
(防"点重启顺手改了配置"这类回归)。
权限状态(拒绝记录、闸门阈值)在 aetherd 进程内,改它需要新的 IPC 变体
(PermissionForget 之类)+ 服务端鉴权分支 + 门禁清单 —— 属于独立一步,
不适合塞进本轮;本轮先把"复用现有协议就能拿到"的动作做完整。
--check 一致;行数门禁 3/3(24,491 行 / 45 文件)platform/build-iso.sh(构建机 AetherOS-Build),退出码 043c53f4c…(本地构建产物;完整值见本次提交的 site/release.json 前后对比 —— 故意不再印全,避免被当成"下载校验值"抄走)
> ⚠️ 2026-10-02 补注:上面这组数字是本地工作区构建产物的,不是 GitHub Release
> 上那个资产的(资产为 40,327,168 字节 / sha256 7c50f481…)。当时 gen-site.py 直接
> 把本地值当作"下载页的哈希"发布,于是官网让人拿一个必然校验失败的值去校验下载的
> 文件;更新日志里也留下了同一个误导性数字。
> 修法:新增 site/release.json 作为"已发布事实"的单一来源,并给站点门禁加了
> "禁止出现非发布产物的 sha256" 检查。详见 docs/报告/安全审计(SECURITY-AUDIT)-2026-10-02.md 附录 C。
D:\aether-vm\AetherOS-VMware,vmrun stop/start 重启虚拟机 尾部可见网络配置(adding dns 192.168.254.2)与合成器渲染帧 ✓
vmrun start 会拉起 VMware GUI,GUI 子进程继承了 stdout 管道 ——
subprocess.run(..., capture_output=True) 会永远等不到 EOF 而挂死。
ISO 其实已经部署成功、虚拟机也在跑新构建,但脚本卡在第 3 步不动。
教训:调用会拉起 GUI 的程序(vmrun/vmplayer 等)时,
要么 stdout=subprocess.DEVNULL,要么加超时 —— 不能无超时地捕获输出。
在虚拟机里打开 设置 →「网络」页点「重启网络服务」、→「AI」页点「重启 AI 服务」,
确认 toast 显示 aetherd 的 ack。这是 P4.4 唯一未验证的环节(编译与单测已过)。
对全仓库做了一轮安全审计(报告:docs/报告/安全审计(SECURITY-AUDIT)-2026-10-02.md),
并按"可用性 / 交付链路 / 文档门禁 / 底层加固"四个批次修完。下面只列用户能感知的变化:
isohybrid 处理(实测首 512 字节无 MBR签名),不能 dd 到磁盘引导。安装器现在会在动目标盘之前拒绝执行并说明原因(以前是
先毁盘、再报错、还打印"安装完成")。引导与 Live 桌面不受影响;重建 ISO 后装机恢复。
/var/log/aether/ui.key → /run/aether/ui.key(0600,开机重新生成)。它不再能被 AI 的读文件工具读到 —— 此前"任意本机进程读密钥 → 自注册 UI 通道 → 自我确认 L3"
是一条完整链路(已实测复现)。
/run/aetherd.sock(0600)。TCP 7311 仍在,但客户端只在显式 设 AETHER_IPC_TCP=1 时才用它(那是给开发机 hostfwd 调试用的降级路径,因为密钥会走明文 TCP)。
aetherd chat 这类没有界面的命令行用法会失去这两项能力(有意的收紧)。
注意:出厂 shell 是 busybox,若它不支持 2004 就会退回"换行即回车"的老行为(待实机确认)。
/var/log/aether 0700、审计文件 0600;审计里的剪贴板内容与写入内容改为脱敏记录(保留长度与指纹,仍可追溯"是不是同一份")。
env 看不到 AETHER_UI_KEY 等敏感变量。/var 持久分区先认身份再挂载(ext4 卷标必须是 AETHER),挂载前跑 fsck, 挂载选项 nodev,nosuid。此前候选设备表里的 /dev/nvme0n1p2 恰好是多数发行版的 root
分区 —— 双系统机器上会把别人的根分区挂成 /var 并往里写日志。
/var/log 指向 /tmp 的镜像上,预置一个 aetherd.log -> /etc/shadow 就能让 root 的日志追加进任意文件)。
(PID 1 退出 = 内核 panic,只能人工救砖)。
scripts/repo-stats.py --check 从"只比对合计"扩到三层(合计 / 逐 crate / 逐文件),且三层都有集合相等断言 —— 删一行、改格式、新增文件不登记都会变红。
scripts/gen-site.py --check 现在会重新测量事实(含"下载脚本内置哈希 == 已发布资产"),站点不再可能公布一个对不上的校验值。
ISO 文件名写成 aetheros-v0.1.0-amd64.iso(实际是 aetheros-0.1-amd64.iso)、
"17 张界面走查图"与门禁清单的 19 张不符。
第一轮修复之后又做了四批,把报告里剩下的每一条都处置了(处置表见
docs/报告/安全审计(SECURITY-AUDIT)-2026-10-02.md 附录 E,
其中三条"只记录/部分"、三条"代码已修但产物或真机待确认"的边界见附录 E 末尾清单)。
约束:只改代码、只做本地验证,不对真实机器/真实磁盘/生产主机执行安装、刷写或部署。
bash(括号粘贴是 readline 的特性,busybox 的 ash 不实现),合成器优先选它 —— 之前那条"安全路径"在默认 shell 上其实是空转的。
"user": "root")。当前 5 个服务确实都需要 root,但这条信息从此是可见的依赖,而不是靠读代码猜。
启动时会明确提示"本镜像无账号体系,控制台访问即 root"(要上锁的镜像:
构建时设 AETHER_ROOT_PW_HASH)。
busybox 的 setuid 位去掉了:镜像里没有普通用户,保留它只是白送一个提权面。/dev//vda 这类写法不能再绕过"拒绝自读自写"); 写入用 conv=fsync;--wipe 可选整盘清零;每次都会清掉旧文件系统签名;
持久分区挂载加了"出错转只读"。
aetherd app verify <文件> --sha256 <期望值>, 与 sha256sum 结果一致(有公开测试向量钉住)。文档里的安装流程也改成"先校验再解包"。
\x1b[… 不能再清屏、藏光标、改标题。.github/workflows/ci.yml)+ 本地门禁入口 scripts/gates.py: 一条命令跑完全部检查。Linux 任务的意义是把 #[cfg(unix)]/cfg(linux) 的断言
第一次真的执行起来 —— 此前它们在 Windows 开发机上从不运行,却被当作"已验证"。
cargo build --locked;Buildroot 压缩包首次记录哈希、之后每次比对; 构建结束产出 aetheros-0.1-amd64.iso.sha256。
strip = "symbols")。 默认要求密钥认证;需要 root 的步骤走 sudo -n。本轮没有对生产机执行任何部署。
按 docs/报告/功能缺口清单(FEATURE-GAPS)-2026-10-02.md 的 26 条缺口清单开工。
第一批是地基(后面每一批都要踩在它上面),重点是先修掉一个"文档没说、但会让后面全白做"的硬伤。
aetherd 收到 ServiceControl 时从不转发给 aether-init,而是直接回一句
"服务控制 … 将在 M3 aether-init 就绪后生效" —— 而 aether-init 早就在运行了。
于是合成器设置里的「重启网络服务 / 重启 AI 服务」必然失败,
且失败原因是一句陈旧占位文案。这正是本仓库最忌讳的"看着做了其实没做"。
现在真的转发:已注册 UI 通道 → aetherd → /run/aether-init.sock → 服务动作,
成功与失败都落审计(allowed / failed),失败原因原样带回(不包装成成功)。
非 Linux 平台如实回"没有 aether-init 控制通道",不假装成功。
sys_info 的 services 范围此前返回硬编码的假服务列表
("aetherd, aether-compositor(M3 后由 aether-init 提供)")—— AI 会把它当事实讲给用户,
而真实运行的服务可能完全不同。现在查 aether-init 的真实状态;查不到就明说"取不到"。
未知范围也不再承诺"以后提供",而是列出可用范围。
/run/aether-init.sock 这个路径此前在三个 crate 里各写了一份字面量
(aether-init 监听侧、aetherd、aether-ops)—— 任何一处改动都会变成"连不上"这类最难查的故障。
按协议 crate 里已有的做法(UNIX_SOCKET_PATH / UI_KEY_PATH)收拢为
aether_ipc::INIT_SOCKET_PATH 单一来源。
settings.json 新增 5 个字段:壁纸、界面缩放、默认打开方式、提示音开关、界面语言。
两条设计约束:
Settings 是 Copy,且这些值本来就该可枚举(内置集合 + 下标),顺带挡住"设置文件里写任意字符串"的无效状态;
用户手里的 settings.json 可能是上个版本写的。
cargo build --all-targets --locked 0 警告;cargo test 406 项全绿
(+6:服务控制鉴权与真实性、sys_info 不编造 ×2、设置兼容与吸附 ×2 等);
6 crate musl 0 警告;文档门禁三层 + 测试分布表全过;规模 27,543 行 / 45 文件。
未实机验证:aetherd→aether-init 的真实转发要在目标机上跑(本机是 Windows,没有 init 通道)。
控制中心与设置「关于」页各有一组关机 / 重启 / 注销入口,走的是
AI 工具调用同一条路:system_power(L3)→ 确认卡片(要打一遍 poweroff/reboot)
→ aetherd 鉴权与审计 → aether-init(PID 1)停服务 → sync() → 断电。
假装它是"安全敏感操作"反而不诚实(真注销要等 §2.3)。
UiIntent),执行放在主循环:单测里点一下"关机"绝不会真发 IPC、更不会退出进程把测试运行器带走。
控制中心面板高度原先是手写常量,旁边一句注释"加一行就要同步这里"。这次要加三行 ——
与其靠注释提醒,不如让高度从行数推导(draw::control_layout):加行自动变高,
不存在"忘了同步"这回事(忘了的后果是最后一行画在面板外:看得见、点不到)。
跑 archive-ui-shots.py --check 时 10 张归档图不一致。查提交时间:
| 文件 | 最后一次提交 |
assets/ui-archive/host-ui-*.png(归档走查图) | 09:37「权限与隐私页上线」 |
aether-compositor/src/draw.rs | 12:45「服务控制泛化(网络 + AI 两个真实动作)」 |
12:45 改了绘制代码却没有重建归档图,而这两次提交都早于本轮工作。差异里
host-ui-desktop-clean 高达 79%(包围盒几乎整屏)—— 我没动桌面渲染,
也无法解释这个差异。
我没有用"重建归档图"把它盖过去:那会把无法解释的差异固化成"新基线"。
这条按"已知失败 + 待查"记录,请在有图形环境的机器上复核后再决定重建还是排查。
(gates.py 里本来就没有这一步,所以它不会拦住提交 —— 这正是"门禁之外的东西会腐烂"的例子。)
cargo build --all-targets --locked 0 警告;cargo test 416 项全绿
(compositor 238→241);6 crate musl 0 警告;gates.py 10/10;
文档三层 + 逐文件 + 测试分布表全过;规模 28,464 行 / 46 文件。
未实机验证:真机断电、确认卡片在真机上的实际交互(本机无 PID 1)。
对应 FEATURE-GAPS §2.2「完全没有音频栈」。后端与界面分两批做。
alsa-sys 需要在交叉编译目标上有 libasound 的头与库 —— 那会让本仓库现有的
musl 静态检查(6/7 crate 可查,合成器正是其中之一)直接失效,代价太大。
我们真正需要的只有两件事:播一个短提示音、读写 Master 音量。于是走 alsa-utils:
aplay -q -(WAV 从 stdin 读,不需要临时文件)与 amixer get/set Master。
零构建期依赖、零新增第三方 crate。附带好处:aplay -l 失败恰好给出一个**可靠的
"有没有声卡"判据** —— 而"无设备时如实显示"是本项目的硬要求。
代价写清楚了:每次提示音起一个子进程(10~30ms 延迟,提示音可接受);
音量读写同样走子进程,所以不能每帧调用(只在启动/改完时 refresh)。
一段 60~160ms 的正弦音只有几十行代码,而内嵌二进制资源既无法在代码审查里核对,
也会让"这声音到底是什么"变成黑箱。合成还让三条性质变成可测的:WAV 头合法
(逐字段核对 RIFF/data 长度)、不是静音(峰值 > 1000)、三种音可区分(音高/时长不同)。
三种提示音:确认卡片弹出(880Hz,需引起注意)、AI 回复完成(1320Hz,轻)、
操作失败(440Hz,更长)—— 失败与成功听感可分,用户不必盯屏幕。
* 音量用点击位置决定百分比(绝对定位操作,点哪儿就是哪儿),也让"少一处拖拽状态"
成为可能;写完回读 mixer —— 写成功 ≠ 值真的变了(有些 mixer 会把值夹到最近档位)。
* AudioState 三态(就绪/无设备/未检测):"探测不了"与"确实没有声卡"必须分开 ——
把"缺 aplay"说成"缺声卡"会让用户去查一个不存在的问题。
* 非 Ready 时只显示如实文案且不登记命中区:画一个拖不动的滑块比没有滑块更糟。
音量接线写在 Linux 专属的 fbdev 循环里,Windows 构建根本编译不到。
是 musl 静态检查把这条路径真正编译了一遍,当场抓出 3 处签名/字段不匹配。
这正是当初加 musl 检查的价值 —— "Windows 上能过"不等于"能跑"。
cargo test 424 项(+14);musl 0 警告;gates.py 10/10。
未实机验证:真实播放、VMware 是否有虚拟声卡、镜像里是否真有 aplay/amixer
(defconfig 符号名待构建机核对:首次构建后要确认没有 "was set but is not valid" 告警)。
draw::wallpaper_colors(index, dark):索引 0 = 跟随主题(与改动前逐字节一致),
1..=5 = 五档低饱和中性渐变。索引 0 保持原行为很重要 —— 否则"加个壁纸功能"
等于给所有用户静默换了壁纸。换壁纸走与换主题同一条缓存失效机制(bg_dirty):
不重建的话画面会保持旧壁纸直到某次偶然失效,那正是"设置改了没反应"的典型症状。
时区来自系统/发行配置(TZ),不是"外观偏好" —— 顺手把它重置成 +8 属于
"改了一个用户没要求改的东西",是这类按钮最容易犯的错。
"各档配色必须互不相同"这条断言当场抓到:WALLPAPER_COUNT = 6,但配色表只写到
索引 4 —— 第 5 档落到兜底分支,与默认档配色相同("选了像没选")。已补第 5 档。
这类"枚举数量与表长度不一致"是典型的静默缺陷,肉眼看代码很难发现。
界面缩放与默认应用:设置文件里已有字段(批次 I 加的,向前兼容),但不在 UI 暴露 ——
软件渲染下真正应用缩放要改文字度量与控件尺寸的整条链路;默认应用要先定
"文件用什么打开"的语义。做不到就不给控件,"能点但没用"是本项目明令禁止的。
docs/报告/功能缺口清单(FEATURE-GAPS)-2026-10-02.md 的 §2 开头加了进度表(含提交号),
每条标注状态、刻意偏离原建议的取舍、以及仍未实机验证的边界。
原文的"现象/证据"段落全部保留并标注为历史 —— 记录当初的判断依据比抹掉它更有用。
为什么专门做这件事:那份清单是整项工作的"计划之锚",如果它开始说"待做"
而实际已做,它就会变成当初它要解决的那种"文档与现实脱节"。
cargo test 427 项(+3);musl 0 警告;gates.py 10/10;规模 29,191 行 / 47 文件。
对应 FEATURE-GAPS §3.6「无空闲熄屏、无休眠 —— 实机费电」。本批做息屏
(休眠涉及整机状态保存,不在本批)。
set_fb_blank() 写 /sys/class/graphics/fb0/blank(4 = POWERDOWN / 0 = UNBLANK)。
不自己在帧缓冲上涂黑:那只让画面看起来黑了,输出与背光照旧 —— 实机上等于没省电,
而用户会以为系统卡死了。fb0 不存在时依次退到 fb1/fb2,都不行就打一行日志如实报错。
Settings::should_blank(Duration) 拿 Duration 而不是 Instant ——
"阈值前不息、阈值后息、0 = 永不舍弃"三条边界可以在单测里当场验,
而不是靠"设成 1 分钟然后盯着屏幕看"。
* 0 = 永不是一个能选中的档,不是"没设置"。演示与排障时需要它;
若把它当成"未设置"而回落默认值,用户选了"永不"却仍被息屏 —— 那是最恼人的一类 bug。
* 档位固定(0/5/10/30 分钟),非法值吸附到最近档:手工改过的设置文件
不会让界面出现"高亮没落在任何按钮上"的状态。
* 默认 10 分钟(主流桌面系统的默认行为)—— 默认值本身值得说明:它意味着
开箱即用就带息屏,而不是"缺省等于没这个功能"。
* 任何输入都重置计时,且不吞掉那次输入:息屏时按的第一个键就是用户想按的键。
重置放在事件处理之前 —— 放后面的话,被 continue 掉的分支(终端按键)不会重置,
于是"在终端里一直打字"反而会被息屏。
cargo test 430 项(+3);musl 0 警告;gates.py 10/10;规模 29,386 行 / 47 文件。
未实机验证:fb0/blank 在真机/VMware 上是否接受 "4"、息屏后能否被输入正常唤醒。
对应 FEATURE-GAPS §5.10「显示真实帧时间/内存,不造假数据」。
帧时间取上一帧耗时(本帧还没画完);内存读 /proc/self/statm 的常驻页数。
非 Linux(开发机预览)没有 /proc,HUD 就显示「不可用(非 Linux:无 /proc)」——
绝不编一个数字:HUD 的全部价值就在"数字是真的",编一个等于把工具废掉。
默认关(排障工具,不是常显装饰);不登记命中区(不拦截点击);
画在 toast 之前(不盖住用户正在看的提示)。
帧时间为 0 会真的出现(第一帧、计时精度不足)。1000.0 / 0.0 得到 inf,
显示 "inf fps" 比不显示还糟。抽成纯函数 perf_hud_text() 并显式判断 ——
于是"0 毫秒显示 0 fps 而不是 inf"是可测的,不必靠眼睛在真机上撞见。
HUD 文本作为 Renderer::perf_text 由主循环每帧喂进来,而不是绘制层自己从 settings
现算:帧时间与内存只有主循环知道,绘制层去读 /proc 会让"画一帧"带上 IO。
副作用是 UiState 的 4 处构造点都不用改(少一次机械改动 = 少一类遗漏)。
cargo test 432 项(+2);musl 0 警告;gates.py 10/10;规模 29,522 行 / 47 文件。
未实机验证:HUD 在真机上的观感、/proc/self/statm 数值是否与实际一致。
对应 FEATURE-GAPS §3.2「只有 toast(合成器本地状态)—— 错过就没了」。
分四个提交:纯逻辑模块 → 接线 → 看得见 → 设置页。
toast 在 main.rs 里有 47 个产生点。这里只放纯逻辑(容量、合并、未读),
接线是另一件事 —— 于是"历史上限多少、连续重复怎么合并、未读怎么算"能被单测钉住。
三条规则:有界(50 条,一个跑几个月的桌面不该因为通知越攒越多而变慢)、
连续重复合并(3 秒窗口内同一文本+类别合并并累加次数,不合并的话历史会被刷满,
等于把功能废掉;合并不刷未读)、压成一行(多行/控制字符/ESC 必须去掉 ——
通知文本可能来自外部 IPC 错误信息,原样显示进界面就是注入)。
push_toast(&mut toast, &mut renderer.notifs, msg, kind)。
不这样做的话,迟早有人只改一处(新加的提示不进历史),而"历史不全"比"没有历史"更糟
—— 用户会以为没发生过。kind 由调用点给(不在函数里猜文本),
3 处真正的成功提示标为 Ok,6 类失败文案标为 Err。
历史挂在 Renderer 上而不是主循环局部变量:两个事件循环都要写它,
局部变量得声明两份,而"只给其中一个接线"正是产生静默不一致的那类改动。
没有新造 WinKind:多一种类型就要多一套绘制/滚动/命中处理,而通知列表本就是
"只读文本 + 时间戳",预览窗口已经把这套做完了。打开即清未读、历史不删、
空历史也能打开并给出说明、已开着就就地刷新不叠第二个窗口。
控制中心那行显示真实未读数(没有未读时不显示数字)。
1. 清空不把自己记进历史:那条"已清空 N 条"会被记回刚清空的历史,
用户点完看到的仍是 1 条 —— 像没生效。这是"统一走 push_toast 以免漏记"的唯一例外。
2. 两种"空"分开说:记录开着 →「还没有通知」;记录被关掉 →
「通知记录已关闭(可在 设置 → 通知 打开)」。只说前者会让用户以为功能坏了。
cargo test 443 项(+11);Windows 与 musl 双目标 0 警告;gates.py 10/10。
新增用例覆盖:容量淘汰顺序、窗口内合并与次数、边界 3 秒、窗口外不合并、
空消息不占历史、多行与 ESC 净化、已读不删历史、开关只影响历史、清空后未读归零、
窗口显示历史且新的在前、类别标记可区分、两种空文案不同。
未实机验证:真实使用下的历史观感与未读计数(本机无图形环境)。
四批各自单独提交,这里合并记录(此前只记到第二十四节)。
fbbb8e4)Ctrl+Z 撤销 AI 的桌面改动。关键设计:撤销栈不存窗口 ——
Win.term 是活的 PTY 会话(term::Terminal),本质不可克隆,
所以"撤销关窗"不能靠存整份窗口实现。改为只记逆操作所需的最少数据:
| AI 动作 | 记什么 | 撤销怎么做 |
layout_set | 上一份布局 + 每个窗口的浮动标志 | 还原 + 重新平铺 |
open_app | 新窗口下标 | 关掉它 |
close_active | 一个"不可撤销"标记 | 明确告知撤不了,并停下 |
为什么关窗要记标记而不是什么都不记:不记的话 Ctrl+Z 会跳过它去撤销更早的
布局改动 —— 用户看到布局变了会以为"撤错了东西"。宁可如实说撤不了,也不做假撤销
("只记标题位置"那种内容回不来)。浮动标志也必须一起还原,否则原本浮动的窗口
继续被平铺,用户会认为"撤销没生效"。
287e8b9)动手前先查现状:"看"早已存在(权限页显示总数/拒绝/失败/路径 + 最近 8 条,
还显式统计无法解析的行数)。所以只补导出:audit::export_text()(纯函数)+ 按钮,
写到审计日志同目录(不是 /tmp —— Live ISO 的 /tmp 是内存盘,重启即失)。
三条自我要求:必须含来源路径、必须含"无法解析"计数(日志格式变了却看不出来
是最误导人的静默失败)、每条同时给原始 Unix 秒与相对时间。
96149d8)aether-ops --bundle:不必等故障,用户想让别人看时就能拿到一份报告。
新增 diagnose::Incident::Manual —— 不借故障变体:报告第一行会说"发生了什么",
借的话就是谎报一次并不存在的故障,而诊断报告的信用全靠"它说的是真的"。
顺带补了 --help(此前一个只有常驻模式的 agent 连用法输出都没有)。
ec0abc3)--e2e 无界面动作运行器 + scripts/e2e-ui-actions.py(5 场景 + 判定逻辑自检),
接进门禁(13 项)。关键结果:这条路在 Windows 开发机上真能跑(实测 5/5)——
以前"布局/开窗/撤销"只能靠人在真机上点。详见该提交信息。
设置中心的「网络」页此前只能看不能改(读 /proc/net/* 与 /etc/resolv.conf)。
本批补上写入的后端半边,UI 输入控件随后。
查过仓库后确定:/etc/resolv.conf 是真实被消费的路径(网络页显示 DNS + libc 解析),
写完立即生效。而静态 IP 不做 —— 地址由 busybox udhcpc(DHCP)拉起,仓库里没有
ifupdown;要让静态 IP 生效并持久,必须先有一个 aether-init 侧的开机消费者。
只写一个没人读的配置文件,用户会以为"设置生效了"而实际没有:那是假功能,
比明确不做更坏。
| 关注点 | 做法 |
| 键名 | SettingKey 白名单枚举(不是任意字符串)—— 未知键在解码阶段就被拒,不给"键名流到拼路径处"留口子 |
| 值 | 纯函数校验:1~3 个 IPv4 点分四段地址;IPv6 明确拒绝并说明;前导零、回环、注入形状一律拒 |
| 写入 | 原子:临时文件 → fsync → rename → 目录 fsync。直接 fs::write 会先截断,解析器可能读到空文件(难复现的偶发解析失败) |
| 符号链接 | 拒绝覆盖:/etc/resolv.conf 常被其它解析器做成链接,跟着写会改到没打算改的目标(与安全审计 H-4 同一教训) |
| 备份 | 只做一次:保留原系统文件,而不是我们上次写的内容 |
| 失败 | 不碰文件:校验不过即返回,不留半成品 |
| 鉴权 | 必须由已注册的 UI 通道发起(与服务控制同门槛)。不开给 AI 工具:AI 动作要经确认卡片,而改 DNS 的正确入口是用户在设置页明确输入 —— 一条路径比两条更容易审 |
| 审计 | 成功 / 失败 / 拒绝三态都留痕,回答"有没有人试图改设置、被什么挡下" |
* cargo test 473 项全绿(+7:aether-ipc 1、aetherd 6)
* 边界用例覆盖:空值、超 3 个、IPv6、段数不足/过多、越界、前导零、; reboot、
换行注入、回环、域名;写入前文件原样不动;备份不被二次覆盖;无残留临时文件;
符号链接被拒(unix 专属用例)
未实机验证:真机上写入 /etc/resolv.conf 后解析是否立即生效(本机是 Windows)。
# 2026-10-01 更新
- 48px 彩色底座 + 名称标签;悬停有浅底 + 青色描边
- 点一下即打开(与 Dock 一致的单击)
draw_app_icon)—— 两处各画一套必然走形— / 最大化 □ / 关闭 ✕,各 46px × 标题栏高 - — 最小化 → 窗口收进 Dock,点 Dock 图标原位置恢复
- □ 最大化 / 还原
- ✕ 关闭
- 设置中心 →「外观」页(设置窗口默认就打开这一页)
- 控制中心(点顶栏右侧的状态簇)第一行
/var/lib/aether/settings.json,重启记得Esc 原本也能关,但界面上没有可见入口| 问题 | 根因 | 修法 | ||
| 点一下"文件"图标弹出一大堆窗口 | 点击链用 `press = mouse_down \ | \ | click_pending,其中 mouse_down` 是电平信号——按住期间每帧为真,于是每帧开一个新窗口(直到 8 个上限)。Dock 之所以没暴露:点已开的应用是"聚焦"(幂等),桌面图标是"打开"(非幂等) | 桌面图标与控制中心改用一次性信号 click_pending |
| 鼠标在虚拟机里灵敏度太高 | main.rs 对相对位移硬编码 ×2(早期在 QEMU 里嫌 PS/2 计数偏小加的补偿,被当成了全局常量) | 默认改回 1:1;倍数交给用户设置(设置中心 →「输入」→ 鼠标速度:慢/标准/快),越界值夹取 25–300 | ||
| 系统颜色发粉 | 浅色令牌是粉调 | 浅色基色全部改中性白(壁纸实测 (254,254,254),R−G=0) |
--all-targets、Linux musl --all-targetspython scripts/archive-ui-shots.py --check 逐像素一致python scripts/repo-stats.py --check 3/3(23,694 行 / 43 文件)- 桌面近黑像素 32% → 0.3%(窗口确实没了)
- 三个桌面图标底座颜色全部命中
- macOS 红/黄/绿三色命中 6 / 0 / 0(红绿灯确实没了;红的 6 像素是抗锯齿噪声)
Alt+Tab 仍会切到已最小化的窗口(应改为恢复或跳过)ServiceControl / AuditQuery / SysInfo 扩权),不做空壳页light_symbol(macOS 圆点符号)保留一个版本周期便于回退,下版删除8fac34b 桌面改版(默认无窗口 + 桌面图标)· c708c37 修"弹出一堆窗口" + Windows 三键 ·
5fa4ee8 鼠标灵敏度 · 0413699 主题可切换 · 74ba996 浅色改纯白 · cee3c82 落地页主视觉改白
# 版本发布说明
>
>
v0.1.0 之后的第一个更新(仍是 prerelease)。相对 v0.1.0 的变化:
55aa):v0.1.0 的资产从未过 isohybrid, 所以 dd 到 U 盘起不来、装不了机 —— 根因是同步工具按字符串前缀跳过了 platform/build-iso.sh,
构建机两周一直在用旧脚本。已修,并有门禁盯着。
rustls 0.23.43 → 0.23.46(RUSTSEC-2026-0285);cargo audit 复验 0 漏洞。/var 写入仍在。校验和与体积见下载页 —— 由发布流程从资产本身算出(这一次实测回下载一致)。
首个公开版本。 可引导 ISO,QEMU / VirtualBox / VMware 三个平台实测开机;可安装到虚拟磁盘后独立引导。
First public release. Bootable ISO verified on QEMU, VirtualBox and VMware. ~~installable to a virtual disk and bootable from it~~ — corrected 2026-10-02: the published ISO is not isohybrid, so disk installation does not work; see the note below.
⚠️ 2026-10-02 更正:上面"可安装到虚拟磁盘后独立引导"对本版本发布的那个 ISO 不成立。
实测该资产(40,327,168 字节 / sha256 7c50f481…)首 512 字节无 MBR 签名,即未经 isohybrid 处理,
不能 dd 到磁盘引导 —— 装机路径会失败。引导与 Live 桌面不受影响。构建脚本已补上 isohybrid 步骤与自检
(platform/build-iso.sh),重新构建后装机才可用。详见 报告/安全审计(SECURITY-AUDIT)-2026-10-02.md 的 H-6。
*Correction (2026-10-02): the disk-install claim does not hold for the ISO shipped with this release —
it was measured to have no MBR signature (not isohybrid), so it cannot be written to a disk and booted.
Booting and the live desktop are unaffected. The build script now applies isohybrid; a rebuilt ISO will
support installation.*
aether-init):服务编排、持久化分区、串口日志、故障自愈。aether-compositor):直接写 framebuffer 的立即模式合成器,自带窗口管理、平铺布局、阴影与圆角、字形缓存、脏行上屏与自适应帧率。
aetherd + aether-ipc):NDJSON 线协议,双通道 —— Unix socket(/run/aetherd.sock,0600,root-only)优先,回环 TCP 作为开发/调试备用。
每一次工具调用都要过权限闸门,L2+ 操作弹确认框。
推理通道支持两种部署:用户自己的网关(客户端 → 自有服务器 → 各家模型),
或直接指向上游端点 —— 后者需要 API Key,它会持久化在 /etc/aether/model.json
(权限 0600,与 ui.key 同级处理)。两种方式都不经过本项目的任何中转服务:
密钥只存在用户自己的机器上。
aetherd 安装 → 在桌面里跑起 htop 3.3.0(Ubuntu 24.04 官方包)。aether-install)自研。scripts/repo-stats.py --check(文档口径)、 cargo test --workspace、musl 静态目标 --all-targets 零警告、
scripts/archive-ui-shots.py --check(界面截图逐像素比对)。