aeroxw/easy-tdx
1
0
Fork 0
mirror of https://ghfast.top/https://github.com/aeroxw/easy-tdx.git synced 2026-09-12 15:44:15 +08:00
Code Issues Packages Projects Releases Wiki Activity
273 Commits 1 Branch 0 Tags
052119e6ae3d3a0f67413dbe7ccfbd184c68e430
Commit Graph
39 Commits
Author SHA1 Message Date
GitHub d0d65d64b8 feat: v1.20.0 服务器失败自动 ping 切换（无需手动 easy-tdx ping） 
服务器连不上或返回空数据时，自动测速切到延迟最低的可用服务器再试，
Python API / CLI / Web API 三入口全部自动生效。

核心改动：
- _reconnect.py 新增 select_best_host_sync/async（连接失败 failover）
  和 find_working_host_sync/async（空数据逐台实测）
- 8 个 client 的 _execute 注入跨主机故障转移（复用 auto_reconnect 开关）
- get_market_stat 空数据时按延迟顺序逐台实测找返回数据的服务器
- 新增 _reconnect/_areconnect helper 收敛重建连接副本
- MacClient failover 用 save_best_mac_host（延续 v1.19.4 不污染 best_host）
- 顺手修复 test_commands_offline 未使用 import（main CI failure 根因）

测试：925 passed（新增 18 个 failover 测试），ruff/mypy 零新增错误。
 2026-07-08 18:07:37 +08:00
Justin Gu 14debdb446 feat(web-ui): v1.19.7 服务器设置页面（测速+切换通达信服务器） 
新增 web UI 第六个页面「服务器设置」，让用户在浏览器上：
1. 列出全部 50+ 候选服务器
2. 一键并发测速（显示延迟和可达性）
3. 点选切换到最快或可用的服务器（热重连，无需重启）

解决不同地区/运营商对通达信各服务器连通性不同的问题。

新增:
- AsyncTdxClient.reconnect_to(host) 热切换方法（持锁，关旧建新）
- GET/POST /api/v1/server/hosts|test|switch 三个端点
- ServerSettingsView.vue 页面（列表+测速+切换）
- 导航栏第六个入口

设计: 先reconnect成功再save_best_host（避免污染config），
host校验只允许候选列表内IP，不自动测速避免首屏卡顿。
 2026-07-07 23:08:32 +08:00
Justin Gu c2c3e7ffb4 fix(release): v1.19.6 release.yml 先构建前端再 pip install（修复EXE丢依赖） 
v1.19.5 EXE 只有 11MB，双击报 ModuleNotFoundError: No module named 'pandas'。
根因：release.yml 先 pip install -e '.[web,packaging]' 再 Build frontend，
但 force-include 要求 web-ui/dist 在 pip install 时就存在——install 阶段
dist 不存在导致 editable install 静默降级，PyInstaller 收集不到第三方包。

修复：调换步骤顺序，Build frontend 在 Install Python deps 之前。
ci.yml 上一 commit 已同样修复。
 2026-07-07 22:23:30 +08:00
Justin Gu d5309454bc fix(packaging): v1.19.5 PyPI wheel 含前端 dist（pip install 后不再 404） 
根因：PyPI wheel 只有 Python 包，不含前端 dist。_resolve_web_dist_dir
三级探测（env/_MEIPASS/仓库根）在 PyPI 安装环境下全失败返回 None，
StaticFiles 不挂载，GET / 返回 404。

修复：
- pyproject.toml hatchling force-include 把 web-ui/dist 映射到包内
  easy_tdx/web/dist
- publish.yml 在 python -m build 前先 npm ci && npm run build
- _resolve_web_dist_dir 新增第 4 级探测：包内 easy_tdx/web/dist

验证：本地构建 wheel 含 4 个前端文件，模拟 PyPI 安装后第 4 级探测
成功找到 dist。907 测试全过。
 2026-07-07 20:46:26 +08:00
Justin Gu 3bc15e620c fix(config): v1.19.4 MAC客户端不再污染标准best_host（取不到数据根因） 
根因：mac/client.py 的 MacClient.from_best_host 和 AsyncMacClient.from_best_host
调用 save_best_host(best)，把选中的 MAC 协议服务器（如 121.36.248.138）
写进了全局 best_host 字段——但这个字段是标准 TDX 协议用的。之后标准
AsyncTdxClient 用 get_best_host 读到这个 MAC host，用标准协议请求 MAC
服务器，返回空 body（偏移 2 剩余 0）。web app lifespan 启动 MAC 客户端
时触发污染。

修复：
- config.py 新增独立的 best_mac_host 字段 + get_best_mac_host / save_best_mac_host
- mac/client.py 4 处改用新字段（不再碰 save_best_host / get_best_host）
- get_best_host 加交叉污染校验：缓存 host 不在标准列表里自动重置
  （自动修复已被污染的 config.json，用户无需手动操作）

测试：新增 5 个回归测试（污染检测 + MAC host 隔离），907 全过。
 2026-07-07 20:36:44 +08:00
Justin Gu 032f5a40c0 fix(web): v1.19.3 K线空body不再500 + SPA路由刷新404 
两个独立问题（日志证据）：

1. K线空body 500：SH600519 等正常股票偶发请求时，通达信返回
   ret_count>0 但 body 完全为空（偏移2 剩余0）。v1.18.3 的容错有
   'if bars:' 条件，bars 为空时 raise → 500。移除该条件，始终 return
   （空列表让前端分页重试比 500 友好）。GetIndexBarsCmd 同改。

2. SPA fallback 缺失：/optimize /portfolio 等前端路由刷新时 404。
   子类化 StaticFiles 为 SPAStaticFiles，404 时返回 index.html。
   API 路径不受影响。

测试：更新 test_security_bars_truncated_first_record（原断言 raise，
现断言返回空列表）+ 新增空 body 回归测试。902 全过。
 2026-07-07 20:13:39 +08:00
Justin Gu ecd6e298f5 fix(packaging): v1.19.2 修复干净 Windows 上 EXE 页面纯黑（MIME 类型） 
根因：干净 Windows（无开发环境）注册表里没有 .js 的 Content Type 映射，
mimetypes.guess_type('.js') 返回 None，StaticFiles 回退到 text/plain。
浏览器 <script type="module"> 启用严格 MIME 检查，拒绝执行 text/plain
的 JS → Vue 不挂载 → 页面纯黑（/docs 不受影响因为它是 API 路由）。

修复：mount 前用 mimetypes.add_type 强制注册 .js/.mjs/.css/.svg 的正确
MIME，无论机器装没装开发工具都生效。

同时改 easy_tdx.spec：datas 用 pathlib.rglob 逐文件展开，更可靠。
 2026-07-07 15:18:53 +08:00
Justin Gu 957cb8eeb0 Merge commit 'e3e8dd4' 
# Conflicts:
#	CHANGELOG.md
#	pyproject.toml
#	src/easy_tdx/commands/security_bars.py
 2026-07-07 01:54:20 +08:00
Justin Gu 0b4ed9af62 feat(packaging): v1.19.1 支持 Windows 单 EXE 打包 + 系统托盘 + 自动发版 
面向零基础老年用户，easy-tdx 可打包成单一 Windows EXE，双击即用。

新增:
- 后端同源托管前端 dist（app.py 三级探测：env → _MEIPASS → web-ui/dist）
- easy-tdx serve 默认 --open-browser，启动后自动开浏览器
- PyInstaller 打包入口（__main__.py）+ spec 配置（easy_tdx.spec）
- 系统托盘（tray.py）：右下角图标，右键"打开浏览器/退出"
  解决老人不会用任务管理器关闭的问题
- GitHub Actions release.yml：打 v* tag 自动构建并发布 EXE 到 Releases
- docs/packaging.md 打包使用文档

修复:
- K 线残缺尾记录导致 500（security_bars.py）：通达信服务器偶发
  ret_count 与 body 长度不匹配，改为 try/except 优雅降级丢弃残缺尾，
  返回已解析的完整记录。GetIndexBarsCmd 同改。加 4 个回归测试。
- PyInstaller frozen 模式三个坑：
  1. console=False 下 stdout/stderr 为 None → 重定向到日志文件
  2. multiprocessing spawn 子进程重新 import __main__ → freeze_support + 子进程检测
  3. 系统托盘需主线程消息泵 → uvicorn 挪到后台线程

文档:
- README/手册改为三档分流：EXE（零基础）/ Python（一条命令）/ 源码（打包）
- 删除 npm run dev / 5173 / 两个终端的过时说明
- 手册补虚拟环境配置 + EXE 打包附录 + EXE 排错 FAQ
 2026-07-07 01:48:07 +08:00
GitHub e3e8dd492e fix: K线响应截断容错 + 一键寻优并发默认8进程 
- security_bars: parse_response 遇末尾残缺记录时丢弃并返回前 N-1 条，
  避免 TDX 服务端截断响应导致整页 500（如 000408 count=800 日线）
- OptimizeView: 一键寻优并发默认 8 进程，用户选择持久化到 localStorage

bump version to 1.18.3
 2026-07-06 13:23:37 +08:00
Justin Gu c901d198ca chore: bump version to 1.18.2 + CHANGELOG 
记录移除拼音声母搜索的回退发版
 2026-07-06 02:55:58 +08:00
Justin Gu c9d80617e8 revert: 移除拼音声母搜索，回到 6 位代码输入 
拼音搜索的底层依赖（首次需爬沪深 A 股 5000 条全名单，几十次 TDX 协议
往返，慢机器几十秒到超时）太重，反复优化（按需加载/遮罩/单飞/预热）
都无法兼顾'不阻塞核心行情请求'与'首次可用'。用户决定放弃此功能，
回到简单稳定的 6 位代码输入。

回退 e2bf29e..2523605 共 6 个 commit 的全部改动：
- 删除 StockSearchInput / AppInitOverlay / useStockSearch
- 移除 pypinyin 依赖、/security/search-index 端点、lifespan 预热
- SymbolPicker / StocksPicker 恢复为纯 6 位代码输入
- README / CHANGELOG 同步回退

代码状态等同 v1.18.1（一键寻优多进程并发）发布后的干净基线
 2026-07-06 02:50:51 +08:00
Justin Gu e2bf29e931 feat(web-ui): 股票代码输入支持拼音声母搜索（zjxc→中际旭创） 
所有股票代码输入框（回测/寻优/组合页）支持代码/中文名/拼音声母三路
匹配的下拉联想。复用项目里早已有但从未被前端消费的 security_list_all
数据（沪深 A 股 5206 只完整中文名表）。

后端:
- 新增 GET /api/v1/security/search-index 端点，返回 [{code,name,initials}]
- 声母用 pypinyin FIRST_LETTER 预计算，进程内缓存，首次算一次常驻
- web extra 新增 pypinyin>=0.50 依赖

前端:
- 新增 useStockSearch composable（模块级缓存 + 三路过滤 + 防抖）
- 新增 StockSearchInput.vue（下拉 + 键盘导航 + 市场标签）
- SymbolPicker / StocksPicker 接入新组件，保留直接输 6 位代码的快路径

实测 zjxc→中际旭创、gzmt→贵州茅台、cjxc→楚江新材，5000 条本地过滤 <5ms
 2026-07-06 01:43:57 +08:00
Justin Gu 044e21064c chore: bump version to 1.18.1 + CHANGELOG 
本次发布两个主题:
1. 一键寻优所有策略支持多进程并发（串行/4/8/16）
2. 策略库组合回测结果加组合评级 + 市场前缀纠正
 2026-07-06 00:59:41 +08:00
Justin Gu c57cde156b feat(web-ui): 策略组合保存 + Tab 分类 + 审计修复 (v1.18.0) 
v1.18.0

策略库新增 kind='multi' 类型：组合回测结果可保存为组合，
卡片「↻ 重跑到今天」一键用今天重跑得到截至当天的策略信号
（持仓/空仓/浮盈/浮亏三态高亮）。策略库拆成「单标的」「组合」
两个 Tab，避免数量多了混排难找。

核心机制：保存配置 → 载入即重跑到今天 → 看持仓表 = 今日信号。
复用现有 SQLite 单表（kind 字段本就是 TEXT），零数据库迁移，
零后端逻辑改动，仅 schema Literal 加 'multi'。

含 10 项代码审计修复：multi-icon 字体误用、lastComboCash 漏赋、
弹窗 ARIA/ESC/focus、三态函数收敛 computed、警示样式合并、
重跑按钮改橙、items 运行时校验、ref 替代 querySelector、
selectedIds 静默替换、文案精简。

补记 v1.17.15 CHANGELOG（橙色按钮 + 名言轮播）。

- 改 web-ui/src/views/StrategiesView.vue（保存组合+Tab+三态+审计修复）
- 改 src/easy_tdx/web/backtest_schemas.py（kind Literal 加 'multi'）
- 改 web-ui/src/types.ts（TS 类型同步）
- 改 CHANGELOG.md（补 v1.17.15 + 新增 v1.18.0）
- bump pyproject.toml 1.17.15 → 1.18.0
 2026-07-05 03:01:09 +08:00
Justin Gu cf843cebad release: v1.17.14 — Web UI 数据评级系统（S/A/B/C/D 五档，三入口覆盖） 
纯前端 TypeScript 实现，零后端改动。回测/组合/寻优三处结果顶部
显示评级徽章，让普通人 1 秒判断「适不适合经常参与」。

评级不看收益率（避免被近期大涨误导），只看风险调整后的持有体验：
卡玛/最大回撤/胜率/利润因子/夏普/波动率六维加权 + 一票否决。
京东方「收益 126% 但胜率 35%」案例 = D 档（核心验证点）。

长线低频策略（6年6笔）不会被冤枉：交易<10笔时只降权胜率/利润因子
维度，不否决整个评级（修复用户实测反馈）。

- 新增 web-ui/src/grading/ 核心模块（engine/thresholds/combinedMetrics/index）
- 新增 GradeBadge.vue + GradeDetails.vue 组件
- 接入 BacktestView/PortfolioView/OptimizeView（寻优排名表加评级列）
- 15 个自检测试（node:test + rolldown 打包），覆盖京东方 D / 长线 B 等场景
 2026-07-05 01:21:18 +08:00
Justin Gu 239ff46ac8 release: v1.17.13 — 修复多策略组合回测最大回撤虚高（分母误用初始值而非峰值） 
用户反馈：3 个策略各自最大回撤仅 45.53%/40.16%/16.89%，组合却显示 83.76%。
根因：_build_combined_equity 的 drawdown_pct 分母误用 initial（固定初始资金），
净值大涨后（总收益 545%，峰值≈6.45×初始）绝对回撤额除以小初始值被等比放大。
改为 drawdown / peak（相对当时峰值，0~1），与单标的 PortfolioTracker 一致。
连带修复卡玛比率（年化/最大回撤）。其余指标经核对均正确。加回归守卫。
 2026-07-04 21:07:39 +08:00
Justin Gu ee628c1b34 release: v1.17.12 — 修复 CI 在新版 FastAPI 上路由注册失败 
DELETE /api/v1/strategies/{id} 原用 status_code=204，较新 FastAPI/Starlette
在路由注册阶段（add_api_route）就抛 AssertionError: Status code 204 must
not have a response body，导致 CI ubuntu 矩阵 21 个 web 测试因 fixture
导入 router 连带 ERROR。改为返回 200 + {"deleted": id} 确认体。
 2026-07-04 20:50:07 +08:00
Justin Gu 05dc9a74af release: v1.17.11 — Web UI 策略库（SQLite 持久化）+ 多策略资金分仓组合回测 
新增两层能力：
1. 策略库：单标的/组合回测结果可保存到本地 SQLite 单文件
   (~/.easy_tdx/strategies.db)，策略库页可载入回填、重跑、删除。
2. 多策略组合回测：勾选 N 个单标的策略，各拿 1/N 资金、各跑原标的，
   净值曲线按日期并集对齐求和，组合结果含 19 项完整绩效指标 + 持仓表。

后端：strategy_store.py(SQLite CRUD) + multi_strategy_engine.py(资金分仓引擎)
+ routers/strategies.py + /backtest/multi-strategy/run/async。
前端：StrategiesView.vue + 保存策略按钮 + 复用组合页图表组件。

895 单测全绿（+24 新增），ruff/mypy strict/前端 vue-tsc 全通过。
 2026-07-04 20:40:57 +08:00
Justin Gu 07205b6166 release: v1.17.10 — 一键寻优「查看」跳转携带完整行情上下文 
- SymbolPicker code/category/startDate/endDate 改 defineModel 双向同步
- OptimizeView 两个「查看」按钮跳转 URL 附带 symbol/startDate/endDate/category
- BacktestView onMounted 回填标的/周期/日期到 SymbolPicker 表单
- 向后兼容：老 URL(只有 strategy/params) 仍正常，缺失字段保持默认
- 前端 vue-tsc / vite build 通过，后端 870 单测全绿(无回归)
 2026-07-04 04:12:46 +08:00
Justin Gu 57cad1f3db release: v1.17.9 — 修复回测交易统计离谱数值（前后端口径错配 + 持仓天数跨月放大） 
- 交易盈亏指标改为收益率口径（avg_win/loss/max_win/loss = pnl/cost_basis）
- 平均持仓天数改用真实日历日相减（原 YYYYMMDD 整数差跨月放大）
- 盈亏比无亏损时记 999.0（原 0.0，与 100% 胜率自相矛盾）
- 新增 Trade.cost_basis 字段 + engine 填充
- 3 个回归守卫；870 单测全绿，ruff/mypy strict/前端 vue-tsc 通过
 2026-07-04 03:55:05 +08:00
Justin Gu cd790c9404 release: v1.17.8 — 修复 windows 3.10 flaky 测试超时 
test_task_runner_does_not_evict_running 用 release.wait(timeout=5) 钉住慢任务保持
running，但 CI 慢环境（windows 3.10）下整个测试执行超过 5s 后任务因超时自动完成、
状态变 done，掩盖了「running 任务被 LRU 错误淘汰」的回归断言。

改为 timeout=30 留足 CI 慢环境余量（release.set() 仍是确定性释放点）。该测试用于
守护 LRU 淘汰跳过 running 任务的并发正确性，与港股逐笔成交无关，是 v1.17.2 引入的
预先存在问题。

本地连跑 5 次稳定通过，867 单测全绿。
 2026-07-04 02:24:48 +08:00
Justin Gu 56153eeb97 release: v1.17.7 — 修复 Windows CI fixture 读取编码 
1.17.5 引入的 tests/fixtures/ex_history_transaction.json 含中文注释，Windows CI
默认用 cp1252 解码 UTF-8 文件触发 UnicodeDecodeError: 'charmap' codec can't
decode byte 0x8f，导致 3 个 Windows 矩阵的 test_parse_ex_history_transaction_hk
失败（Linux 矩阵因默认 utf-8 不受影响）。

修复：所有 fixture 读取显式指定 encoding='utf-8'：
- test_hk_transaction.py 的 load_hex/load_json（直接触发点）
- test_commands_offline.py 的 load_hex（纯 ASCII hex，当前未触发但一并统一）
- test_decode_errors.py 的 _load_hex（同上）

867 单测全绿，ruff format/check / mypy strict 通过。
 2026-07-04 02:11:27 +08:00
Justin Gu 94f631a06b release: v1.17.6 — 港股逐笔成交全量取数 + start 倒序语义文档 
回应 issue #14 后用户反馈：默认 count=2000 取回的成交时间全集中在尾盘。
根因是通达信逐笔协议（A 股 0x122F 与港股 ex 0x23FC/0x2406 一致）的 start 为
倒序语义——start=0 指向最新一笔（收盘方向），并非 bug。02715 全天成交 13327
笔，count=2000 只取最近 2000 笔故集中在尾盘。

新增：
- goods_transaction_all（MacExClient 同步+异步）—— 港股股票类市场自动按 1800/页
  翻页取全天全部逐笔成交，安全上限 50 页（90000 条）。返回协议原生倒序，需正序
  由调用方 df.iloc[::-1]。market 非港股时抛 ValueError。
- _fetch_all_hk_transactions_sync/async（_hk_transaction.py）底层实现。

变更：
- goods_transaction docstring 补 start 倒序语义说明，引导需全天数据用
  goods_transaction_all。

修复：
- 1.17.5 的 test_hk_transaction.py 未过 CI ruff format --check（注释对齐、
  MacTransaction 单行化、文末空行）。

867 单测全绿（+5 全量取数测试），ruff format/check / mypy strict 通过。
 2026-07-04 02:03:47 +08:00
Justin Gu 40ae2eba53 release: v1.17.5 — 港股逐笔成交协议路由修复 (issue #14) 
MacExClient.goods_transaction 此前对所有扩展市场统一复用 A 股 MAC 协议的
SymbolTransactionCmd（0x122F），但 0x122F 数据源未接入港股，服务器对港股
market 一律返回 39 字节空响应（count=0）。

港股股票类市场（HK_STOCK_MARKETS = {27,31,48,49,71,98}）改走 ex 扩展行情
协议：query_date=None → GetExTransactionDataCmd（0x23FC 当日），指定日期 →
GetExHistoryTransactionDataCmd（0x2406 历史）。返回的 ExTransactionRecord
（price 为整数、单位 0.001 HKD）映射为与 A 股 MacTransaction 一致的 schema，
价格 ÷1000 换算为港元浮点，与港股分时图 float 价格对齐。count > 1800 时按
1800/页自动分页。其余扩展市场（美股 / 期货等）保持 MAC 0x122F 路径不变。

新增 src/easy_tdx/ex/_hk_transaction.py（市场判定 + 字段映射 + 自动分页，
同步/异步共用）；回归测试 24 例（tests/unit/test_hk_transaction.py）+ 真实
fixture（港股 00700 在 2026-07-03 的 0x2406 响应）。862 单测全绿，ruff /
mypy strict 通过。
 2026-07-04 01:29:17 +08:00
Justin Gu 78bbe46d01 release: v1.17.4 — Web UI 回测交互重构 + 一键寻优全策略 2026-07-04 00:09:19 +08:00
Justin Gu c15bd8232f release: v1.17.2 — QFQ 深层历史负价修复 
通达信服务端 QFQ 模式对长期重度除权股票（如 601088）深层历史页
返回负价格，导致回测总收益 -3087%、回撤 326.85%、年化 nan、
bollinger 崩溃、10 策略 invalid-value-in-scalar-power、MyTT divide-by-zero。

客户端兜底：检测 QFQ 负价时用 NONE+XDXR 本地重算前复权
（因子以除权日前一交易日含权收盘价为基准，保证除权日前后连续）。
同步+异步双路径一致修复，失败降级返回原值。

- 新增 src/easy_tdx/mac/adjust.py（纯函数 compute_forward_factor/
  apply_forward_adjust/has_bad_prices）
- MacClient/AsyncMacClient 触发本地重算，XDXR 按 (market,code) 缓存
- tests: +20 例（16 纯函数 + 4 集成），844 全绿，ruff/mypy 通过
 2026-07-03 22:42:04 +08:00
Justin Gu bd419da83d release: v1.17.0 — 回测可视化 Web UI（单标的/组合/寻优/对比） 
回测从命令行升级到浏览器可视化。Vue3 + ECharts 单页应用，零代码完成
单标的回测、组合回测、参数网格寻优、结果对比四大场景。

后端新增回测 REST API + 策略注册表 + 后台任务执行器，
内置策略从 5 个扩充到 18 个。823 单测全绿。

README 新增 Web UI 章节，CHANGELOG 记录本次全部变更。
 2026-07-03 11:55:04 +08:00
Justin Gu 133c208510 release: v1.16.3 — 修复 market-stat 全市场涨跌统计家数偏小10倍 
通达信统计指数 880005/880006 的计数类字段返回真实家数的 1/10，
get_market_stat 未做缩放还原，导致 up/down/total/limit_up 等系统性偏小 10 倍。
对 6 个计数字段统一 round(field * 10)，成交额/量/市值不动。
重写 test_get_market_stat_mapping 覆盖还原逻辑。761 单测全绿。
 2026-07-02 12:46:27 +08:00
GitHub 155328df8b release: v1.16.2 — 三轮审计质量加固（B6.9→A7.9） 
经三轮代码审计后的综合质量加固版本，覆盖协议核心层、数据正确性、
错误处理、测试真实度与可维护性。761 单测全绿（+58），ruff/mypy 全过。

主要修复：
- 离线 .day 写入原子化（fsync + _repair_tail + 读取校验，CQS 守住）
- 回测止损前视偏差（延迟下一根开盘 + 跳空保护）
- VWAP 权重索引 / bar_time fail-fast / 绩效除零保护
- 闭包绑定 / 路径穿越 / naive datetime 跨时区 / ruff UP038

重构：
- 抽 AsyncHeartbeatMixin 收敛 4 处心跳副本（12→1）
- 统一 _RETRY_DELAYS 退避序列 / scanner 失败可观测性

新增 5 个测试文件 + 公共 API 类型契约，CI 加 Windows 矩阵 +
trusted publishing 签名 + 锁文件。

详见 CHANGELOG.md
 2026-07-02 03:37:37 +08:00
GitHub bc83ffa4ac fix(tick_charts): 多日分时图 minutes>=1440 报 ValueError (Issue #10) 2026-07-01 16:22:57 +08:00
GitHub 615994ad72 feat(kline): 分钟级K线时间戳可选bar_time对齐Tushare (Discussion #7) 
通达信协议用bar开始时间打时间戳（5min线上午最后一根标11:25、下午第一根标13:00；午休11:30-13:00无bar），而Tushare/同花顺/聚宽用bar结束时间（标11:30/13:05）。新增bar_time参数让用户一键切换，避免自行+5分钟偏移。

- 全部3条K线路径覆盖：A股get_security_bars/get_index_bars、扩展行情get_instrument_bars、MAC get_stock_kline（含同步+异步、get_stock_kline_with_indicators）

- CLI kline新增--bar-time {start,end}选项；Web /bars、/bars/index新增bar_time查询参数

- bar_time=start（默认）保持完全向后兼容；bar_time=end仅对分钟级周期（1/5/15/30/60min）生效，自动按周期时长右移并处理跨小时/跨日边界

- 协议解码层零改动，偏移作为纯展示语义在client层后处理，单一工具函数_apply_bar_time_align_df/_apply_bar_time_align_bars复用于全部路径

- 新增27个单元测试（test_codec_datetime.py偏移逻辑 + test_kline_bar_time.py三路径覆盖），全量700单测通过

- bump 版本号至 1.16.0
 2026-06-30 15:02:27 +08:00
GitHub db83e7505d fix(security_quotes): 修复 ETF/指数实时行情价格被放大10倍 (Issue #8) 2026-06-29 22:15:28 +08:00
Justin Gu 3945800728 feat(cli): company-info 传板块名自动读完整正文（分块循环 + 多服务器重试） 
修复体验问题：此前传板块名仍需用户关心 --offset/--length，太笨拙。
现在传板块名即自动按目录 length 分块循环读取整个板块（单次上限 30720 字节，
大板块如「公司大事」77万字节也能一次读全），--offset/--length 仅传文件名时生效。

- _resolve_filename 返回板块 length，_run_content 分块循环读取完整内容
- 修复分块 offset 推进 bug：原按解码字符串 GBK 重编码计字节，遇 U+FFFD 崩溃；
  改为按请求字节数推进（服务器按字节偏移工作）
- 修复多服务器目录版本不一致：传板块名未命中时自动重试多个服务器（最多4次）
- bump 版本号至 1.15.3
 2026-06-27 04:37:44 +08:00
Justin Gu 781ee6c48a feat(cli): company-info 命令合并 + examples/06_finance 文档完善 
合并 company-info（列目录）与 company-info-content（读正文）为一个命令，
板块名改为可选位置参数：无参数列目录，有参数读正文。消除两个相似命令名
导致的混淆（用户曾误用 company-info SH 601088 "公司概况" 报错）。

- company-info：name_or_filename 可选，无则列 F10 板块目录，有则读正文
- company-info-content：保留为隐藏别名（hidden=True），向后兼容 v1.15.1
- 提取 _run_category/_run_content 模块级函数复用逻辑
- 新增 examples/06_finance/{README.md,company_cli.sh,company_web_api.py}
  覆盖 CLI / Python API / Web API 三种调用方式，含 16 个 F10 板块完整列表
- 更新 company_info.py 板块名为实测的 16 板块
- bump 版本号至 1.15.2
 2026-06-27 04:22:43 +08:00
Justin Gu 3df1ea607f chore(release): v1.15.1 
同步版本号至 1.15.1：pyproject.toml + CHANGELOG。
 2026-06-27 04:05:57 +08:00
Justin Gu 29b6ca33aa feat(cli): 新增 finance-info / company-info / company-info-content 命令 
把 TdxClient 上已封装但未暴露给 CLI 的三个 F10/财务方法做成命令，
数据源走通达信原生协议（与 Web 层 /finance /company/* 同源），
覆盖 f10（新浪三表）之外的 F10 全文板块。

- finance-info: 最新财务快照（37 字段单期指标），与 f10 多期三表互补
- company-info: F10 板块目录（最新提示/公司概况/财务分析/... 等 16 板块）
- company-info-content: 读 F10 正文，支持板块名（自动解析）或文件名
  --offset 语义随入参而定：板块名=板块内相对偏移，文件名=绝对偏移
- conn.py: 新增 get_tdx_client() 上下文管理器

补 README 命令表与 CHANGELOG。
 2026-06-27 04:02:09 +08:00
Justin Gu e5bc1b1a16 docs: 将 README 中的 Changelog 迁移至独立的 CHANGELOG.md 
- README 历史版本记录（1.0.0 → 1.14.5）全部搬运到 CHANGELOG.md
- README Changelog 章节替换为指向 CHANGELOG.md 的链接
- CHANGELOG.md 现包含完整 41 个版本（1.15.0 → 1.0.0）的变更记录
 2026-06-25 03:41:54 +08:00
Justin Gu f36e2d6a6c feat(screen): v1.15.0 — 强势股排名 + 修复证券类型识别与名称分批查询 
新增：强势股排名（screen strength）
- 全市场按 5/20/60 日涨幅加权合成强势分，纯离线扫描
- 三种预设：steady(稳健)/breakout(妖股)/balanced(均衡)
- CLI: easy-tdx screen strength --preset steady --top 50 --table
- Web API: GET /api/v1/market/strength
- 支持自定义权重、成交额过滤、并发扫描

修复：
- _detect_security_type 代码段不全，ETF/基金/科创板/逆回购被误判为 A 股
- screen strength/rank 名称补齐超 80 只时末尾被丢弃（分批查询）

详见 CHANGELOG.md
 2026-06-25 03:33:13 +08:00