fix: harden binary release smoke test

Author: MisonL

main.py

@@ -17,7 +17,7 @@
 # 导入 cleanup 模块以注册 atexit 钩子
 import src.utils.cleanup
 # 从新的配置模块导入 settings 实例
-from src.utils.config import get_settings
+from src.utils.config import get_settings, resolve_app_root
 # 导入日志管理器，以便调用其清理函数
 import src.utils.log_manager
 # 导入UI工具
@@ -137,6 +137,24 @@ def initialize_dependencies():
 
     console.print("[dim]依赖项初始化完成。[/dim]")
 
+def run_smoke_test() -> int:
+    """执行非交互式启动自检。"""
+    settings = get_settings()
+    console.print(f"PyRAG-Kit {VERSION} smoke test ok")
+    console.print(f"app_root={resolve_app_root()}")
+    console.print(f"log_path={settings.log_path}")
+    return 0
+
+
+def run_cli(argv: list[str] | None = None) -> int:
+    """解析启动参数并执行对应入口。"""
+    args = list(sys.argv[1:] if argv is None else argv)
+    if "--smoke-test" in args:
+        return run_smoke_test()
+    main()
+    return 0
+
+
 def main():
     """程序主入口，提供交互式菜单并实现延迟加载。"""
     display_banner()
@@ -177,4 +195,4 @@ def main():
             console.print("[bold red]请检查错误信息并重试。[/bold red]")
 
 if __name__ == "__main__":
-    main()
+    sys.exit(run_cli())

scripts/build_binary_release.py

@@ -149,15 +149,16 @@ def executable_path(bundle_root: Path) -> Path:
 
 def validate_bundle(bundle_root: Path) -> None:
     executable = executable_path(bundle_root)
-    subprocess.run(
-        [str(executable)],
+    result = subprocess.run(
+        [str(executable), "--smoke-test"],
         cwd=bundle_root,
-        input="4\n",
         text=True,
         capture_output=True,
         check=True,
         timeout=30,
     )
+    if "smoke test ok" not in result.stdout:
+        raise RuntimeError("发布包自检输出不符合预期。")
 
 
 def main() -> None:

tests/test_main_entry.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+import main
+
+
+def test_run_cli_uses_smoke_test(monkeypatch):
+    called = {"count": 0}
+
+    def fake_run_smoke_test():
+        called["count"] += 1
+        return 0
+
+    monkeypatch.setattr(main, "run_smoke_test", fake_run_smoke_test)
+
+    result = main.run_cli(["--smoke-test"])
+
+    assert result == 0
+    assert called["count"] == 1

tests/test_release_scripts.py

@@ -1,7 +1,8 @@
 # -*- coding: utf-8 -*-
+import subprocess
 from pathlib import Path
 
-from scripts.build_binary_release import prepare_runtime_layout
+from scripts.build_binary_release import prepare_runtime_layout, validate_bundle
 from scripts.extract_release_notes import extract_section
 
 
@@ -20,3 +21,25 @@ def test_extract_section_returns_version_content():
 
     assert section.startswith("## [1.3.0]")
     assert "运行与配置" in section
+
+
+def test_validate_bundle_uses_smoke_test(monkeypatch, tmp_path):
+    bundle_root = tmp_path / "bundle"
+    app_dir = bundle_root / "PyRAG-Kit"
+    app_dir.mkdir(parents=True)
+    executable = app_dir / "PyRAG-Kit"
+    executable.write_text("", encoding="utf-8")
+
+    recorded = {}
+
+    def fake_run(command, **kwargs):
+        recorded["command"] = command
+        recorded["kwargs"] = kwargs
+        return subprocess.CompletedProcess(command, 0, stdout="PyRAG-Kit 1.3.0 smoke test ok\n", stderr="")
+
+    monkeypatch.setattr("scripts.build_binary_release.subprocess.run", fake_run)
+
+    validate_bundle(bundle_root)
+
+    assert recorded["command"][-1] == "--smoke-test"
+    assert recorded["kwargs"]["check"] is True