文档

短文,真实行为。

完整的分版本文档在仓库里——ax/docs 与 axcrew/docs。这里是要点索引,保持同样的语气:每一项都能在代码里找到对应实现。

01

概览

AX 是一个代理运行时内核——不是聊天人格层。模型 → 工具 → 模型的单一循环、可断点续传的会话,以及窄而明确的能力契约。AXCrew 是控制平面:在多个 AX 设备之间调度任务、实时流式输出过程,但不触碰代理状态。

02

安装

一条命令,按 SHA256SUMS 校验。安装器从 GitHub 拉取最新发布、校验归档,再安装单个二进制文件。用 AX_VERSION 指定 tag,用 AX_INSTALL_DIR 指定目录。

install
curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh
03

模型响应处理

Chat Completions 与 Responses 适配器保留匹配提供方和模型的推理状态。明确的流错误或缺失完成边界会报错,不将部分输出当作成功;未完成的工具调用不会执行,明确的 token 上限使用已有续接流程。

04

运行时

内核按 token 预算选择上下文(绝不固定消息数量)、容量感知压缩、可断点续传的工具轮次,以及依赖 DAG——就绪的独立调用以有界并发执行(默认 4,上限 64)。长任务也跑在同一条循环里——不存在单独的规划器。

05

工具与权限

内置工具:shell、filesystem、find_files/glob、patch、search、web、view_image。每个工具都声明自己的权限——按能力 allow / ask / deny——经由 UI 与运行时共享的同一个 PermissionStore。shell 和未知影响工具持有独占租约;只读工具声明影响后可并发运行。

tools
ax run "find the failing test and fix it"
06

网页预览与操作

Crew 会话侧栏提供原生浏览器标签。本地 Windows AX 通过经过认证的本机桥接读取和操作页面,遵守 AX 网站权限与受控页面网络保护。其他桌面平台目前支持用户预览,不支持 Agent 控制;远程 AX 使用自身运行环境,独立浏览器自动化需要 Node 和 Playwright。

07

技能

技能是放在 $AX_HOME/skills 或 <project>/.ax/skills 下的 SKILL.md 包。路由按词法进行、与语言无关;命中路由才加载正文与资源。启用/禁用是确定性的、作用域化的,且永远不需要一次模型调用。

08

MCP

AX 实现 stdio、Streamable HTTP 与 WebSocket 三种传输。服务器在被代理工具调用前保持休眠;无需连接即可查看能力目录。远端工具变成名为 mcp__server__tool 的普通工具。

mcp
ax mcp tools <server>
09

记忆

三层作用域——全局、项目、会话——存于 SQLite,历史为追加式 JSONL。检索按归属者过滤、最多召回 32 个候选、轻度重排后注入有界摘要。无向量嵌入、无向量库、无额外模型调用。

10

子代理

主模型按任务需要判断是否委派,适用于调研、写作、分析和编程。普通子智能体与队列子任务共享深度、并行名额和继承的权限上限。AXCrew 的「插件 → 智能体」页可设置全局或项目限制:深度 0 关闭本地委派,1 允许直接子智能体,更大的深度允许递归。数据清单本身不会自动启动子任务。

11

沙箱

文件与终端工具遵循工作区沙箱;原生操作系统隔离目前需要 Linux。应用、网站访问与操作审批与文件/终端边界分开管理。Windows/macOS 原生沙箱后端尚未实现。

12

模型提供方

提供方中立。OpenAI 兼容端点(DeepSeek、Groq、Mistral、OpenRouter、xAI、Kimi……)、OpenAI Responses、原生 Anthropic/Gemini/Vertex/Bedrock/Radius 适配器、Codex 设备流 OAuth、WorkBuddy 账号。实现 ModelProvider 即可接入本地模型,主循环无需改动。

providers
DEEPSEEK_API_KEY=… ax --provider deepseek --model deepseek-chat
13

ACP 适配器

ax acp 通过 stdio 讲 Agent Client Protocol v1:initialize、session/new、load、resume、prompt、cancel,以及只读的 _ax/status、_ax/models、_ax/tools、_ax/capabilities 与 scopedCapabilities。每行一个 JSON-RPC 对象。

acp
ax acp
14

AXCrew

一个 Rust 控制平面,带桌面客户端(Tauri 2 + React)与 Android 客户端。在已配对的 AX 设备之间调度确定性任务 DAG,维护设备身份,代理审批,并流式输出实时 CrewEvent JSON。历史、记忆、工具与凭据始终留在 AX 侧。

crew
axcrew up
ax crew pair <code> --gateway https://crew.example.com
15

CLI 参考

一切都可以从同一个二进制触达。会话跨重启恢复;目标可挂起、恢复、被取代或取消,且不丢失已断点的工作。/system 按需展示实测 CPU、内存与 NVIDIA GPU 用量。

每个主题一个文件,互相交叉引用而不是重复。完整的架构决策记录在 ax/docs/adr。

ax/docs  ·  axcrew/docs