概览
AX 是一个代理运行时内核——不是聊天人格层。模型 → 工具 → 模型的单一循环、可断点续传的会话,以及窄而明确的能力契约。AXCrew 是控制平面:在多个 AX 设备之间调度任务、实时流式输出过程,但不触碰代理状态。
安装
一条命令,按 SHA256SUMS 校验。安装器从 GitHub 拉取最新发布、校验归档,再安装单个二进制文件。用 AX_VERSION 指定 tag,用 AX_INSTALL_DIR 指定目录。
curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh模型响应处理
Chat Completions 与 Responses 适配器保留匹配提供方和模型的推理状态。明确的流错误或缺失完成边界会报错,不将部分输出当作成功;未完成的工具调用不会执行,明确的 token 上限使用已有续接流程。
运行时
内核按 token 预算选择上下文(绝不固定消息数量)、容量感知压缩、可断点续传的工具轮次,以及依赖 DAG——就绪的独立调用以有界并发执行(默认 4,上限 64)。长任务也跑在同一条循环里——不存在单独的规划器。
工具与权限
内置工具:shell、filesystem、find_files/glob、patch、search、web、view_image。每个工具都声明自己的权限——按能力 allow / ask / deny——经由 UI 与运行时共享的同一个 PermissionStore。shell 和未知影响工具持有独占租约;只读工具声明影响后可并发运行。
ax run "find the failing test and fix it"网页预览与操作
Crew 会话侧栏提供原生浏览器标签。本地 Windows AX 通过经过认证的本机桥接读取和操作页面,遵守 AX 网站权限与受控页面网络保护。其他桌面平台目前支持用户预览,不支持 Agent 控制;远程 AX 使用自身运行环境,独立浏览器自动化需要 Node 和 Playwright。
技能
技能是放在 $AX_HOME/skills 或 <project>/.ax/skills 下的 SKILL.md 包。路由按词法进行、与语言无关;命中路由才加载正文与资源。启用/禁用是确定性的、作用域化的,且永远不需要一次模型调用。
MCP
AX 实现 stdio、Streamable HTTP 与 WebSocket 三种传输。服务器在被代理工具调用前保持休眠;无需连接即可查看能力目录。远端工具变成名为 mcp__server__tool 的普通工具。
ax mcp tools <server>记忆
三层作用域——全局、项目、会话——存于 SQLite,历史为追加式 JSONL。检索按归属者过滤、最多召回 32 个候选、轻度重排后注入有界摘要。无向量嵌入、无向量库、无额外模型调用。
子代理
主模型按任务需要判断是否委派,适用于调研、写作、分析和编程。普通子智能体与队列子任务共享深度、并行名额和继承的权限上限。AXCrew 的「插件 → 智能体」页可设置全局或项目限制:深度 0 关闭本地委派,1 允许直接子智能体,更大的深度允许递归。数据清单本身不会自动启动子任务。
沙箱
文件与终端工具遵循工作区沙箱;原生操作系统隔离目前需要 Linux。应用、网站访问与操作审批与文件/终端边界分开管理。Windows/macOS 原生沙箱后端尚未实现。
模型提供方
提供方中立。OpenAI 兼容端点(DeepSeek、Groq、Mistral、OpenRouter、xAI、Kimi……)、OpenAI Responses、原生 Anthropic/Gemini/Vertex/Bedrock/Radius 适配器、Codex 设备流 OAuth、WorkBuddy 账号。实现 ModelProvider 即可接入本地模型,主循环无需改动。
DEEPSEEK_API_KEY=… ax --provider deepseek --model deepseek-chatACP 适配器
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 对象。
ax acpAXCrew
一个 Rust 控制平面,带桌面客户端(Tauri 2 + React)与 Android 客户端。在已配对的 AX 设备之间调度确定性任务 DAG,维护设备身份,代理审批,并流式输出实时 CrewEvent JSON。历史、记忆、工具与凭据始终留在 AX 侧。
axcrew up
ax crew pair <code> --gateway https://crew.example.comCLI 参考
一切都可以从同一个二进制触达。会话跨重启恢复;目标可挂起、恢复、被取代或取消,且不丢失已断点的工作。/system 按需展示实测 CPU、内存与 NVIDIA GPU 用量。
每个主题一个文件,互相交叉引用而不是重复。完整的架构决策记录在 ax/docs/adr。
ax/docs · axcrew/docs