更新日志¶
v5.8.2(2026-08-29)——计划状态不再越级,WorkBuddy 客户端支持¶
主要变更¶
- 计划状态同步不再越级推进任务:
syncPlanWithIterationOutcome不再在每次 sync 时调用markPlanTaskInProgress。当子代理运行时上报成功但缺少显式 task id 时,下一个 pending 任务会被强制置为in_progress;现在 sync 只记录证据,并仅在收到显式taskId时才行动,in_progress完全由 harness loop 持有。死代码hasCommitEvidence辅助函数已删除,hasTargetFileChanges的绝对/相对路径匹配也已修复。 - WorkBuddy 现在是头等 AIOS 客户端:原生工作流/技能生成、写入
~/.workbuddy/mcp.json的 MCP 配置、完整的 24/24 技能同步,以及通过内置codebuddyCLI 驱动的 solo-harness 已全部接好。aios harness run --provider workbuddy可解析出该 provider 并运行。
升级说明¶
- 使用
aios update更新,无需配置迁移。 codebuddy二进制默认不在 PATH 中;请将export PATH="/Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/cli/bin:$PATH"加入你的 shell 配置并重启客户端。
v5.8.1(2026-08-26)——LLM 语义判断的需求澄清与 aios-shell 卡死修复¶
主要变更¶
- aios-shell MCP 长命令不再卡死:shell server 与 stdio proxy 现在并发处理 JSON-RPC——命令执行期间 ping、取消和其它请求仍即时响应。
notifications/cancelled按 requestId 立即终止在途命令而不是等超时;Windows 下用taskkill /T /F清理整棵进程树;stdin 关闭时清理所有在途命令。 - 保留 aios-shell 代理链路:
aios-mcp-proxy.mjs仍提供_meta.aios观测元数据与本地 ref 存储;RTK/Caveman 仍是客户端侧唯一输出压缩。SHELL_TOOL.description中过时的 "compression via AIOS MCP proxy" 承诺已移除(代理原样转发输出,不压缩)。 - MCP server 启动超时兜底:生成的 Codex
config.tomlserver 段带startup_timeout_sec(60/30/30);OpenCodeopencode.json迁移时缺失则注入experimental.mcp_timeout: 90000。 - 需求澄清改为 LLM 语义判断触发(去掉正则):旧正则(
MISSING_REQUIREMENTS_PATTERN/VAGUE_BEHAVIOR_PATTERN/VAGUE_GOAL_PATTERN)只能命中显式措辞,识别不了语义层模糊——点名具体功能但缺验收标准、范围或成功标准。现在derive-facts.mjs不再从措辞生产ACCEPTANCE_CRITERIA_MISSING;requirementsCapability.activate()仅由grill/specintent 或领域词汇歧义 observation 触发。rex-requirements技能重写为执行期内嵌问询:一次一题、带推荐答案、3 轮收敛,遇到真正决策点才问——不是开头的前置审问会。description 双触发:LLM 可自助判断模糊请求触发,rex-harness 也可激活。 - 阶段边界插入:
advanceSoftwareWorkflow在每个 Capability 完成后重新选择,delivery 中途遇到决策点可在下个阶段边界插入需求澄清,澄清完成后继续原 Capability。
升级说明¶
- 使用
aios update更新,无需配置迁移。 - 更新后重启 opencode/codex 客户端,让新的 shell server 与代理生效。
rex-code-review新增场景化子代理验收模式(正常/边界/异常场景矩阵 + 证据回收);见references/acceptance-scenario-matrix.md。
v5.8.0(2026-08-22)——受治理的自我迭代与 Memo 触发链修复¶
主要变更¶
- session 结束时自动生成幂等、可审核的 memory candidate;候选不会直接进入 active shared recall。
- 新增 manual、5 个候选阈值和 24 小时 cooldown 三种 evolution trigger;
aios evolution status会解释为什么触发或没有触发。 - 新增 schema、provenance、安全、scope、baseHash、replay、holdout、回归指标、memory conflict 和 trusted core 验收门禁。
- 新增 candidate 到 canary、active、stable 的版本化晋级状态、审计事件和回滚。
- 新增 patch/minor/major、channel、安全更新、任务占用和通知去重的版本更新提醒。
- Solo session 新增 owner PID/heartbeat、每轮 started/completed 标记、SIGINT/SIGTERM 优雅停止和启动时 crash/stale-running 对账。
升级说明¶
- 使用
aios update --check查看兼容更新。 - 使用
aios evolution status查看候选和 consolidation 状态。 - 现有 memo 数据无需迁移;新的 session close 候选从后续会话退出开始生成。
v5.6.1(2026-08-12)——aios work:计划驱动的多 Agent 调度¶
主要变更¶
aios work现在从活动结构化计划分解并发工作项:合格计划任务变成带依赖、路径归属(targets+allowedWrites)和验收标准的工作项。;分隔的--context仍是无计划场景的回退路径。- 调度后报告保留计划驱动分解,顶层
workItems始终与实际执行的调度计划一致。 - 新增规范
aios-work-dispatch技能:何时进入并行调度(planned disposition、至少两个独立项、文件归属不重叠、无严格顺序)、如何表达分解、以及预览/批准边界。aios-workflow-router把可并行的计划型工作路由到调度技能。
升级说明¶
- 用
aios update更新。无需配置迁移。如果移动项目或安装目录后 MCP 服务器显示"连接关闭",在新项目根目录重跑aios update或aios internal browser mcp-migrate,然后重启客户端(见故障排查)。
v5.6.0(2026-08-11)——aios work:一条命令并行多 Agent 调度¶
主要变更¶
- 新增
aios work命令:统一的规划 + 并发多 Agent 调度入口——planner、implementer、reviewer、security-reviewer 以有界并行(默认并发 3)执行并经 merge gate 收口,live 默认开启。 --dry-run零成本预览 DAG 与工作项;--serial强制并发 1 处理耦合任务;--client/--concurrency调整 subagent 运行时;--session/--resume --retry-blocked复用既有调度状态。- 复用既有编排引擎与全部安全门(preflight readiness、capability guard、owned-path file policy、merge gate);按阶段模型路由默认保持开启。
升级说明¶
- 用
aios update更新。无需配置迁移;aios team与aios orchestrate行为不变。
v5.4.4(2026-08-06)— Agent 冒烟检测可靠性:输出契约客户端与超时自动升级¶
主要变更¶
agents smoke --live不再因走 JSON 输出契约的客户端(如 Codex)而失败。探测 prompt 现在显式覆写契约为纯 ACK 标记,ACK 检测兼容 JSON 包裹的回复,post-receive 压缩证明只对达到minRawBytes的输出生效(短输出按设计内联),空压缩 refs 不再导致证据记录崩溃。- 硬编码的 30 秒探测超时替换为
AIOS_AGENT_SMOKE_TIMEOUT_MS与agents smoke --timeout-ms <ms>(默认提升至 60 秒)。 - 探测遇到瞬时慢响应会自动重试并升级超时(60s → 120s → 240s),全部耗尽才判定 blocked——一次慢客户端冷启动或模型排队延迟不再让 Agent 永久失去工作流启用状态。最终 blocker 信息自带恢复命令。
升级说明¶
- 已安装用户可直接
aios update升级。如果你此前遇到过"command 无效 / workflow 卡死"(Agent 因 live smoke 证据漂移被 blocked),重新执行aios agents smoke --live --client <名字> --timeout-ms <ms>重新生成 v2 证据即可,无需数据迁移。
v5.4.3(2026-08-06)— CRG 决策检查点与 Worker Journal 改名¶
主要变更¶
- 工作流层接入 CRG(code-review-graph)决策检查点:
aios-workflow-router与rex-workflow在动手前调用get_minimal_context、改文件前调用get_impact_radius+query_graph(tests_for)、查代码优先semantic_search_nodes/query_graph、每个阶段结束后调用detect_changes。CRG 不可用时降级为rg+ 读文件,不阻塞流程。 aios init新增--yes/--retry/--force选项,并由新的install-state模块支撑,setup/update 具备幂等性(从未安装的组件恢复,或强制全新重装)。- solo harness 日志目录从
solo-harness更名为worker-journal;会话产物现在位于artifacts/worker-journal/。旧的solo-harness目录在首次读取时自动迁移,solo worktree 临时前缀同步跟随新名。 - 客户端提示面(AGENTS.md / CLAUDE.md / GEMINI.md)同步 CRG 工作流章节。
升级说明¶
- 已安装用户可直接
aios update升级。旧solo-harness会话目录自动迁移,无需手动操作。
v5.4.2(2026-08-05)— 本地 Browser MCP 作为唯一浏览器入口¶
主要变更¶
- 从浏览器 MCP 的选择、安装、迁移与生命周期恢复中移除已退役的
ai-browser-book/AIOS_BROWSER_USE_REPO运行时依赖。 - 仓库内 Node/Playwright MCP(
scripts/run-local-browser-mcp.mjs)成为唯一浏览器 MCP 入口,带完整 dist 校验与 source/tsx 回退。 - 浏览器安装现在会安装本地 MCP 依赖、Playwright Chromium、构建 MCP 服务、迁移客户端配置,并通过
browser_health暴露运行时就绪检查。 - 新增跨平台浏览器 MCP 回归覆盖、Hermes 迁移覆盖,以及 GitHub release 工作流中本地浏览器安装路径的检查。
v5.4.1(2026-08-02)— Windows 运行时自更新安全修复¶
主要变更¶
aios update自更新在 Windows release 安装上现在是安全的。之前从安装目录内运行更新时,进程工作目录停留在安装器需要删除的目录中;Windows 无法删除被进程 cwd 占用的目录,删除静默失败,新版本被嵌套到<install>/aios/,导致后续更新以MODULE_NOT_FOUND失败。- 更新器现在会在运行 release 安装器之前把工作目录移出安装树;安装器会验证旧目录确实被删除(失败时显式报错,而不是继续嵌套安装);更新后的重执行会检查入口点,替换出错时输出清晰的修复指引。
- 更新器优先使用本地
scripts/aios-install.ps1执行 release-installer 更新,防御性安装器修复立即生效,不再依赖远程拉取。 - 移除了遗留的未跟踪
agent-sources/skills/目录(此前已删除 gitlink),该目录导致 token-discipline 同步测试失败。
升级说明¶
- 已安装用户安装本版本后即可用
aios update正常更新;修复本身包含在发布资产中。
v5.4.0(2026-08-01)— 工作流迭代 v2.1:Activation 安全与类型化 Evidence 契约¶
主要变更¶
- Rex activation store 改为写前事务机制(
.aios/workflow-activations/transactions/):Workflow 与 Activation 投影原子落盘,重启自动 roll-forward 残留事务,读取时校验两者一致性,不一致 fail-closed(stale-activation-projection)。 - 新增 store 文件锁序列化 Command token 推进:并发调用返回
AIOS_REX_STORE_BUSY,防止同一 token 被双重消费。 - 新增 Wayfinder Artifact 类型 schema(
wayfinder-artifact.mjs):Navigation Map、Decision Graph、Decision Ticket、Next Slice 结构验证;partial/blocked 状态不得声明 Ticket 或 Next Slice。 - 新增 Planning Artifact 类型 schema(
planning-artifact.mjs):Frontier ready/blocked 互斥无重叠、Parallel Group 跨组唯一性、Convergence Gate、Runtime Artifact Contract 校验。 - 新增
normalizeEvidenceRefs():evidence ref 必须带协议前缀(artifact:、receipt:等),拒绝 TODO/TBD/placeholder;覆盖 Wayfinder、Planning、Requirements 全部产物。 - Client projection 中断备份恢复前重新校验 marker digest 是否在
projection-history.json受管历史中,防止伪造 junction 被提升(interrupted-backup-untrusted)。 - Plan evidence mirror(
syncEvidenceToMatchingPlan)失败时改为返回结构化planEvidence.status = 'failed',保留已提交 Rex 状态可见。 - AIOS MCP server 新增
wayfinderArtifact/planningArtifact工具参数。 - S1–S5 全批次 13 个 canonical Skill 完成 SkillOpt eval 更新,digest 追加至
projection-history.json。
可用性边界¶
- 本版本涉及的 typed artifact schema 仅在 rex runtime 内部校验;现有
.aios/workflow-activations/状态向后兼容,无需迁移。 - Evidence ref 协议前缀校验从本版本提交起对新 evidence 生效;历史已存储的 ref 不会被追溯性拒绝。
v5.3.0(2026-07-30)— Context Lifecycle 安全与兼容性¶
破坏性变更¶
- 下次显式写入计划时,结构化计划会升级为 schema v3;旧运行时无法读取升级后的计划状态。
- Session close 改为写入可审查的 memo candidate sidecar,不再自动发布 shared memo。
- 在具备可信 broker 与并发控制 authority 前,Dream approve、reject、archive、restore 与 GC 均返回 DENY receipt;Dream apply 仍仅产生 proposal。
可用性边界¶
- Context Lifecycle V1 仅以 S0-S2 observe/shadow instrumentation 发布;本版本未启用或宣称 selective enforcement、opt-in pilot 或默认 hard enforcement。
- Context proposal 必须经人工显式确认。未确认 targets 或 context 的计划可能投递零个 execution-context unit;本版本不承诺开箱即用的上下文智能。
v5.0.0(2026-07-20)— Rex-only 工作流迁移¶
rex-harness是新 AIOS 安装和托管客户端投影的唯一默认软件工程工作流;Superpowers 已从 AIOS 工作流和安装组件中退役。- 普通的
aios update、aios init或aios setup会收敛 Rex,但会保留缺少 AIOS 所属证明的旧 Superpowers 投影并报告 conflict。 - 仅在需要清理经精确识别的 AIOS 旧链接时使用
aios update --adopt-legacy-superpowers --dry-run,确认后再执行 adopt。覆盖 Codex、Claude、Gemini、OpenCode、Hermes、Grok 和共享.agents投影。 - 变更 skill 时使用
skill certify --changed生成已纳入版本控制、可复算的证据;发布门会重新执行确定性探针,不会只信任状态文件或内容 hash。
v4.0.1(2026-07-14)— 公共内容与 SEO/GEO 覆盖¶
- 同步文档版本徽标、根目录
VERSION、GitHub Release 与公开更新日志,使它们统一指向4.0.1。 - 补齐当前 AIOS 工作流、发布导航以及更适合搜索和 AI 答案引擎理解的公开文档与博客内容。
v4.0.0(2026-07-14)— 自适应工作流策略¶
- 新增
noop、direct、guarded、planned自适应路由,为不同请求选择合适的工程流程。 - 补充持久化计划、编辑安全门和基于证据的验证说明,覆盖多步骤 AI Agent 工作。
- 阅读发布文章:v4.0 自适应工作流策略。
文档与工作流说明¶
- v3.6.0 Headroom token 智能工作流:
aios init现会与 RTK、Caveman 一起安装经过测试范围的 Headroom;Gemini/Grok 的用户级 MCP 注册需单独传--yes-headroom-mcp授权。Hermes 必须在真实 TTY 中完成,否则显示pending-interactive。已有外部或冲突条目不会被覆盖,AIOS-owned 条目记录在~/.aios/integrations/headroom-mcp.json。MCP-only 是显式按需压缩,不是透明输入拦截。详见:Token 智能与压缩 与 Headroom + Ponytail 博文。 - 已把 agent 治理说明补到 Team 文档、按场景指南、ContextDB 参考页和博客中。
- 新的 smoke 证据说明会指向
.aios/agents/smoke/<agent>.json、.aios/agents/provenance/<agent>.json和.aios/interception/metrics/agents-smoke-<agent>.jsonl。 - skill 修改后的 live 使用前,请先运行
node scripts/aios.mjs skill verify-training --changed --base HEAD --json。 - Memo 陈旧锁修复:
aios memo storage repair-locks只隔离已确认记录 owner PID 死亡的锁;活动锁和格式错误的锁文件保持不变。 - Grok Build 成为 AIOS 一等公民客户端:xAI Grok Build(
grok/ runtime idgrok-build)现已支持 skills、agents、native、team、harness。MCP 使用 Codex 形态 TOML(~/.grok/config.toml)。详见:Grok Build + AIOS 博客。 - Hermes Agent 成为 AIOS 一等公民客户端:Hermes(Nous Research)具备 skills、native、harness。详见:Hermes Agent + AIOS 博客文章。
v3.6.0(2026-07-10)— Headroom + Ponytail Token 智能工作流¶
新增¶
- 在隔离的
uv tool或pipx环境中检测并安装headroom-ai[all]>=0.31.0,<0.32.0;要求 Python 3.10+。 - 新增
--yes-headroom-mcp,让无人值守的包安装授权与 MCP 用户配置授权保持独立。 - Gemini CLI、Grok Build、Hermes Agent 通过自己的官方 MCP 命令注册
headroom mcp serve;Hermes 无真实 TTY 时保留为pending-interactive。
安全与兼容¶
- AIOS-owned MCP 注册指纹写入
~/.aios/integrations/headroom-mcp.json;外部或冲突条目保持不动。 - 明确
headroom_compress、headroom_retrieve、headroom_stats是模型显式调用的按需压缩,不是当前请求的透明拦截。 - 文档区分 RTK、Caveman、ContextDB、Headroom 与 Ponytail 启发的最小正确改动门禁。
v3.4.0(2026-07-09)— Grok Build 一等公民客户端¶
- 注册
grok/grok-build,完整能力集(含 team + harness) - 项目 skills/agents:
.grok/skills、.grok/agents;指令文件共用AGENTS.md - 无人值守:
grok --always-approve -p "..." - 官方文档、更新日志与多语言博客已同步
v3.3.0(2026-07-02)— 废弃原生拦截运行时,全自动安装 RTK + Caveman¶
Breaking Change:AIOS 原生拦截运行时废弃¶
AIOS 原生 token 拦截运行时(scripts/aios-mcp-proxy.mjs、scripts/aios-intercept.mjs、config/aios-interception.json)已标记为 deprecated。代码保留但不再积极维护。
替代方案是社区维护的工具:
- RTK (https://github.com/rtk-ai/rtk) — Rust CLI 代理,压缩命令输出 60-90%。单二进制,<10ms 开销,100+ 支持命令。本地运行,无外部服务。
- Caveman (https://github.com/JuliusBrussee/caveman) — Claude Code skill,压缩 agent 输出 token ~75%。保持技术准确性,仅压缩表述风格。本地 prompt skill。
新功能:全自动安装¶
aios init 现在自动检测并安装 RTK + Caveman:
# 交互式安装(用户确认后全自动)
node scripts/aios.mjs init --all
# CI/无人值守(跳过确认)
node scripts/aios.mjs init --all --yes-compression-tools
# 仅检测不安装
node scripts/aios.mjs init --dry-run
安装流程:检测 → 用户确认 → 下载安装 → 验证 → PATH 配置 → rtk init -g 客户端初始化。
平台支持:macOS (brew)、Linux/WSL (install.sh)、Windows (PowerShell zip 下载 + 自动 PATH 配置)。
删除的策略¶
bidirectional-turn-compression强制策略全部删除pre_send/post_receive压缩验证要求删除uncontrolled_host_output策略违规标记删除- "Do not install RTK, Caveman" 禁令删除
迁移指南¶
- 运行
aios init安装 RTK + Caveman - 旧的
scripts/aios-mcp-proxy.mjs不需要删除,但不再维护 - 旧配置
config/aios-interception.json不再被读取 - 重启 AI 客户端激活 RTK hook/plugin
- 在 Claude Code 中输入
/caveman激活 Caveman
v3.2.0(2026-07-01)— Harness 可靠性与技能生命周期升级¶
Harness Solo Runtime¶
- consecutiveFailures 自动中止:
backoff.mjs新增双计数器(consecutiveFailures+consecutiveInfraFailures)。连续 5 次非成功 outcome 后自动 abort session,不再无限重试浪费 token。 - Emergency 压缩第三级:
mermaid-canvas.mjs在 mild(20 节点)/ aggressive(50 节点)之上新增 emergency 级别(100 节点触发),仅保留 5 个最近节点,防止 canvas 溢出。 - Dry-run Readiness 预检:新增
dry-run-readiness.mjs,在 harness 启动前检查 4 个维度(ContextDB、Git、Provider、Session)。blocked级别直接阻止启动。
Runtime Directive 系统¶
- Directive 注入:新增
directive-inject.mjs,从.aios/config.json读取default_mode,将对应的systemPromptAdditions注入每轮 harness 迭代 prompt。支持 3 个内置预设和自定义mode_presets。
Auto-Dream(Phase A:手动)¶
- 手动记忆整理 CLI:
scripts/lib/memo/autodream.mjs提供--preview(预览)和--apply(执行)模式,封装已有的 taxonomy + 去重 + TTL 过期管道。
Skill Workshop¶
- Stale 检测:apply 前比对目标
SKILL.md的文件系统 hash 与 lock 中的computedHash,不一致则拒绝 apply,防止覆盖用户手动修改。 - 文件级 rollback:apply 前将完整
SKILL.md内容存入lock.rollbackSnapshot.previousContent,rollback 时恢复实际文件内容。
验证¶
全部改动通过 37/37 单元 + 集成测试。
详见:v3.2.0 发布文章。
v3.1.0(2026-06-30)— Hermes Agent 一等公民客户端集成¶
- Hermes Agent 注册为第 7 个 AIOS 一等公民客户端:具备 skills、native、harness、superpowers 全部能力。
- MCP 桥接服务器:
scripts/aios-mcp-server.mjs在 Hermes 会话内暴露 5 个 AIOS 工具(aios_context_pack、aios_doctor_suite、aios_intercept_compress、aios_skill_validate、aios_skill_install)。 - Native emitter + MCP target:AGENTS.md 输出 + JSON stdio(
.mcp.json+config.yamlscopes)。 - 多语言文档覆盖(英/中/日/韩)。
- 详见:Hermes Agent + AIOS 博客文章。
v2.0.2(2026-06-15)¶
- 技能健康记录校验:
recordSkillObservation()现在会拒绝未知 status,不再把生产端拼写错误静默落成 failure,避免污染失败率统计。 - Help 优先解析:
aios skill ... --help与aios session ... --help会先展示用法,再执行必填位置参数校验。 - Crush 配置卫生:
.crush.json与crush.json不再由仓库跟踪;本地 Crush 配置仍可生成/读取,但会被 git 忽略。 - 详情参见:v2.0.2 发布文章。
v2.0.1(2026-06-13)¶
- Browser MCP alias 迁移:修复 legacy alias 兼容路径,同时保持默认 browser-use runtime 稳定。
v2.0.0(2026-06-12)¶
- 拉取式运行时上下文:移除自动 ContextDB prompt 注入和 startup-mode 注入,agent 只在需要时读取运行时上下文。
v1.52.0(2026-06-11)¶
- aios_shell MCP 工具:通过
aios-shellMCP 别名实现跨所有客户端的确定性 shell 输出压缩。shell 命令通过scripts/shell-mcp-server.mjs执行,输出由 MCP proxy 自动压缩,压缩率超过 99%。 - 三层拦截防线:MCP 工具(全客户端)→ shim+hook(Claude/全客户端)→ 提示词引导。无单点故障。
- Shim 自愈:原生 shim 探测 4 条回退路径(
AIOS_ROOT_DIR→ baked root →~/.rexcil/aios→~/cool.cnb/rex-ai-boot),全部失败后 fail-open 执行真实客户端。 - 敏感命令守卫:
git push和npm publish在执行前被拦截,需宿主权限审查。 - aios-shell 注册到全客户端配置:通过
doctor --fix注册到.mcp.json、.codex/config.toml、.gemini/settings.json、opencode.json、crush.json。 - 详情参见:v1.52.0 博客文章。
v1.51.0(2026-06-10)¶
- Crush smoke 验证:将 Crush(charmbracelet)加入 pending-smoke 门控,强化 live execution 拦截。
- Native strict 模式升级:
clients doctor --native-strict现在验证受管 shim 背后是否存在真实下游客户端。
v1.50.1(2026-06-05)¶
- 全客户端 turn compression 合规:所有 AIOS 托管客户端/宿主共享
bidirectional-turn-compression指标,并强制记录pre_send与post_receive。 - 绕过不再冒充省 token:未经过 AIOS-managed runner 的 direct host output 会记录为
policy-violation/non_compliant,且saved_bytes=0。 - Proof 矩阵:
node scripts/aios.mjs interception proof --json和doctor --json输出 Codex、Claude、Gemini、Antigravity、OpenCode、Crush、Cursor、aios-harness、generic-mcp的turn_compression_matrix。 - 技能训练证据:
aios-interception-runtime已通过 SkillOpt-Lite 训练,产物位于.skillopt/aios-interception-runtime-2026-06-05。 - 发布教程:阅读 v1.50.1 token 压缩合规文章 和 Token 智能与压缩。
v1.50.0(2026-06-04)¶
- 统一 AIOS 搜索:
node scripts/aios.mjs search "<query>"可以一次搜索项目记忆、pinned memo、文档、计划和代码。 - 跨客户端记忆安全:
project_shared对所有客户端可见;agent_private只有匹配--agent <runtime-client-id>时可见。 - 全客户端 native 指令:Codex/OpenCode/Crush 通过
AGENTS.md,Claude 通过CLAUDE.md,Gemini/Antigravity 通过GEMINI.md接收同一套 search 指令。 - 发布教程:阅读 v1.50.0 统一搜索教程 和 ContextDB。
本页用于追踪 AIOS 的版本变化,并快速跳转到相关文档。
官方发布记录¶
⭐ 在 GitHub 上 Star 📦 查看 Releases
最新稳定版¶
1.17.0(2026-05-16):- Memo Storage:
aios memo现在使用 storage 抽象,公开实现只有file(默认 append-only JSONL:.aios/memo/file/events.jsonl)和split(每条 memo 一个 JSON 文件)。通过aios memo storage status、aios memo storage use split、aios memo storage use file、aios memo storage rebuild和aios memo storage doctor管理。 - 适合 Git 共享的 memo 源数据:
.aios/memo/是项目 memo 的规范根目录。ContextDB/SQLite 只保留兼容镜像和可重建缓存角色,不再是 memo source of truth。 - 运行时状态对齐:新的 ContextDB 运行时状态写入
.aios/context-db/;legacymemory/context-db仅在已存在时作为兼容读路径。 -
详见 ContextDB 中的 memo 存储边界。
-
1.13.0(2026-05-15): - Context Registry(拉取式上下文):用 ~350 字节的 registry 指针替代每次 ~30KB 的推送式注入。Agent 读取
.aios/context-db/index.json后按需加载上下文。启动从 ~5 分钟降到近乎即时。 aios init:一条命令初始化全部四种 coding agent(Claude Code、Codex CLI、Gemini CLI、OpenCode)。自动检测已安装的 agent,写入 registry 标记到配置文件,配置 save guard hooks。幂等操作。- 多客户端 native sync 修复:Gemini 现在写入
GEMINI.md(Gemini CLI 实际读取的文件)。OpenCode 直接读取AGENTS.md(无需单独文件)。旧的.gemini/AIOS.md和.opencode/AIOS.md已标记废弃。 --context-mode slim:Team/harness 路由和包装后的 agent 在检测到 registry 标记时自动使用 slim 注入。未包装的 agent 回退到完整注入。-
详见 ContextDB。
-
1.11.0(2026-05-09): -
debug-hub v0.3:注入追踪与自动清理。新增 MCP 工具:
instrument、list_instruments、cleanup_instruments。标记约定DH:<sessionId>实现零依赖调试代码注入与双模清理(显式通过 instrument 记录,回退通过 workspace grep)。支持dryRun安全预览。跨模型调试协议通过 workspace memory 共享。用 debug-hub skill 替换上游 debug skill。详见 debug-hub。 -
1.10.0(2026-05-09): -
debug-hub v0.2:新增自动 Trace 物化(防抖合并)、agent 调试会话、结构化证据事件、
/api/health,以及timeline、health、compact_contextMCP 工具。包含 HTTP 端点输入校验、MCP 参数校验、路径穿越防护、大小写不敏感搜索和防抖索引优化。详见 debug-hub。 -
1.8.0(2026-05-08): - 新增包装式
codex、claude、gemini、opencode、hermes、grok会话的自触发 harness 路由。 - Model Router(模型路由器):Agent Team 的智能多模型调度。包含模型能力注册表(8个模型)、任务类型到模型的路由、三种CLI协议适配器(claude/codex/gemini)、按成本升序的降级链、Agent可调用的
model-routerskill、AIOS_MODEL_{ROLE}环境变量覆盖,以及感知反馈循环集成。详见 Model Router。 - GroupChat Runtime:
aios teamlive 模式现在使用基于轮次的 agent 执行,共享对话历史。每轮中的 agent 并行运行;所有 agent 都能看到完整的累积对话线程。被阻塞的 agent 会触发自动 re-plan 轮次。与旧的单次隔离 dispatch 模式形成对比。 - OpenCode CLI subagent 支持:
opencode-cli现已成为所有编排路径(subagent、team 和 GroupChat runtime)完全支持的AIOS_SUBAGENT_CLIENT。
较早稳定版¶
1.7.1(2026-04-26):- 新增 Solo Harness 发布博客。
-
补齐既有 persona/user profile 记忆层说明(
aios memo persona ...、aios memo user ...),修正此前文档漏写。 -
1.7.0(2026-04-26): - 新增
aios harness,支持单 Agent 过夜执行、run journal、stop/resume 控制、HUD 可见性和可选 worktree 隔离。 - 新增并同步官方
Solo Harness文档到英文、中文、日文、韩文站点。
更早稳定版¶
1.6.3(2026-04-25):- 将中文官方文档的新手视觉引导同步到英文、日文、韩文站点。
-
重写多语言首页、快速开始、按场景命令和多 Agent 实战页,让各语言用户都按任务上手。
-
1.6.2(2026-04-25): - 增加中文官方文档的新手三步路径、TUI Setup/Doctor、ContextDB 记忆循环和 Agent Team/HUD 视觉示意图。
-
让新用户先按任务找到命令,再按需进入 ContextDB、多 Agent 和高级编排。
-
1.6.1(2026-04-25): - 修复 GitHub Release workflow 在干净 Linux checkout 中因 generated skills/native 输出漂移导致的预检失败。
- 简化中文首页、快速开始、按场景用法和多 Agent 实战入口,让新用户先按任务找到命令。
最近版本¶
main(未发布):- debug-hub MCP 原生调试日志服务(2026-05-06):面向 coding agent 的 MCP 原生 debug 日志采集服务,提供 Node.js/Browser/Go 三种 SDK、内嵌 Web UI、
~/.debug-hub/文件存储、5 个 MCP 工具供 agent 自我诊断(list_traces、get_trace、search_logs、get_stats、clear_logs);agent 无需人工介入即可内省自身运行时日志- Agent 自触发 harness 路由(2026-05-05):包装后的
codex/claude/gemini/opencode/hermes/grok会话现在会提示single/subagent/team/harness;长任务、过夜任务、可恢复目标可自触发aios harness run ... --workspace <project-root>,支持--max-iterations,并可用CTXDB_HARNESS_PROVIDER、CTXDB_HARNESS_MAX_ITERATIONS控制
- Agent 自触发 harness 路由(2026-05-05):包装后的
- 包装式 coding agent 的 Privacy Shield(2026-04-24):ContextDB shell 启动交互式 CLI 时会打印彩色隐私面板,展示 Privacy Guard 状态、自定义模型中转端点检测,以及
aios privacy read --file <path>安全读取路径;自动提示词也明确 LLM 隐私规则只是提示约束,可验证保护来自确定性的 AIOS gate - 按工作区路由启动 + 项目级 Node 选择(2026-04-23):
ctx-agent的路由启动现在会保留当前 git 工作区,即使它是从非 AIOS 仓库触发;mcp-server的 npm scripts 统一经由scripts/with-project-node.mjs运行,持续遵循.nvmrc/ Node 24,使用内置node:sqlite避免外部 SQLite addon ABI 漂移,并在本机缺少 Node 24 时给出明确报错 - ContextDB Shell 启动优化(2026-04-22):
ctx()优先使用编译后的mcp-server/dist/contextdb/cli.js,单次调用开销从 ~0.3s 降至 ~0.06s;one-shot 代理启动从 ~2.2s 优化到 ~0.5s(快约 78%);shell-bridge 的detectRunner不再依赖tsx;安装时如缺少dist/自动触发 build,build 失败则优雅回退到 npm-run 模式 - 默认核心技能更新(2026-04-19):
awesome-design-md、frontend-design、cap-commit-push提升为默认核心技能 - ContextDB 懒加载(2026-04-18 至 2026-04-19):交互式会话默认启用懒加载上下文(
CTXDB_LAZY_LOAD=on);代理通过 facade prompt 自主发现记忆,不再直接注入完整上下文包;新增懒加载文档及多语言博客文章 - AIOS 工作流路由 skill(2026-04-18):新增
.claude/skills/aios-workflow-router,提供可靠的任务到技能路由与发现能力 - 路由/并发文档更新 + 默认并发改为 3(2026-04-20):补充交互路由与并发参数的简化配置指南(
CTXDB_INTERACTIVE_AUTO_ROUTE、CTXDB_CODEX_DISABLE_MCP、CTXDB_TEAM_WORKERS、AIOS_SUBAGENT_CONCURRENCY);在概览核心能力中增加指南入口;live subagent runtime 默认并发从2调整为3 - Browser MCP 迁移到 browser-use CDP(2026-04-10):默认浏览器运行时从 Playwright 切换到 browser-use MCP over CDP;新增启动器
scripts/run-browser-use-mcp.sh;迁移命令aios internal browser mcp-migrate;截图超时保护可配置BROWSER_USE_SCREENSHOT_TIMEOUT_MS - HUD/Team skill-candidate 增强(2026-04-09 至 2026-04-10):
--show-skill-candidates详细视图参数;--skill-candidate-limit <N>可配置限制数;fast-watch 模式默认限制从 6 降到 3;artifact 读取缓存优化性能;HUD 建议skill-candidate apply命令;team status 显示 skill-candidate artifacts 和 drafts - Quality-gate 可见性(2026-04-08 至 2026-04-09):quality-gate category 在 HUD minimal status 和 team history summary 中显示;quality-failed-only 过滤器;quality prefix 过滤器支持多值
- Learn-eval draft 推荐(2026-04-07 至 2026-04-09):hindsight lesson drafts;skill patch draft candidates;draft recommendation apply flow;持久化 skill-candidate draft artifacts
- Turn-envelope v0(2026-04-07):基于 turn 的事件链路 telemetry;harness 中的 clarity entropy memo 覆盖
- Browser doctor 自动修复(2026-04-06 至 2026-04-08):
doctor --fix自动修复 CDP 服务;setup/update 生命周期自动修复 browser doctor;文档中添加 CDP 快速命令 - 多环境强化学习训练系统:统一的
rl-core控制平面,支持 shell、browser、orchestrator 三种环境适配器;三指针 checkpoint lineage;四车道 replay pool;PPO + teacher distillation 训练 - Mixed-environment campaigns(
rl-mixed-v1):一次 live batch 可跨越 shell + browser + orchestrator episode,统一 rollback 决策 - ContextDB
search默认走 SQLite FTS5 +bm25(...)排序;当 FTS 不可用时自动回退 lexical 检索 - ContextDB 语义重排改为基于当前 query 的 lexical 候选集执行,降低旧但精确命中的误丢失
aios orchestrate上线subagent-runtimelive 执行(需AIOS_EXECUTE_LIVE=1)- 新增有界 work-item 队列调度与 ownership hints 传播
- 新增 no-op 快路径:上游
filesTouched=[]时自动完成reviewer/security-reviewer - 新增 Windows PowerShell 冒烟工作流:每次 push
main触发(.github/workflows/windows-shell-smoke.yml) skills安装支持global/project两种范围选择- 仓库内 canonical skill authoring tree 收口到
skill-sources/,repo-local client roots 改为node scripts/sync-skills.mjs生成 skills默认安装模式改为可移植的copy,保留显式--install-mode link作为本地开发选项- release 打包与 preflight 会通过
check-skills-sync校验生成目录没有漂移 - skill 选择器改为 catalog 驱动,区分核心默认项与按需业务项;卸载时只显示已安装技能
- TUI skill picker 新增
Core/Optional分组,并对长描述做终端友好截断 doctor会提示同名 skill 的project安装覆盖global安装- Node 运行时口径统一到 24 LTS
- Ink TUI 重构(v1.1.0):基于 TypeScript + Ink 的全屏 TUI,采用 React 组件;启动横幅显示 REXCLI ASCII art;自适应 watch 间隔;左右选项循环
0.17.0(2026-03-17):- TUI 卸载选择器在小终端中可滚动,
-Select all/Clear all/Done按钮固定在底部 - 卸载光标选择现在与渲染后的分组列表保持对齐
- setup/update skill 选择器对已安装技能标注
(installed)标签 0.16.0(2026-03-10):新增 orchestrator agent catalog 与生成器0.15.0(2026-03-10):orchestrate live默认门禁(AIOS_EXECUTE_LIVE)0.14.0(2026-03-10):新增subagent-runtime运行时适配器(stub)0.13.0(2026-03-10):运行时 manifest 外置化0.11.0(2026-03-10):扩展本地 orchestrate preflight 覆盖范围0.10.4(2026-03-08):非 git 工作区 wrapper fallback 与文档同步0.10.3(2026-03-08):修复 Windows cmd-backed CLI 启动0.10.0(2026-03-08):安装/更新/卸载生命周期统一为 Node0.8.0(2026-03-05):新增严格 Privacy Guard(支持 Ollama)并接入安装流程0.5.0(2026-03-03):ContextDB SQLite sidecar 索引(index:rebuild)、可选--semantic检索路径、统一ctx-agent运行核心
2026-03-16 运行观测状态¶
- 连续 live sample 维持成功(
dispatchRun.ok=true),最新 artifact: .aios/context-db/sessions/codex-cli-20260303T080437-065e16c0/artifacts/dispatch-run-20260316T111419Z.jsonlearn-eval当前仍给出:[fix] runbook.failure-triage(clarity-needs-input=5)[observe] sample.latency-watch(avgElapsedMs=160678)- 结论:timeout 暂不下调,继续按 latency-watch 观测。
相关阅读¶
更新规则¶
凡是涉及安装、运行行为、兼容性的发布,必须在同一 PR 同步更新文档并在本页体现。