chore(仓库): 证据目录只放行尺子与手册 + nex_design_system 登记为 submodule

阶段 9–45 落地的第一道:先把「什么东西该跟着仓库走」这条边界收口,否则后面的
提交要么把几百 MB 可再生证据带进仓,要么把规范里点名的尺子留在仓外。

.gitignore:旧的一条 `reports/*evidence/` 把整块证据目录排掉,于是 vo6.py /
run_t1.py / preflight.py / closure.mjs / vo/README.md 这些**尺子与手册**只存在于
这一块盘上——换机或重克隆就要照报告重建一遍,而 `UI规范.md` §13.11 等条目直接
点名它们。改成 globstar 一套:目录逐层放行、内容默认全排,只放行 .py / .mjs /
vo/README.md;png / json / log / txt / mp4 / jsonl 这些证据本体照旧不进仓
(可再生,且体积大)。另补 `frontend/dist-*/`:阶段 19 实测一份对照构建产物
被 Tailwind v4 当源码扫描,正式 CSS 从 77 786 B 涨到 88 997 B(+84 条死工具类),
`index.css` 的 `@source not` 是第一道、这条是第二道,两处都被实测验证过。

nex_design_system:NEX 设计系统本体,有自己的上游仓库与历史,本地停在 `10ccdc1`。
此前它以 gitlink 形态躺在索引里却没有 `.gitmodules`,别人克隆后那是一个
「不知从哪拉」的空目录,而 `AGENTS.md` 的规范层级 6 正指着它的 `docs/02–08`。
现在补 `.gitmodules`(path/url/branch=main),并设 `ignore = untracked`,
让子仓库里的 `.DS_Store`、`nex.config.yaml` 不再污染本仓库的 `git status`。
main
mula.liu 2026-11-12 10:20:59 +08:00
parent 418fb6bc5a
commit 621131417d
3 changed files with 33 additions and 1 deletions

28
.gitignore vendored
View File

@ -47,7 +47,23 @@ media/
.local/
# reports/*.md 是要留的验收报告,但旁边的证据目录是截图和音视频
reports/av_sync/
reports/*evidence/
# 证据目录整体不进仓(截图/日志/音视频都是可再生的大文件),但**读屏腿的脚本和手册必须跟着仓库走**:
# 阶段 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
@ -85,3 +101,13 @@ dist/
# .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-*/

5
.gitmodules vendored 100644
View File

@ -0,0 +1,5 @@
[submodule "nex_design_system"]
path = nex_design_system
url = https://git.unissense.tech/mula/nex_design_system.git
branch = main
ignore = untracked

@ -0,0 +1 @@
Subproject commit 10ccdc164c8fa6ad5d22ff97c0af9c260ebf061b