继续完善代码

scripts/cli/app.py

@@ -7,12 +7,14 @@ import sys
 from typing import List, Optional
 
 from service.task_service import (
+    cmd_config_path,
     cmd_health,
     cmd_log_get,
     cmd_logs,
     cmd_run,
     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
@@ -88,6 +90,9 @@ def build_parser() -> ZhArgumentParser:
     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())
     return p
@@ -95,12 +100,15 @@ def build_parser() -> ZhArgumentParser:
 
 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
-    if len(argv) == 2 and argv[0] not in {"run", "logs", "log-get", "health", "version", "-h", "--help"}:
+    if len(argv) == 2 and argv[0] not in {
+        "run", "logs", "log-get", "health", "config-path", "version", "-h", "--help"
+    }:
         return cmd_run(target=argv[0], input_id=argv[1])
     parser = build_parser()
     args = parser.parse_args(argv)

scripts/main.py

@@ -28,6 +28,10 @@ from jiangchang_skill_core.runtime_env import apply_cli_local_defaults
 
 apply_cli_local_defaults()
 
+from util.config_bootstrap import bootstrap_skill_config
+
+bootstrap_skill_config()
+
 from cli.app import main
 
 if __name__ == "__main__":

scripts/service/task_service.py

@@ -7,9 +7,10 @@
 from __future__ import annotations
 
 import json
+import os
 from typing import Optional
 
-from jiangchang_skill_core import collect_runtime_diagnostics, format_runtime_health_lines
+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
@@ -90,15 +91,41 @@ def cmd_log_get(log_id: str) -> int:
     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(),
     )
-    status = "failed" if runtime.has_fatal_issues else "ok"
-    print(f"{SKILL_SLUG} health: {status}")
-    for line in format_runtime_health_lines(runtime):
+    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
 

scripts/util/config_bootstrap.py

@@ -0,0 +1,19 @@
+"""技能配置初始化：.env.example 落盘与用户 .env 缺失项合并。"""
+
+from __future__ import annotations
+
+import os
+
+from jiangchang_skill_core import config
+
+from util.constants import SKILL_SLUG, SKILL_VERSION
+from util.runtime_paths import get_skill_root
+
+
+def bootstrap_skill_config() -> str:
+    """确保用户数据目录 .env 存在，并追加 .env.example 中的新配置项。"""
+    example_path = os.path.join(get_skill_root(), ".env.example")
+    env_path = config.ensure_env_file(SKILL_SLUG, example_path)
+    comment = f"{SKILL_SLUG} v{SKILL_VERSION}" if SKILL_VERSION else None
+    config.merge_missing_env_keys(example_path, env_path, comment_skill=comment)
+    return env_path