[anjia0532]

摘要

在已合并的 #30 之上，新增市场资讯模块：用两个 7615 免登录 Entry 取全市场资讯流。

• client.f10.market_news(tab=3, *, page=1, page_size=50) —— 资讯首页顶部要闻流，CWServ.tdxi_zxxwsy；tab 取 1 滚动 / 2 今日焦点 / 3 要闻速递 / 4 正面 / 5 负面 / 6 精华 / 7 最新提示 / 9 机构调研
• client.f10.channel_news(channel, *, page=1, page_size=50, query1="1", keyword="") —— 按频道号取栏目资讯，CWServ.tdxi_zxxwnews，共 84 个频道（财经 / 股票 / 新股 / 港股 / 美股 / 基金 / 期货 / 理财 / 外汇 / 债券 / 期权）
• client.f10.news_channels() —— 频道号与中文名（静态枚举，不发请求）

资讯流不走 code + section 分派，与个股 F10 是两条独立通道；新闻行在响应 result_sets[1].rows，用 extract_news_rows() 提取。

顺带把「期货分时与连续合约命名」文档补进 EXTENDED_MARKET.md（沪金主连 = AUL8）。

提交

提交	内容
388f94e feat(news)	资讯模块（f10/news.py）+ CLI 三个子命令 + MCP 三个工具 + 单页文档
30d3dac docs(ex)	期货分时与连续合约命名（AUL8）
eecf3e8 docs(news)	补齐五处入口文档 + test_news.py

文档补齐（本次重点）

新模块此前只有 methods/F10-市场资讯.md 单页，按 CLI / MCP / API 任一入口查都找不到。补齐：

• docs/CLI.md —— eltdx f10 action 表：news-channels / market-news / channel-news，标注 --tab 的 8 个取值
• docs/MCP.md —— 工具表：eltdx_market_news / eltdx_channel_news / eltdx_news_channels
• docs/API_REFERENCE.md —— 新增「市场资讯」小节，说明三个方法与底层 Entry
• docs/METHOD_REFERENCE.md —— 常用 F10 方法表补三行，含完整签名
• docs/F10_7615.md —— 新增「市场资讯（tdxi_zxxw*）」章节，登记两个 Entry 并补 #entry-* 锚点
• docs/methods/README.md —— 索引（原提交已含）

测试

新增 tests/test_news.py（9 条，离线）：

• NewsHomeTab 枚举值（8 个，query=8 前端已停用故不收录）
• news_channels() 排序、84 个频道、元素类型
• market_news / channel_news 的 Entry 与 Params 顺序（含默认值 ["3","1","50"]）
• 未知 tab / 频道号降级为数字字符串
• extract_news_rows 取第 2 个结果集，缺表或无 result_sets 时返回空列表

已登记到 python_test_groups.json 的 round4-local。

验证

• 1608 passed，ruff check 通过
• sync_docs --check：docs/ 与 src/eltdx/docs/ 镜像一致
• mkdocs build --strict：0 warning（含新增页面与全部相对链接）
• 无定版内容（Cargo / CHANGELOG / releases / interface-catalog / check_release_* 均未改动）

本机 36 个失败与本次改动无关：34 个 test_protocol_unit.py 可转债 volume_lots 用例是 src/eltdx/_native.pyd 编译产物过期（纯净 upstream/main 上同样失败），另 2 个为已知环境限制（版本断言、verify_wheel_matrix 不支持 Windows）。

[anjia0532]

这是我手头最后一个PR了。

[electkismet]

感谢补齐市场资讯接口和文档。我把当前 main（f603734）与本 PR 的 eecf3e8 合并到临时目录做了复核：

• market_news() / channel_news() 在默认 static 网关和 page2 上均能返回新闻；
• 合并后的 round4-local：1550 passed；
• 另外构建了真实 Windows wheel，并在独立环境安装验证，发现一处合并前需要补齐的检查。

本 PR 新增 3 个 MCP 工具后，总数已经是 35；tests/test_mcp.py 已更新，但 scripts/smoke/mcp_stdio_check.py:21-22 仍断言 32：

RuntimeError: expected 32 MCP tools, got 35

调用链是 verify_wheel_matrix.py → installed_smoke.py → mcp_stdio_check.py。PR 的 CI 会跳过 native-dist，因此目前的绿色检查没有覆盖到这里；合并 main 后的五平台 wheel 安装检查，以及后续 Publish，都会执行这段检查并失败。

请把这两行中的工具数从 32 同步为 35（断言和报错文本），再跑一次安装包 smoke。我已在临时副本只调整这两个数字，用同一个真实 wheel 验证通过。

这轮复核未发现其他阻塞项，补齐这一处后再合并即可。