fix: decouple release bundle from local knowledge base

Author: MisonL

README.md

@@ -135,6 +135,7 @@ uv run python scripts/build_binary_release.py --target macos-x64 --validate
 ```
 
 发布工作流定义在 [`.github/workflows/release.yml`](/Volumes/Work/code/PyRAG-kit/.github/workflows/release.yml)，发布说明会从 [CHANGELOG.md](/Volumes/Work/code/PyRAG-kit/CHANGELOG.md) 的对应版本节自动提取。
+二进制包内默认只包含空的 `knowledge_base/` 占位目录，使用时请自行放入 Markdown 源文档后再构建知识快照。
 
 ---
 

scripts/build_binary_release.py

@@ -24,7 +24,6 @@
     "config.toml.example",
     ".env.example",
 ]
-PACKAGE_DIRS = ["knowledge_base"]
 HIDDEN_IMPORTS = [
     "src.providers.google",
     "src.providers.openai",
@@ -107,12 +106,28 @@ def stage_bundle(target: str, version: str) -> Path:
     shutil.copytree(app_source, app_target)
     for relative_file in PACKAGE_FILES:
         shutil.copy2(PROJECT_ROOT / relative_file, bundle_root / relative_file)
-    for relative_dir in PACKAGE_DIRS:
-        shutil.copytree(PROJECT_ROOT / relative_dir, bundle_root / relative_dir)
+    prepare_runtime_layout(bundle_root)
 
     return bundle_root
 
 
+def prepare_runtime_layout(bundle_root: Path) -> None:
+    knowledge_base_dir = bundle_root / "knowledge_base"
+    data_kb_dir = bundle_root / "data" / "kb"
+    data_logs_dir = bundle_root / "data" / "logs"
+
+    knowledge_base_dir.mkdir(parents=True, exist_ok=True)
+    data_kb_dir.mkdir(parents=True, exist_ok=True)
+    data_logs_dir.mkdir(parents=True, exist_ok=True)
+
+    placeholder = knowledge_base_dir / "README.md"
+    placeholder.write_text(
+        "# 知识库目录\n\n"
+        "请将您的 Markdown 知识库文档放入当前目录，然后再执行知识库构建。\n",
+        encoding="utf-8",
+    )
+
+
 def archive_bundle(bundle_root: Path, target: str) -> Path:
     if target == "windows-x64":
         archive_path = bundle_root.parent / f"{bundle_root.name}.zip"

tests/test_release_scripts.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+from pathlib import Path
+
+from scripts.build_binary_release import prepare_runtime_layout
+from scripts.extract_release_notes import extract_section
+
+
+def test_prepare_runtime_layout_creates_placeholder_directories(tmp_path):
+    prepare_runtime_layout(tmp_path)
+
+    assert (tmp_path / "data" / "kb").is_dir()
+    assert (tmp_path / "data" / "logs").is_dir()
+    placeholder = tmp_path / "knowledge_base" / "README.md"
+    assert placeholder.is_file()
+    assert "Markdown" in placeholder.read_text(encoding="utf-8")
+
+
+def test_extract_section_returns_version_content():
+    section = extract_section("1.3.0")
+
+    assert section.startswith("## [1.3.0]")
+    assert "运行与配置" in section