框架扩展
选择扩展点
Task 负责同步研究,Component 负责受管理的可复用资源,BaseStep 适配异步 Job 操作,宿主负责进程监督。Task manifest 不注册应用 provider,应通过 Application(providers=...) 和配置提供。
Provider 与局部 Registry
@provider("backend") 声明名称,不修改全局状态。ProviderRegistry 在单个应用中将 component_type/backend 映射到类,拒绝冲突并在装配后冻结。BaseComponent 位于 app.components.base,BaseStep 位于 app.steps.base,provider 位于 app.components.registry。
可运行的 Step 与 Job 示例
import asyncio
from axonx.app.core.application import Application
from axonx.app.components.registry import provider
from axonx.app.steps.base import BaseStep
@provider("greeting")
class GreetingStep(BaseStep):
async def execute(self):
self.response.answer = {"message": f"Hello, {self.context['name']}"}
async def main():
async with Application(
providers=[GreetingStep], log_to_console=False, log_to_file=False,
jobs={"greet": {
"parameters": {
"type": "object", "properties": {"name": {"type": "string"}},
"required": ["name"], "additionalProperties": False,
},
"steps": [{"backend": "greeting"}],
}},
) as app:
response = await app.run_job("greet", {"name": "AxonX"})
assert response.success
print(response.answer)
asyncio.run(main())声明组件依赖
BaseComponent 构造时调用 self.depend("attribute", "instance", ExpectedBase),应用检查类别/类型、注入对象并安排启动/关闭顺序。BaseStep 用 self.component(ExpectedBase) 访问已配置能力。PipelineJob 每次调用复制 Step 状态,不应通过全局对象共享可变调用状态。
参数、默认值与系统字段
Job parameters 是对象 JSON Schema,默认值在校验前合并。Step injected_parameters 单独描述系统上下文,调用方不能伪造注入键。配置中的 Step 选项选择后端/组件,不是公共参数。通过 self.context 使用 JobContext 映射,通过 self.response 写响应。
事件与结果
await self.emit(event) 提供背压。事件从 axonx.client.events 导入,Task 进度/日志类型来自 task.models.events。Job 产生一个终态 ResultEvent,非流式调用折叠成相同 JobResponse。提前结束消费时应关闭异步事件源。
宿主集成
定义查询注入 task_catalog,更新注入 updates,Cron 注入 launch_scheduled。Application 不隐式发现/安装插件或启动进程,CLI Daemon 启动层负责装配。没有宿主更新后端的嵌入式应用不能通过更新 Job 自行重启。
Task 组合与研究基类
同步子任务使用 BaseTask.run_task。TaskExecutor 管理生命周期和清理,同名目录由调用方协调。窗口工作使用 core.windows 和注入时钟,不可变在线发布和核验历史使用 storage.online。股票组合 Task 继承 task.builtins.stock.portfolio.BaseStockPortfolioTask 并提供股池与选择器;回测继承 task.builtins.stock.backtest.BaseStockBacktestTask,消费冻结的 Portfolio 产物完成执行与估值,UI 不重复实现记账。
验证范围
验证 provider 装配、公共 Schema、启动回滚、清理/取消、终态事件和资源所有权,并执行上面的独立示例。协议认证和进程所有权是应用边界,不是任意插件代码的安全沙箱。