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。

src/easy_tdx/cli/__init__.py

@@ -19,6 +19,7 @@ from .cmd_board import (
 )
 from .cmd_capital import capital_flow
 from .cmd_chanlun import chanlun
+from .cmd_company import company_info, company_info_content, finance_info
 from .cmd_ex import ex
 from .cmd_factor import factor
 from .cmd_finance import f10, fund_flow
@@ -80,6 +81,9 @@ cli.add_command(server_info)
 cli.add_command(symbol_info)
 cli.add_command(f10)
 cli.add_command(fund_flow)
+cli.add_command(finance_info)
+cli.add_command(company_info)
+cli.add_command(company_info_content)
 cli.add_command(ex)
 cli.add_command(indicator)
 cli.add_command(indicator_list)

src/easy_tdx/cli/cmd_company.py

@@ -0,0 +1,165 @@
+"""通达信原生 F10 / 财务快照命令（TDX 协议，与 Web 层 ``/finance`` ``/company/*`` 同源）。
+
+与 ``cmd_finance.py`` 的新浪三表（``f10``）区别：
+  - ``f10``                走新浪 HTTP，输出多期结构化利润表/负债表/现金流
+  - 本模块走通达信协议，输出最新一期财务快照 + F10 全文板块
+"""
+
+from __future__ import annotations
+
+import click
+
+from ..models.enums import Market
+from .parsers import parse_market
+
+
+@click.command("finance-info")
+@click.argument("market")
+@click.argument("code")
+@click.option("--table", "use_table", is_flag=True, help="表格输出")
+@click.option("--output", "output_fmt", type=click.Choice(["json", "table", "csv"]), default="json")
+def finance_info(market: str, code: str, use_table: bool, output_fmt: str) -> None:
+    """获取最新财务快照（通达信协议，30+ 项单期指标）。
+
+    含股本结构、资产负债、利润、现金流、每股指标等最新一期数据。
+    与 ``f10``（新浪多期三表）互补，本命令仅返回最新一期。
+
+    \b
+    示例：
+
+      easy-tdx finance-info SH 600519 --table
+
+      easy-tdx finance-info SZ 000001
+    """
+    from ..exceptions import TdxError
+    from .conn import get_tdx_client
+    from .output import print_error, print_output
+
+    fmt = "table" if use_table else output_fmt
+    mkt = Market(parse_market(market))
+    try:
+        with get_tdx_client() as client:
+            df = client.get_finance_info(mkt, code)
+    except TdxError as e:
+        print_error(str(e))
+        raise SystemExit(1) from e
+    print_output(df, fmt)
+
+
+@click.command("company-info")
+@click.argument("market")
+@click.argument("code")
+@click.option("--table", "use_table", is_flag=True, help="表格输出")
+@click.option("--output", "output_fmt", type=click.Choice(["json", "table", "csv"]), default="json")
+def company_info(market: str, code: str, use_table: bool, output_fmt: str) -> None:
+    """获取 F10 公司信息板块目录。
+
+    返回各板块的名称（最新提示/公司概况/财务分析/持股情况/股本结构/
+    分红融资/高管信息/行业产品/新闻公告/回顾展望 等）、文件名及偏移长度。
+    拿到板块名后可用 ``company-info-content`` 读取正文。
+
+    \b
+    示例：
+
+      easy-tdx company-info SH 600519 --table
+    """
+    from ..exceptions import TdxError
+    from .conn import get_tdx_client
+    from .output import print_error, print_output
+
+    fmt = "table" if use_table else output_fmt
+    mkt = Market(parse_market(market))
+    try:
+        with get_tdx_client() as client:
+            df = client.get_company_info_category(mkt, code)
+    except TdxError as e:
+        print_error(str(e))
+        raise SystemExit(1) from e
+    print_output(df, fmt)
+
+
+@click.command("company-info-content")
+@click.argument("market")
+@click.argument("code")
+@click.argument("name_or_filename")
+@click.option(
+    "--offset",
+    default=0,
+    type=int,
+    help="偏移（字节）：传板块名时为板块内相对偏移，传文件名时为文件绝对偏移，默认 0",
+)
+@click.option("--length", default=1024, type=int, help="读取长度（字节，默认 1024）")
+def company_info_content(
+    market: str, code: str, name_or_filename: str, offset: int, length: int
+) -> None:
+    """读取 F10 公司信息板块正文（GBK 文本）。
+
+    ``name_or_filename`` 既可传板块名（如 ``最新提示``，自动查目录解析），
+    也可直接传文件名（如 ``600519.txt``）。建议先用 ``company-info``
+    查看可用板块名。
+
+    ``--offset`` 语义随入参而定：传板块名时为**板块内相对偏移**
+    （0 = 板块起点）；传文件名时为**文件绝对偏移**。
+
+    \b
+    示例：
+
+      easy-tdx company-info-content SH 600519 "最新提示"
+
+      easy-tdx company-info-content SH 600519 600519.txt --length 2048
+    """
+    from ..exceptions import TdxError
+    from .conn import get_tdx_client
+    from .output import print_error
+
+    mkt = Market(parse_market(market))
+    try:
+        with get_tdx_client() as client:
+            filename, seg_start, matched_board = _resolve_filename(
+                client, mkt, code, name_or_filename
+            )
+            # 板块名命中：--offset 解释为板块内相对偏移（默认 0 = 板块起点）
+            # 文件名：--offset 解释为文件绝对偏移
+            effective_offset = seg_start + offset if matched_board else offset
+            content = client.get_company_info_content(mkt, code, filename, effective_offset, length)
+    except _ResolveError as e:
+        print_error(str(e))
+        raise SystemExit(1) from e
+    except TdxError as e:
+        print_error(str(e))
+        raise SystemExit(1) from e
+    click.echo(content)
+
+
+class _ResolveError(Exception):
+    """板块名解析失败（内部信号异常，与 TdxError 分开捕获）。"""
+
+
+def _resolve_filename(
+    client: object, market: Market, code: str, name_or_filename: str
+) -> tuple[str, int, bool]:
+    """把板块名或文件名解析为 (filename, 板块起始 offset, 是否板块名命中)。
+
+    策略：先查 F10 目录，若 ``name_or_filename`` 命中某个板块名则返回
+    (对应 filename, 该板块 start, True)；否则视为文件名返回 (name_or_filename, 0, False)。
+    返回的 ``matched`` 决定 ``--offset`` 的语义：板块名时为相对偏移，文件名时为绝对偏移。
+    """
+    # 形如 '600519.txt' 的文件名，跳过目录查询直接用（offset 为绝对偏移）
+    if "." in name_or_filename:
+        return name_or_filename, 0, False
+
+    df = client.get_company_info_category(market, code)  # type: ignore[attr-defined]
+    if not df.empty:
+        row = df.loc[df["name"] == name_or_filename]
+        if not row.empty:
+            return str(row["filename"].iloc[0]), int(row["start"].iloc[0]), True
+
+    # 未命中板块名：当作不带后缀的纯 ASCII 文件名兜底（如 '600519' → '600519.txt'）
+    if name_or_filename.isascii() and name_or_filename.isalnum():
+        return f"{name_or_filename}.txt", 0, False
+
+    available = "" if df.empty else "、".join(df["name"].tolist())
+    raise _ResolveError(
+        f"未找到板块名 '{name_or_filename}'。"
+        + (f"可用板块：{available}" if available else "请先运行 `easy-tdx company-info` 查看目录。")
+    )

src/easy_tdx/cli/conn.py

@@ -1,10 +1,11 @@
-"""CLI 连接工厂：延迟创建 MAC 客户端。"""
+"""CLI 连接工厂：延迟创建 MAC / TDX 客户端。"""
 
 from __future__ import annotations
 
 from collections.abc import Generator
 from contextlib import contextmanager
 
+from ..client import TdxClient
 from ..ex.mac_client import MacExClient
 from ..mac.client import MacClient
 
@@ -26,6 +27,26 @@ def get_mac_client() -> Generator[MacClient, None, None]:
         client.close()
 
 
+@contextmanager
+def get_tdx_client() -> Generator[TdxClient, None, None]:
+    """创建 TDX 客户端上下文（自动选最快服务器）。
+
+    用于通达信原生协议命令（F10 公司信息、最新财务快照等），
+    与 Web 层 ``/finance`` ``/company/*`` 端点同源。
+
+    使用方式::
+
+        with get_tdx_client() as client:
+            df = client.get_finance_info(market, code)
+    """
+    client = TdxClient.from_best_host()
+    try:
+        client.connect()
+        yield client
+    finally:
+        client.close()
+
+
 @contextmanager
 def get_mac_ex_client() -> Generator[MacExClient, None, None]:
     """创建扩展市场 MAC 客户端上下文（端口 7727）。"""