SmartTools — 量化交易工具集

量化交易辅助工具集合，配合 SmartMACD（实盘策略）和 Genesis（OPS Web）使用。

---

工具一览

工具	目录	用途
SmartAPICollector	SmartAPICollector/	掘金 API 行情数据采集，写入 DuckDB
scripts	scripts/	交易日志文件复制归档（N/R 账号）
updateloadconfig	updateloadconfig/	配置同步 + 日志清理 + 执行目录清理

---

SmartAPICollector

用途：通过掘金量化 API 采集 A 股行情数据，存储到本地 DuckDB 供 Genesis/回测使用。

入口：main.py
配置：config.json（token、采集开关、标的列表）

主要功能：

• K线数据采集（1min / 5min / 30min / 1day）
• Tick 数据采集
• 资金流向、龙虎榜数据
• Symbol Master（全量 A 股信息）

数据输出：D:\QuantData\market_data.duckdb

运行方式：

python main.py

---

scripts

用途：将融资账号（R）和普通账号（N）的掘金交易日志文件，按日期复制到 Genesis 可读取的目标路径。

入口：copy_investment_logs.py
配置：copy_config.json（源路径、目标路径、账号标识）

主要功能：

• 自动获取当天日期，按 YYYYMM/YYYYMMDD/ 结构归档
• 支持自定义 N/R 账号路径
• 复制后校验文件完整性

运行方式：

python copy_investment_logs.py
python copy_investment_logs.py --date 20260409

---

updateloadconfig

用途：SmartMACD 配置文件同步 + 运行目录清理，通常在日终或重启策略前执行。

入口：updateloadconfig.py
配置：updateloadconfig.json（enable 开关、source/target 路径）

主要功能：

子命令	说明
sync	从最新日期目录复制 context_setting.json 到 N/R 目标目录
clean-logs	清理 target 目录下的 .txt 日志和 api_call*.json 文件
clean-exec	清理 execution_folder 下的临时文件/目录

运行方式：

python updateloadconfig.py           # 按 JSON 开关执行
python updateloadconfig.py sync      # 仅同步配置
python updateloadconfig.py clean-logs
python updateloadconfig.py all       # 强制执行全部

---

系统依赖关系

SmartMACD（实盘策略）
    ↓ 产生交易日志
scripts（copy_investment_logs）
    ↓ 复制日志到 D:\Online\
Genesis（OPS Web daily_import）
    ↓ 导入 SQLite

SmartAPICollector
    ↓ 采集行情
DuckDB（market_data.duckdb）
    ↓ 供 Genesis 回测/分析使用

updateloadconfig
    → SmartMACD 配置同步（context_setting.json）
    → 运行目录清理

---

环境要求

• Python 3.13
• 掘金量化 token（在各工具 config.json 中配置）
• DuckDB：pip install duckdb

路径约定

路径	说明
D:\Source\SmartTools\	本仓库根目录
D:\QuantData\market_data.duckdb	SmartAPICollector 输出
D:\Online\YYYYMM\YYYYMMDD\	掘金交易日志原始路径
D:\Source\Genesis\data\trading.db	Genesis SQLite 数据库