116 lines
5.9 KiB
Plaintext
116 lines
5.9 KiB
Plaintext
# ============================================================
|
||
# Nex Animation Studio · 忽略清单
|
||
#
|
||
# 原则:仓库里放「代码 + 表结构定义 + 文档」。
|
||
# 跑出来的东西、机器相关的配置、含密钥的数据都不进仓库;
|
||
# 需要跨机搬运的数据走 scripts/seed.py export → 部署包,不走 git。
|
||
#
|
||
# 注意:.gitignore 的行内 # 不是注释(会被当成路径的一部分),注释必须独占一行。
|
||
# ============================================================
|
||
|
||
# ---- Python ----
|
||
__pycache__/
|
||
*.py[cod]
|
||
*.egg-info/
|
||
.venv/
|
||
venv/
|
||
.pytest_cache/
|
||
.mypy_cache/
|
||
.ruff_cache/
|
||
|
||
# ---- 运行数据:产物、数据库、日志 ----
|
||
# 换环境时这些属于「迁移」,不属于「部署」
|
||
# media/:生成的视频/图片/配音、上传素材、缩略图(约 1.7G),永远不进仓库。
|
||
# 这里**故意写成任意层级**(不带前导斜杠):产物目录会长在任何地方——
|
||
# 根下 media/、在 backend/ 下启动时漂出来的 backend/media/、以后某个模块
|
||
# 自己建的 backend/app/services/media/……只锚根目录的话,漂出去的副本会被提交。
|
||
# 斜杠结尾只匹配**目录**,所以 media.py / media.ts 这类代码文件不受影响。
|
||
# 但「不受影响」只到文件为止:前端 React 迁移新增了一个**同名的代码目录**
|
||
# frontend/src/components/media/(MediaThumb / AudioPlay / RecordAudio / VersionPanel /
|
||
# MediaLightbox / WorkflowBar),裸 media/ 连它一起忽略,六个组件长期没进版本库、
|
||
# 部署包里也缺一层,而两道体检当时都看不见(一个只看 .vue,一个不数前端文件)。
|
||
# 这里不改成锚根 /media/:上面三条漂出保护更有价值,改用显式反选把代码目录捞回来。
|
||
# 以后再有叫 media/ 的代码目录,这里和 scripts/deploy.sh 的 --include 要一起加。
|
||
media/
|
||
!frontend/src/components/media/
|
||
# /models/:whisper.cpp 听写权重 ggml-small.bin(465M,server.sh install 会自动下载)
|
||
# 这个**必须带前导斜杠**、只锚仓库根:backend/app/models/ 是 ORM 代码目录,
|
||
# 写成裸 `models/` 会连它一起忽略掉(deploy.sh 的 --exclude 'models/' 就是这么炸的)。
|
||
# 判断口诀:名字撞上代码目录的(models/)必须锚根;只可能是产物的(media/)就放开层级。
|
||
/models/
|
||
*.db
|
||
# SQLite 开了 WAL(app/db.py),伴生文件同样是数据,别漏
|
||
*.db-wal
|
||
*.db-shm
|
||
*.sqlite3
|
||
# .local/:pid、日志、验收证据、临时参考素材,全是本机运行痕迹
|
||
.local/
|
||
# reports/*.md 是要留的验收报告,但旁边的证据目录是截图和音视频
|
||
reports/av_sync/
|
||
# 证据目录整体不进仓(截图/日志/音视频都是可再生的大文件),但**读屏腿的脚本和手册必须跟着仓库走**:
|
||
# 阶段 11–13 的 T-1 工装(vo6.py / run_t1.py / preflight.py / README.md)此前只存在于这一块盘上,
|
||
# 换机或重克隆就要照报告重建一遍。所以这里改成「排除内容、逐层放行 vo/ 的 .py 与手册」。
|
||
# 口径不变:放行的是**尺子与手册**,不是证据。
|
||
# ── 证据目录:默认全排,逐层只放行「尺子与手册」(阶段 21 统一成 globstar 一套)──
|
||
# 排除用 **,目录必须先放行,否则深处的 negation 走不进去(Git 不会下进被忽略的目录)。
|
||
reports/*evidence/**
|
||
!reports/*evidence/**/
|
||
# 尺子:任何一层(含 nex-p8/n14/scripts/sortcheck.py 这类深度四的 N14 闸门)都要跟着仓库走。
|
||
!reports/*evidence/**/*.py
|
||
# 同一口径补 .mjs(阶段 22.5):Bundle 那几把尺子是 Node 写的——closure.mjs(阶段 18,UI规范 §13.11 直接点名)、
|
||
# eagergraph.mjs / lazykit.mjs / attribbucket.mjs(阶段 22/22.5)。只放行 py 的话,规范里指向的尺子在新克隆里不存在,
|
||
# 就成了「文档有、仓库没有」。放行的是尺子本体,产物与日志照旧不进仓。
|
||
!reports/*evidence/**/*.mjs
|
||
# 手册:读屏腿的操作手册只有这一份,报告里的步骤指向它。
|
||
!reports/*evidence/*/vo/README.md
|
||
# 不放行的:png / json / log / txt / mp4 / mov / jsonl 等证据本体,可再生,且体积大。
|
||
nohup.out
|
||
*.log
|
||
*.pid
|
||
|
||
# ---- 密钥与部署数据 ----
|
||
# .env 是机器相关配置(ComfyUI 地址、数据库串),进仓库的是模板 .env.example
|
||
.env
|
||
.env.local
|
||
.env.*.local
|
||
# scripts/seed/ 是 scripts/seed.py export 的产物:模型配置密文 + 加密主密钥 + 口令哈希。
|
||
# 主密钥能解开全部 API Key,和密文同级机密,只随部署包走,不进仓库。
|
||
scripts/seed/
|
||
.local/deploy/
|
||
*.tar.gz
|
||
|
||
# ---- 容器数据卷(docker compose 把 ./data 挂进容器当库 + 媒体)----
|
||
# 一旦误提交,别人 pull 下来就自带你这台机器的库和出片产物
|
||
/data/
|
||
|
||
# ---- 前端 ----
|
||
node_modules/
|
||
frontend/dist/
|
||
dist/
|
||
.vite/
|
||
|
||
# ---- 系统 / 编辑器 ----
|
||
.DS_Store
|
||
._*
|
||
.Trash*
|
||
.idea/
|
||
.vscode/
|
||
*.swp
|
||
|
||
# ---- 本项目约定:删掉的东西先进回收站 ----
|
||
# .trash/ 是「随时可恢复」与「已确认无用」的分界线(本目录当前还不是 git 仓库,
|
||
# 但约定先行,将来接仓库时不用二次清理)
|
||
.trash/
|
||
|
||
# 阶段 19:临时构建目录(Bundle 取证用的对照产物 / 带 sourcemap 的产物)。
|
||
# 两条理由,缺一不可:
|
||
# 1) Tailwind v4 的自动内容扫描会把非忽略目录里的构建产物当源码读,产物 CSS 里的
|
||
# 类名被原样读成候选 —— 实测 frontend/dist-b1 一份对照产物让正式 CSS
|
||
# 从 77 786 B 涨到 88 997 B(多 84 条死工具类 / 12.6 %,gzip 1.55 kB)。
|
||
# 真正的修法在 frontend/src/styles/index.css 的 @source not "../../dist*",
|
||
# 这条规则是第二道:顺带让 git status 干净。两处都被实测验证过,别只留一处。
|
||
# 2) index-*.css.map 的 sourcesContent 同理(曾让 CSS 多 638 B 且哈希漂移)。
|
||
frontend/dist-*/
|
||
|
||
# 设计规范相关
|
||
nex_design_system/ |