contract-archive-cli 0.2.7__py3-none-any.whl

contract_archive/cli_party.py

@@ -0,0 +1,166 @@
+"""
+`party` 子命令：管理 known_parties 身份基准库（查看/录入/删除主体固有标识）。
+
+独立文件——cli.py 已逼近 1000 行红线，不能再塞。known_parties.json 含真实 PII，
+故本命令只在本地档案库读写，不提供导出/分享。基准的"首见入库"由 ingest 自动完成，
+本命令组负责人工查看与修正：set 覆盖（纠正被 OCR 读错的首见基准）、rm 删除。
+"""
+from __future__ import annotations
+
+import json as _json
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.table import Table
+
+from .archive.party_registry import PartyRegistry, group_by_value
+from .archive.paths import ArchivePaths, default_archive_root
+# 复用 cli_common 的全局 console（理由同 cli_config）：自建实例会让全局 --no-color 失效。
+from .cli_common import OutputFormat, console, err_console
+from .config import load_settings
+
+# pretty_exceptions_show_locals=False：防 traceback 把 PII 等局部变量 dump 到终端。
+party_app = typer.Typer(
+    help="管理 known_parties 身份基准库（主体固有标识的跨文档核对基准）",
+    pretty_exceptions_show_locals=False,
+    no_args_is_help=True,  # clig.dev：裸 `party` 列出 list/show/set/rm，而非报 Missing command
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+
+_archive_opt = typer.Option(
+    None,
+    "--archive",
+    "-a",
+    help="档案库根目录；不传则用 CONTRACT_ARCHIVE_DIR 或 XDG 默认",
+)
+
+
+def _resolve_archive(archive_opt: Optional[Path]) -> ArchivePaths:
+    """与 cli._resolve_archive 同逻辑：flag > env/config > XDG 默认。隔离实现以避免循环 import。"""
+    if archive_opt:
+        root = archive_opt
+    else:
+        configured = load_settings().archive_dir
+        root = Path(configured) if configured else default_archive_root()
+    return ArchivePaths(root=root.expanduser().resolve())
+
+
+def _load_registry(archive_opt: Optional[Path]) -> PartyRegistry:
+    return PartyRegistry.load(_resolve_archive(archive_opt).known_parties_path)
+
+
+@party_app.command("list")
+def list_parties(
+    archive: Optional[Path] = _archive_opt,
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """列出基准库里所有主体及其固有标识。"""
+    reg = _load_registry(archive)
+    parties = reg.all_parties()
+    if fmt is OutputFormat.json:
+        # known_parties 是跨文档身份核对基准，agent 据此核对身份——给机读出口，别只剩表格。
+        # 空库吐合法 {}（与其它命令空集合吐 [] 同一套契约）。注意：含真实 PII，仍只到本地 stdout。
+        print(_json.dumps(parties, ensure_ascii=False, indent=2))
+        return
+    if not parties:
+        err_console.print("[yellow]known_parties 为空——入库文档后会自动录入首见标识。[/yellow]")
+        return
+    table = Table(title=f"known_parties · {len(parties)} 个主体")
+    table.add_column("主体", style="cyan", no_wrap=True)
+    table.add_column("标识")
+    table.add_column("值", overflow="fold")
+    table.add_column("首见", style="dim")
+    # 表格按值折叠同号多 label（电话/联系电话…）去冗余；--format json 保持原始未折叠。
+    for name, ids in parties.items():
+        first = True
+        for label, rec in group_by_value(ids):
+            table.add_row(name if first else "", label, rec.get("value", ""), str(rec.get("first_seen_doc", ""))[:12])
+            first = False
+    console.print(table)
+
+
+@party_app.command("show")
+def show_party(
+    name: str = typer.Argument(..., help="主体名（姓名或机构全称）"),
+    archive: Optional[Path] = _archive_opt,
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """查看某主体的全部标识基准。"""
+    reg = _load_registry(archive)
+    ids = reg.get(name)
+    if not ids:
+        # json 模式吐 not_found 信封到 stdout（别让 | jq 拿空输入）；table 走 stderr。
+        if fmt is OutputFormat.json:
+            print(_json.dumps({"error": "not_found", "name": name}, ensure_ascii=False))
+        else:
+            err_console.print(f"[red]未找到主体: {name}[/red]")
+        raise typer.Exit(1)
+    if fmt is OutputFormat.json:
+        print(_json.dumps(ids, ensure_ascii=False, indent=2))
+        return
+    # 同值多 label 折叠后才是"几项不同标识"——同号的电话/联系电话算一项，故计数用折叠后行数。
+    rows = group_by_value(ids)
+    table = Table(title=f"{name} · {len(rows)} 项标识")
+    table.add_column("标识", style="cyan")
+    table.add_column("值", overflow="fold")
+    table.add_column("角色", style="dim")
+    table.add_column("首见出处", style="dim")
+    for label, rec in rows:
+        table.add_row(label, rec.get("value", ""), rec.get("role", ""), str(rec.get("first_seen_doc", "")))
+    console.print(table)
+
+
+@party_app.command("set")
+def set_party(
+    name: str = typer.Argument(..., help="主体名"),
+    label: str = typer.Argument(..., help="标识名，如 身份证号 / 电话 / 银行账号"),
+    value: str = typer.Argument(..., help="标识值"),
+    archive: Optional[Path] = _archive_opt,
+) -> None:
+    """手动录入/修正某主体的标识基准（覆盖既有值；用于纠正首见时被 OCR 读错的基准）。"""
+    paths = _resolve_archive(archive)
+    reg = PartyRegistry.load(paths.known_parties_path)
+    try:
+        reg.set(name, label, value)
+    except ValueError as e:
+        err_console.print(f"[red]{e}[/red]")
+        raise typer.Exit(1)
+    reg.save()
+    # 状态变更确认走 stderr（与 delete/vacuum 一致），stdout 留给数据。
+    err_console.print(f"[green]已设置[/green] {name}·{label} → {paths.known_parties_path}")
+    err_console.print(
+        "[yellow]注意：known_parties.json 明文存 PII，已设为仅本人可读(0600)，请勿提交或分享。[/yellow]"
+    )
+
+
+@party_app.command("rm")
+def rm_party(
+    name: str = typer.Argument(..., help="主体名"),
+    label: Optional[str] = typer.Argument(None, help="标识名；省略则删除该主体全部标识"),
+    archive: Optional[Path] = _archive_opt,
+    yes: bool = typer.Option(False, "--yes", "-y", help="跳过确认（删整个主体时需要）"),
+) -> None:
+    """删除某主体的某标识；不给 label 则删除整个主体。"""
+    paths = _resolve_archive(archive)
+    reg = PartyRegistry.load(paths.known_parties_path)
+    target = f"{name}·{label}" if label else name
+    # 删【整个主体】（省略 label）是更危险路径：known_parties 是跨文档 PII 核对基准，
+    # 删错会让后续身份核对静默失准。比照 delete 的守卫——非交互须显式 --yes，TTY 下确认。
+    # 删单个 label（精确指定）影响小，保持轻量、不强制确认。
+    if label is None and not yes:
+        if not sys.stdin.isatty():
+            err_console.print(
+                f"[red]拒绝在非交互环境删除整个主体 {name}：请加 --yes 确认[/red]"
+            )
+            raise typer.Exit(1)
+        if not typer.confirm(f"删除主体 {name} 的全部标识基准？", default=False):
+            err_console.print("[yellow]aborted[/yellow]")
+            raise typer.Exit(0)
+    if reg.remove(name, label):
+        reg.save()
+        err_console.print(f"[green]已删除[/green] {target}")
+    else:
+        err_console.print(f"[red]未找到: {target}[/red]")
+        raise typer.Exit(1)

contract_archive/cli_query.py

@@ -0,0 +1,492 @@
+"""
+只读查询/展示命令：list / search / show / raw / stats / todo / seals。
+
+这些命令不写库、不调用付费 API，是档案库的"读侧"。它们用 @app.command 挂到
+cli_common 的主 app 上——import 本模块即触发注册（见 cli.py 的组装段）。
+
+依赖方向：本模块只 import cli_common（基础设施）+ archive 读函数 + cli_render
+（纯渲染），绝不回头 import cli（写命令模块），以保持 DAG、避免循环 import。
+"""
+from __future__ import annotations
+
+import json as _json
+import sys
+from dataclasses import asdict
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.table import Table
+
+from .archive import (
+    SearchFilter,
+    Stats,
+    collect_stats,
+    list_documents,
+    list_obligations,
+    list_seals,
+    load_document_text,
+    open_archive_db,
+    search_documents,
+)
+from .cli_common import (
+    Actor,
+    ColorWhen,
+    DocStatus,
+    DocType,
+    OrderBy,
+    OutputFormat,
+    _archive_empty,
+    _archive_opt,
+    _resolve_archive,
+    _resolve_ident,
+    app,
+    color_disabled,
+    console,
+    err_console,
+    not_found_json,
+)
+from .cli_render import (
+    build_list_table,
+    build_search_table,
+    build_show_table,
+    color_legend,
+    extracted_terms,
+    render_highlighted,
+    row_to_dict,
+    seal_rows_to_dict,
+)
+
+# ---------- list ----------
+
+
+@app.command("list")
+def list_cmd(
+    archive: Optional[Path] = _archive_opt,
+    limit: int = typer.Option(50, "--limit", "-n", help="最多返回 N 条（按排序截断）"),
+    order_by: OrderBy = typer.Option(
+        OrderBy.ingested_at, "--order-by", help="排序字段"
+    ),
+    status: Optional[DocStatus] = typer.Option(
+        None, "--status", help="过滤状态；默认全部"
+    ),
+    doc_type: Optional[DocType] = typer.Option(
+        None, "--type", help="按文档类型过滤"
+    ),
+    incomplete: bool = typer.Option(
+        False, "--incomplete", help="只列疑似不完整的合同（缺签章/缺要素）"
+    ),
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """列出档案库内已索引文档。"""
+    paths = _resolve_archive(archive)
+    if _archive_empty(paths, fmt):
+        return
+    conn = open_archive_db(paths.db_path)
+    rows = list_documents(
+        conn,
+        limit=limit,
+        order_by=order_by.value,
+        status=status.value if status else None,
+        doc_type=doc_type.value if doc_type else None,
+        incomplete=incomplete,
+    )
+    conn.close()
+
+    if fmt is OutputFormat.json:
+        print(_json.dumps([row_to_dict(r) for r in rows], ensure_ascii=False, indent=2))
+        return
+
+    console.print(build_list_table(rows, paths.root))
+
+
+# ---------- search ----------
+
+
+@app.command()
+def search(
+    archive: Optional[Path] = _archive_opt,
+    name: Optional[str] = typer.Option(None, "--name", help="合同名包含（LIKE）"),
+    party: Optional[str] = typer.Option(
+        None, "--party", help="甲方 OR 乙方包含（LIKE）"
+    ),
+    amount_min: Optional[float] = typer.Option(
+        None, "--amount-min", help="金额下限（元）"
+    ),
+    amount_max: Optional[float] = typer.Option(
+        None, "--amount-max", help="金额上限（元）"
+    ),
+    signed_after: Optional[str] = typer.Option(
+        None, "--signed-after", help="签订日 ≥ YYYY-MM-DD"
+    ),
+    signed_before: Optional[str] = typer.Option(
+        None, "--signed-before", help="签订日 ≤ YYYY-MM-DD"
+    ),
+    expire_before: Optional[str] = typer.Option(
+        None, "--expire-before", help="到期日 ≤ YYYY-MM-DD（找快到期）"
+    ),
+    auto_renewal: Optional[bool] = typer.Option(
+        None,
+        "--auto-renewal/--no-auto-renewal",
+        help="是否自动续约",
+    ),
+    has_risk: bool = typer.Option(False, "--has-risk", help="只显示有风险条款的"),
+    deadline_before: Optional[str] = typer.Option(
+        None,
+        "--deadline-before",
+        help="存在 deadline ≤ YYYY-MM-DD 的义务（找近期待办合同）",
+    ),
+    deadline_after: Optional[str] = typer.Option(
+        None, "--deadline-after", help="存在 deadline ≥ YYYY-MM-DD 的义务"
+    ),
+    actor: Optional[Actor] = typer.Option(
+        None, "--actor", help="义务 actor"
+    ),
+    status: Optional[DocStatus] = typer.Option(None, "--status", help="过滤状态"),
+    has_seal: Optional[bool] = typer.Option(
+        None, "--has-seal/--no-seal", help="有/无印章（默认不过滤）；只想列章本身用 seals 命令"
+    ),
+    seal_owner: Optional[str] = typer.Option(
+        None, "--seal-owner", help="盖章主体包含（LIKE）"
+    ),
+    seal_type: Optional[str] = typer.Option(
+        None, "--seal-type", help="印章类型包含（LIKE），如 合同专用章/公章"
+    ),
+    subject: Optional[str] = typer.Option(
+        None, "--subject", help="主体包含（LIKE），覆盖所有文档类型（含合同甲乙方）"
+    ),
+    limit: int = typer.Option(50, "--limit", "-n", help="最多返回 N 条（按排序截断）"),
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """多字段 AND 过滤查询。"""
+    paths = _resolve_archive(archive)
+    if _archive_empty(paths, fmt):
+        return
+    conn = open_archive_db(paths.db_path)
+    flt = SearchFilter(
+        name=name,
+        party=party,
+        amount_min_cents=int(round(amount_min * 100)) if amount_min is not None else None,
+        amount_max_cents=int(round(amount_max * 100)) if amount_max is not None else None,
+        signed_after=signed_after,
+        signed_before=signed_before,
+        expire_before=expire_before,
+        auto_renewal=auto_renewal,
+        has_risk=has_risk,
+        deadline_before=deadline_before,
+        deadline_after=deadline_after,
+        actor=actor.value if actor else None,
+        status=status.value if status else None,
+        has_seal=has_seal,
+        seal_owner=seal_owner,
+        seal_type=seal_type,
+        subject=subject,
+        limit=limit,
+    )
+    rows = search_documents(conn, flt)
+    conn.close()
+
+    if fmt is OutputFormat.json:
+        print(_json.dumps([row_to_dict(r) for r in rows], ensure_ascii=False, indent=2))
+        return
+
+    console.print(build_search_table(rows))
+
+
+# ---------- show ----------
+
+
+@app.command()
+def show(
+    ident: str = typer.Argument(..., help="档案 id (整数) 或 sha 前缀 (>=4 字符)"),
+    archive: Optional[Path] = _archive_opt,
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """显示单条档案详情。"""
+    paths = _resolve_archive(archive)
+    # show 请求的是具体一条；库不存在/查不到都是错误（exit 1）。
+    # table 模式提示走 stderr；json 模式吐 not_found 信封到 stdout（别让 | jq 拿到空输入）。
+    if not paths.db_path.exists():
+        if fmt is OutputFormat.json:
+            not_found_json(ident)
+        else:
+            err_console.print(f"[yellow]archive empty: {paths.db_path}[/yellow]")
+        raise typer.Exit(1)
+    conn = open_archive_db(paths.db_path)
+    row = _resolve_ident(conn, ident)
+    conn.close()
+
+    if not row:
+        if fmt is OutputFormat.json:
+            not_found_json(ident)
+        else:
+            err_console.print(f"[red]not found: {ident}[/red]")
+        raise typer.Exit(1)
+
+    if fmt is OutputFormat.json:
+        print(_json.dumps(
+            row_to_dict(row, archive_root=paths.root, include_original_source=False),
+            ensure_ascii=False,
+            indent=2,
+        ))
+        return
+
+    console.print(build_show_table(row, paths.root))
+
+
+# ---------- raw ----------
+
+
+@app.command()
+def raw(
+    ident: str = typer.Argument(..., help="档案 id (整数) 或 sha 前缀 (>=4 字符)"),
+    archive: Optional[Path] = _archive_opt,
+    color: ColorWhen = typer.Option(
+        ColorWhen.auto, "--color",
+        help="auto=仅 TTY 上色（管道纯文本）| always（配 less -R）| never",
+    ),
+) -> None:
+    """
+    打印文档原文（MinerU OCR 输出的纯文本）到 stdout。
+
+    与 show 互补：show 看 LLM 抽出的结构化字段，raw 看抽取所依据的原始文本——
+    这正是抽取时喂给 LLM 的同一份内容（raw_text.txt，缺失则退回 markdown.md），
+    用于核对抽取结果是否忠于原文。
+
+    交互终端下默认按抽取来源给命中关键字着色（当事人/金额/日期/风险/字段），
+    一眼看出哪些被 LLM 识别到；管道（非 TTY）时输出纯文本，不破坏 raw|grep / raw|less。
+    """
+    paths = _resolve_archive(archive)
+    # 同 show：请求的是具体一条，库不存在/查不到都按错误处理（exit 1），提示走 stderr。
+    if not paths.db_path.exists():
+        err_console.print(f"[yellow]archive empty: {paths.db_path}[/yellow]")
+        raise typer.Exit(1)
+    conn = open_archive_db(paths.db_path)
+    row = _resolve_ident(conn, ident)
+    conn.close()
+
+    if not row:
+        err_console.print(f"[red]not found: {ident}[/red]")
+        raise typer.Exit(1)
+
+    # output_dir 可能为空串（失败入库的记录），Path("")/"mineru" 会落到不存在目录，
+    # load_document_text 返回 ""，统一走下面的"无原文"分支，无需单独判空。
+    mineru_dir = Path(row.output_dir) / "mineru"
+    text = load_document_text(mineru_dir)
+    if not text:
+        err_console.print(
+            f"[red]no OCR text for id={row.id} sha={row.short_sha}: {mineru_dir}[/red]"
+        )
+        raise typer.Exit(1)
+
+    # 上色判定：always 强制（显式逃生口，压过 NO_COLOR）；auto 仅当 stdout 是 TTY
+    # 且未被全局禁色（--no-color / NO_COLOR）；never 禁用。
+    # 管道默认纯文本——保住 raw|grep / raw|less 的既有行为（不破坏 userspace）。
+    use_color = color is ColorWhen.always or (
+        color is ColorWhen.auto and sys.stdout.isatty() and not color_disabled()
+    )
+    if not use_color:
+        print(text)
+        return
+
+    terms = extracted_terms(row)
+    # 图例走 stderr：解释颜色含义，又不污染 stdout 的原文（even with | less -R）。
+    legend = color_legend(terms)
+    if legend and sys.stderr.isatty():
+        print(legend, file=sys.stderr)
+    sys.stdout.write(render_highlighted(text, terms))
+    if not text.endswith("\n"):
+        sys.stdout.write("\n")
+
+
+# ---------- stats ----------
+
+
+@app.command()
+def stats(
+    archive: Optional[Path] = _archive_opt,
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """档案库统计：总数 / status 分布 / 按月签订分布 / 近 30 天到期数。"""
+    paths = _resolve_archive(archive)
+    # 库不存在 = 零文档档案：合成零值 Stats，走同一条渲染路径，
+    # 不为"空库"单开分支——json 形状始终是对象（不会退化成 list 的 []）。
+    if paths.db_path.exists():
+        conn = open_archive_db(paths.db_path)
+        s = collect_stats(conn)
+        conn.close()
+    else:
+        s = Stats(
+            total=0, by_status={}, by_sign_month={},
+            new_this_month=0, expiring_within_30d=0,
+        )
+
+    if fmt is OutputFormat.json:
+        print(_json.dumps(asdict(s), ensure_ascii=False, indent=2))
+        return
+
+    table = Table(title=f"Archive Stats · {paths.root}")
+    table.add_column("metric", style="cyan")
+    table.add_column("value")
+    table.add_row("total", str(s.total))
+    table.add_row(
+        "by_status",
+        ", ".join(f"{k}={v}" for k, v in sorted(s.by_status.items())) or "-",
+    )
+    table.add_row("new_this_month", str(s.new_this_month))
+    table.add_row("expiring_within_30d", str(s.expiring_within_30d))
+    table.add_row(
+        "by_sign_month",
+        "\n".join(f"{m}: {c}" for m, c in s.by_sign_month.items()) or "-",
+    )
+    console.print(table)
+
+
+# ---------- todo ----------
+
+
+@app.command()
+def todo(
+    archive: Optional[Path] = _archive_opt,
+    actor: Optional[Actor] = typer.Option(
+        None, "--actor", help="义务 actor"
+    ),
+    before: Optional[str] = typer.Option(
+        None, "--before", help="deadline ≤ YYYY-MM-DD"
+    ),
+    after: Optional[str] = typer.Option(
+        None, "--after", help="deadline ≥ YYYY-MM-DD"
+    ),
+    include_undated: bool = typer.Option(
+        False, "--include-undated", help="同时显示无 deadline 的义务"
+    ),
+    within_days: Optional[int] = typer.Option(
+        None,
+        "--within-days",
+        help="便捷选项：deadline 在今天到 N 天内（等价于 --after today --before today+N）",
+    ),
+    limit: int = typer.Option(50, "--limit", "-n", help="最多返回 N 条（按排序截断）"),
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """
+    跨合同列出待办义务（"催办看板"）。按 deadline 升序。
+
+    用例：
+      contract-archive todo --within-days 30           本月需要做的事
+      contract-archive todo --actor party_b            乙方所有待办
+      contract-archive todo --actor party_a --before 2026-12-31
+      contract-archive todo --include-undated          含无日期的（如"签订当日支付定金"）
+    """
+    from datetime import date, timedelta
+
+    if within_days is not None:
+        today = date.today().isoformat()
+        before = before or (date.today() + timedelta(days=within_days)).isoformat()
+        after = after or today
+
+    paths = _resolve_archive(archive)
+    if _archive_empty(paths, fmt):
+        return
+    conn = open_archive_db(paths.db_path)
+    items = list_obligations(
+        conn,
+        actor=actor.value if actor else None,
+        before=before,
+        after=after,
+        include_undated=include_undated,
+        limit=limit,
+    )
+    conn.close()
+
+    if fmt is OutputFormat.json:
+        print(
+            _json.dumps(
+                [
+                    {
+                        "doc_id": it.doc_id,
+                        "contract_name": it.contract_name,
+                        "actor": it.actor,
+                        "action": it.action,
+                        "deadline": it.deadline,
+                        "evidence": it.evidence,
+                    }
+                    for it in items
+                ],
+                ensure_ascii=False,
+                indent=2,
+            )
+        )
+        return
+
+    table = Table(title=f"Todo · {len(items)} obligation(s)")
+    table.add_column("deadline", style="cyan")
+    table.add_column("actor")
+    table.add_column("action", overflow="fold")
+    table.add_column("contract", overflow="fold", style="dim")
+    table.add_column("doc", justify="right", style="dim")
+    actor_label = {"party_a": "甲方", "party_b": "乙方", "both": "双方"}
+    for it in items:
+        deadline = it.deadline or "[dim]无日期[/dim]"
+        table.add_row(
+            deadline,
+            actor_label.get(it.actor, it.actor),
+            it.action,
+            it.contract_name or "-",
+            f"#{it.doc_id}",
+        )
+    console.print(table)
+
+
+# ---------- seals ----------
+
+
+@app.command("seals")
+def seals_cmd(
+    archive: Optional[Path] = _archive_opt,
+    owner: Optional[str] = typer.Option(
+        None, "--owner", "--seal-owner", help="盖章主体包含（LIKE）；与 search 的 --seal-owner 同义"
+    ),
+    seal_type: Optional[str] = typer.Option(
+        None, "--type", "--seal-type",
+        help="印章类型包含（LIKE），如 合同专用章/公章；与 search 的 --seal-type 同义",
+    ),
+    limit: int = typer.Option(200, "--limit", "-n", help="最多列 N 枚印章"),
+    fmt: OutputFormat = typer.Option(OutputFormat.table, "--format", help="table | json"),
+) -> None:
+    """
+    跨文档列印章：某主体有哪些章、各出现在哪些文档（按主体/类型聚合阅读）。
+
+    与 search 互补：seals 列【印章】本身；要按印章条件筛【文档】（哪些合同盖了某章）
+    用 `search --has-seal/--seal-owner/--seal-type`。
+
+    用例：
+      contract-archive seals                  全部印章
+      contract-archive seals --seal-owner 示例公司   某公司的章
+      contract-archive seals --seal-type 合同专用章
+    """
+    paths = _resolve_archive(archive)
+    if _archive_empty(paths, fmt):
+        return
+    conn = open_archive_db(paths.db_path)
+    rows = list_seals(conn, owner=owner, seal_type=seal_type, limit=limit)
+    conn.close()
+
+    if fmt is OutputFormat.json:
+        print(_json.dumps(seal_rows_to_dict(rows), ensure_ascii=False, indent=2))
+        return
+
+    table = Table(title=f"Seals · {len(rows)} 枚")
+    table.add_column("owner", overflow="fold", style="magenta")
+    table.add_column("type")
+    table.add_column("raw_text", overflow="fold", style="dim")
+    table.add_column("doc", overflow="fold")
+    table.add_column("id", justify="right", style="dim")
+    for r in rows:
+        table.add_row(
+            r.owner or "?",
+            r.seal_type or "-",
+            r.raw_text,
+            r.title or "-",
+            f"#{r.doc_id}",
+        )
+    console.print(table)