"""任务编排、日志查询模板。 通用业务编排层:负责参数校验、鉴权、调用具体业务实现、写入任务日志。 复制后在 cmd_run 中实现真正的业务逻辑。 """ from __future__ import annotations import json import os from typing import Optional from jiangchang_skill_core import collect_runtime_diagnostics, config, format_runtime_health_lines from db import task_logs_repository as tlr from service.entitlement_service import check_entitlement from util.constants import PLATFORM_KIT_MIN_VERSION, SKILL_SLUG, SKILL_VERSION from util.runtime_paths import get_skill_root from util.timeutil import unix_to_iso def cmd_run(target: Optional[str] = None, input_id: Optional[str] = None) -> int: """通用任务执行入口模板。复制后请实现真实业务逻辑。""" _ = (target, input_id) ok, reason = check_entitlement(SKILL_SLUG) if not ok: print(f"❌ {reason}") return 1 print("❌ 这是模板仓库,请复制后在 scripts/service/task_service.py 中实现 cmd_run 的真实业务逻辑。") return 1 def cmd_logs( limit: int = 10, status: Optional[str] = None, task_type: Optional[str] = None, target_id: Optional[str] = None, ) -> int: if limit <= 0: limit = 10 rows = tlr.list_task_logs(limit, status, task_type, target_id) if not rows: print("暂无任务日志") return 0 sep_line = "_" * 39 for idx, r in enumerate(rows): rid, ttype, tid, iid, ititle, st, err, rsum, cat, uat = r print(f"id:{rid}") print(f"task_type:{ttype or ''}") print(f"target_id:{tid or ''}") print(f"input_id:{iid or ''}") print(f"input_title:{ititle or ''}") print(f"status:{st or ''}") print(f"error_msg:{err or ''}") print(f"result_summary:{rsum or ''}") print(f"created_at:{unix_to_iso(cat) or str(cat or '')}") print(f"updated_at:{unix_to_iso(uat) or str(uat or '')}") if idx != len(rows) - 1: print(sep_line) print() return 0 def cmd_log_get(log_id: str) -> int: if not str(log_id).isdigit(): print("❌ log_id 必须是数字") return 1 row = tlr.get_task_log_by_id(int(log_id)) if not row: print("❌ 没有这条任务日志") return 1 rid, ttype, tid, iid, ititle, st, err, rsum, cat, uat = row print( json.dumps( { "id": int(rid), "task_type": ttype, "target_id": tid, "input_id": iid, "input_title": ititle, "status": st, "error_msg": err, "result_summary": rsum, "created_at": unix_to_iso(cat), "updated_at": unix_to_iso(uat), }, ensure_ascii=False, ) ) return 0 def cmd_config_path() -> int: example_path = os.path.join(get_skill_root(), ".env.example") env_path = config.get_env_file_path() or "" print( json.dumps( { "skill": SKILL_SLUG, "env_path": env_path, "example_path": os.path.abspath(example_path), }, ensure_ascii=False, ) ) return 0 def cmd_health() -> int: runtime = collect_runtime_diagnostics( skill_slug=SKILL_SLUG, platform_kit_min_version=PLATFORM_KIT_MIN_VERSION, skill_root=get_skill_root(), ) example_path = os.path.join(get_skill_root(), ".env.example") env_path = config.get_env_file_path() or "" env_exists = bool(env_path and os.path.isfile(env_path)) health_status = "failed" if runtime.has_fatal_issues else "ok" lines = [ f"{SKILL_SLUG} health: {health_status}", *format_runtime_health_lines(runtime), f"env_path: {env_path}", f"env_exists: {env_exists}", f"example_path: {os.path.abspath(example_path)}", ] for line in lines: print(line) return 1 if runtime.has_fatal_issues else 0 def cmd_version() -> int: print(json.dumps({"version": SKILL_VERSION, "skill": SKILL_SLUG}, ensure_ascii=False)) return 0