Armadra 0.5.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.

功能版本。中转 https://relay.armadra.com（armadra-cloud 0.3.10）缺省不再要求人机验证。

桌面 / 服务器

• 设置 → 远程访问 → 中转账号可「修改口令」：成功后该账号其他设备下线，本设备保持登录（契约 §63，#265）。
• 人机验证弹窗：修复桌面端空白与闪烁（页面来源 http://127.0.0.1:<端口> 未被允许嵌入）；加载失败只提示一次并可重试；中转不要求验证时不弹窗（#267）。
• Windows：运行产物读取用精确文件号比对，修复祖先目录被 junction 替换时未拒绝（#270）。
• 协议 minor 36。

手机与平板

• 同上：修改中转口令入口。

{"minimumInstalled":"0.1.0"}

Armadra 0.4.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.

功能版本。中转改为部署在 Cloudflare：https://relay.armadra.com（armadra-cloud 0.3.9 起）。

桌面 / 服务器

• 远程服务登录支持 Turnstile 人机验证：中转要求时先弹出验证再提交口令，令牌带 action=armadra-login；challenge_required / challenge_invalid 有明确提示（契约 §62，#258、#260）。
• 服务重命名与服务端默认名：选择服务页与远程访问每行可改名（只存本设备），主机名称可在本机服务设置，中转经 /.well-known 提供 name（迁移 0046，契约 §61，#257）。
• 协议包 0.3.5（平台协议 1.2），协议 minor 35。

手机与平板

• 同上：添加连接时的人机验证与服务改名。

工程

• ESLint 堆上限调高，CI 不再在 lint 时内存溢出（#262）。

{"minimumInstalled":"0.1.0"}

Armadra 0.3.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.

三端统一版本线的第一个版本：桌面、服务器壳与手机 / iPad App 同为 0.3.0（App 此前为独立的 1.1.0）。中转需 armadra-cloud 0.3.0（镜像 ghcr.io/owlbay/armadra-relay:0.3.0）。

桌面 / 服务器

• 分享范围：整台主机 / 工作区 / 会话，可设只读；只读在 core 侧强制，终端输入、画布修改与文件写入一律拒绝（迁移 0045，契约 §60，#252）。
• 账号与共享、设备与会话显示签发来源并按来源分组（#246）。
• Claude Code mod：输入框上方横条（上下文 / 派发对象与待收消息）、消息到达提示、状态栏画布名、设置页显示挂载状态（契约 §58，#249）；/armadra-post、-inbox、-ack、-send、-team、-open、-list 斜杠命令，ACP 会话同样挂载（契约 §59，#248）。
• 协议包 0.3.0 / 平台协议 1.1；协议 minor 33。

手机与平板

• 版本并回统一版本线，构建号继续递增（#247）。
• 分享对话框支持选择范围与只读（随桌面）。

工程

• 版本规则：修订号为缺陷修复、次版本为功能、主版本为特大更新，任一端升级时其他端下次对齐（#247）。
• design-showcase 减少动效检查等画面稳定后再比对（#251）。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.6

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.

多端切换、多中转与附件。手机端版本见 apps/mobile/CHANGELOG.md。中转仍用 armadra-cloud 0.2.1。

改进与修复

• 服务选择页：手机与 iPad 启动先选服务；三端设置与命令面板可「切换服务」，桌面可在新窗口打开另一服务（#240，#229）。
• 一个主机多条到达方式：经多个中转挂同一主机时凭据互不覆盖、切换不再新增设备（迁移 0044，契约 §55，#237）。
• 画布 Agent 粘贴 / 拖入图片与文件：终端上传到会话主机并插入路径；ACP 按能力发送图片与资源附件（契约 §56，#241，Closes #226）。
• 终端在节点外松开鼠标时选区正确结束（#235，Closes #227）。
• Claude Code ≥ 2.1.293 额外挂 armadra-mod：进程内上报状态、状态栏显示节点；低版本与安全模式自动降级（契约 §57，#238，#230）。
• 协议 minor 29；中继心跳用例稳定（#243）。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.5

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.

性能、终端与 CLI 兼容。手机端起改为独立版本线（1.0.0，见 apps/mobile/CHANGELOG.md）。中转仍用 armadra-cloud 0.2.1。

性能

• Runtime 资源采样改为异步加超时、每轮一张进程表，事件循环最长卡顿由 90–237 ms 降到 6–14 ms；新增 GET /api/diagnostics/runtime（契约 §54，#221）。
• 离屏内存采样降频生效；系统内存压力通知页面回收；WebGL 隐藏终端 30 秒后归还名额（#219）。
• 终端分阶段生命周期：平移离屏 60 秒断开显示连接，10 分钟释放前端实例，会话保留；离屏共享调度器与背压（#222）。
• 渲染方式 DOM / WebGL / 自动与缩小时限帧（实验）进「终端外观」（#224）；终端内存探针与基线进夜间检查（#220）。

终端与画布

• 支持 OSC 7501 程序状态与 OSC 9;4 进度（契约 §53，#217）。
• 连线随两端相对位置选边（#213）；小地图收起钮悬停显示、连线按画布样式绘制（#218）。

Agent CLI

• Codex 启动不再出现 hook 信任与内嵌模式两条警告，不写用户配置（#214）。

手机端

• 版本号独立并修正 iOS 版本一直显示 0.2.0；关于页显示 App 与主机版本、协议兼容提示（#225）。

工程

• nightly 修复：打包后 core 关停顺序与超长 socket 路径、iOS 用例、Windows 保活探针（#208、#215）；issue / PR 中英模板与需求流程（#212、#228）。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.4

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.

设置重组、Agent 连线与启动体验。中转仍用 armadra-cloud 0.2.1。

改进与修复

• 设置：弹窗按窗口比例放大不再封顶；导航重组为 8 组，每页标明作用范围（本设备 / 主机 / 账号）；新增「默认」「终端外观」（字体从本机等宽字体选择）；集成并入「Agent CLI」，SSH 与执行主机合为「远程机器」，远程服务与对外服务整合为「远程访问」「设备与会话」；旧入口与深链自动跳转（#202、#205）。
• Agent 连线：上下文线与派发线按类型分色（上下文为专用色，派发取簇色）；所有节点四边各一个连接点；修复界面改主从方向后投递授权不跟随（#200、#204）。
• 布局方向：纵向 / 横向两种（缺省纵向），整理时主 Agent 居中于其子 Agent；小地图按类型与派发簇着色，缩放加 −/+（#200、#204）。
• 删除「新建 Agent」向导；「派生」改为直接建从，从连接点拖到空白处弹出创建菜单（#204）。
• ACP 创建提速：节点出现即可输入，阶段提示，session/new 60 秒超时，菜单打开时预启动（契约 §51，#206）。
• 同时启动多个同类 CLI 时按配置目录排队，失败自动重试一次并可手动重试（契约 §52，#201）。
• 注入只认本产品命名，不再识别旧别名（契约 §13.5，#203）。
• 协议 minor 24。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.3

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.

修复版。

修复

• 集成与启动迁移只认本产品自己写入的 hook、技能目录与指令块；其他工具的注入不再展示、修改或删除，启动迁移不再写用户 HOME，执行主机上的 Worker 不再改 Codex 配置（#198）。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.2

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.

界面与多端体验修整。中转仍用 armadra-cloud 0.2.1。

改进与修复

• 设置 → 集成：每家一张卡片、固定五行；适配器与 CLI 都可一键安装 / 重装 / 恢复上一版本（OpenCode、Oh My Pi、GitHub Copilot、Pi 等），只跑 npm i -g、不写 CLI 配置（契约 §47，#193）。
• 在画布中创建 Agent：按驱动报告可用性，节点菜单「派生 Agent…」；Pi 的 ACP 适配器标为仅终端视图（契约 §48，#193）。
• ACP 会话视图：按协议内容分类展示，复制、编辑后重发、重新生成、停止、看 diff、打开文件、计划、图片与资源链接、/ 命令与用量；会话内可选中、点击，不再拖动画布（契约 §49，#196）。
• 设置弹窗按视口比例；节点头的徽标与按钮常显、样式统一（#192）。
• 画布整理：组、导入批次、白板对象按整块移动，保持原顺序；主 Agent 在左、子 Agent 在右侧等距对齐；可只整理选中，一次撤销；导入两个以上对象自动成组（#194）。
• 多端：新端加入不再让其他端的终端整屏重绘、被压成手机尺寸；身份通知分级，续期不再全量重取；丢失租约只切只读、不重载（#195）。
• CI：runs 编排测试按平台注入、controller 通道先读完请求体再回复（#191）。

{"minimumInstalled":"0.1.0"}

Armadra 0.2.1

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.

个人中转模式补齐。需要配合 armadra-cloud 0.2.1 的中继（镜像 ghcr.io/owlbay/armadra-relay:0.2.1）。

修复与补齐

• iPad 经中转发消息偶发「这一轮没有完成」：中转、云端与 core 的 HTTP 空闲 keep-alive 统一 75 秒；中转限流与预检缓存按真实使用放宽（#184、armadra-cloud#11）。
• Agent 回合对账：提示带 clientTurnId，core 去重；网络失败先确认再判，重连后补读断线期间的回合（契约 §39.9，#185）。
• 远程访问时的设置页：只对本机有效的项隐藏或禁用，不能停用本页正走的连接；中转托管页刷新不丢登录（#186）。
• 手机：推送点开切到对应主机，经中转时显示中转不可用提示，访客令牌不再覆盖主人（#187）。
• 媒体与下载：短期媒体票加 Range，视频音频边下边播，经中转同样可用；图片与文本设大小上限；语言会话断线后持续重连；同一中转上两台源不再共用凭据（契约 §37.4，#188、armadra-cloud#12）。
• 测试：多源探针全部经中转，新增 WebKit 往返探针。

{"minimumInstalled":"0.1.0"}

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

协作与工作流

• 实时协同：core（#32）、页面绑定与在线光标（#50）、评论与提及，Agent 可读评论（#56）。
• 工作流引擎：草案、模板、运行与关卡（#36）；工作流页面、再运行与定时（#65）。

账号与安全

• 身份加固：口令策略、限流锁定、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"}