ANX 协议采用一核多体、各司其职、相互配合的设计思路,转为AI Agent理解与执行优化,并非只使用单一结构。其中 ANX Config 形式为协议核心,承载最完整的结构定义与配置信息,是构建 ANX 应用、SOP、小程序等场景的基础与关键。
围绕这一核心,协议延伸出四类标准形式,分别面向不同环节协同工作:CLI 形式负责运行时指令执行,Config 形式负责应用与流程配置,Markdown 块形式用于人与 Agent 对话中的可视化交互,Card 节点形式则用于向 AI 清晰呈现应用当前状态与页面结构。
多形式设计的目的,是让协议在构建配置、运行执行、可视化对话、AI 理解等全流程中都能自然适配、各司其职,既保证底层逻辑统一,又能在不同场景下高效可用。

以下为 ANX 协议 4 类标准形式与关键特征。

1、ANX Config 形式

用于 AI 原生应用、SOP、小程序的配置描述。
在 JSON 结构中,kindkindsautoSet 是 ANX 配置的关键字段,常见于 ANX APP、SOP 等场景,使用格式如下:

// Markdown 中出现以下结构,表示定义了一个 form 配置,需要进行可视化渲染
{
  "kind": "form",
  "kinds": [],
  "autoSet": {}
}

协议标准与完整用法,以 ANX 协议官方开源仓库为准:
https://github.com/mountorc/anx-protocol


2、ANX Markdown 块形式

用于在 Markdown 中进行模块声明、渲染展示与可视化交互。
在 Markdown 里,通过 :::anx 声明一个 ANX 可视化块,由 Marked-ANX 负责解析、渲染与交互,使用格式如下:

// Markdown 中出现以下结构,表示定义了一个 form 配置,需要进行可视化渲染
:::anx
{
  "kind": "form"
}
:::

开源项目 marked-anx 插件已完整实现 :::anx 的解析与可视化渲染逻辑,详细说明与源码:
https://github.com/mountorc/marked-anx


3、ANX Card 节点形式

用于在任意文本中标记可交互节点,标识一个 ANX 执行单元。
在 Markdown 或页面中,<x> 是 ANX 标签的标志性标记,出现 <x> 即代表使用 ANX 协议声明节点结构。
同时,cardKey 字段是 ANX 节点的重要标准,也是区分 ANX ConfigANX Card 的关键标识。

使用格式如下:

// Markdown 中基础结构
<x kind cardKey>
  内容区域
</x>

// 示例:一个 kind 为 form、cardKey 为 card_1234 的表单节点
<x form card_1234>
  表单区域
</x>

4、ANX CLI 形式

用于在 ANX 应用运行环境中执行命令、进行交互控制。
在生产与执行环境中,以 anx 开头的命令即为 ANX CLI 命令,遵循 ANX 协议 CLI 命令集定义,使用格式如下:

// 通用格式
anx <cardKey> <action> params

// 示例:获取指定 card 的表单信息
anx card_1234 get_form

// 示例:为指定 card 的表单写入数据
anx card_1234 set_form '{"username":"kevin"}'

ANX CLI 命令集以 anx-protocol 开源仓库中的 CLI 模块定义为准;
anx-core 项目已集成 ANX CLI 命令的解析与执行模块:

  • https://github.com/mountorc/anx-protocol
  • https://github.com/mountorc/anx-core

随着 ANX 协议的持续普及,希望能帮助你更好地在相关场景中协作,或主动使用 ANX 协议更高效地完成任务。
更多形式与场景化能力正在持续迭代中,欢迎关注与共建,感谢您的支持!

ANX协议官方开源地址:https://github.com/mountorc/anx-protocol

Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐