意图驱动的 AI 编码代理框架,基于 Rust 核心,支持多 Agent 协作与 AHP 协议外部治理。
A3S Code 是一个以意图检测为核心范式的 AI 编码代理框架。每条用户输入自动分类为 8 种意图类型(locate、understand、retrieve、explore、reason、validate、compare、track),据此动态切换 Agent 操作风格(general / explore / plan / verification / code_review)并注入针对性上下文,避免通用模式下的精度损失。
框架提供 15 个内置工具(文件读写编辑、搜索、bash、web 访问、git worktree、多任务并行等),支持 Lead-Worker-Reviewer 多 Agent 团队协作模式,内置 agentic-search、code-search、code-review、explain-code、find-bugs 等 Skills。安全层面通过 AHP(Agent Harness Protocol)的 19 个 harness point 实现外部治理,配合 allow/deny 权限策略、Circuit Breaker(3 次连续 LLM 失败后停止)、Auto-compact(token 限制前自动压缩)、HITL 确认、Taint Tracking、PII 脱敏及 MicroVM 沙箱隔离,满足企业级部署需求。
核心以 Rust 实现(约 79.5%),通过 PyO3 和 napi-rs 提供原生 Python 与 Node.js 绑定,采用 HCL 配置格式,支持 20 个 trait-based 扩展点替换任意组件(LLM client、tools、memory、hooks 等),并集成 MCP 协议。四种记忆类型(Episodic / Semantic / Procedural / Working)支持跨会话持久化,Lane Queue 实现基于优先级的任务调度(P0→P1→P2→P3),规划系统支持任务分解与波次执行。
架构分层:
Agent (facade, config-driven, workspace-independent)
└── AgentSession (workspace-bound)
└── AgentLoop (core execution engine)
├── IntentDetector → ContextPerception (AHP 2.3)
├── ToolExecutor (15 built-in tools)
├── SkillRegistry / PluginManager
├── Planning + SessionLaneQueue
├── HookEngine (12 lifecycle events)
├── AHP Executor (19 harness points)
├── Security (permissions, taint, HITL, PII)
├── Context (RAG providers)
└── Memory (4 types)
安装与快速开始:
pip install a3s-code # Python
npm install @a3s-lab/code # Node.js
配置文件 agent.hcl 指定 LLM 提供商后,通过 Agent.create("agent.hcl") 初始化,创建 session 绑定工作区即可使用。
待确认事项:当前入口 A3S-Lab/Code 为上游 AI45Lab/Code 的 fork(落后约 10 个 commit,停留在 v1.9.3,上游已发布 v1.10.0),fork 同步策略不明;README 中引用的 a3s.dev/docs/code 域名无法解析,实际可用文档站为 GitHub Pages;PyPI/NPM 包页面未直接确认;A3S-Lab 与 AI45Lab 组织关系未公开说明。