Repository navigation
Armadra 0.2.0
Not notarised/signed for: macOS, Windows, Linux (GPG), component packages (no signing key), desktop updater packages (no release signing key). The operating system will warn on first install.
0.1.0 之后的第一个版本。0.1.0 是 Tauri 壳加 Rust Runtime / Go Host;0.2.0 起只剩一份 TypeScript core,由 Electron 桌面壳与无窗口服务器壳装配,页面仍是同一份。
兼容性
minimumInstalled仍为 0.1.0:迁移只新增(0001–0013 与 0.1.0 逐字节相同,新增到 0041),0.1.0 的数据库可以直接升上来。- 随桌面壳打包的
@armadra/agent为 0.6.8,宿主 API 版本 1。 GET /api/agents的行不再有启动兼容字段launchWords/launchArgs(从没有公开版本带过旧启动格式),页面只经launcher拼行。- ACP 入口实测通过的版本:claude-agent-acp 0.85.1 起、pi-acp 0.0.34 起;其余五家(codex-acp、opencode、omp、copilot、ama)还没有真跑记录。
架构与壳(#5–#13)
- 桌面壳换成 Electron;Runtime 与 Host 合并为 Electron-free 的 TypeScript core(
apps/desktop/src/core/),新增无窗口的服务器壳apps/server。 - 远端执行主机:SSH 终端里的 Agent 拿到画布注入,远端的 Git 长操作、文件监听、语言服务、资源采样与交接都经执行主机上的 Worker。
- 节能休眠:空闲的 Agent 会话结束以释放内存,聚焦、投递或计划冷启动时用 CLI 自己的 resume 接回。
canvas team一次组一队 Agent;open-agent/ 成员可各带一条 worktree。- 浏览器节点的 Agent 工具补强(无障碍快照、hover / drag / fill / pdf、多选、穿 shadow root、整页截图)。
- 成员权限:组管理员管自己的组,只读共享、写租约与接管按权限判。
- Hook、技能与画布说明只在画布启动时注入,不再写全局配置;Gemini CLI 退役。
- CLI 协作第一部分:投递前的画面门、通信与共享上下文。
画布启动器(#14–#19)
- 启动行统一经
run/<cli>启动器与委托垫片拼出,节点终端只带垫片 PATH;/api/agents答launcher。 - Codex 改用会话旗标,不再写信任记录;迁移 v2 清掉旧信任记录。
- Windows 启动器
armadra-launch.exe。
Agent 与 ACP
- ACP 传输与适配器表(#29),会话视图页面(#37),ACP 作为同一节点的另一种驱动、与终端共用行 / 代次 / 租约 / 休眠(#51)。
- 第七个内置 Agent ama 与宿主适配器(#35);
@armadra/agent升到 0.6.5(ACP 会话带画布 MCP,#52)与 0.6.7(宿主注入的 runner,ama 可以给 ama 派任务,#71)。 armadra-hook mcp:stdio MCP,工具表与armadra-hook canvas一致(#44)。- 画面门补齐,计划投递也经过它;未登记的选择菜单一律拦下(#38)。
- 节点凭据:多账号第二阶段,启动器按需兑换,节点 shell 里只有引用(#30)。
HostApi.runners与wait动词(#63);输出到画板与新建 Agent 向导(#48)。- Agent 权限角色:operator 驱动与审批自己起的终端,ACP 与工作流按对象落到画布(#64)。
- 跨主机交接与 Worker 舰队(#42)。
协作与工作流
账号与安全
- 身份加固:口令策略、限流锁定、passkey、TOTP(#34);安全页面:会话 / 设备、MFA、审计、两步登录(#61)。
- OAuth / OIDC / SSO:GitHub 与通用 OIDC(#39)。
- 安全收尾:泄露口令检查、公网加固、安全审查(#73)。
- 出站地址表与用量端点政策(#40);密钥后端按平台补齐(#25)。
- 同浏览器多窗口不再互相作废 CSRF(#58)。
- 桌面壳不再放行回环匿名请求(安全审查 L9,#114 与 G5-28):core 回环监听上的每一条
/api/与每一条 WebSocket 都要会话,本机别的回环端口上的网页与不带凭据的本机进程一律 401。桌面页面的请求带票据换来的 Bearer、流先换一次性票,托盘用自己的会话;只有设了ARMADRA_LOOPBACK_OWNER=1的裸 core(探针、armadra.sh run web)照旧放行。 - 依赖安全告警修复:undici、brace-expansion、ip-address、hono、fast-uri、dompurify(#46)。
Gateway、推送与手机
- Gateway core:本地 CA、配对载荷、Bearer 模式与
/api/gateway(#31);桌面 Gateway 设置页与配对(#47)。 - 推送 core:Web Push、APNs / FCM 直连与端到端加密中继(#33)。
- 移动网页连接页与手机细节(#62);Capacitor 手机壳:iOS / Android 原生端,钥匙串、指纹钉扎、扫码、推送解密、深链(#68)。
平台、发布与运维
- 签名、公证与自动更新端到端;本地构建不自动更新(#53)。更新链路修正与通道(#41)。
- 服务器部署:镜像、内建 ACME、公网部署指南、备份与升级(#54);服务端性能基线与执行主机舰队视图(#55)。
- Linux 打包验证与夜间冒烟(#57);Windows 真机验收包与启动器凭据兑换(#66)。
- 分发渠道与第三方声明(#67);可选崩溃上报(#59)。
- 界面:设计系统 token 与基础件(#24)、设计展示页(#43)、存量界面两轮套用(#49、#72)。
个人中转与远程服务(#131–#181)
- 个人中转:桌面与服务器壳经出站隧道登记到自建中转(自签 TLS 加指纹钉扎、账号口令登录),手机与浏览器经中转访问同一台主机;中转托管页面(#143、#148、#152、#169、#170)。
- 客户端源表与「远程服务」设置页:添加、登录、分享本机,侧栏按源分组并可拖动排序;地址错误给出具体提示(#138、#144、#171、#181)。
- 分享链接:可多次使用、就地可见、复制、撤销与改备注;桌面系统分享菜单(#145、#149、#175、#181)。
- 页面多源:一个标签页同时挂多台主机,查询与 store 按源区分,切源不串,中转停了单独提示;手机多连接与扫码挂载(#139、#141、#142、#178)。
- 安装包带服务器壳,
Armadra serve无窗口启动(#157);单实例锁、撤销时清理中转侧记录(#154)。
接口与契约(#136–#182)
- 全部域迁到 oRPC 契约(§34–§43),旧路径保留并由对偶测试核对逐字节一致;控制面 WebSocket
/api/ws,语言会话保持独立连接(§35.6);错误码注册表补齐(#136、#146、#147、#150、#151、#153、#155、#158–#162、#164、#182)。
其他修复(#115–#182)
- 回环请求全部要会话(#116、#117);GitLab / Gitea 补齐:子组、变基、合并方式与检查通过后合并(#115、#118、#179)。
- 新建 Agent 只选 Agent 即创建,目录跟画布走(#122、#168);ACP 适配器安装与重装入口(#173)。
- 钥匙串长密钥被截断导致远程服务登录 500(#172);「谁读过我」清单为空(#156);资源抽屉显示不全(#124)。
- iPad 状态栏、窗口控件与浮层按安全区让开(#174、#180);下载改为流式、浏览器画面背压(#180)。
工程
- 共享层、core 骨架与契约节(#22、#23、#27);CI 端到端分档、每条一个清单文件(#26、#57);本地 dev-stack(#28)。
- 真 CLI 端到端 C 档探针与运行手册(#70);探针一律用临时 HOME(#69)。
- 端到端稳定性修复(#45、#60、#74)。
- macOS 上无头 Chromium 关掉 GPU,修掉 CI 虚拟机里浏览器偶发整体冻住;CDP 线路追踪与卡住时的现场采集;update-e2e 进程树清理(#76)。
- 真 CLI 端到端探针:Claude / Codex 前提改为可选、
--preflight/--setup-only、TUI / ACP 只跑选中的家、信任对话框等选项画出再答;实跑通过 claude-agent-acp 0.85.1 与 pi-acp 0.0.34,记入兼容表(#77)。
已知限制
- 证书与发布源要由维护者提供;没有时发布按「未签名」处理,系统首次安装会警告。
- 手机壳不随本版上架商店。
{"minimumInstalled":"0.1.0"}