axi 是什么?

AXI(Agent eXperience Interface)是一套面向 AI 代理的命令行设计原则、基准工具和参考实现目录。它关注输出 token、默认字段、截断、错误码和上下文提示等 CLI 细节,不是一个统一的代理运行时。

⭐ 666 Stars 🍴 23 Forks TypeScript MIT 作者: kunchenguid
来源:github.com/kunchenguid/axi;https://github.com/kunchenguid/axi/blob/ma… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目用自建 GitHub 与浏览器任务比较 AXI 风格 CLI、传统 CLI 和 MCP,给出成本、成功率与回合数数据,因此引发工具接口选型讨论。基准也由项目方维护,不能当作独立结论。

来源:github.com/kunchenguid/axi/blob/main/README.md

核心功能

十条 CLI 原则

覆盖紧凑输出、最小默认 schema、可恢复截断、预计算汇总、明确空状态、结构化错误、环境上下文、内容优先、下一步提示和一致帮助。

来源:github.com/kunchenguid/axi/blob/main/README.md
项目自建基准

仓库公布 490 次浏览器运行和 425 次 GitHub 运行,用固定任务与 Claude Sonnet 4.6 比较不同接口条件。

来源:github.com/kunchenguid/axi/blob/main/README.md
实现目录

官方目录列出 gh-axi、chrome-devtools-axi、lavish-axi、quota-axi 等实现;各工具由自己的仓库和发布节奏维护。

来源:github.com/kunchenguid/axi/blob/main/README.md
JavaScript SDK 与 skill

仓库提供用于构建 AXI 输出的 JavaScript SDK,也提供代理技能文件解释原则和示例。

来源:github.com/kunchenguid/axi;https://github.com/kunchenguid/axi/release…

技术架构

AXI 仓库由原则文档、代理 skill、浏览器与 GitHub 基准 harness、实现目录和独立发布的 JavaScript SDK 组成。SDK 负责紧凑输出等构建能力;具体服务访问由 gh-axi 等外部 CLI 实现。它没有像 MCP host 那样统一管理服务发现、连接和上下文。

来源:github.com/kunchenguid/axi/blob/main/README.md;https://github.com/kun…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Node.js 20+(SDK)Node.js 20+(S… pnpm 11.1.1(仓库开发)pnpm 11.1.1(… @toon-format/toon(SDK)@toon-format/t… 十条 CLI 原则 项目自建基准 实现目录 JavaScript SDK 与 skillJavaScript SDK 与 s… axi 项目本体 核心功能 关键依赖

技术栈

语言TypeScript / JavaScript框架CLI 设计规范、benchmark harness、Agent Skill、AXI JavaScript SDK
Node.js 20+(SDK)pnpm 11.1.1(仓库开发)@toon-format/toon(SDK)
本地 shell 与被接入服务;凭据和权限由具体 AXI CLI 管理
来源:github.com/kunchenguid/axi;https://github.com/kunchenguid/axi/release…

快速上手

先阅读十条原则,再挑一个没有写权限的测试场景。若评估 gh-axi 或 chrome-devtools-axi,先检查对应 npm 包、仓库和权限说明,在隔离目录安装并使用只读账号;记录同一任务的成功率、token、回合数和错误恢复。构建自有工具时,Node.js SDK 要求 20 以上,仓库开发使用 pnpm 11.1.1。
来源:github.com/kunchenguid/axi/blob/main/README.md;https://github.com/kun…

使用场景

适合为代理设计或改造 CLI、评估输出压缩与错误恢复,以及建立接口对照实验。不适合仅凭官方基准就替换现有 MCP 集成;身份、连接生命周期、跨语言 SDK 或集中发现等需求应单独评估。

来源:github.com/kunchenguid/axi/blob/main/README.md;https://modelcontextpr…

优势与局限

优势

  • 把 token 和回合数转成具体 CLI 设计规则
  • 公开任务矩阵和基准工具
  • 原则可逐条应用到已有命令行
  • SDK 与参考实现给出落地入口

局限

  • 基准由项目方设计和执行,并非独立评测
  • 结果绑定任务集、模型和当时版本,不能外推到所有代理
  • AXI 不提供 MCP 的统一 host、client、server 架构
  • 参考实现分散在不同仓库,安装与权限要逐项核对
  • 本轮没有安装 npm 包或复跑基准
来源:github.com/kunchenguid/axi/blob/main/README.md;https://modelcontextpr…

最新版本

仓库最新正式 Release 为 JavaScript SDK 子包 axi-sdk-js v0.1.12,发布于 2026-09-16,修复 stdout 管道关闭时的 EPIPE 优雅退出。该版本号不代表原则文档或所有参考实现同步到 0.1.12。

来源:github.com/kunchenguid/axi/releases/tag/axi-sdk-js-v0.1.12

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、仓库包配置、实现目录、axi-sdk-js v0.1.12 Release 与 MCP 官方架构文档  |  limitations: 未安装 gh-axi、chrome-devtools-axi 或 SDK,未授权 GitHub/浏览器,也未复跑任何基准  |  observed_output: 官方 README 公布浏览器 490 次、GitHub 425 次项目自建运行;当前 formal release 是 SDK 子包 axi-sdk-js v0.1.12,而不是整个原则项目的统一版本

来源:github.com/kunchenguid/axi/blob/main/README.md;https://github.com/kun…

同类项目对比

MCP 官方架构由 host、client 和 server 组成,强调能力协商、服务发现以及上下文和工具的标准化连接。AXI 处理的是另一层问题:让 shell 命令的默认输出和错误更适合代理。需要统一连接与跨工具生态时评估 MCP;已有 CLI 但 token 浪费或恢复困难时,可借鉴 AXI 原则。两者可以同时存在。

来源:modelcontextprotocol.io/docs/learn/architecture;https://github.com/ku…

总结评价

AXI 最有价值的部分是可检查的 CLI 设计清单。先把十条原则用于一个低风险命令,并在自有任务上与现有 CLI 或 MCP 流程对照;只有结果可重复、权限模型也合适时,才扩大采用范围。

来源:github.com/kunchenguid/axi/blob/main/README.md;https://modelcontextpr…

常见问题

AXI 是一个可以直接运行的代理框架吗?

不是。AXI 主体是十条 CLI 设计原则、基准、skill、SDK 和实现目录;具体操作 GitHub 或浏览器要使用对应的独立 CLI。

axi-sdk-js v0.1.12 是整个 AXI 项目的版本吗?

不是。v0.1.12 是 JavaScript SDK 子包的正式版本。原则文档、基准和各参考实现有各自的维护节奏。

AXI 官方基准能证明它普遍优于 MCP 吗?

不能。数据来自项目方在指定任务和 Claude Sonnet 4.6 上的自建测试,适合提出假设,采用前仍需用自己的任务、模型和权限环境复测。

AXI 和 MCP 能一起使用吗?

可以。MCP 负责标准化 host、client 与 server 的连接;AXI 原则可用于优化某个 CLI 或 MCP server 背后的命令输出,两者解决的层级不同。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件