整理 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,33 @@
+# Project Layout
+
+`aIzhinengti-clean` is the repository-ready project root. The parent `aIzhinengti` directory is only a temporary workspace/reference area.
+
+## Root
+
+- `src/`: renderer application source.
+- `electron/`: Electron main/preload code and app configuration source.
+- `server/`, `admin-panel/`: local auth/admin support code.
+- `scripts/`: development, packaging, release, and maintenance scripts.
+- `packaging/`: build resources and local packaging dependencies.
+- `docs/`: project notes and operational documentation.
+- `archive/`: preserved cleanup leftovers. Do not treat this as active source.
+
+## Packaging Split
+
+- Track small, intentional packaging assets such as icons and JSON config.
+- Keep large runtimes and media packs under `packaging/vendor` or ignored resource subdirectories.
+- Do not place Python runtimes, FFmpeg builds, Playwright browsers, models, fonts, BGM, or generated release output in the project root.
+
+## Generated Or Local-Only Directories
+
+The following root directories are local outputs or runtime data and should stay ignored:
+
+```text
+build/
+data/
+dist/
+dist-electron/
+dist-release-final/
+resources-bundles/
+node_modules/
+```