渠道与配置
Axile 公共核心内置 CTP、掘金和天勤。使用前需要安装对应依赖,确认 SDK 支持的运行平台,并选择账户模式。
安装渠道依赖
以下命令在独立 Axile 仓库根目录执行:
| 渠道 | 命令 | 说明 |
|---|---|---|
| 天勤 | uv sync --extra tqsdk | 本指南使用的连接表单;支持实盘、快期模拟、本地模拟 |
| CTP | uv sync --extra ctp | 依赖 OpenCTP 原生模块,需检查平台和连接环境 |
| 掘金 | uv sync --extra gm | SDK 支持的平台运行;macOS 不安装 GM SDK |
| 全部 extras | uv sync --extra all | 仍受平台与第三方 SDK 限制 |
依赖要求见 pyproject.toml。渠道显示“暂不可用”时,先检查对应依赖是否已安装;反复提交连接表单无法解决依赖缺失。
账户连接模式
天勤三种模式共用天勤账号与密码。实盘模式另外填写期货公司和交易账户凭据;本地模拟另外填写初始资金。
本地模拟状态保存在当前 Worker 中,日盘或夜盘 Worker 重建后会重置。实盘或模拟由账户连接模式决定,运行环境 environment=local 只影响日志,不会把账户改成模拟账户。
连接与记录核对
账户概览的连接开关用于连接或断开账户,旁边的详情入口显示进度、核对结果和失败原因。修改连接设置后,重新确认账户状态。连接就绪后再查询资产、计算目标或执行交易。
CTP 和天勤的近期委托、成交查询覆盖柜台当前交易日,并合并本次连接的观测记录;掘金使用当前可查询记录。具体范围以弹窗中的“记录范围说明”为准。各渠道提供的开平仓、交易日、费用等字段不同,缺少字段时不补算。
调仓收尾规则
各渠道继续按先减后增执行,品种并发方式不变。减仓结束后的账户查询同时用于阶段到位判断和下一阶段目标重算;新一阶段执行后再查询账户,统一生成最终持仓与到位结论。
仅由旧持仓观测产生的“目标未完成”可以根据收尾快照纠正;实际报单、撤单和账户控制错误继续保留。账户查询失败时保留已有执行证据,继续阻断后续开仓。休市跳过规则不变,历史记录不自动改写。
掘金的撤单拒绝等非成交回报不会记为成交;实时回调和历史查询使用相同的成交转换规则。
高级设置

| 设置 | 含义 |
|---|---|
| 数据库 | 主服务使用 SQLite;默认位于运行目录 |
| 运行环境 | 控制日志详细程度 |
| 日志目录与滚动 | 日志写入位置及切分周期 |
| 用户算法目录 | 启动时扫描并注册自定义算法的目录 |
主服务读取配置文件和代码默认值,不从 .env 读取业务配置。AXILE_CONFIG_TOML 用来指定配置文件路径,不能逐项覆盖配置。
保存需要重新读取的配置后,要重启服务。直接用 CLI 启动的,再执行一次启动命令;托管运行的,由外部 supervisor 重启。