# 发布历史

本页记录 qteasy 各版本的**用户可见**变更。升级前可查阅对应版本；2.0 大版本请参阅 [2.0 迁移指南](qteasy_2_migration_guide.md)。

## 2.5.2 (2026-05-24)

- **Trader Shell CLI 可用性**  
  **`orders`** 列表现显示本地订单 ID（`id`）与券商委托号（`broker_id`，若有），便于对照 **`cancel ORDER_ID`** 撤单或排障。**`history`** 仅展示确有成交的记录，未成交或已取消且无成交量的订单不再混入列表。**`task -l`** 默认列出排队中的任务（`queued`），**`task -l -s all`** 与 **`tasks`** 以与 **`schedule`** 一致的表格展示任务 ID、名称、状态与参数；仍可用 **`task TASK_ID`** 查看详情、**`task TASK_ID -c`** 取消排队任务。**`broker`**、**`gate`**、**`reconcile`**、**`liveconfig`** 改为分段键值可读输出（风格接近 **`overview`** / **`config`**），布尔项以颜色区分；程序化集成请直接调用 Trader API。**`rotatelogs`** 执行前预览待删文件并提示确认，非交互环境须加 **`--yes` / `-y`**；别名 **`rotatelog`**、**`rotate-logs`** 仍可用。从命令模式回到 **dashboard** 时，**`-r`** 回放的系统日志条数与设定一致（按逻辑日志条目计数）；非 DEBUG 模式下不再因先截物理行再过滤 DEBUG 而明显变少。
- **券商成交回报（Broker）**  
  券商 **`transaction()`** 回报现支持 **4 元组或 5 元组**：第 5 项为可选真实柜台委托号。内置模拟券商仍使用 4 元组，与 2.5.1 兼容。修复分段成交时误将本笔成交量当作订单总量校验的问题；5 元组委托号可写入成交结果，供实盘对账与撤单映射。
- **实盘配置（XtQuant 协作）**  
  **`live_trade_broker_type`** 与 **`qt.configure(...)`** 现允许取值 **`xtquant`**（须安装并注册扩展包后方可实际接入；未注册时可能回落为模拟券商）。
- **文档**  
  新增英文契约 [XtQuant / MiniQMT Broker Adapter Contract v1](live_trading/4a-xtquant-broker-adapter-contract-v1.md)，说明受理、轮询成交与 5 元组语义及禁止对 QMT 双重下单。

## 2.5.1 (2026-05-18)

- **Trader Shell dashboard**  
  修复启动阶段系统日志在文件与屏幕上**成对重复**显示的问题。`acquire_live_price` 等任务的倒计时与监视列表行情改为在终端**单行原位刷新**，不再出现多行残留、刷屏。
- **系统日志（DEBUG）**  
  实盘刷新并写入实时行情数据时，DEBUG 级别系统日志仅输出数据表**前 3 行**与**总行数**摘要，不再写入整表内容，便于查阅且减少日志体积。非 DEBUG 模式下用户可见提示不变。
- **Dashboard 历史日志回放**  
  进入 dashboard 时回放的多行系统日志（如策略信号明细）按**整条消息**显示或过滤，续行不再被误当作独立日志行单独出现在屏幕上。
- **收盘 `post_close` 与 `created` 订单**  
  修复收盘任务对仍为 `created` 的订单误用撤单逻辑导致 `post_close` 失败的问题。收盘后此类未报单订单将置为 **`rejected`**（视同未受理）；已报单的 `submitted` / `partial-filled` 仍按原规则撤单为 **`canceled`**。

## 2.5.0 (2026-05-17)

- **实盘 Trader 运行稳定性**  
  实盘核心运行器完成架构升级，更适合长时间无人值守运行：启停与退出路径统一，命令行/图形界面不再各自拼装后台线程，按 **Ctrl+C** 退出时与主循环解耦，关停更可预期。任务可排队、可取消，失败可重试并在系统日志中追溯；成交入账在数据库侧整笔提交或回滚，避免半写入导致账本不一致；同一笔券商回报重复处理不会重复改账。开盘前可按配置运行**启动检查**（`live_trade_startup_gate_mode`），未通过时可阻止策略自动下单；在策略准备拆分模式下，策略运行前使用时点快照，快照缺失或过旧时会跳过当次策略并在日志中给出可理解的跳过原因，而不是静默失败。
- **券商受理、对账与恢复诊断**  
  柜台受理成功后，本地订单可关联券商委托号，便于对账与排障。模拟盘支持可配置的受理随机拒单（默认一定比例，便于验证拒单路径；示例与测试可设为 0 以保持结果确定）。开盘、收盘后会在日志中输出对账检查点摘要（现金、持仓、在途单计数等），便于检索。在 **DEBUG** 模式下，可通过 `run --task diagnose_pending_orders` 或在 Shell 中等价方式做在途单只读诊断（本地与柜台差异摘要），**不包含**自动改单或自动补偿。周期性自动对账任务与差异自动修复仍属后续演进项。
- **Trader Shell：运维命令与 dashboard**  
  在 Trader 提示符下无需退出即可查看实盘产物路径、有效 live 配置摘要、任务队列与取消排队任务、手动运行启动检查、打印对账快照 JSON、轮换过期交易/风控日志、查看券商连接状态等；`run --task` 支持按帮助说明运行开盘/收盘/诊断等任务；`sync` / `pull-state` 预留给后续 QMT 集成，当前会给出明确提示。启动后默认进入 **dashboard**，单行刷新下一任务倒计时、监视列表行情与系统消息；按 **Ctrl+C** 打开选单：**1** 命令模式、**2** dashboard、**3** 退出；数字键无需按 Enter，5 秒无输入自动恢复中断前模式，选单等待期间再按 **Ctrl+C** 与选 **3** 相同并正常退出。修复从命令模式回到 dashboard 时日志重复、状态行残留、关闭 debug 时仍显示调试日志等问题；主循环发生意外错误时可选择回到 dashboard 继续观察或退出关停。
- **日志与产物维护**  
  按 `trade_log_keep_days` 轮换交易日志时，会一并清理超龄的 `*.risk.log`。系统日志中的结构化运行记录便于还原任务执行、跳过原因与对账检查点，排障时不必仅靠零散英文提示拼凑上下文。
- **模拟/实盘文档**  
  扩充 `live_trading` 系列：配置与运行、券商接入、快照与启动门禁、产物与排障、手工冒烟清单，并新增 CLI 能力矩阵（已实现 vs 预留）；补充 dashboard / 命令模式与 Ctrl+C 选单说明（§7.1）；区分本地风控拒单与柜台受理拒单，便于按清单做冒烟测试与问题定位。

## 2.4.5 (2026-05-13)

- **RuleIterator 分标的参数**  
  在 `realize()` 中用 `get_pars` / `get_data` 读取、用 `update_par_values` 写入时，`multi_pars` 与普通参数保持同步，分标的与统一参数可用同一套 API 更新。
- **示例与文档**  
  `examples/live_grid.py`、`examples/live_grid_multi.py` 统一采用 `get_pars` / `update_par_values` 写法；策略基类文档明确：分标的参数须用**字典**（键为代码），元组表示全池共用一组参数，兜底键为 **`default`**（非 `others`）。
- **Trader CLI 策略列表**  
  简要列表模式下，带 `multi_pars` 的策略会提示运行 **`strategies -d`** 查看完整分标的参数。

## 2.4.4 (2026-05-08)

- **东方财富行情与盘中任务**  
  修复 2.4.3 回归：东方财富 HTTPS 行情请求在部分环境下失败、盘中追赶任务入队格式错误导致主循环报错、实时 K 线日期解析异常等问题，恢复自选价与盘中启动后的正常调度。
- **示例脚本**  
  修正 `live_grid_multi` 示例中的配置与用法，避免执行时不必要的 refill 干扰。

## 2.4.3 (2026-05-06)

- **实盘终端界面**  
  修复 System / Info 页在刷新持仓与环境摘要时界面不更新或崩溃的问题。
- **分标的参数提示**  
  当分标的参数字典被误写成单元素元组（常见尾逗号笔误）时，错误信息更清晰，便于自行纠正。
- **实盘示例**  
  修正若干 live trade 官方示例中的用法问题。

## 2.4.2 (2026-04-19)

- **异步回放与持仓同步**  
  模拟券商异步回放时，脚本可可靠等待队列订单与在途成交处理完毕，避免仅凭队列是否为空判断完成而导致持仓滞后、重复下单。
- **实盘数据源刷新**  
  分钟/小时级实时 K 线按资产类型写入对应数据表，不再一律写入股票表，基金/指数/期货等 live 数据落表正确。
- **分钟策略数据链路**  
  修复实盘分钟级策略可能拿不到足够日内数据的一连串问题，盘中信号生成更稳定。

## 2.4.1 (2026-04-18)

- **盘中启动 Trader**  
  修复交易时段内启动 Trader 时，逾期的开盘/收盘类任务可能被逆序重放、状态机卡在 sleeping 的问题；逾期任务现按时间顺序入队，盘中启动可正确追到当前市场状态并继续运行策略与行情任务。

## 2.4.0 (2026-04-14)

- **模拟/实盘基础架构（S1.3）**  
  提供可配置、可测试的 live 基础：`LiveTradeConfig` 校验运行时配置；可插拔 `RiskManager` 在提交前拦截不安全订单并给出原因；券商适配骨架（连接/下单/撤单/轮询成交）为后续 QMT 等接入做准备。产物清单（日志/断点/风控日志）与 CLI/TUI 订单生命周期展示更清晰。
- **文档**  
  新增独立 live_trading 文档系列（概览、配置运行、风控与订单、券商适配、排障）；教程含股票与 ETF 双路径模拟示例及 S1.3 设计说明；首页与 API 交叉链接便于找到 live 指引。

## 2.3.1 (2026-04-11)

- **交易日志保留**  
  默认 `trade_log_keep_days` 改为 **3**（原 0）：每次新 Python 进程导入 qteasy 时，会在 `trade_log_file_path` 下清理超龄 CSV；设为 `None` 或 **0 及以下** 可关闭自动删除。文档已与「启动时清理、非每次回测前清理」的行为对齐。
- **实盘与回测一致性**  
  实盘下单生成现已计入佣金；滑点处理与回测侧优化对齐；资产类型 **FD**（ETF/场内基金）不再在 live 模式入口被拒；正 **VS** 信号在 live 下与回测一致，小单量不足最小成交单位时不再被静默丢弃。
- **数据补齐 API**  
  仅在显式传入数据类型名时才做类型推断；仅传表名与 `asset_types`（如盘前 refill）不再报错。

## 2.3.0 (2026-04-08)

- **文档与教程**  
  教程结构重组，学习路径更清晰；HistoryPanel 与包级用法从研究探索延伸到回测工作流；示例刷新，常见端到端路径更易跟做。
- **HistoryPanel 高亮**  
  可用与标的、日期对齐的二维布尔掩码驱动高亮，多标的视图下同一逻辑条件可一致强调，无需逐序列手工接线。

## 2.2.9 (2026-03-31)

- **HistoryPanel 研究算子**  
  新增累计收益 `cum_return()`、归一化 `normalize()`（支持掩码）、组合 `portfolio()`（等权/加权/分组及可选基准）、K 线指标 `kline.*(inplace=)`、一键预设 `research_preset()` 与分页 `plot()`、列级 DSL `assign()`、截面/时序 `rank()` 与 `zscore(method='cs'|'ts')`、显式 `align_to()` / `resample()` 避免静默错位。详见 [HistoryPanel API](api/HistoryPanel.rst) 与教程 [2.5-historypanel-data-analysis](tutorials/2.5-historypanel-data-analysis.md)。
- **运算符语义**  
  算术运算符返回新面板而非原地修改；`copy(deep=True)` 默认为深拷贝，`deep=False` 共享底层数据。

## 2.2.8 (2026-03-30)

- **HistoryPanel 研究与索引（破坏性）**  
  方括号索引返回带标签子面板；支持 `subpanel` / `to_numpy`、列赋值、`where()` 掩码、只读 htype 属性（如 `panel.close`）、比较得 bool 数组以便链式 `where`、`loc` 时间轴选取。文档与教程说明与 pandas 的差异及使用边界。

## 2.2.7 (2026-03-26)

- **交互图高亮（Q06）**  
  `hp.plot(..., highlight=...)` 在 Plotly 交互折线/蜡烛图上可用；双标的叠加时高亮标记随当前主标的切换。

## 2.2.6 (2026-03-25)

- **双标的交互图样式**  
  主/次序列除透明度外区分线宽；FigureWidget 与 HTML 点击切换主标的时样式保持同步。

## 2.2.5 (2026-03-23)

- **交互图十字线**  
  Plotly 交互图点击任意 K 线可在主图显示实心十字线（bar 中点）；平移/缩放时指示器同步，bar 滚出视口时自动隐藏。

## 2.2.4 (2026-03-22)

- **复权 OHLC 蜡烛图（Q01）**  
  修复 `plot()` 无法识别 `open|b` 等复权列名导致蜡烛图错误的问题；同时存在裸名与复权列时，蜡烛图优先裸名 OHLC，与既有价格列约定一致。
- **交互图 X 轴**  
  HTML 嵌入图保留 Q03 的 X 轴 clamp 与最小可见 bar 宽度；FigureWidget 多行图监听主 X 轴并同步写入各 `xaxis*`，平移越界不再留下半屏空白。

## 2.2.3 (2026-03-22)

- **静/交互图一致性（P1）**  
  仅在有蜡烛面板时显示 OHLC 摘要头：静态图固定末 bar，交互图默认同理且点击 bar 更新（英文标签）；Matplotlib 与 Plotly 共用逻辑主题，图例 inset 于左上以省横向空间。
- **`plotly_backend_app`**  
  `interactive=True` 时可指定 `auto`（默认，先试 FigureWidget 再 HTML）、`FigureWidget` 或 `html`。

## 2.2.2 (2026-03-20)

- **DataSource 兼容性**  
  缺少可选文件后端（如 `tables`/`pyarrow`）时不再失败；回退 `csv` 时保证数据目录可用；`hdf5` 作为 `hdf` 别名；回退警告更易诊断。

## 2.2.1 (2026-03-19)

- **回测 NaN 价格**  
  修复价格为 NaN（停牌等）时污染信号解析与成交结果的问题；NaN 价位不再产生虚假成交或费用。

## 2.2.0 (2026-03-17)

- **数据可视化**  
  新图表流水线可从历史数据自动生成蜡烛、成交量、MACD、折线等组合图，多指标多标的同屏对比无需额外代码。
- **交互 K 线**  
  Notebook 内支持缩放、平移、悬停查看 OHLCV 与指标，探索价格行为更直观。
- **`qt.candle` 升级**  
  底层接入新可视化管线，API 保持兼容；Renko 不再支持，旧交互 widget 视为遗留。
- **日志与交易文件**  
  系统/交易日志与净值曲线 CSV 路径更可预期，旧文件按配置自动清理以节省磁盘。
- **回测精度与时间网格**  
  PT/PS/VS 与日内时间网格执行更贴近真实交易节奏，组合调仓与日内调度更易理解。

## 2.1.4 (2026-03-10)

- **回测评价**  
  修正回测报告中 `oper_count` 表；大规模回测评价不再触发 pandas 性能警告，输出与原先一致。
- **数据类型与历史取数**  
  修正若干内置类型定义；`get_history_data` 对 `(dtype, freq, asset_type)` 组合解析更稳健，同名多定义安全合并，避免空数据或重复列错误。

## 2.1.3 (2026-03-09)

- **生成文件名**  
  交易日志、系统日志、数据导出等文件名符合 Windows / Linux / macOS 要求，跨平台路径更省心。
- **净值曲线**  
  `trade_log=True` 时完整净值曲线另存为 `value_curve_{name}_{datetime}.csv`，与 trade_log / trade_summary 同目录并按 `trade_log_keep_days` 轮换。
- **回测结果与报告**  
  回测结果补充价格信息，报告展示更清晰，结果分析更省力。

## 2.1.2 (2026-03-08)

- **回测成交价**  
  逗号分隔资产池字符串正确处理；成交价列与全池对齐，后复权或部分标的缺数据时回测仍可运行。
- **历史取数**  
  无效类型名抛出 `ValueError` 并列出未匹配项（提示 `qt.define()`）；弃用参数 `htypes` 仅在显式传入时覆盖 `htype_names`。
- **回测结果图标题**  
  图表标题含 Operator 名称与回测时间，便于与 trade_log / trade_summary 文件对应。
- **错误信息**  
  修正 DataType 缺列提示中的拼写错误。

## 2.1.1 (2026-03-07)

- **回测报告手续费**  
  修复日频评价下报告「Total operation fee」恒为 0：`total_fee` 现与 trade_log 逐笔费用之和一致。
- **交易日志轮换**  
  新增配置 `trade_log_keep_days`，按保留天数自动删除过期 `trade_log_*.csv` 与 `trade_summary_*.csv`，避免日志目录无限增长。

## 2.1.0 (2026-03-06)

- **过程数据 API**  
  策略可在 `realize()` 中通过 `get_data('proc.own_cash')`、`get_data('proc.trade_records')` 等访问运行时现金、持仓、成交等，无需在 `data_types` 中声明；回测与 live 注入一致，严格无前视。
- **动态回测路径**  
  策略源码使用 `proc.*` 时自动走逐步回测；否则仍用批量信号 + 向量化回测，无需手动声明。
- **实盘过程数据**  
  动态数据策略在 Trader 中同样可用 `get_data('proc.xxx')`，与回测 API 一致。
- **移除旧式 op_* 类型**  
  `op_cashes` 等 `op_*` DataType 已删除，请改用过程数据 API，详见 [2.0 迁移指南](qteasy_2_migration_guide.md)。
- **pandas 频率别名**  
  兼容 pandas 2.2 前后频率别名（如 `M/ME`、`H/h`），减少跨版本 freq 不匹配警告。

## 2.0.1 (2026-03-05)

- **文档**  
  补充整体架构与设计说明。
- **回测评价频率**  
  评价表与权益曲线统一按日频计算，与策略运行频率无关。
- **配置清理**  
  移除已无意义的 `price_priority_OHLC`、`price_priority_quote`。
- **回测成交价与调度**  
  修复部分场景成交价获取失败；小时/分钟回测默认运行时间表不再包含开盘时刻；成交价与评价价复权方式统一。
- **PT / PS / VS 语义**  
  PT 在 T+0 现金交割下尽量复用同步卖出现金调仓；PS/VS 保持朴素订单语义，资源不足则放弃该笔。

## 2.0.0 (2026-02-27)

- **2.0 主版本**  
  架构与 API 重大升级，提供更灵活的多策略、多频率、多窗口与优化能力。**升级前请阅读** [2.0 迁移指南](qteasy_2_migration_guide.md)。
- **Operator / Strategy / Group**  
  引入 `Parameter` 与 `Group`：参数可按标的分别设置；策略分组可各自设定运行频率、时机与信号混合；运行时间表更细粒度；Tracing 可写入 trade log；优化算法与评价指标更丰富。
- **DataType**  
  支持资产类型 `ANY`；`StgData` 简化策略数据声明。
- **移除配置项**  
  `maximize_cash_usage`、`benchmark_asset_type`、`benchmark_dtype` 已移除，逻辑由执行流与 `benchmark_asset` 推断，迁移见指南。

## 1.4.11 (2026-02-14)

- **2.0 弃用预告**  
  对将在 2.0 移除或变更的 API 发出 FutureWarning，便于提前迁移：`get_history_data(htypes=...)` → `htype_names` 与后缀（如 `close:b`）；`print_trade_log` / `print_backtest_log` → `trade_log`；`get_table_map()` → `get_table_master()`；broker `random` → `simulator`；Trader `info(verbose=...)` → `detail`；以及 `Operator.op_type`、`op_data_freq`、`get_share_idx()` 等变更提示。

## 1.4.10 (2025-12-19)

- **优化性能**  
  修复部分系统上优化算法 2 多进程运行时性能偏低的问题。

## 1.4.9 (2025-03-11)

- **Trader 日志与成交**  
  修复 live 模式日志重复；几乎同时两笔同标的成交写入冲突；偶发错误时间戳行情导致策略 NaN；周一早盘数据窗口不足；周频 refill 改为每周五晚间自动补齐。

## 1.4.8 (2025-03-01)

- **Trader CLI refill**  
  新增 `refill` 命令及 `run --task refill`，可在 Shell 内手动补齐数据源表。
- **自动 refill**  
  修复 live 模式自动数据源补齐失败的问题。

## 1.4.7 (2025-02-26)

- **live refill 配置**  
  新增 `live_trade_daily_refill_tables`、`live_trade_weekly_refill_tables`、`live_trade_monthly_refill_tables`，可指定 live 模式下按日/周/月补齐的表。
- **稳定性**  
  修复交易模式下配置偶被覆盖、`DataSource.all_basic_tables` 返回不正确、CLI `schedule` 无法打印当前任务等问题。

## 1.4.6 (2025-02-19)

- **refill_data_source**  
  当前渠道不可用的表会跳过并警告；修复重复下载写入重复数据的问题。

## 1.4.5 (2025-02-18)

- **live K 线存储**  
  修复 live 模式下 K 线偶发写入错误。
- **基金行情**  
  东方财富渠道支持基金分钟与日 K 取价 API。

## 1.4.4 (2025-02-12)

- **模拟券商与 Trader**  
  修复部分场景无法获取实时价；历史数据 index 与开盘时刻对齐问题；东方财富渠道格式与稳定性改进。

## 1.4.3 (2025-02-11)

- **live 行情渠道**  
  修复 Trader 偶从错误渠道取 live 价、无法写入数据源的问题。
- **refill_data_source**  
  新增可选参数控制是否下载依赖表。

## 1.4.2 (2025-02-07)

- **依赖**  
  `dbutil`、`pymysql` 改为必选依赖；缺少可选依赖时的警告展示修正。

## 1.4.1 (2025-02-06)

- **数据质量**  
  修复后复权价偶发获取错误、带参 DataType kwargs 错误、实时 K 线索引无有效交易时间等问题。
- **refill_data_source**  
  `channel` 与 `data_source` 可选并增加校验。

## 1.4.0 (2025-02-05)

- **DataType 体系**  
  新 DataType 类简化本地数据取用；名称可用 `|` 参数（如 `close|b` 后复权收盘）。
- **数据渠道**  
  新 `data_channel` 模块，支持多在线源；更多预定义数据表与实时价 API。
- **弃用**  
  旧 `adj` 参数、`wt_000300.SH` 成份写法仍兼容但建议改用新 dtype 语法，详见文档。

## 1.3.12 (2024-12-18)

- **Trader TUI/CLI 日志**  
  RESULT DELIVERY 数量显示截断至 2～3 位小数；系统日志面板增加时间戳；TUI 系统信息面板展示环境信息。

## 1.3.11 (2024-11-03)

- **启动配置**  
  修复纯数字字符串在启动配置文件中解析不正确的问题。

## 1.3.10 (2024-09-03)

- **依赖与字体**  
  更新 database 中弃用 pandas 语法与版本要求；新增按操作系统配置 K 线图中文字体（`ZH_font_name_MAC/WIN/LINUX`）。
- **启动配置 API**  
  新增 `get_start_up_settings()`、`start_up_config`；修正 live trader 帮助信息。

## 1.3.9 (2024-09-01)

- **启动配置**  
  `update_start_up_setting()` 对 qt 配置键做合法性校验；`start_up_settings()` 输出与返回值改进；写文件时保留说明头。

## 1.3.8 (2024-09-01)

- **启动配置文件**  
  新增 `start_up_settings()`、`update_start_up_setting()`、`remove_start_up_setting()` 读写启动配置。
- **TUI 下单**  
  修复 TUI 买卖单输入错误处理。

## 1.3.7 (2024-08-31)

- **TUI 交易**  
  支持快捷键手动买卖、撤单；新增交易日志表格。

## 1.3.6 (2024-08-25)

- **CLI orders**  
  `orders` 正确筛选标的；`--time all/a` 生效。
- **CLI summary**  
  新增 `summary`，以可读方式展示指定时段交易操作。

## 1.3.5 (2024-08-22)

- **Trader 状态持久化**  
  退出时保存最近运行状态，再次进入可恢复。
- **delete_account()**  
  删除账户时一并清理交易日志、记录与断点文件。

## 1.3.4 (2024-08-17)

- **模拟券商**  
  无 live 价时增加重试再撤单，降低填单失败率。
- **网格示例**  
  修正示例中 NaN 价格写入策略参数的问题。

## 1.3.3 (2024-08-16)

- **零价买入**  
  修复 live 无价时可能以 0 价买入的问题。
- **pandas 2.2**  
  频率别名兼容，避免 FutureWarning。

## 1.3.2 (2024-08-13)

- **Windows K 线字体**  
  修正 Windows 下蜡烛图中文字体名。

## 1.3.1 (2024-08-13)

- **CLI debug**  
  新增 `debug` 命令切换调试模式。
- **自选价**  
  改进 CLI 监控价显示与修复展示失败；Windows 字体名再次修正。

## 1.3.0 (2024-08-09)

- **示例运行**  
  `-r` 清除订单时可指定账户，而非清空全部账户。
- **交割与日志**  
  卖出现金交割记录更清晰；修复 trade log 现金/持仓记录错误、买入交割异常、空数据提取及 CLI `CHANGE` 若干边界问题。

## 1.2.15 (2024-07-28)

- **内置策略**  
  新增 `ATR`、`OBV` 内置策略及文档。

## 1.2.14 (2024-07-12)

- **内置策略**  
  更新 AD、ADOSC，修正实现并补充 docstring。

## 1.2.13 (2024-06-19)

- **内置策略查询**  
  `built_ins()` 恒返回 id→类型 dict，错误 id 时模糊匹配；`built_in_list()` / `built_in_strategies()` 行为对齐；新增 `built_in_doc()` 返回策略 docstring。

## 1.2.12 (2024-06-12)

- **T+0 卖现**  
  卖股所得现金可立即计入可用现金。
- **撤单与表信息**  
  未成交订单日终正确撤销；Windows 下获取表信息失败问题修复。

## 1.2.11 (2024-06-09)

- **数据源**  
  MySQL 连接失败时回退默认数据源类型。
- **TUI 自选**  
  修复 watch list 管理 bug。

## 1.2.10 (2024-06-07)

- **TUI 自选**  
  Ctrl+A 添加、Ctrl+R 移除自选；添加/退出确认对话框；界面微调。

## 1.2.9 (2024-06-03)

- **live 入门**  
  补充 live 初始化帮助与 docstring。

## 1.2.8 (2024-06-02)

- **UI 选择**  
  命令行 `-u` 须显式指定 `tui` 或 `cli`。
- **账户配置**  
  `live_trade_account` 重命名为 `live_trade_account_name`，帮助信息更完整。
- **qt.candle**  
  未安装 TA-Lib 时仍可生成 K 线。

## 1.2.7 (2024-05-30)

- **数据 refill**  
  修复交易日历缺失时 refill 失败的问题。

## 1.2.6 (2024-05-07)

- **系统表**  
  修复部分场景无法读取系统表最后 record id 的问题。

## 1.2.5 (2024-05-06)

- **HistoryPanel**  
  修复递归 import 问题。

## 1.2.4 (2024-05-05)

- **内置策略**  
  修复 MACDEXT、WILLR、AROONOSC、SLPHT 等策略 bug。

## 1.2.3 (2024-04-30)

- **版本显示**  
  修正 `__version__` 显示错误（曾显示 1.2.1）。
- **下载进度**  
  tushare refill 进度条信息修正。

## 1.2.2 (2024-04-29)

- **性能**  
  未安装 TA-Lib 时偶发极慢问题修复；RuleIterator 策略 escaped failure 修复。
- **live 账户**  
  `qt.live_trade_accounts()` 可查看全部 live 账户。

## 1.2.1 (2024-04-25)

- **打包**  
  修正 1.2.0 样式文件未打入包的问题。
- **live 账户 API**  
  新增 `live_trade_accounts()` 返回各账户详情。
- **CLI**  
  修正 trade info 格式；live 相关配置帮助改进。

## 1.2.0 (2024-04-25)

- **Trader TUI**  
  新增终端 UI，与 Trader Shell 二选一（`live_trade_ui_type`）；内置亮/暗主题；展示账户、持仓、订单与日志；Ctrl+P / Ctrl+R 暂停恢复。

## 1.1.11 (2024-04-20)

- **refill_data_source**  
  支持可调批次大小与间隔的分批下载。
- **配置错误提示**  
  配置键非法值时错误信息更友好。

## 1.1.10 (2024-04-19)

- **tushare 重试**  
  修复 tushare 自动重试相关配置不生效的问题。

## 1.1.9 (2024-04-09)

- **分钟数据**  
  修复本地分钟数据提取偶发错误；兼容性改进。

## 1.1.8 (2024-04-05)

- **Python 3.9–3.12**  
  扩展支持；兼容 pandas 2.2.1、numpy 1.26.4、numba 0.59.1；修复 3.10+ 策略优化失败；若干错误信息改进。

## 1.1.7 (2024-04-03)

- **Python 版本**  
  官方支持 Python 3.9～3.12 安装运行。

## 1.1.4 (2024-03-30)

- **依赖冲突**  
  调整 numba/numpy 版本约束；首次加载警告略改进；修复 pandas > 2.0 兼容问题；优化算法 2 在部分 numpy/numba 组合下的性能警告。

## 1.1.3 (2024-03-25)

- **回测结果**  
  回测返回 dict 新增 `trade_log`、`trade_records`、`full_histories` 键，便于直接访问。

## 1.1.2 (2024-03-18)

- **CLI dashboard**  
  `dashboard --rewind` 可查看历史保存日志。
- **CLI buy/sell**  
  提交结果打印更明确。

## 1.1.1 (2024-03-16)

- **live 系统日志**  
  不同 live 实例写入不同系统日志文件；支持从 live / 系统日志文件读信息。

## 1.1.0 (2024-03-08)

- **Trader Shell 参数解析**  
  全命令支持 `--parameter` / `-p` 风格及 `-h`/`--help`；错误提示与用法说明改进。`watch` 支持 `-r` 移除、`-c` 清空；`buy`/`sell` 用 `-p` 价格、`-s` 方向；`info`/`overview` 增加 `--system`；`orders` 增加 status/time/side/type 过滤；`config` 支持 `-s` 设置与 `-l` 层级；`strategies` 支持 `--set-par`；`run` 支持 `--args` 传任务参数。

## 1.0.27 (2024-03-05)

- **数据库读取**  
  移除通过 pandas SQL 读库路径，避免高版本 pandas 要求 sqlalchemy 的 UserWarning。

## 1.0.26 (2024-02-29)

- **live 日志**  
  live 交易日志写入系统日志文件，以账户号为前缀区分。

## 1.0.25 (2024-02-28)

- **live trade_log 文件**  
  live 模式保存 trade log 文件至 `trade_log_file_path`；若干 live bug 修复与错误信息打印。

## 1.0.24 (2024-02-18)

- **broker 回归**  
  修复 1.0.18 以来 broker 合并不完整导致 live 下单失败的问题。

## 1.0.23 (2024-02-15)

- **filter_stocks / candle**  
  修复类型转换错误导致筛选与 K 线失败的问题。

## 1.0.22 (2024-02-14)

- **get_config / candle**  
  修正 list 日期解析错误；进度条文本截断至屏宽；`get_stock_info()` 无需全部基础表即可运行。

## 1.0.21 (2024-02-11)

- **稳定性**  
  若干 bug 修复。

## 1.0.20 (2024-02-08)

- **免 TA-Lib 指标**  
  修正 EMA、MACD、TRIX、DEMA 在无 ta-lib 时的实现，结果与 talib 版略有差异但可用。

## 1.0.19 (2024-02-07)

- **免 TA-Lib**  
  RSI、MA、BBANDS 不再依赖 ta-lib，无 ta-lib 也可画 K 线；降低初学者依赖门槛。

## 1.0.18 (2024-02-05)

- **Trader Shell 消息**  
  订单成交展示含股数与现金变化；INFO/OVERVIEW 默认不再打印系统信息；numpy 版本要求更新。

## 1.0.17 (2024-01-29)

- **CLI run**  
  可在主线程运行策略便于调试。
- **live 行情**  
  修复运行频率低于 1 小时时 live 价获取失败。

## 1.0.16 (2024-01-27)

- **信号无法下单提示**  
  live 模式现金/持仓不足无法转订单时会提示。
- **成交与成本**  
  修复重复处理成交导致可用量/现金错误、成本计算错误、history 命令多标的成本错误；修复非交易日意外填数据（#85）等问题。

## 1.0.15 (2023-12-29)

- **指数与 ETF live**  
  支持监控指数/ETF live 价；live 交易目标支持 ETF 与指数。

## 1.0.14 (2023-12-22)

- **依赖**  
  移除可选 sqlalchemy；broker 增加最大重试后停止执行。

## 1.0.13 (2023-12-21)

- **Trader Shell**  
  命令模式上下键翻阅历史；新增 `buy`/`sell` 手动下单；live 价后台线程获取。
- **Simulator Broker**  
  按 live 价返回模拟成交；修复订单互相阻塞。

## 1.0.12 (2023-12-07)

- **视觉与 live 价**  
  界面效果改进；live 价后台线程避免主循环卡顿；非本地时区也可显示 live 价；监控刷新间隔可配置。

## 1.0.11 (2023-12-03)

- **Shell 参数风格**  
  支持 `--parameter` / `-p` 新风格（旧风格将弃用）。
- **live 配置**  
  可配置 broker 参数与时区；ta-lib 改为可选，部分内置策略无 ta-lib 仍可用。

## 1.0.10 (2023-11-25)

- **reference 数据**  
  修正 1.0.9 遗留的 reference None 错误。
- **backtest_price_adj**  
  默认值改为 `none`。

## 1.0.9 (2023-11-24)

- **reference 数据**  
  修正 reference 生成与注入策略的逻辑。
- **文档**  
  文档改进。

## 1.0.8 (2023-11-22)

- **Trader Shell**  
  依赖 `rich` 的消息着色；文档发布至 Read the Docs；新增 `qteasy.__version__`。

## 1.0.7 (2023-11-11)

- **Strategy**  
  新增 `use_latest_data_cycle` 控制是否用最新价生成信号。
- **Shell watch**  
  新增 `watch` 实时监控价；Shell 显示股票名称；东方财富 live 价渠道。

## 1.0.6 (2023-10-19)

- **Shell config**  
  新增 `config` 命令。
- **FUND**  
  支持 FUND 作为投资类型。

## 1.0.0 (2023-09-19)

- **首次 PyPI 发布**  
  qteasy 首个可在 PyPI 安装使用的正式版本。