整理 clean 目录结构说明和忽略规则

2026-06-20 18:36:36 +08:00
parent b6f30a838f
commit 028d407a78
4 changed files with 134 additions and 22 deletions
@@ -0,0 +1,20 @@
+# Packaging Layout
+
+`packaging/` keeps build-time assets separate from application source code.
+
+## Directories
+
+- `build-resources/`: Electron Builder icons and installer assets. Small icon files are source-controlled. Large redistributables such as `vc_redist*.exe` stay local and are ignored.
+- `resources/`: Files copied into the packaged app as `resources/extra`, such as config files, cover templates, tray assets, sound effects, and voice preview cache metadata.
+- `vendor/`: Local packaging dependencies and large runtime bundles, including Playwright, Python runtime, FFmpeg, models, fonts, ziti, and BGM. This directory is intentionally ignored by Git.
+
+## Restore Local Vendor Assets
+
+Use the existing preparation scripts when a fresh checkout needs local packaging dependencies:
+
+```bat
+npm.cmd run prepare-package
+node scripts\copy-playwright-browser.cjs
+```
+
+Dependency download helpers write into `packaging/vendor` instead of the project root.