Function _main_impl

scripts/k.py:2810–3228

()

# ============================================================

def _main_impl():
    parser = argparse.ArgumentParser(
        prog="k",
        description="知识库 CLI - 提供内置工具做不到的结构化查询",
    )
    parser.add_argument(
        "--json", action="store_true",
        help="输出 JSON 格式（给 LLM/脚本用）",
    )
    parser.add_argument(
        "--workspace", dest="workspace", default=None,
        help="指定工作区名称（在 workspaces/ 下查找）。"
             "默认会自动选择第一个存在的 workspace；如果没有则报错并提示运行 `k.py new-workspace <name>` 创建。",
    )

    # 共享 parent：让 --json 在子命令后面也能用
    common = argparse.ArgumentParser(add_help=False)
    common.add_argument(
        "--json", action="store_true", dest="json_sub",
        help="输出 JSON 格式（给 LLM/脚本用）",
    )

    sub = parser.add_subparsers(dest="cmd", required=True)

    p_search = sub.add_parser("search", help="跨 wiki 关键词搜索", parents=[common])
    p_search.add_argument("query")
    p_search.add_argument("--limit", type=int, default=20)

    p_list = sub.add_parser("list-pages", help="按 frontmatter 字段过滤页面", parents=[common])
    p_list.add_argument("--type", dest="filter_type")
    p_list.add_argument("--status", dest="filter_status")
    p_list.add_argument("--confidence", dest="filter_conf")
    p_list.add_argument("--tag", dest="filter_tag")
    p_list.add_argument("--modified-by", dest="filter_by")

    sub.add_parser("list-orphans", help="找无入链的孤儿页面", parents=[common])
    sub.add_parser("list-conflicts", help="找带冲突标注的页面", parents=[common])
    sub.add_parser("list-to-update", help="找带 #to-be-updated 的页面", parents=[common])

    p_back = sub.add_parser("backlinks", help="查询某页的反向链接", parents=[common])
    p_back.add_argument("path", help="目标页面路径，相对项目根")

    p_out = sub.add_parser("outlinks", help="查询某页的出向链接", parents=[common])
    p_out.add_argument("path", help="源页面路径，相对项目根")

    sub.add_parser("health", help="综合健康度报告", parents=[common])

    p_val = sub.add_parser("validate-frontmatter", help="校验 frontmatter", parents=[common])
    p_val.add_argument("path", help="要校验的文件路径")

    p_outline = sub.add_parser("outline", help="显示文档章节大纲（含 preview / agent_summary）", parents=[common])
    p_outline.add_argument("path", help="md 文件路径（相对项目根）")

    p_rs = sub.add_parser("read-section", help="按 anchor 或标题读取整个 H 段", parents=[common])
    p_rs.add_argument("path", help="md 文件路径")
    p_rs.add_argument("anchor_or_title", help="anchor（如 h-2-3-abc123，可加 ^ 前缀）或标题文本")

    p_rb = sub.add_parser("read-block", help="按 anchor 读取单个块（^p-/^t-/^c-/^f-）", parents=[common])