更新日志¶

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。
Grok Build 成为 AIOS 一等公民客户端：xAI Grok Build（grok / runtime id grok-build）现已支持 skills、agents、superpowers、native、team、harness。MCP 使用 Codex 形态 TOML（~/.grok/config.toml）。详见：Grok Build + AIOS 博客。
Hermes Agent 成为 AIOS 一等公民客户端：Hermes（Nous Research）具备 skills、native、harness、superpowers。详见：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.yaml scopes）。
多语言文档覆盖（英/中/日/韩）。
详见：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-shell MCP 别名实现跨所有客户端的确定性 shell 输出压缩。shell 命令通过 scripts/shell-mcp-server.mjs 执行，输出由 MCP proxy 自动压缩，压缩率超过 99%。
三层拦截防线：MCP 工具（全客户端）→ shim+hook（Claude/全客户端）→ 提示词引导。无单点故障。
Shim 自愈：原生 shim 探测 4 条回退路径（AIOS_ROOT_DIR → baked root → ~/.rexcil/harness-cli → ~/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。

本页用于追踪 Harness CLI 的版本变化，并快速跳转到相关文档。

官方发布记录¶

⭐ 在 GitHub 上 Star 📦 查看 Releases

较早稳定版¶

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 实战入口，让新用户先按任务找到命令。

2026-03-16 运行观测状态¶

连续 live sample 维持成功（dispatchRun.ok=true），最新 artifact：
.aios/context-db/sessions/codex-cli-20260303T080437-065e16c0/artifacts/dispatch-run-20260316T111419Z.json
learn-eval 当前仍给出：
[fix] runbook.failure-triage（clarity-needs-input=5）
[observe] sample.latency-watch（avgElapsedMs=160678）
结论：timeout 暂不下调，继续按 latency-watch 观测。

更新规则¶

凡是涉及安装、运行行为、兼容性的发布，必须在同一 PR 同步更新文档并在本页体现。

更新日志