Skip to content

架构总览 ​

AxonX 分离应用能力、同步研究执行和文件证据。

AxonX 使用入口、服务命令与核心能力

各层职责 ​

层职责所属模块
客户端JSON、SSE、上传、MCPaxonx.client
应用配置、分发、provider、受管理生命周期axonx.app
Daemon监督服务、定时进程和更新axonx.daemon
插件已安装 Task 注册和 wheelaxonx.plugin
Task类型化开发、执行、记录和产物axonx.task

查询执行链 ​

客户端向 /jobs/status 提交 task_id。认证和 Dispatcher 校验请求,Job Step 通过 task_index 读取并返回 JobResponse。索引观察文件,读取记录不会执行或修复 Task。

研究执行链 ​

本地 CLI exec 发现 Task 注册并解析执行配置,构造 Task 后调用 TaskExecutor。同步步骤和子任务在该进程执行。执行器保存 metadata/进度、关闭资源、校验输出并发布终态。CLI 等待完成并返回输出及退出码。

远程原生命令通过目标的 cli Job,在服务工作区启动配置的 AxonX 命令新进程,传输 stdout/stderr 并清理其进程组。定时 exec 由 Daemon 启动,在应用服务替换后继续执行。两者的进程所有者不同。

shell Job 与 cli 复用相同的 pipeline 和进程执行逻辑,ShellStep 选择 Bash 与可选工作目录。两种 Job 都关闭客户端断开时的取消行为,服务关闭时终止其进程组;普通 pipeline Job 默认在客户端断开时取消执行。

应用装配 ​

Application 在局部 registry 中装配 provider,注入有类型的依赖,按拓扑顺序启动受管理组件并逆序关闭。框架扩展通过 providers=... 提供。启动层显式注入 TaskCatalog、更新后端和定时命令启动器。嵌入式应用可省略产品适配器,Cron 需要宿主启动器。

插件与 Agent ​

插件 manifest 只注册 Task。安装修改所选 Python 环境,不刷新常驻服务的注册快照或已缓存类。远程部署显式构建、上传、安装、清理,然后重启验证。

Agent 通过 CLI 或已配置的 Job 工具检查相同证据。内置 Claude 后端管理 SDK 会话并附加规范开发指南。研究执行独立于 Agent 对话轮次。

设计边界 ​

  • upstream_task_ids 声明输入依赖,parent_task_id/children 记录调用,都不自动执行整个 DAG。
  • Task 查询属于观察,运行时启动和停止负责修正确认已退出的本机进程。
  • 同名写入由调用方协调,metadata 原子替换不是锁。
  • 每个目标有独立解释器、文件和配置。显式 CLI target 直接连接,Studio 可通过已配置的后端转发。

Job 与 Task · Task 契约 · 框架扩展

Agent-native quant research.