nex_animation/.gitignore

116 lines
5.9 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# ============================================================
# 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/