feat: 申报赛道推荐助手首版 v1.0.1（match-guide-track-default）

scripts/cli/app.py

@@ -0,0 +1,234 @@
+"""CLI：argparse 与分发（申报赛道推荐助手）。
+
+只负责参数解析并转交 service；业务内核在 match_service / profile_service，
+勿在此按入口复制逻辑。
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import List, Optional
+
+from service.task_service import (
+    cmd_add_teacher,
+    cmd_add_track,
+    cmd_config_path,
+    cmd_health,
+    cmd_import_teachers,
+    cmd_import_tracks,
+    cmd_init_db,
+    cmd_list_reports,
+    cmd_list_teachers,
+    cmd_list_tracks,
+    cmd_match,
+    cmd_match_batch_input,
+    cmd_render_html,
+    cmd_run,
+    cmd_show_report,
+    cmd_stats,
+    cmd_version,
+)
+from util.config_bootstrap import bootstrap_skill_config
+from util.argparse_zh import ZhArgumentParser
+from util.constants import LOG_LOGGER_NAME, SKILL_SLUG
+from util.logging_config import get_skill_logger, setup_skill_logging
+
+
+def _cli_str_or_none(raw: Optional[str]) -> Optional[str]:
+    if raw is None:
+        return None
+    v = str(raw).strip()
+    return v or None
+
+
+def _cli_int_or_none(raw: Optional[str]) -> Optional[int]:
+    raw = _cli_str_or_none(raw)
+    if raw is None:
+        return None
+    try:
+        return int(float(raw))
+    except ValueError:
+        return None
+
+
+def _handle_run(args: argparse.Namespace) -> int:
+    tail = [str(x).strip() for x in (args.run_tail or []) if str(x).strip()]
+    if len(tail) > 2:
+        print("参数过多。")
+        print("用法：python main.py run [target [input_id]] | run [-t target] [-i input_id]")
+        return 1
+    t_target: Optional[str] = None
+    t_input: Optional[str] = None
+    if len(tail) == 2:
+        t_target, t_input = tail[0], tail[1]
+    elif len(tail) == 1:
+        if tail[0].isdigit():
+            t_input = tail[0]
+        else:
+            t_target = tail[0]
+    target = _cli_str_or_none(getattr(args, "target", None)) or t_target
+    input_id = _cli_str_or_none(getattr(args, "input_id", None)) or t_input
+    return cmd_run(target=target, input_id=input_id)
+
+
+def _handle_add_teacher(args: argparse.Namespace) -> int:
+    return cmd_add_teacher(
+        name=str(args.name or "").strip(),
+        department=_cli_str_or_none(args.department) or "",
+        title=_cli_str_or_none(args.title) or "",
+        tags=_cli_str_or_none(args.tags) or "",
+        papers=_cli_str_or_none(args.papers) or "",
+        projects=_cli_str_or_none(args.projects) or "",
+        sci_q1=_cli_int_or_none(args.sci_q1),
+        core_papers=_cli_int_or_none(args.core_papers),
+    )
+
+
+def _handle_add_track(args: argparse.Namespace) -> int:
+    return cmd_add_track(
+        year=int(args.year),
+        track_name=str(args.track_name or "").strip(),
+        program=_cli_str_or_none(args.program) or "",
+        agency=_cli_str_or_none(args.agency) or "",
+        tags=_cli_str_or_none(args.tags) or "",
+        priority=_cli_str_or_none(args.priority) or "",
+        min_title=_cli_str_or_none(args.min_title) or "",
+        min_sci_q1=_cli_int_or_none(args.min_sci_q1),
+        quota=_cli_int_or_none(args.quota),
+        source=_cli_str_or_none(args.source) or "",
+    )
+
+
+def _handle_match(args: argparse.Namespace) -> int:
+    return cmd_match(teacher=_cli_str_or_none(args.teacher) or "", year=_cli_int_or_none(args.year))
+
+
+def _handle_list_reports(args: argparse.Namespace) -> int:
+    return cmd_list_reports(limit=int(args.limit or 20))
+
+
+def _handle_render_html(args: argparse.Namespace) -> int:
+    report_id = getattr(args, "report_id", None)
+    return cmd_render_html(report_id=int(report_id) if report_id else None)
+
+
+def _print_full_usage() -> None:
+    print("申报赛道推荐助手（main.py）可用命令：")
+    print("  python main.py add-teacher --name X [--department 学院] [--title 副教授] [--tags 标签1,标签2]")
+    print("                      [--papers 论文1;论文2] [--projects 项目1;项目2] [--sci-q1 N] [--core-papers N]")
+    print("  python main.py import-teachers --teachers-json <file|->")
+    print("  python main.py add-track --year YYYY --track-name X --track-tags 标签1,标签2 [--program 面上项目]")
+    print("                    [--agency 数理学部] [--priority 关键词1,关键词2] [--min-title 副高及以上] [--min-sci-q1 N] [--quota N]")
+    print("  python main.py import-tracks --tracks-json <file|->")
+    print("  python main.py list-teachers [--department 学院] | list-tracks [--year YYYY]")
+    print("  python main.py match [--teacher X] [--year YYYY]     # 主命令：Top 3 推荐 + 建议书")
+    print("  python main.py match-batch-input                     # 批量匹配 input/ 目录画像")
+    print("  python main.py list-reports [--limit N] | show-report --id N | render-html [--report-id N]")
+    print("  python main.py stats")
+    print("  python main.py run [target [input_id]] [-t target] [-i input_id]")
+    print("  python main.py health | config-path | version | init-db")
+
+
+def build_parser() -> ZhArgumentParser:
+    p = ZhArgumentParser(
+        prog="main.py",
+        description="申报赛道推荐助手：维护教师学术画像与指南赛道库，标签匹配 + 硬门槛过滤，生成可解释的 Top 3 赛道推荐与《申报策略建议书》。",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    sub = p.add_subparsers(dest="cmd", required=True, parser_class=ZhArgumentParser)
+
+    sp = sub.add_parser("add-teacher", help="录入/更新教师画像（按姓名幂等）")
+    sp.add_argument("--name", required=True, metavar="教师姓名")
+    sp.add_argument("--department", default=None, metavar="所属学院")
+    sp.add_argument("--title", default=None, metavar="职称")
+    sp.add_argument("--tags", default=None, metavar="研究标签(逗号分隔)")
+    sp.add_argument("--papers", default=None, metavar="近3年论文(分号分隔)")
+    sp.add_argument("--projects", default=None, metavar="项目经历(分号分隔)")
+    sp.add_argument("--sci-q1", default=None, metavar="SCI一区篇数", dest="sci_q1")
+    sp.add_argument("--core-papers", default=None, metavar="核心论文篇数", dest="core_papers")
+    sp.set_defaults(handler=_handle_add_teacher)
+
+    sp = sub.add_parser("import-teachers", help="批量导入教师画像")
+    sp.add_argument("--teachers-json", required=True, metavar="JSON(file|-)", dest="teachers_json")
+    sp.set_defaults(handler=lambda a: cmd_import_teachers(str(a.teachers_json)))
+
+    sp = sub.add_parser("add-track", help="录入/更新指南赛道")
+    sp.add_argument("--year", required=True, metavar="指南年度")
+    sp.add_argument("--track-name", required=True, metavar="赛道名称", dest="track_name")
+    sp.add_argument("--program", default=None, metavar="项目类型")
+    sp.add_argument("--agency", default=None, metavar="学部/归口")
+    sp.add_argument("--tags", default=None, metavar="需求标签(逗号分隔)")
+    sp.add_argument("--priority", default=None, metavar="优先方向关键词(逗号分隔)")
+    sp.add_argument("--min-title", default=None, metavar="职称门槛", dest="min_title")
+    sp.add_argument("--min-sci-q1", default=None, metavar="SCI一区门槛", dest="min_sci_q1")
+    sp.add_argument("--quota", default=None, metavar="拟资助数")
+    sp.add_argument("--source", default=None, metavar="指南来源")
+    sp.set_defaults(handler=_handle_add_track)
+
+    sp = sub.add_parser("import-tracks", help="批量导入指南赛道")
+    sp.add_argument("--tracks-json", required=True, metavar="JSON(file|-)", dest="tracks_json")
+    sp.set_defaults(handler=lambda a: cmd_import_tracks(str(a.tracks_json)))
+
+    sp = sub.add_parser("list-teachers", help="查询教师画像")
+    sp.add_argument("--department", default=None, metavar="学院筛选")
+    sp.set_defaults(handler=lambda a: cmd_list_teachers(department=_cli_str_or_none(a.department) or ""))
+
+    sp = sub.add_parser("list-tracks", help="查询指南赛道")
+    sp.add_argument("--year", default=None, metavar="年度筛选")
+    sp.set_defaults(handler=lambda a: cmd_list_tracks(year=_cli_int_or_none(a.year)))
+
+    sp = sub.add_parser("match", help="申报赛道匹配（主命令，缺省全部教师）")
+    sp.add_argument("--teacher", default=None, metavar="指定教师姓名")
+    sp.add_argument("--year", default=None, metavar="指南年度")
+    sp.set_defaults(handler=_handle_match)
+
+    sp = sub.add_parser("match-batch-input", help="批量匹配 input/ 目录教师画像")
+    sp.set_defaults(handler=lambda _a: cmd_match_batch_input())
+
+    sp = sub.add_parser("list-reports", help="查询推荐报告历史")
+    sp.add_argument("--limit", default=20, metavar="条数")
+    sp.set_defaults(handler=_handle_list_reports)
+
+    sp = sub.add_parser("show-report", help="查看一份推荐报告详情")
+    sp.add_argument("--id", required=True, type=int, metavar="报告编号", dest="report_id")
+    sp.set_defaults(handler=lambda a: cmd_show_report(report_id=int(a.report_id)))
+
+    sp = sub.add_parser("render-html", help="重建《申报策略建议书》（缺省最近 10 份）")
+    sp.add_argument("--report-id", default=None, metavar="报告编号", dest="report_id")
+    sp.set_defaults(handler=_handle_render_html)
+
+    sp = sub.add_parser("stats", help="匹配统计")
+    sp.set_defaults(handler=lambda _a: cmd_stats())
+
+    sp = sub.add_parser("run", help="任务执行命令骨架")
+    sp.add_argument("--target", "-t", default=None, metavar="目标")
+    sp.add_argument("--input-id", "-i", default=None, metavar="输入id", dest="input_id")
+    sp.add_argument("run_tail", nargs="*", metavar="位置参数")
+    sp.set_defaults(handler=_handle_run)
+
+    sp = sub.add_parser("health", help="健康检查")
+    sp.set_defaults(handler=lambda _a: cmd_health())
+
+    sp = sub.add_parser("config-path", help="输出用户 .env 与模板路径")
+    sp.set_defaults(handler=lambda _a: cmd_config_path())
+
+    sp = sub.add_parser("version", help="版本信息(JSON)")
+    sp.set_defaults(handler=lambda _a: cmd_version())
+
+    sp = sub.add_parser("init-db", help="幂等初始化本地数据库与数据管理元数据")
+    sp.set_defaults(handler=lambda _a: cmd_init_db())
+    return p
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    argv = argv if argv is not None else sys.argv[1:]
+    bootstrap_skill_config()
+    setup_skill_logging(SKILL_SLUG, LOG_LOGGER_NAME)
+    get_skill_logger().info("cli_start argv=%s", sys.argv)
+    if not argv:
+        _print_full_usage()
+        return 1
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return int(args.handler(args))