Skip to content

渠道与配置 ​

Axile 公共核心内置 CTP、掘金和天勤。使用前需要安装对应依赖,确认 SDK 支持的运行平台,并选择账户模式。

安装渠道依赖 ​

以下命令在独立 Axile 仓库根目录执行:

渠道命令说明
天勤uv sync --extra tqsdk本指南使用的连接表单;支持实盘、快期模拟、本地模拟
CTPuv sync --extra ctp依赖 OpenCTP 原生模块,需检查平台和连接环境
掘金uv sync --extra gmSDK 支持的平台运行;macOS 不安装 GM SDK
全部 extrasuv sync --extra all仍受平台与第三方 SDK 限制

依赖要求见 pyproject.toml。渠道显示“暂不可用”时,先检查对应依赖是否已安装;反复提交连接表单无法解决依赖缺失。

账户连接模式 ​

天勤三种模式共用天勤账号与密码。实盘模式另外填写期货公司和交易账户凭据;本地模拟另外填写初始资金。

本地模拟状态保存在当前 Worker 中,日盘或夜盘 Worker 重建后会重置。实盘或模拟由账户连接模式决定,运行环境 environment=local 只影响日志,不会把账户改成模拟账户。

连接与记录核对 ​

账户概览的连接开关用于连接或断开账户,旁边的详情入口显示进度、核对结果和失败原因。修改连接设置后,重新确认账户状态。连接就绪后再查询资产、计算目标或执行交易。

CTP 和天勤的近期委托、成交查询覆盖柜台当前交易日,并合并本次连接的观测记录;掘金使用当前可查询记录。具体范围以弹窗中的“记录范围说明”为准。各渠道提供的开平仓、交易日、费用等字段不同,缺少字段时不补算。

操作步骤见第一个组合和委托与成交。

调仓收尾规则 ​

各渠道继续按先减后增执行,品种并发方式不变。减仓结束后的账户查询同时用于阶段到位判断和下一阶段目标重算;新一阶段执行后再查询账户,统一生成最终持仓与到位结论。

仅由旧持仓观测产生的“目标未完成”可以根据收尾快照纠正;实际报单、撤单和账户控制错误继续保留。账户查询失败时保留已有执行证据,继续阻断后续开仓。休市跳过规则不变,历史记录不自动改写。

掘金的撤单拒绝等非成交回报不会记为成交;实时回调和历史查询使用相同的成交转换规则。

高级设置 ​

系统高级设置中的数据库、日志和用户算法目录

设置含义
数据库主服务使用 SQLite;默认位于运行目录
运行环境控制日志详细程度
日志目录与滚动日志写入位置及切分周期
用户算法目录启动时扫描并注册自定义算法的目录

主服务读取配置文件和代码默认值,不从 .env 读取业务配置。AXILE_CONFIG_TOML 用来指定配置文件路径,不能逐项覆盖配置。

保存需要重新读取的配置后,要重启服务。直接用 CLI 启动的,再执行一次启动命令;托管运行的,由外部 supervisor 重启。

Axile 公共核心使用文档