STATUS
项目现状
从派发、执行到交付,哪些路径实际跑过,哪些仍有限制。依据仓库的验证记录逐项列出。
已验证
- 单机与可信内网三台真机(Orange Pi / MacBook / Windows)按设计使用:一句话进来分成「本地回答 / 派一个任务 / 跨机器的多阶段计划」,不可逆操作停在待审批队列等人批。
- 真实跨网多跳已实测(Mac → 中继 → 云主机),3 MiB 项目树哈希一致。
- main 上有 10 项必过检查;发版覆盖六个平台目标,每周跑一次安全扫描。
- 守护进程空闲时常驻内存约 40MB,几乎不占 CPU。
未做
- UPnP / NAT-PMP 自动端口映射。
- punch / dir 帧的源签名收敛。
- daemon → 面板的 mesh 指标 IPC:面板是独立侧车进程,读不到 daemon 内存里的计数器。
已知限制
- 信任模型与沙箱在 docs/status.md 的「已知限制」里仍有未关闭的 P2 条目。
- /rewind 快照仍在调用方 goroutine 上同步生成。上下文压缩现保留原始消息及轮次;旧版本已经删除的历史无法重建。
- 产物预览的跨节点拉取、文件查看器的符号链接窗口尚未收口。
接下来
v0.1.x 的产品主线是让用户交代任务后,可以在自己管理的设备之间执行、恢复并收回结果。桌面入口与网格改进为这条路径服务,尚未交付的工作不绑定补丁版本号。
参与
提 Issue、开 PR 都欢迎,合并前会跑完 10 项必过检查。从上面任意一条边界挑一个去复现,也是有效的贡献。
平台支持矩阵
六个正式发布目标加 Linux lite 变体;每个目标都有对应的归档与 SHA-256 条目。
| OS | ARCH | 状态 |
|---|---|---|
macOS |
arm64 / amd64 |
正式发布,Apple Silicon 与 Intel Mac |
Linux |
amd64 / arm64 |
正式发布,服务器、桌面与 ARM 开发板 |
Windows |
amd64 / arm64 |
正式发布,PowerShell 5.1 安装器 |
lite-linux |
amd64 / arm64 / armv7 |
无内嵌控制台与 TUI 的轻量变体,面向无头设备 |
源码构建 |
Go ≥ 1.26.11 |
无 CGO;make build 即可,控制台需先 make web |
Windows 专属失败无法在 macOS 上伪装复现;遇到这类问题先按「测试夹具未与平台同步」排查。
验证到什么程度
把「跑通过」和「只在代码里落地」分开写,来源见 docs/status.md 的验证表。
| 检查 | 结论 |
|---|---|
| make gate | 2026-11-13:fmt-check、vet、staticcheck、vuln、build、114 项适配器契约与完整 Go 测试通过;race-focused 覆盖 core / commander / bus / storage / askengine / scheduler / webui-panel |
| make gate-all | 2026-11-13:gate、web-gate 与四个 TUI PTY 契约完整重跑通过(鼠标、退出、Side、任务侧栏) |
| Web typecheck + 单测 + vite build | exit 0(427 个前端测试,2026-11-13) |
| 三设备真机流水线 | 历史真机回归(v0.0.11-preview):macOS ↔ Windows ↔ Linux SBC 跑通多跳委派、硬钉选、两跳流水线、执行中杀节点与断线重连;非本轮重新实测 |
| 跨网项目树回传 | 历史跨网回归:Mac → 中继 → 云主机,3 MiB 项目树哈希一致;非本轮重新实测 |
| 语音链路真机 | 未验:只验了缺驱动时正确报错并退出的降级路径 |
| 原生 Codex 真实调用 | 2026-11-13:官方端点冒烟与真实文件写入/回读 exit 0,产物校验通过;不代表全部服务商或 CLI 都已实测 |
| Web 交付、刷新与首次上手 | 2026-11-13:隔离面板验证记录/停止恢复与交付,桌面和手机亮暗主题复查;48 项站点检查及文档检查通过。只更新源码与本地预览,现有服务和公网官网尚未部署 |
| 发布编译矩阵 | 2026-11-13:固定最终前端资源后,原生、lite 全包、六个系统/架构目标与三个 Linux lite 目标全部编译通过;编译通过不等于各平台本轮真机运行通过 |
质量门禁
main 受分支保护:必须走 PR,必过检查全绿才允许合并,规则里没有绕过名单。
10 项必过检查
PR 阶段并行跑 lint、test、race、web、适配器契约、TUI PTY 与跨平台矩阵;推 main 之后还有一轮发版门禁。
竞态检测
内核是并发系统,go test -race 的发现按发布阻断项处理,不是警告;核心包尽量保持约 60% 以上覆盖率。
安全扫描
每周一跑一次 security.yml,另可手动触发;govulncheck 长期变红时先查工具链有没有新的补丁版本。
契约测试
适配器线协议由假 CLI 断言 argv、环境、进度与超时;四条 TUI PTY 契约覆盖鼠标、退出、侧边对话和任务侧栏。
发版顺序是硬约束:先推 main,等该 SHA 的发版门禁全绿,再打 tag。给 feature 分支打 tag 不会触发发版管线。