docs: 修正 servers.json 清理后遗留的过时描述(含一处事实反转)
servers.json 复测后三池台数已变(standard 9 / mac 22 / ex 4),但 README 与部分文档
仍停留在旧口径,且有一处因果结论被实测推翻:
- README.md
- 测试用例数 127 → 164(并补「当日测速缓存」到用例分组说明)
- 「已知限制」补测速缓存详情的文档站链接
- docs/internals/routing.md
- 三池台数:标准池「数十台」→ 9 台、MAC 池「数台」→ 22 台(EX 池 4 台不变),
并标注为 2026-09-21 离线探针实测可达数、实际以当日测速缓存为准
- **事实反转修正**:原文「MAC 池远小于标准池,这解释了逐笔/分时并发弱于日线」
与实测不符(mac 22 > standard 9)→ 已改为陈述实测台数,
并指出两通道单台连接上限默认相同(均 4)
- docs/internals/cache-pool.md
- 「为什么 MAC 池更小」小节前提已不成立 → 改为「MAC 通道的单台连接上限」,
保留 mac_pool_cap=4 的可用信息,删除错误因果
- docs/refactor-audit.md
- 历史快照的 127 passed 标注「审查当时」,避免误读为当前基线
验证:scripts/check_docs.py exit 0;mkdocs build --strict exit 0(无告警)
This commit is contained in:
1 parent
d422385877
commit
b78d0fabf5
4 files changed
+14
-10
No files matched your search
@@ -104,7 +104,7 @@ curl -o ~/.workbuddy/skills/pytdxdata/SKILL.md --create-dirs \
|
||||
|
||||
```bash
|
||||
uv sync # 建虚拟环境 + 注册 tdx 命令
|
||||
uv run pytest tests/ # 127 个测试用例(协议 / 池 / 缓存 / 分页 / 全接口回归 / 文件解析 / CLI / 文档漂移)
|
||||
uv run pytest tests/ # 164 个测试用例(协议 / 池 / 缓存 / 分页 / 全接口回归 / 文件解析 / CLI / 文档漂移 / 当日测速缓存)
|
||||
uv sync --group docs # 文档站依赖(mkdocs-material + mkdocstrings)
|
||||
uv run mkdocs serve # 本地预览文档站
|
||||
```
|
||||
@@ -115,7 +115,8 @@ uv run mkdocs serve # 本地预览文档站
|
||||
- 标准通道 K 线 `count < 100` 部分服务器返回空 → 分页器已强制 `min_page=100` 规避
|
||||
- 港股 / 美股期权在通达信协议内无数据
|
||||
- 服务器可用性随时间变化。**当日首次启动会自动在后台测速并缓存**(对调用方无感,当天不再重测);
|
||||
也可用 `python -m pytdxdata.server_probe` 离线重生成随包清单
|
||||
也可用 `python -m pytdxdata.server_probe` 离线重生成随包清单。
|
||||
缓存路径与三个开关见 [安装与配置 → 当日自动测速](https://openbot-coder.github.io/pytdxdata/getting-started/#当日自动测速无感)
|
||||
|
||||
## 免责声明
|
||||
|
||||
|
||||
Reference in new issue
Block a user