Autonomous Intelligence

面向AI代理的、事务安全的本地行动层。

Autonomous Intelligence 通过 MCP 暴露能力作用域内的计算机操作，同时将执行、审批和崩溃恢复保留在独立的本地 Broker 之后。

开始使用 · 客户端兼容性 · MCP 工具 · 安全模型 · 架构 · 贡献指南

为什么存在

大多数桌面代理原型将概率性规划直接连接到强大的操作系统原语。这很方便，但使得重试、崩溃、提示注入和模糊的 UI 状态变得危险。

Autonomous Intelligence 划定了一条严格的边界：

• MCP 适配器和规划器是不可信的。

• Broker 独立地推导策略和行动类别。

• 每个副作用都由一个持久化的操作和尝试表示。

• 写入需要精确的、一次性使用的审批。

• 恢复在重试前验证后置条件。

• 无法协调的效果将变为 UNCERTAIN 并停止。

当前版本提供了一个故意狭窄、面向生产的垂直切片，用于工作区文件操作。Windows UI 自动化和浏览器控制只有在满足相同契约时才会添加。

关键保证

MCP 接口

Autonomous Intelligence 是一个 MCP v2 stdio 服务器，具有五个集中的工具：

autonomous-intelligence://capabilities 资源描述了活动的工作区和安全边界。

工具失败通过 MCP 以 is_error=true 返回，允许宿主模型纠正无效路径或参数，而不会将错误字符串误认为成功。

客户端兼容性

该服务器与模型无关且与宿主无关。它通过 stdio 使用 MCP 协议，不调用特定供应商的 LLM API。

使用完整的多客户端设置指南进行全局和项目范围的安装、验证命令以及特定于客户端的审批行为。

架构

flowchart LR
    H["MCP host / AI client"] --> M["Untrusted stdio MCP adapter"]
    M --> E[("Engine journal")]
    E -->|"Authenticated JSON IPC"| B["Execution Broker"]
    B --> U["Human approval"]
    B --> L[("Authoritative Broker ledger")]
    B --> X["Semantic action executor"]
    X --> W["Capability-scoped workspace"]
    E -->|"Status + reconcile"| B

Broker 未嵌入 MCP 进程。如果 Broker 不可用，工具将显式失败，而不是回退到直接的主机访问。

开始使用

要求

• Windows 10/11

• Python 3.11 或更新版本

• 一个 MCP 宿主，例如 Codex、ChatGPT 桌面版，或其他兼容客户端

从源码安装

git clone https://github.com/coldrazer/autonomous-intelligence.git
cd autonomous-intelligence

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

1. 启动 Broker

在可见的终端中运行 Broker，以便可以审查写入审批：

autonomous-intelligence --workspace C:\path\to\allowed-workspace broker

Broker 默认拒绝写入，除非批准了确切的操作。--approval-mode allow 仅用于一次性自动化测试。

2. 连接 LLM 客户端

为任何支持的宿主生成配置，无需修改其文件：

autonomous-intelligence --workspace C:\path\to\allowed-workspace `
  client-config claude

有效的客户端名称是 codex、claude、kimi、antigravity、gemini、cursor、vscode 和 generic。

对于 Codex，直接注册命令是：

在虚拟环境激活的情况下：

codex mcp add autonomous-intelligence -- `
  autonomous-intelligence-mcp `
  --workspace C:\path\to\allowed-workspace

验证注册：

codex mcp get autonomous-intelligence
codex mcp list

更改 MCP 配置后，重新启动本地 Codex 客户端。ChatGPT 桌面应用、Codex CLI 和 IDE 扩展共享相同的 Codex MCP 配置。

对于手动配置，将其添加到 ~/.codex/config.toml：

[mcp_servers.autonomous-intelligence]
command = "C:\\path\\to\\autonomous-intelligence\\.venv\\Scripts\\autonomous-intelligence-mcp.exe"
args = ["--workspace", "C:\\path\\to\\allowed-workspace"]
startup_timeout_sec = 20
tool_timeout_sec = 120
default_tools_approval_mode = "auto"

[mcp_servers.autonomous-intelligence.tools.autonomous_write_file]
approval_mode = "prompt"

通用宿主配置也可在 mcp-config.example.json 中找到。有关 Claude Code、Kimi、Antigravity、Gemini CLI、Cursor、VS Code 和通用 stdio 客户端的详细信息，请参阅 docs/CLIENT_SETUP.md。

GitHub 容器包

面向容器的 MCP 宿主可以拉取经过签名的多平台 OCI 镜像：

docker pull ghcr.io/coldrazer/autonomous-intelligence:0.3.1

推荐用于 Windows 桌面使用的原生 wheel。容器部署将 Broker 和 MCP 适配器分开运行，并使用共享的状态卷；请参阅容器指南了解确切的命令和安全边界。

直接 CLI

诊断 CLI 使用相同的 Engine、Broker、策略和日志：

# Read a workspace file
autonomous-intelligence --workspace C:\workspace read notes.txt

# Create a file; approval occurs in the Broker terminal
autonomous-intelligence --workspace C:\workspace write output.txt `
  --content "verified output"

# Recover attempts after a process restart
autonomous-intelligence --workspace C:\workspace recover

# Stop the Broker
autonomous-intelligence --workspace C:\workspace shutdown

安全模型

调度生命周期

Engine PREPARED
  → Broker ACCEPTED
  → approval issued and consumed when required
  → Broker IN_FLIGHT
  → semantic effect attempted
  → Broker DELIVERY_ATTEMPTED
  → typed postcondition evaluated
  → Engine VERIFIED

IN_FLIGHT 故意保守：交付前立即崩溃和交付后立即崩溃在协调之前是无法区分的。

恢复行为

Autonomous Intelligence 不声称对任意 GUI 操作或外部系统（既不提供幂等键也不提供可靠协调）具有精确一次执行。

开发

安装开发依赖项并运行完整套件：

python -m pip install -e ".[dev]"
python -m pytest

测试涵盖：

• 日志状态转换和重放冲突

• 审批拒绝、过期、绑定和单次使用

• 工作区逃逸和受保护的状态路径

• 副作用前后的崩溃恢复

• MCP 模式、注释、资源和工具错误语义

• 针对八种 MCP 客户端格式的宿主特定配置渲染

• 完整的 Windows 子进程链：MCP 客户端 → stdio 服务器 → 命名管道 → Broker → 工作区

请参阅 docs/PROTOCOL.md 了解线路和恢复契约，以及 docs/IMPLEMENTATION_STATUS.md 了解当前范围和路线图。

路线图

• 事务性 Engine 和权威 Broker 账本

• 能力作用域内的语义文件操作

• MCP v2 stdio 适配器

• Codex、Claude、Kimi、Antigravity、Gemini、Cursor 和 VS Code 设置资源

• 多平台 GitHub Container 包，包含 SBOM 和出处

• Windows 命名管道集成测试

• 只读 Windows UI 自动化观察适配器

• 结构化 UI 指纹和歧义拒绝

• 人类输入争用检测

• 浏览器 CDP 适配器，包含源和框架绑定

• 强化 Windows 服务身份、ACL 和签名安装程序

安全

在部署或报告漏洞之前，请阅读 SECURITY.md。当前版本是一个经过评估的本地垂直切片——并不意味着不受限制的自主桌面控制是安全的。

贡献

欢迎贡献，前提是保留事务和策略边界。从 CONTRIBUTING.md 开始。

许可证

根据 MIT 许可证 发布。