Commit Graph
7 Commits
Author SHA1 Message Date
awayingsandClaude f58010ead8 docs: README 瘦身至 204 行 + 文档导航;修复 examples 财务锚点
- README 保留功能介绍/30 秒上手/架构摘要/安装/Web UI 入口,CLI 参考、
  Web API、Python API、枚举、完整 API 列表、架构树、开发章节全部移交 docs/
- 新增「文档导航」段:24 份 docs 全部从 README 可达,完整索引见 docs/index.md
- examples/06_finance/README.md 的 #财务 锚点改指 docs/cli-finance.md#财务

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:55 +08:00
awayingsandClaude ae24c3a5f1 docs: 新增 architecture/development,重写 docs/index.md 全量索引
- architecture.md:七层架构图 + 源码树 + 分层要点(越层直调/协议层无 IO/
  e2e_mock 替身/__main__ 三形态/平台差异)
- development.md:环境初始化/测试三层分布/静态检查/开发流程四阶段
  (需求 Issue→开发测试→提交 CI→发布 release+CHANGELOG)/文档规范
- index.md:人类目录(分类+每文件一句描述+历史归档标注)+ 完整 toctree
  (38 个 md 全部入树,消除 ReadTheDocs orphan 页面)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:50 +08:00
awayingsandClaude 990b4a7802 docs: 拆分超大文档——教程/参考分离,去过期版本横幅,模型枚举归并
- backtest_usage(742→485):CLI 章移交 cli-backtest.md,示例/注意事项
  抽至 backtest-examples.md,重建目录
- quantitative-guide(628→325):第 5-7 章(滑点/执行仿真/归因/工作流)
  抽至 quantitative-advanced.md 并重编号
- api_reference(704→478):删除过期版本横幅(1.16.2)与快速开始教程段;
  数据模型/枚举与 field_mapping.md 逐表核对后去重(field_mapping 为唯一权威);
  WebSocket 节随 web-api.md 合并移除
- field_mapping:吸收 MAC 协议枚举(Period/Adjust/Category/BoardType/
  SortType/ExMarket),全部文档回到 ≤500 行

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:44 +08:00
awayingsandClaude 36b586b015 docs: README Python API 章拆至 python-api.md(教程),枚举/API 列表归入参考文档
- python-api.md:连接/MAC/统一客户端/标准协议/离线/缠论/公告/财报/实时轮询教程
- MAC 协议枚举(Period/Adjust/Category/BoardType/SortType/ExMarket)并入 field_mapping.md
- MacClient/MacExClient 完整方法表并入 api_reference.md(TdxClient 表与正文重复,删除)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:35 +08:00
awayingsandClaude d8b3a1afb5 docs: README Web 章拆至 web-api/web-ui,WebSocket 帧规范并入 web-api
- web-api.md:REST/WebSocket/SSE 端点与示例;吸收 api_reference.md 的
  WebSocket 帧表/控制消息/行为约定/前端接入,消除两处互补重复
- web-ui.md:行情终端与回测工作台零代码操作手册(原错位嵌套在
  「本地 K 线仓库」章节下的 Web UI 块,补全章节结构)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:30 +08:00
awayingsandClaude bfb8789ae8 docs: README CLI 章按域拆至 docs/cli*.md + chanlun/data-local(含参数表去重合并)
- cli.md 命令总览(补 chanlun/zhuoyao/bias-signal 漏项)+ 按域导航
- cli-market / cli-finance / cli-indicators / cli-screen / cli-backtest 按域拆分
- cli-backtest 吸收 backtest_usage CLI 章的 backtest/optimize 参数表与 --indicators 说明
- chanlun.md(CLI+Python)、data-local.md(warehouse+offline)按主题合一
- 策略 demo 图复制至 docs/images/demo/,图片与内联链接路径改写为 docs 内相对路径

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-08 23:21:26 +08:00
ac512d791c fix(offline): sync-daily 成交量单位换算(股→手),修复大盘股 uint32 溢出 (#60)
encode_daily_bar 按 vol/vol_coeff(vol_coeff=0.01 时 ×100)写入 .day,
期望输入为手;而 K 线协议返回的成交量单位是股。原 _sync_one_daily 直接把
股喂给 append_daily_bars,日成交 >4295 万股的股票(招商银行等)编码后
溢出 uint32,struct.pack('I') 报错,sync-daily/sync-all 失败。

在 vol_coeff == 0.01 的证券类型写入前换算 股→手(读取端 ×0.01 还原,
方向对称)。用服务器原生 .day 文件实测验证:浦发银行 2026-08-31 原始
vol 字段 99,682,464 与协议 API(股)完全一致。

Co-authored-by: awayings <awayings@qq.com>
Co-authored-by: Claude <noreply@anthropic.com>
2026-08-31 20:28:15 +08:00