mula.liu
|
cceafe4e56
|
v 0.1.2
|
2026-11-12 18:53:28 +08:00 |
mula.liu
|
f2907ac8b7
|
v 0.1.2
|
2026-11-12 18:23:15 +08:00 |
mula.liu
|
5c15acf5ef
|
v 0.1.2
|
2026-11-12 14:26:46 +08:00 |
mula.liu
|
41febc241b
|
docs(reports): 阶段 4–45 实施报告入仓 + 按新规则放行的取证尺
`reports/*.md` 是要留的验收报告,`reports/ui_evidence/` 里放行的只有尺子与手册
(`.py`/`.mjs`/`vo/README.md`),截图与日志等可再生证据本体照旧不进仓——这条边界
由上一个 `chore(仓库)` 提交的 `.gitignore` 定义。
- 40 份阶段报告:NEX 阶段 4–45(含 8.5、8.5.1、22.5 三轮小数号),每份都是
「改了什么 / 复用了什么 / 偏离了哪条 / 实跑读数 / 未完成」五段式;
外加两篇 2026-10-26 的验收报告与 `UI审计与调整`。
- 202 份取证工装:`nex-p8`…`nex-p44` 各阶段的探针脚本、读屏腿(`vo6.py`、
`run_t1.py`、`spinpreflight.py`、`gateselftest.py`、`mdtablecheck.py`)、
Bundle 尺(`closure.mjs`、`eagergraph.mjs`、`lazykit.mjs`、`attribbucket.mjs`)
与 `vo/README.md` 手册。`UI规范.md` 与这些报告里点名的路径在新克隆里从此真实存在。
- 报告里「未 commit」那类句子已统一加时点限定(阶段 44、45 两份本轮改的就是这个口径)。
|
2026-11-12 10:22:03 +08:00 |
mula.liu
|
3e94a79b89
|
docs(规范): 阶段 9–45 口径入册(含 §13.14 执行过程那条)+ 台账 E11 与落地追记
三份规范与 `nex.config.yaml` 必须和这一批代码同时落地,否则「文档与实现冲突」
的账会留给下一轮。
- `docs/UI规范.md`:§2 表/§5.1.2.1(32 档只属于页头与工具条独立动作,卡片内动作
归位)/§12 与 §12.2/§12.3/§13.14(新增:折叠行本身就是可点的语义元素,
同动作的文字胶囊是第二入口,总控台「展开/收拢执行过程」那颗去掉)/§15.1 与
§15.14(12 族族账、`projectswitchcheck` 默认落盘口径)同步。
- `docs/NEX-对照与例外.md`:登记 E11(环节资产页不渲染 `Pager`、命中数住 `<BarRight>`
的理由与证据位置),§7 变更记录补阶段 37–44 各行,末了加一条 2026-11-12 的落地
追记——把本轮之前所有报告里「HEAD 仍是 `418fb6b`」「未 commit」那类句子统一改口径,
并写清两条待办:本地未 push、`nex_design_system` 子仓库指针未 push。
- `docs/工程规范.md`:脚本准入与探针清单跟着第 14 道更新。
- `AGENTS.md`:常驻探针 13 道 → 14 道两处。
- `nex.config.yaml`:`icons` 一栏改为两级表的真实形状(core 54 只/extra 24 只/
index 是桶/`_kit.ts` 不含图形,边界由 `classaudit` 附三守);`board` 断点注释改为
实测的「看板卡宽地板 320→288(auto-fill,minmax)」;`ui_gates` 与 `verification`
两条改为 12 族族账的实际读数口径。**改了尺子就要同步它**,这一条是项目级硬要求。
- `README.md`:补第 14 道探针那一行、初始口令改 `admin@123`、`seed.py install
--reset-password` 的保守口径说明。
表格自检:`/usr/bin/python3 reports/ui_evidence/nex-p37/mdtablecheck.py docs/*.md
reports/*.md` → 文件=50、不符行=0(顺手把阶段 45 报告里代码段内那个裸 `|` 转义掉,
`新建项目|111x32` → `新建项目\|111x32`,GFM 表格里的 code span 同样要转义)。
|
2026-11-12 10:21:58 +08:00 |
mula.liu
|
83ed9622ec
|
test(闸门): 常驻探针补两只新闸与凭据口径,14 道全绿
`scripts/**` 是本项目对 NEX 10「阶段 5 质量门禁」的现成实现,跟着呈现层一起落地。
- 新增 `scripts/ui/projectswitchcheck.py`:第 14 道常驻探针——改了项目数据生命周期
(详情 store/切换与轮询)才跑。判据是换项目不残留、404 认错、静置不闪;
读数落盘默认 `/tmp/nex_ui_projectswitch`,优先级 `NEX_JSON` > `NEX_OUT` >
默认目录(阶段 37 把「跑一次就在版本树里留一个未跟踪文件」这条收掉)。
`README.md` 的探针清单同步补这一行。
- 新增 `scripts/ui/chunkbudget.mjs`:产物级 chunk 预算闸,配 `frontend/chunk-budget.json`
的在册上限,超预算即非零退出。
- 八只常驻探针的登录口令默认值 `admin1234 → admin@123`,跟 `.env.example` 对齐;
只改凭据默认值,判据与豁免一字未动,因此不触发 `gateprobe` 的 29 条自证。
- `classaudit.mjs`:子闸从 9 条扩到 12 族(+附/附二/附三:图标型控件命名 ICNN、
两级表边界、图标出口形状),末尾新增机器可读的 `FAMILY` 族账行——它同时是
`gateprobe` ㉖ 的判据凭据,退出码 = 任一族非零。
- `gateprobe.py` 补到 29 条闸门自证;`visualcheck.py`、`gridcheck.py`、`tableaudit.py`、
`rhythmcheck.py`、`aligncheck.py`、`symmetrycheck.py`、`tagcheck.py`、`footercheck.py`、
`semanticcheck.py`、`feedbackcheck.py`、`btnrowcheck.py`、`btnclustercheck.py` 按各阶段
咬出的缺陷补判据(`footercheck` 的 CASES 改成环节资产页的真实触发器)。
落地前实跑:`node scripts/ui/classaudit.mjs` 退出码 0、12 族全 0;
`.venv/bin/python scripts/ui/gateprobe.py` → `GATEPROBE_OK 29/29`、`^OK` 205 条、
`FAIL` 0 条、退出码 0(与阶段 35 起的基线逐字相同)。14 道活体探针沿用阶段 44
收工(2026-11-11 22:02)的全绿读数——本轮零业务代码改动,R12 全量回归不触发。
同一批 `scripts/**` 里的非探针部分(一起提交,同属质量与部署工装):
- `scripts/seed.py` 补 `--reset-password`:`install` **默认不改已存在账号的口令**
(这台机器可能早就改过,覆盖成开发机的口令是反直觉的倒退),只有显式加这条
才让部署包里的口令生效;`scripts/seed/users.json`/`model_specs.json` 跟着真实
初始口令与模型配置更新。
- `scripts/dev.sh`/`server.sh`/`e2e_selfcheck.py` 里那几处初始口令与提示同步;
`server.sh install` 在没有 `scripts/seed/` 时明确告知「服务器将用 mock 模型 +
admin/admin@123 起步」。
|
2026-11-12 10:21:48 +08:00 |
mula.liu
|
ee17358182
|
feat(前端): 阶段 9–45 呈现层落地——环节资产同构、图标两级表、kit 分包与四处交互收口
这一提交是 NEX 阶段 9–45 里所有**业务呈现层**的落地(不含探针与文档)。
三把尺子里只碰了 `styles/index.css`/`styles/app.css`,`theme/antd.ts` 一字未动;
不升级、不换库、不引入第二套 UI 组件包,业务页仍然不直接 import antd(R8)。
主线:
- 环节「资产管理」与平台资产库呈现层同构(阶段 44):`pages/project/Library.tsx`
换成与 `pages/AssetLibrary.tsx` 同一套 kit 骨架——PageHead / StatGrid /
Tabs+counts / Panel / Ctlbar `cols={5}` / ChipBar / Grid+Tile pick / MediaThumb /
Drawer;摘要尺上收为 `Tile.TILE_SUMMARY` 一处定义,两页共用,不再各写各的。
在册偏离见 `docs/NEX-对照与例外.md` E11(本页接口不收 `page`/`page_size`,
硬造前端切片是假分页;筛选条缺平台那两颗「状态」「排序」下拉,因为环节接口
根本不收 `status`/`sort`,补它们属于功能改动——待授权)。
- 项目总控台去掉「展开/收拢执行过程」那颗文字胶囊(阶段 44):折叠行本身
就是可点的语义元素,胶囊是同一动作的第二入口。口径写进 `UI规范.md` §13.14。
- 卡片动作收口(阶段 45):项目总览 / 环节资产 / 模型中心三处卡片上的动作
按钮按 `§5.1.2.1` 的尺子归位(32 档只属于页头与工具条独立动作,卡片内不再
混挂实底),`Ctlbar` 与 `Fields` 配套。
- 图标:登记表两级拆分落地(阶段 25)——`components/icons/core.ts`
(首屏外壳可达 54 只)/ `extra.ts`(只有懒页面要 24 只)/ `_kit.ts`(不含图形)/
`index.ts` 退化为只转发 core 的桶;边界由 `classaudit` 附三守。
`@ant-design/icons` 按嵌套包定价回落到 `^5.6.1`(阶段 26、27)。
- 分包:`vite.config.ts` 一条 `codeSplitting.groups` 只圈我们自己的四个目录
(components/lib/stores/api),`includeDependenciesRecursively: false` 是关键,
第三方怎么分块一个字不动。同一把 churn 实验:只改 `Input.tsx` 一个字符串,
改前 21 块里 20 块改名(用户多下 1 276 kB/gzip 390 kB),改后第三方大块
1 217 164 B 哈希不变,只有 `kit-*`/`index-*` 换名。
`frontend/chunk-budget.mjs` 的产物级预算基线 `chunk-budget.json` 随仓库走。
- S-2/S-3/T-1 的收口:图标默认为装饰 + 控件补自然中文名称、antd 语言包根因、
表单 id 关联新增 `ui/fieldId.ts`、离线告警宿主、交付面与窄屏表等(阶段 9–43 报告逐条)。
- `public/help/*.png` 是 `helpshots.py` 重新拍的 12 张手册插图(此前与实现漂移)。
提交前当场复跑静态四闸:`npm run typecheck` 0、`npm run build` 0(产物哈希与阶段 44
收工读数一字不差:`Library-0Ke7LMGG.js`/`AssetLibrary-DiALYoDN.js`)、
`node scripts/ui/classaudit.mjs` FAMILY 12 族全 0、`node scripts/ui/chunkbudget.mjs` 全 `ok`。
|
2026-11-12 10:21:29 +08:00 |
mula.liu
|
cbc645c4e1
|
perf(交付面): 按 media type 压缩 + 哈希产物长期缓存,后端与 nginx 同一套口径
Bundle 那十几轮量的是**文件字节**(`chunkinfo`),但线上真正过网的是这一层的响应头:
首屏闭包 1 469 kB 里 1 144 kB 是一个带哈希的 JS chunk,不压就是按 raw 发,量好的
gzip 450 kB 白量。补上缺的另一半(阶段 29、30)。
backend/app/main.py:
- `gzip_eligible()` 是唯一的权威名单,只认 media type 不认路径前缀(只压文本,
mp4 与已压过的图片挡在外面);`ContentTypeGZipMiddleware` 按它决定是否压,
小于阈值的响应不压(压完加头比原文还大,还多一个 `Vary` 命中率)。
- 中间件顺序是有条件的:压缩层必须**最先**注册,否则 `add_middleware` 把自己插到
最外层之后,压缩跑到了鉴权外面。
- 交付面缓存:`/assets` 带内容哈希 ⇒ `public, max-age=31536000, immutable`;
`index.html` 与 history 回落出去的壳 ⇒ `no-cache` 每次回源校验,否则发版后老标签页
拿着旧壳去引已经不存在的哈希文件,用户看到白屏。
frontend/nginx.conf:反代这一层写同一套口径(注释里点名「权威名单在后端
`app.main.gzip_eligible`,这里这份是兜底」),并补 `gzip_proxied any`——
它管的是**带 `Via` 请求头的请求**(nginx 站在 CDN 后面时),默认 `off` 下直连浏览器
照样压;挂 CDN 时这套压缩不能整块失效。三组合 A/B/C 的实测对账在
`reports/ui_evidence/nex-p30/nginx-ab.log`:后端已压时 nginx 透传不叠第二层,
后端没压时这里兜底压上(A 组合 `/api/projects` 341 909 → 53 333 B 是 nginx 自己压的)。
测试:新增 `backend/tests/test_api_content_gzip.py`,`test_spa_history_fallback.py`
补 `test_asset_delivery_cache_and_gzip`,三条断言各自钉住一个会真实发生的事故
(不压 / 壳不回源 / 小文件也压)。
|
2026-11-12 10:21:17 +08:00 |
mula.liu
|
7a7c5e06e8
|
fix(配置): 初始管理员口令三处对齐到 admin@123,测试不再抄第二遍口令
播种用的初始口令在三个地方各写了一份:`.env.example`、`docker-compose.yml` 的
`BOOTSTRAP_PASSWORD` 默认值、`backend/app/config.py` 的 `bootstrap_password`,
三处原本都是 `admin1234`,而实际部署与本机库里跑的是 `admin@123`——默认值和真实
初始口令不一致,新库首启建出来的账号跟所有文档/脚本里那一对对不上。
`backend/tests/test_auth.py` 顺带把写死的 `ADMIN` 改成读 `settings.bootstrap_*`:
口令的权威只有 settings 一处,测试再抄一遍迟早对不上(这一条正是这次对不齐的成因)。
探针脚本里同样的口令默认值(8 只常驻探针)跟着改,走 `test(闸门)` 那个提交。
|
2026-11-12 10:21:03 +08:00 |
mula.liu
|
621131417d
|
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`。
|
2026-11-12 10:20:59 +08:00 |
mula.liu
|
418fb6bc5a
|
docs(规范): 图标语义三档口径入册 + 阶段 8.5.1 实施报告
- docs/UI规范.md §5.1.1:AT-1 从「在册待办」改成成文口径——图标默认是装饰,语义由
它所在的控件说;三档(默认装饰 / 显式具名 / 显式放行)与两头禁止(不许批量
aria-hidden,也不许批量具名);antd 内部自绘图形的处理边界与两类不动的理由写清。
§15.12 十四条 → 十七条判据 + 「对偶断言」规矩;§15.13 补 GLYPH 第 8 条判据与四档读数;
§16 第 9 步把两道新闸纳入改动流程。
- docs/NEX-对照与例外.md §2.8:S-2 标 COMPLIANT + 验收手段;§6 记一条 InputNumber
英文 aria-label 漂移(P2,改它要动 antd 内部 DOM 或全站 locale);§7 变更记录。
- nex.config.yaml:ui_gates 注释与代码对齐(出口形状 ICONA / GLYPH / 17 条判据),
census-icons.py 登记为只读普查、不进串行。
- 阶段 8.5.1 报告:S-2 现状量级(字形名可见 900 → 80、唯一语义 42 → 0、AX 名称含
字形码 261 → 1)、改法、防复发、120 状态像素回归与噪声对照、真机 VoiceOver 实录、
未解决与 MANUAL QA 边界逐条附证据路径。
不复制规范:只在与代码口径冲突处改既有章节,未新建重复文档。
|
2026-11-08 17:26:20 +08:00 |
mula.liu
|
05434ade8d
|
test(闸门): 字形名外泄钉死在源码与 DOM 两头 + 对偶断言规矩
只改判据不配反例,等于装了个不知道会不会响的烟雾报警器。本轮两条新闸都配了
gateprobe 反例,并立下「对偶断言」规矩:新判据必须同时给「必须点名」的坏样本和
「必须放行」的好样本,只测一头不算进串行。
- classaudit 第 2 闸新增 ICONA:逐行核对登记表出口形状,裸 re-export、直接赋值、
换名再导出三种绕法都红;退出码纳入既有聚合。
- semanticcheck 新增第 8 条判据 GLYPH:在 DOM 上认「aria-label 等于自己的类名后缀
anticon-<码>」的字形名外泄,分「外泄 / 被宿主遮蔽 / 无宿主 / 在册豁免」四档;
GLYPH_TOKENS 与登记表出口名交叉核对,两边不同步就报错。
- gateprobe 十四条 → 十七条:GLYPH 外泄必须响、GLYPH-seen 三档好样本必须静、
classaudit 第 2 闸四种绕法必须响 + 一种正当写法必须静。GATEPROBE_OK 17/17。
- 新增 census-icons.py:图标字形名现状只读普查(A 可见 / B 唯一语义 / D 覆盖外),
立项与收口对账用。恒返回 0、不进串行、无退出码,只在 nex.config.yaml 注释登记。
1440 与 430 两档 × 明暗实测:外泄 0 / 被遮蔽 72 / 无宿主 0 / 豁免 0。
|
2026-11-08 17:24:11 +08:00 |
mula.liu
|
4adf77b848
|
fix(可访问性): 图标默认为装饰 · 4 处控件补自然中文名称
@ant-design/icons 每只字形自带 role=img + aria-label=英文字形码,挂在已有文字的
控件里会让读屏把同一个控件报两遍(「upload 导入脚本」「down 导出」)。
- components/icons/index.ts:79 条出口一律套新增的 decorative(),默认 aria-hidden;
调用方显式给非空 aria-label 时保留 role=img(第 ② 档),显式 aria-hidden={false}
时尊重调用方(第 ③ 档)。两头都不一刀切。新增 IconClear。
- kit 一处收口给 4 处「图标就是全部语义」的控件补自然中文名,页面 0 改动:
Tabs more.icon → 更多页签 / SecretInput iconRender → 显示·隐藏密码 /
Pager itemRender → 上一页·下一页 / SearchInput enterButton+clearIcon → 搜索·清空搜索。
- Select/Dropdown/Collapse 的下拉箭头本就被 antd 包在 aria-hidden 里,InputNumber
上下键宿主自带 antd 硬编码英文名,两类都不动(动它要改 antd 内部 DOM 或全站 locale)。
- styles/app.css:唯一一处样式。传 enterButton 元素后 antd 给外层加
.ant-input-search-with-button 并把悬停 z-index 从 1 降到 0,补回 1,悬停像素与改前一致。
DOM 结构、类名、尺寸、颜色、.anticon 选择器一字不变;R15 不受影响。
阶段 8.5.1 · S-2
|
2026-11-08 17:24:06 +08:00 |
mula.liu
|
bc68081967
|
docs(reports): 报告自引用提交号改成本轮最终哈希(amend 前的 97513c6 已不在分支上)
|
2026-11-08 14:52:12 +08:00 |
mula.liu
|
ed85caebe8
|
docs(reports): 阶段 8.5 实施报告——七项逐条结果、HEAD↔工作树对照、chunk 前后与未解决清单
- 七项逐条:CSS Layer DEFERRED(零迁移 + 组织盘点)· 430 顶栏名三通道 ·
六张窄屏表逐表方案(九套窄档列)· 第 9 闸语义化(semanticcheck + 咬出的 4 类 58 条)·
导航两状态入册(代码零改 + aria-current)· chunk 分析后实施 0 处 · N14 真实读屏。
- §8 自动化总账:本仓库真实存在的命令(**没有 lint / 没有单测**)、主跑 13:40→14:19 全表、
postfix 与最终代码两轮复跑(visualcheck-120-final / tableaudit-430·1440-final /
preview-smoke-final 全 0)、84 ⊂ 120 的口径关系与「30 行打印 vs 120 张断言」的说明、
preview 代理缺 NEX_BACKEND 导致第一次冒烟红的那段(含脚本自己的 preflight 修法)。
- §8.3 HEAD 5a10bfb ↔ 工作树同尺对照:tableaudit@430 违规 6→0、@1440 日志逐字节相同、
semanticcheck 两档 58→0;软档口径未动(NAME 硬0/软40、热区候选 138、24 次走位)。
- §7 VoiceOver 实跑 13 PASS / 3 部分 / 4 待人工,**NVDA + Chrome 本机无环境未执行**
⇒ N14 = MANUAL QA REQUIRED,**阶段 8 不标记完全验收通过**。
- §9 未解决清单 17 条带编号与严重度(L-1/L-2、N-1..N-3、T-1..T-3、S-1..S-4、C-1..C-3、
AT-2′、N14)+ NEX 侧未落地 N9/N10/N12/N17;§10 交付索引与停止线(未做批量 P2 整改、
未动 Header/Sider 尺寸、未换组件库、未升技术栈、未碰后端)。
- 证据树 `reports/ui_evidence/nex-p8f/`(01–11)按仓库既有 `.gitignore:50` 不进版本库,
报告里明写它是本机路径、换机器需重跑闸。
|
2026-11-08 14:51:24 +08:00 |
mula.liu
|
98ea70d74f
|
docs(规范): 阶段 8.5 六处落点 + 常驻探针计数与代码对齐(12 → 13 道)
批准书 §1 的 DEFERRED 要求「先梳理组织关系、只在可复现缺陷处局部修」,§9 要求
「设计规范更新」,所以规范层落了六处,且**不新建第二份规范**(尺子仍只在 UI规范.md):
`docs/UI规范.md`(+316/−11)
· §1.1.2 全站样式组织现状 + CSS Layer 迁移的 DEFERRED 决策:分层/未分层清点口径、
当前层叠优先级怎么成立(Tailwind layers → antd → 未分层 .nex-* 覆盖层)、
`@layer` 声明 0 条 / `!important` 4 条全在 reduced-motion 内、唯一那条压过
`max-md:hidden` 的未分层规则(=L-1)、以及为什么真要迁就要连 preflight 一起想清楚
· §6.2.1 导航的两个状态与「故意不同的生命周期」(折叠=偏好走 localStorage /
抽屉=一次性动作走 useState)+ 当前页对辅助技术可见(aria-current)的暴露规则与折叠档边界
· §6.5 「窄屏不许把入口弄丢」后补三通道:Hover / Focus / Touch,只在真的截断时弹,
触屏档按 `matchMedia('(hover: hover)')` 能力收口(不弹),并登记 N-3 待真机复测
· §13.2.1 窄屏表格两套列档位:`useNarrowTable()` 口径、九张表各自方案表、
「换列定义不换 DOM」的辅助技术理由、数据完整性对账方法(token 级失踪计数)
· §15 标题与 §15.12/§15.13:十三道常驻探针 + 一道反向验证,新增 semanticcheck 那条判据说明
· §16 第 9 / 第 12 步:改尺子的回归清单补上 `gateprobe` 十四条判据与 semanticcheck
`docs/NEX-对照与例外.md`(+8/−3):§8 响应式那行补本项目走的第四条路(窄档换 columns,
建议 NEX 补进 04 §8.2 → N17);§2/§3/§5 新增一行「验收手段」判定 = COMPLIANT(阶段 8.5
起有机器证据),并记下 NEX 08 只列要求不给证明方式;HEAD↔工作树语义读数改成本轮实测口径。
`AGENTS.md`(+2/−2):两处「12 道常驻探针」→ 13 道。这是 semanticcheck 加进来之后
文档与代码对不上的最后一处,现已全站 grep 无残留旧计数。
|
2026-11-08 14:50:30 +08:00 |
mula.liu
|
434370206c
|
NEX 阶段 8.5·第6项:chunk 归属测量脚本(分析完实施 0 处)
批准书 §6 是「先分析,再实施低风险优化」。分析需要一个能回答「这一段字节是谁的」的尺子:
`build --sourcemap` 之后按每个 chunk 的 mapping 区间把模块字节归到文件,
得到组成 / 前十大依赖 / raw·gzip·brotli / 首屏闭包,全部实测、不抄构建器口径。
实测结论(详见 reports/NEX阶段8.5 §6):13 条路由**已经全部** `lazy()`,首屏闭包 7 个文件
在 before/after 完全同构(`ui-*.js` 1187.8 kB 是 rolldown 自动分组,不是本项目的手工分包决策);
首屏 raw 1486.24 → 1487.42 kB、gzip 453.87 → 454.33 kB、brotli 370.90 → 371.37 kB
(三次构建抖动 ≤0.25 kB,增量来自第 3 项的两套列定义);全部产物 +11 kB 全落在换页才拉的
lazy chunk。所以按批准书三条禁令:不抬 `chunkSizeWarningLimit`(警告仍在=C-1)、
不做没依据的全局分包、不改首屏结构 ⇒ **本轮实施 0 处**,只留下这把尺子。
|
2026-11-08 14:50:17 +08:00 |
mula.liu
|
2821475eac
|
NEX 阶段 8.5·第5项:导航两状态入册 + 当前页对辅助技术可见(aria-current)
批准书 §5 的决策是「保持现有分离设计」,所以**两条状态本身一行代码都没改**:
桌面折叠走 `useLocalStorage`(reload 后 `ls="true"`、侧栏 63 px,实测守住),
移动端抽屉开合走 `useState`(`localStorage` 键集为空、reload 后 `open:false`)。
为什么不合并成一条 Boolean,理由写进 `docs/UI规范.md` §6.2.1:折叠是**偏好**
(用户按住的那把尺子,跨会话有效,丢了每次开机都要重展开),抽屉是**一次性动作**
(读完当前这条就该关掉,持久化会让下次进站内先撞一块挡住正文的板子);
两者生命周期不同,共用一条状态等于让手机用户替桌面用户付账。
顺手关掉本轮实测抓到的真实缺口 AT-2:选中项只有 `.ant-menu-item-selected` 这个类,
`li[role=menuitem]` 上没有 aria-current / aria-selected(rc-menu 只在 role=option 分支写
aria-selected),VoiceOver 因此只报「菜单」不报「当前页面」。补 `currentMark(key)` 给
当前路由那一项写 `aria-current="page"`,并把 `useMemo` 依赖补上 `pathname`
(少一项就会在换页后把标记留在旧项上,选中态与标记同源才谈得上「一致」)。
文件头那句「可达性 Menu 自带,不必再自证」是错的,一并改成实测结论 + 证据路径。
验证:三条路由 + 抽屉内**有且只有当前项**带 `aria-current`,菜单宽度 207 未变(没挤出
新视觉);折叠成图标轨时二级项不渲染 → 折叠档 AT 仍读不到当前页,弹层展开后恢复,
这条边界写进规范并登记 S-4。VoiceOver 是否真播报「当前页面」未复听 → AT-2′。
|
2026-11-08 14:50:16 +08:00 |
mula.liu
|
357942ba2e
|
NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复
为什么要新闸:此前所有检查(含 classaudit 的 9 道子闸)量的是**源码字符串**——
aria-label 写没写、tabIndex 写没写。字符串会骗人:`aria-label=" "`、指向不存在 id 的
aria-labelledby、常年写着的 `aria-expanded="true"`、给了 `role=button` 却没 tabIndex、
被 CSS `outline:none` 吃掉的焦点环——源码看着齐全,辅助技术什么都读不到。
批准书 §4 要求「优先用实际浏览器行为与辅助技术语义验证」,所以全部换成真东西:
CDP `Accessibility.getFullAXTree` 读 AT 实际拿到的角色与名称、`getComputedStyle` 读算出来的
焦点环、真按 Tab / Space / Escape 看键盘走到哪儿。
七条判据(退出码 = offender 条数):NAME(AT 可读名称,硬/软两档)· HOTSPOT(pointer 可点
但键盘到不了)· TAB(走位与焦点掉出文档)· FOCUS(焦点环可见性,聚焦前后实测对比)·
ARIA(声明的状态与运行时一致)· LIVE(状态通知)· STATES(空/错误/加载六态)。
旋钮:NEX_WIDTH / NEX_THEME / NEX_ROUTES / NEX_TABS / NEX_NAMESTRICT / NEX_HOTSPOTSTRICT /
NEX_FOCUS_DWELL。软档默认不进退出码(当前 20 颗/主题属「补一句 aria-label 就干净」的历史欠账,
登记为 S-1,按路由分批转硬),不为了让灯变绿而调口径。
它第一天咬到的 4 类 58 条真缺陷,全部就地修好:
· AudioPlay 进度条:可点可拖却键盘到不了、role=slider 没有值 → 补 `tabIndex` +
`valuemin/max/text` + ←→↑↓ 5% / Shift 20% / Home / End,并 stopPropagation(不抢页面滚动)
· MediaLightbox 只读进度:假 slider 是 ARIA 谎报 → 改 `role=progressbar`
· AssetLibrary 三处图标按钮无 AT 名称 → 补 aria-label(选择素材 / 母版)
· `input.nex-file-input` 焦点环被全局 `:where(...):focus-visible{outline:none}` 吃掉
→ `app.css` 唯一一处 +11 行,把环画在**看得见的按钮**上
(`.ant-btn:has(> .nex-file-input:focus-visible)`)——这是本轮唯一动 CSS 的地方
反向验证:`gateprobe` 加 3 条语义判据的反例(人造坏控件必须红、撤掉必须复绿),
常驻出口从 11/11 升到 `GATEPROBE_OK 14/14`;闸登记进 `nex.config.yaml → ui_gates`
(13 → 14 条命令),并把 authority 注释里写死的「12 道探针」改成「§15 探针清单」,
免得规范与代码又对不上一次。
验证:HEAD `semanticcheck` 1440 与 430 均 **EXIT=58**(NAME 20 / HOTSPOT 16 / TAB 16 /
FOCUS 6)→ 工作树两档均 **EXIT=0**;账号侧四条 chromeless 路由另跑 EXIT=0(硬档 0);
最终代码 14:25→14:36 干净复跑 430 档 0 条违规。规范落点 docs/UI规范.md §15.13、§16 第 9 步。
|
2026-11-08 14:50:07 +08:00 |
mula.liu
|
6334a4a894
|
NEX 阶段 8.5·第3项:六张窄屏违规表逐表响应式(useNarrowTable + 九套窄档列,宽档一字未改)
症状:tableaudit @430 违规 6 张表(最大横向溢出 546 px),@576/@768 同样违规。
根因不是「容器太窄」,是列宽预算按 1440 那把尺子算的(全宽表容器 1118),
窄屏容器只剩 356 / 462 / 502,定宽列合计 400–902 把长文列挤成 0 宽。
768 比 576 还窄(侧栏没折叠,正文 462),所以三档窄屏共用一套精简列。
做法:`components/ui/Table.tsx` 新增 `useNarrowTable()`(<992 = antd/tailwind 的 lg);
页面按档位交两套 columns——宽档那份**一字未改**,窄档把次要列并进主列的第二、三行
(数据换位置,不失踪)。用 `Grid.useBreakpoint` 换列定义而不是 CSS `max-lg:hidden`
显隐 DOM:只有一份 columns 在渲染,表头与单元格的辅助技术朗读才不会读到藏起来的列。
九张表各按数据特点选方案,不是一套模板套到底:
① 项目列表:卡片/表格分界 max-sm → max-lg(八列里有封面图/进度条/成本三种形状,
并进两列读不动;窄档换**已验证过的那张项目卡**,字段一个不少,不新增组件)
②③ 派工:主列并「· 状态 · stage」,次要列合并
④⑤ 质检 / 时间线:优先级列保留、次要列并入主列
⑥⑦⑧⑨ 交付:窄档 `#id 名称` 并列、成本/时间并一格
长文本一律保留完整内容提示(Tooltip / aria-label),不靠截断蒙混。
红线自证(批准书 §3 六条):没有统一方案 · 没隐藏重要业务数据(另写 dataintegrity
探针按 token 对账:⑥失踪 3→0,③失踪 9→2 且两次复跑读到的都是实时计时器漂移)·
没靠扩容器宽度糊弄(容器实测 356/462/502 未变)· **tableaudit.py 阈值一字未改**
(ROW_H_MAX 仍是 84,⑥窄档行高实测正好 84,已登记 T-2)· 键盘与操作反馈未动。
验证:tableaudit 430 HEAD 违规 6 张 → 工作树 0 张;576/768 同 0;
@1440 日志去掉时间戳后与 HEAD **逐字节相同**;最终代码 14:44 再跑 430/1440 均 EXIT=0;
visualcheck-120(15 路由 × 4 档 × 2 主题)HTTP 0 / 断言 0;semanticcheck @430 0 条违规。
规范落点 docs/UI规范.md §13.2.1。
|
2026-11-08 14:49:55 +08:00 |
mula.liu
|
a851eca71f
|
NEX 阶段 8.5·第2项:430 顶栏项目名——省略号 + 完整名称三通道(Hover/Focus/Touch,按悬停能力收口)
症状:430 档项目名被 ellipsis 截断后,键盘档没有任何一条路能读到完整名称;
触屏档点胶囊另有出口(概况抽屉标题就是完整名),但鼠标档只剩一份看不全的字。
做法(只动这颗已有的 project switcher 胶囊,不新建提示层、不碰 AppHeader):
· `Typography.Text ellipsis={{tooltip}}` → 受控 `Tooltip`:`trigger=[hover,focus]`;
· 只在悬停/聚焦那一刻现量 `scrollWidth - clientWidth > 1`,名字读得完就不弹;
· Focus 只认 `:focus-visible`,鼠标点开抽屉时背后不挂提示;`Blur`/`Escape` 关闭;
· Touch 通道 = 点胶囊 → 概况抽屉标题(本来就是完整名),写成注释里的契约;
· 触屏档根本不弹:`canHover()` 用 `matchMedia("(hover: hover)")` 按能力收口——
实测事件序列 pointerover(touch)→…→click 之后 antd 的 mouseEnterDelay(0.1s)
仍会在抽屉背后点出气泡,手指不会 leave,气泡就一直挂着(复跑咬出来的)。
验证:430 `truncated:true` 且 CDP AX 名称=完整名;Hover 与 `:focus-visible`
各自 `tip_visible:true`;430 触屏 `tip_visible:false`、抽屉标题=完整名;
768/640/900/1440 `truncated:false` ⇒ 不弹;`stray_tooltips` 1→[];
顶栏四颗子元素 x 区间未变(操作区没被挤压);tableaudit/visualcheck/
semanticcheck 全绿。规范落点 docs/UI规范.md §6.5。
|
2026-11-08 14:49:45 +08:00 |
mula.liu
|
5a10bfbfa6
|
docs(reports): 阶段 8 报告自查——改前那一下 ⌥↓ 不是「没反应」,是做了另一件事
收尾复核截图时发现报告把改前行为写轻了:§4.2 / §4.6 写的是「什么都不发生」,
而 shots-before 那张图上是**检查器被撑起来盖住了看板**。补采两棵树的 stdout 定性:
· HEAD:28 29 30 31 32 33 34 → 一字未变,吐司空,DOM 焦点仍在原卡(29);
window 那条监听不判 altKey,Alt+↓ 被当成普通 ↓ 走 goShot(+1),此时没有选中态
(shotIndex = -1),落点算到第 1 镜,select() 顺手把检查器打开。
· 最终树:→ 28 30 29 31 32 33 34,吐司「镜头 2 已后移到第 3 位」,焦点 29(跟着卡片走)。
所以改前的真实缺陷比「键盘做不到」更糟一点:这一下按键会**替用户做另一个决定**。
而 ⌥↑ 那一行确实是「什么都不发生」——goShot(-1) 在 shotIndex = -1 时取不到落点直接返回,
界面上没有任何一处回答「按过了吗」,两行分开写清了。
顺带把第一次只留图没留读数的缺口补上:shots-HEAD-transcript.txt / shots-final-transcript.txt。
证据目录本身按既有口径 gitignore(reports/*evidence/)。
|
2026-11-08 00:21:39 +08:00 |
mula.liu
|
8e3e4980cf
|
docs(reports): 阶段 8 实施报告——四项批准决策的落点、实测读数与未解决清单
四项各一次提交(D16 1227003 · N16 0b9ea0a · D17/N7 ae4dd7f · N14 687bf5a)+ 插图收尾
7d844a9;NEX 子仓库反向落地两笔(63e36ec 的 04 §8.1/§8.2、c703f14 的 08 §2)。
报告按七小节交付:文件清单 / 前后差异 / 原因 / 规范符合性 / 命令与实测读数 / 前后截图 /
未解决项,并附全部执行过的命令(含 11 道常驻探针、九道 classaudit 闸、120 状态 visualcheck、
四支专项探针与两处 HEAD 反证)。
本轮把三件「写进规范但没人管」的事变成可对账的:断点登记(第 9 闸)、标签皮肤能写什么
(§1.1.1 实测能力矩阵)、拖拽排序的键盘替代(08 §2 新条款)。
另有两处刻意保留的不对称已在文档里说明理由:拖拽不报吐司而键盘必报(判据是「用户能不能
自己看见落点」),以及 <768 抽屉不持久化而 ≥768 折叠持久化。
未解决 7 条汇总在 §7,其中三条需要单独授权:.nex-* 自绘表面整体在 @layer 之外(属大规模
CSS 重写)、430 档顶栏读不出完整项目名、表格窄屏排布剩余 6 条 tableaudit 违规;
另有 N14 的读屏真机复核(VoiceOver/NVDA)缺位,属人工验证而非代码缺口。
|
2026-11-08 00:19:01 +08:00 |
mula.liu
|
7d844a9155
|
docs(帮助页): 重拍 12 张手册插图,跟上门禁与外壳的当前样子
frontend/public/help/*.png 是 <img> 直出的静态截图,不参与构建:UI 每换一次皮肤,
这 12 张就整批过期,正文说的和图里对不上。阶段 8 动了外壳(<768 导航抽屉)与标签皮肤
(D16 那枚此前根本看不见的角标),按 helpshots.py 的既有口径重拍一遍。
口径未变:视口 1600×1000、dsf=2 拍完 LANCZOS 缩回 1600;主题锁 light(12 张彼此要一致);
拍摄主角仍是已交付的项目 12。产物先落临时目录,人工过一眼后才覆盖进 public/help。
单独一笔提交,方便与代码回滚解耦(阶段 8 起沿用同一做法)。
验证:12 张全部产出,尺寸逐项 1600×1000;storyboard 一张可见分镜卡缩略图左下的
「已生成」角标——那正是 D16 修好之后第一次真的落进画面。
|
2026-11-08 00:18:12 +08:00 |
mula.liu
|
687bf5a64d
|
NEX 阶段 8·N14:分镜排序补上键盘替代 ⌥↑/⌥↓,改镜序不再是鼠标专属
阶段 2 把分镜卡做到「点得开」,但排序仍然只有两条鼠标路(HTML5 拖拽 + 分镜表两颗按钮):
键盘能走到卡片,却走不动卡片。用户批准 N14 后按「不加新控件」的口径补齐第二条路。
实现(frontend/src/pages/project/Storyboard.tsx):
- move() 回传 Promise<boolean>(越界 false,其余走 run() 的既有返回值)。三个
void move(...) 调用点一字未改,行为不变——run() 本来就返回布尔,只是没人接。
- 新增 moveByKey():越界报「镜头 N 已经在第 M 位,无法继续前移/后移」,成功报
「已后移到第 M 位」;随后 refocusShotCard()(rAF 最多 8 帧找回 [data-shot-card])
把焦点还给同一张卡——列表整体重排会把卡片重挂、焦点掉回 <body>,
不归还的话第二下按键根本没有落点,等于「只能移一格」。拿不到就不抢焦点。
- ShotCard.onKeyDown 先接 Alt+↑/↓(preventDefault + stopPropagation)再走 Enter/Space:
卡片正处在 window 那条「方向键切镜」监听的冒泡路径上,不拦一次按键会既移镜又切镜;
window 侧同步加 if (ev.altKey && Arrow) return 兜底,焦点不在卡上时宁可不响应。
- 可达性:aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown" + 全站一份 sr-only 说明
(卡片用 aria-describedby 指过去)。不给整块热区加 title——原生 tooltip 会盖住
卡内每一处;也不给每张卡的 aria-label 各念一遍——30 张卡念 30 遍同样的话。
aria-label 逐字未改,阶段 2 的口径与探针定位都不受影响。
- 反馈的不对称是刻意的,写进 UI规范.md §13.3 ⑤ 第 3 条:拖拽时卡片跟着手走、落点
由卡片自己说,键盘时手没在版面上、必须由文字说出「成到哪」;判据从「输入方式一致」
改成「用户能不能自己看见落点」。播报走 notify()(Toast 容器本身是常驻 aria-live),
不另起第二条 live region(R19)。
- 不新增卡脚按钮:224 档实测那一行会劈成 2+1(正是 btnclustercheck 拦的形状),
补按钮就得缩控件或加行,两者都属本轮排除的视觉改动。看板/表格像素零变化,
新插入的 sr-only <p> 放 grid 外面,不参与列宽计算。
帮助页同步:pages/Help.tsx 的分镜步骤与快捷键清单加 ⌥↑ / ⌥↓(注明 Win/Linux 用 Alt)。
G3 补「热区不是按钮时快捷键挂在哪」;对照文档 §2.8 更新证据、§5 N14 ⏸→✅、§7 变更记录。
验证:npm run typecheck 通过(中途抓到一处真实 TS1005:普通注释搬进 JSX 子节点)·
npm run build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道闸全 0 EXIT=0 ·
新写专项探针 sortcheck(明暗各 6 组:顺序变了 / 焦点没丢 / 有播报 / 边界会说话且顺序不动 /
不 Alt 的方向键行为不变 / Enter 仍打开检查器)PASS 0 条,对 HEAD 反证 FAIL 14 条 ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11,含 feedbackcheck 与 gridcheck)·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)断言 0 / HTTP 0 / console 0,
另跑 1440 单档 30 状态同样全 0。证据 reports/ui_evidence/nex-p8/n14/。
上游:NEX 08 §2 新增「可排序条目的键盘移动方式」五条(子仓库单独提交)。
|
2026-11-08 00:16:30 +08:00 |
mula.liu
|
ae4dd7f68e
|
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零
用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改:
① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在,
label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回,
同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态);
② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512;
③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中,
装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203,
项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。
实现:
- kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变)
与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的
未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。
左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是
「替换主内容的位置」还是「压在主内容上的一块面板」。
- AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/
AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378:
里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。
- App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧
「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。
- 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单),
aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按
「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时
画的正是改前那颗 Expand → 顶栏像素没动。
- PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。
第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有
散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法,
折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。
探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量
.ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224
会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。
顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板**
(/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言——
新增 in_nav() 后覆盖 3 → 10 条路由。
未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向
滚动而没有顺手改堆叠单栏。
验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 ·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 ·
navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)·
drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 ·
tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 ·
≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后
before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。
证据 reports/ui_evidence/nex-p8/d17/。
规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、
§15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论;
NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录;
nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
|
2026-11-07 23:36:48 +08:00 |
mula.liu
|
0b9ea0a430
|
NEX 阶段 8·N16:断点治理装上机器闸,登记从「两份人写的表」变成一条可对账的规矩
阶段 7 把页面里 5 把裸 max-[1240px] 之类的私档改名成 --breakpoint-* 命名变体,
归名之后留下的问题是:「登记」这件事只剩两份人写的表(styles/index.css 的 @theme
和 UI规范 §4 那张表)加一句 grep。下一轮谁再写一个 max-[900px]:flex,编译得过、
像素也对,只有人眼能发现;反过来说,往 @theme 加一档却忘了同步 visualcheck.py 的
BP 表更糟——wantDisplay 会对这一档静默返回 null,断言悄悄不跑了,比报错更难查。
classaudit.mjs 新增第 9 闸 BP:尺子的唯一真相是 @theme 里的 --breakpoint-*,其余
四处(页面用词 / UI规范 §4 表 / 探针的 BP·BPORDER / 尺子自己的使用面)全部由这条
闸向它对账,五条判据——① 裸 max-[…]/min-[…];② 用了没登记的变体名(写错名字
Tailwind 不报错,只是这一档压根不生成规则);③ 登记尺子必须有且仅有一个使用者、
不得 0 使用者、必须被 §4 表收录(§4 那三条口径的机器化);④ 每档都要出现在探针的
BP 与 BPORDER 里且同名同值同序(顺序错了会挑错赢家);⑤ .css 里 @media
(max|min)-width: Npx 的 N 必须是登记值,否则页面归了名、样式表里再开一批私档白干。
主阶梯「该不该在这一档换排布」是 R9 的语义判断,机器量不出来,这条闸不管。
闸按 §15.1 的口径反证过 10 例(写坏→红且点名→还原复绿),含一条反向的反向:agent
这把尺子的口径是「一个使用者」不是「一次使用」,同文件第 11 处复用必须放行,否则
闸就成了数次数的假判据。产物 reports/ui_evidence/nex-p8/n16/scripts/gate_bp_proof.py。
顺带修一处本轮写闸时踩到的自伤:新增第 9 闸时把 process.exit 表达式里的 dead.length
顶掉了(第一道闸从此不影响退出码),已还原——这类「闸门静默失效」正是这条闸自己要
防的毛病,写闸的人也一样会犯。
规范侧:NEX 04-layout-system.md 新增 §8.1 命名断点登记出口(有名字/有唯一使用者/
有实测/有对账四条)与 §8.2 专业工作区窄屏降级范式(<768 导航只留一个入口),已在
nex_design_system 子仓库单独提交 63e36ec;UI规范 §4 复核口径从「grep 必须为 0」
改为五条判据 + 指向第 9 闸,§15.1 闸表 8→9 并补基线输出;nex.config.yaml 补
breakpoints_registered 五档、ui_gates 注释改 9 道子闸、custom_breakpoints 从
forbidden 改 registered_only(原注释「禁止私档断点」已与阶段 7 的登记出口不一致)。
验证:classaudit 九道全绿(10 档在册 / 5 把登记尺子 / 0 命中,exit 0)·
反证 BP_PROBE_OK 10/10 · typecheck 通过。页面与样式文件零改动,像素不受影响。
|
2026-11-07 22:39:17 +08:00 |
Codex
|
1227003173
|
NEX 阶段 8·D16:kit 的 Tag 不再吞 className,顺带量清「页面到底能给它写什么」
Status.tsx::Tag 的形参收了 className 却没并进 cn(),全站 10 处站点从写下去那天起就是空转。
并进 cn() 末位(学同文件 Badge 的写法,tailwind-merge 保留后写者)之后逐站点实测,
结论与最初的推测不一样,两半都得记下来:
· 真的一半:styles/index.css:55 的 @import "./app.css" 不带 layer,未层声明高于任何
@layer,所以 .nex-tag.ant-tag 独占的 13 族属性页面 utility 压不动(display/底/色/圆角/
内距/字号/行高/min-height/gap/max-width/white-space/overflow/margin-inline-end);
· 假的一半:.ant-tag 带 transition:all .2s,改完类名立刻 getComputedStyle 读到的是过渡
起始值,margin/flex/font-weight 曾被集体误判成「输了」(700ms 后再读就对了)。
明暗两档逐属性量出能力矩阵,写进 UI规范 §1.1.1,并给 classaudit 加第 8 闸 TAGSKIN:
给 kit 的 Tag/Status 写皮肤类 = 判违规(该走 tone,或把 display 留在 wrapper 上)。
站点回归:ModelCenter「默认」只留 font-bold(皮肤族点不亮,§2.1 也早已废止语义铺底);
Review 的视觉模型名改走 tone="mono";分镜卡撤掉 flex-none 那层 wrapper,
缩略图角标的 absolute 第一次真的生效(此前掉出 overflow-hidden 盒子,探针 visible=False);
PipelineConsole 的 wrapper 保留,注释改成实情:它只为 display 族存在,撤它得先降 .nex-tag 皮肤入层。
验证:typecheck / build 通过;classaudit 8 道闸全 0;常驻 11 道探针 EXIT=0;
visualcheck 15 路由 × 4 视口 × 明暗 = 120 状态全绿(断言 0 / HTTP 0 / console 0);
932 颗标签 before/after 逐站点 diff,46 处差异全部落在预期站点,且无一处皮肤字段改动。
证据与元素级前后截图:reports/ui_evidence/nex-p8/d16/。
|
2026-11-07 22:35:11 +08:00 |
mula.liu
|
5753177616
|
NEX 阶段 7 断点归一:五把实测尺子登记成命名断点,页面里裸 max-[...] 归零
改的是尺子的名字,不是尺子的刻度。审计字面方案(620→576、720→768、
1080/1240/1400→992/1200)逐条实测后全部不采纳,走审计自己留的出口条款
R9:登记为项目断点。
- styles/index.css:--breakpoint-* 主阶梯后面补 5 条登记档位
insp-lg=1400 / board=1240 / insp-md=1080 / insp-sm=720 / agent=620,
每条注明唯一使用者;口径写进注释(一把尺子一个使用者、名字即表面、
加档要带视口测量、删档要连带删掉唯一使用者)
- Storyboard.tsx / AgentConsole.tsx:15 处 max-[Npx] 换成 max-<name>:,
并把「为什么不能并到邻居档位」的实测读数写进就地注释
(agent 并到 576:指令列 415→150、行高 71→90;board 并到 xl:
1204–1239 由 4 列 224 退回 3 列 301;insp-sm 并到 md:721–767 整屏盖住图标轨)
- scripts/ui/visualcheck.py:wantDisplay 的断点表同步这 5 个名字。
归一之前凡含 [ 的类名被直接跳过,这轮起 max-board:flex /
max-agent:order-5 才真的按档位算期望 display 与顺序
- docs/UI规范.md §4:断点登记表落地(档位 ↔ px ↔ 使用者 ↔ 采用理由)
- docs/NEX-对照与例外.md:新增缺口 N16 —— NEX 没有「主阶梯放不下时
的命名登记出口」这一条
验证(最终代码态,全部 EXIT 0):typecheck / build 430ms / classaudit
0 死类名 4088 候选 / 11 道常驻探针 + GATEPROBE_OK 11/11 /
visualcheck 120 状态(15 路由 × 4 宽度 × 明暗,新增 576 档)+ 36 张边界档
断言 0 console 0 HTTP 0 / grep -rn "max-\[" frontend/src = 0 /
sbprobe 16 档与 agentprobe 10 档改前改后 JSON sha256 相同 /
dist CSS 五个断点块声明体逐字节相同 / 9 对前后帧 Header 以下 0 显著差异像素、
总控台两对 PNG 逐字节相同 / 阶段 1 tagw、阶段 2 kbd(1440 与 576)、
阶段 3 zorder5 跨阶段复跑全绿
报告 reports/NEX阶段4-7实施-2026-11-07.md(§4 与 §7 为本轮)
|
2026-11-07 18:54:24 +08:00 |
mula.liu
|
3e86b282e0
|
NEX 阶段 6 拆 kit 与清死代码:Panel/Controls 按职责分成五份、删 7 个 0 调用导出与 2 个死 hook、R8 承认 app 为外壳层
|
2026-11-07 18:21:47 +08:00 |
mula.liu
|
bc5d1bcc90
|
NEX 阶段 5 定一次操作的反馈预算:Library 5 处原生对话框收口、录音链 3 颗吐司并成 1 颗、模型中心开关补结果反馈、430 统计卡改两列
|
2026-11-07 17:51:40 +08:00 |
mula.liu
|
24513a976e
|
NEX 阶段 4 补齐状态表面:首屏骨架、抽屉骨架、权限不足与地址不存在兜底页
|
2026-11-07 17:14:37 +08:00 |
mula.liu
|
4411d222fa
|
NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表
阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 /
Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明
docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行
(COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10
+ 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。
阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、
状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言,
「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。
阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、
分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button,
免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。
阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡——
素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260),
确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。
验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 ×
2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。
详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
|
2026-11-07 16:49:14 +08:00 |
mula.liu
|
a8348d9edd
|
v 0.1.2
|
2026-11-07 13:03:58 +08:00 |
mula.liu
|
2d58807478
|
v 0.1.2
|
2026-11-07 02:55:35 +08:00 |
mula.liu
|
ce91173a6c
|
v 0.1.2
|
2026-11-07 00:48:17 +08:00 |
mula.liu
|
01606b2949
|
模型配置数据包进仓库:同步代码与同步模型配置走同一条通道
开发机 16:42 重新 export 的部署数据集,按「git 同步到服务器」的口径显式纳入版本控制。
这三个 JSON 是 scripts/seed.py export 的产物,一直被 .gitignore 第 62 行挡着(历来只随
deploy.sh 的部署包 rsync 过去),这次用 git add -f 落进仓库,让服务器 git pull 之后
直接 python scripts/seed.py install 就能把模型配置刷进库,不必再单独传一次文件。
- model_specs.json 8 条(4 个真实模型 + 4 条 mock):默认位 image=comfyui/qwen-image-2.1-turbo、
llm=qwen/qwen3.7-plus、tts=comfyui/indextts2、video=comfyui/minimax-h3;ComfyUI 三条的
base_url 是算力机内网地址 10.100.53.199:9200,服务器换网段要在模型管理中心改;
- model_secret_keys.json 是**机密**:那行 key_value 能解开全部 API Key 密文,与密文同级,
仓库必须保持私有;
- users.json 只有 admin,口令是 PBKDF2 哈希,install 对已存在的账号不改口令。
验证
- seed.py doctor --src scripts/seed → 判定通过(error 0 · warn 0):带 Key 1 条
(qwen/qwen3.7-plus)主密钥解密通过 · 主密钥 1 条 · 管理员 admin · 每类能力恰好一个默认。
|
2026-11-06 16:46:59 +08:00 |
mula.liu
|
a73ce504c9
|
用户管理按其它模块的口径重做,卡头不再复读页签与角标
用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。
**1)用户管理:从「左右两栏 + 常驻表单」改成「列表 + 抽屉 + 行内动作」(UI规范新增 §13.5)**
它是站内唯一一个没跟上口径的模块:左列表 + 右详情面板各占一半、页面顶部常驻一张新建表单(还自带一套
`formDirty` / `keepForms` / `syncEdit` 脏检查)、表格没有操作列、五张统计卡只有数字不能点、
抽屉里那颗「允许登录」`Check` 与列表上的「停用」是同一件事的两种写法。逐条对齐资产库 / 模型管理中心:
- 整行点开抽屉(`Table onPick`),**新建与编辑共用同一张 Drawer**(980px,与资产库编辑抽屉同宽)——
关掉即放弃,于是压根不需要脏检查:Kit 没有的那层状态不再自己造;
- 操作列四颗纯图标(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`,0 会话与停用自己分别
disabled,整列 `stopPropagation`,免得点图标连带打开压在底下的抽屉;
- 四张统计卡**全部是筛选入口**(AS-7 同一口径),删掉第五张「活跃会话」:它不是入口,数字还被探针登录污染成四位数;
- 后端 `GET /api/users` 新增 `status`(`active` / `disabled` / `pending`,非法值 400),与既有 `q` `role`
可叠加,`counts` 恒为全库数——统计卡点下去不会把自己的数字点没。「管理员」那张必须筛
`role=admin&status=active` 才与卡上的数一致(`counts.admins` 只数启用中的),`pending` 同理写
`must_change_password && is_active`:停用的账号本来就登不进去,不该再算「待改初始密码」;
- 搜索 320ms 防抖(与资产库同一个值);`useAutoRefresh` 第 4 参带上「任一浮层开着」,30 秒轮询不再冲掉敲了一半的表单;
- **停用与重置密码不能共用一张底部**:§10 那条动作条只许一颗 `type="primary"`,而停用确认是
`primary danger`。于是停用留在行内走 `confirmAction`,重置密码独立一张 Modal(新密码 + 两颗 Check)。
**2)卡头去掉重复的二级标题(§13.6)**
资产库卡头写「人物母版 / 共 10 个母版」,头顶页签写「人物母版 10」,卡底 `Pager` 写「共 10 条」,
第一张统计卡的 `hint` 再写一遍「人物 10 · 场景 6 · 声线 3」——同一句话在一屏里出现四遍。
卡头的 `title` 与 `sub` 整块删掉,只留右端视图切换器;数量交还 `Pager` 与页签角标;`hint` 换成
「点下去清空筛选,回到这一类母版的网格视图」这种只在这里才有的信息。模型管理中心是同一形状
(左栏已经选中「大模型」,卡头再来一句「大模型」):删 `title`,能力说明挂到计数的原生 `title` 上(G2)。
**3)顺着这次改动发现闸门自己有两个洞,一并补上**
- `aligncheck` 与 `symmetrycheck` 的 BASE 写死 `localhost:5173`,而那台端口上跑着**另一个项目**:
十三页一个门牌都没量到,三个跨页集合全是空集、「最大跳动 0」,两把尺于是**空跑成绿**。
现在两把都认 `NEX_BASE` 并且自报样本数(`ALIGN_PROBED` 底线 40、`SYM_HEADS n/13` 底线 10),
掉到地板一律退出码 2——凡是「0 = 通过」的尺都必须报样本数,和 `FOOTER_PROBED` 同一条规矩。
- `feedbackcheck` 的 B 项靠 /users 页面上那颗常驻「保存」触发,保存搬进抽屉后它点不到东西直接抛异常
(而 `| tail` 把非零吞了,看上去还是绿的)。改成整行点开抽屉再点抽屉底部「保存账号」;
**点完必须把指针挪开**——那颗主按钮正对着吐司的落位带,手留在那儿就等于一直 hover,C 永远读到 `paused`。
- `footercheck` 加进 `/users` 三张浮层;行内图标按钮没有可见文案,触发器新增 `@无障碍名` 写法按 `aria-label` 找。
验证(dev 跑在 :5199 / :8010,8000 与 5173 被 nex_buddy 占着)
- 前端闸门:`classaudit.mjs` 六项全 0;`tsc --noEmit`、`npm run build` 通过。
- 探针全绿:aligncheck `ALIGN_PROBED 181` / 0 处(明暗两档)、symmetrycheck `SYM_HEADS 13/13`
三集合单值 {273}/{109}/{1391}(明暗两档)、tableaudit 0、gridcheck 0、rhythmcheck 0、
tagcheck 0(明暗)、btnrowcheck 413 组 0、btnclustercheck 154 簇 0、footercheck
`FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`(加 /users 前 30)、feedbackcheck 明暗两套全过、
gateprobe 11/11、visualcheck 0 断言 0 HTTP 失败。
- 后端 `pytest -q` 全量 **503 passed / 1 skipped**(新增 `test_user_list_filters_are_server_side`:
三档状态筛选、`role`+`status`+`q` 叠加、counts 不随筛选变化、非法值 400)。
- 重启 dev 之后实测:点「管理员」卡 → 角色=管理员 状态=正常 → 表里 1 行 = 卡上 1、卡头「筛选出 1 / 3 个账号」;
点「待改初始密码」(0)→ 空态「没有匹配的账号,换个关键词或清空筛选。」;`status=nope` → 400。
- 手册 12 张插图整批重拍(`helpshots.py`):上一轮删掉的开发期说明还留在插图里——
插图是静态 PNG、不参与构建,UI 每换一次皮肤这 12 张就整批过期。
|
2026-11-06 01:12:21 +08:00 |
mula.liu
|
b504e31628
|
前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏
用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。
逐条落地的口径与取舍:
**1)所有输入框聚焦时的蓝色外框**
量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、
`genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。
第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框,
所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、
`Select.activeOutlineColor` = `transparent`),`styles/app.css` 用
`:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零,
它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important`
(app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。
**焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点;
自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、
`border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。
**2)账号胶囊:菜单去重、项上不留副标题**
「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`,
重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。
菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的
`第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。
现在菜单就是三项:我的账号 / 用户管理 / 退出登录。
**3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` /
`project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`)
三类处置,已写进 UI规范 §14 G2:
- 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复,
含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」;
- 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` /
当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删;
「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」;
- 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」
→ 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」,
全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、
后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。
有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、
条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、
`PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。
配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。
**4)登录页重做**(UI规范新增 §13.4)
左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+
三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**;
右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。
窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。
去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启),
placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清
(只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`,
默认不勾(本机明文口令)。
文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、
§14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免);
README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。
验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0;
后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由
(console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、
btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、
btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped
(后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
|
2026-11-05 22:09:16 +08:00 |
mula.liu
|
27f3656d6b
|
依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑
用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍,
结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh,
只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli,
那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何
whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有
npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org
(实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。
改动:
- Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单
ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim +
--no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**,
直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan
按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动:
_FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换
fonts-wqy-microhei(+10MB)。
- server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组
可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg
完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry;
ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。
- server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(),
查不到就 warn,别等出片了才发现字幕是方块。
- 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。
- README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、
用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖
(只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、
默认即国内,判据是新机器零配置能装起来」。
验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0);
docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿;
pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped
(未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起),
需在服务器上构建确认。
|
2026-11-05 19:36:32 +08:00 |
mula.liu
|
c048a3bc2c
|
v 0.1.1
|
2026-11-05 19:04:25 +08:00 |
mula.liu
|
1a886beca6
|
端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音
一、端口三个键,各管一种形态,键名自带场景
上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」
又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端,
不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性:
一个键只能有一种含义、同一个 socket 不能有两个键。
HOST_PORT 部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口
BACKEND_PORT 开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标)
FRONTEND_PORT 开发形态的前端 Vite(独立进程,必须与后端错开)
compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000"
钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成
命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000,
旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。
实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010;
HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。
二、.env.example 按 .env 的样式重写,噪音清掉
它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下
根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身:
- 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明
「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5,
.env 头部三行指路。
- 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。
- 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等),
需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。
- 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。
本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。
三、docker-compose.yml 114 行 → 77 行
头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」,
正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠,
都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d,
restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。
env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、
本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把
「HOST_PORT=8010 # 本机跑容器…」整串当端口用。
四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、
常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」
改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。
验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化,
容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全);
两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
|
2026-11-05 19:01:32 +08:00 |
mula.liu
|
24978e9843
|
把「服务器上那份 .env 到底管什么」写死:模板默认改成单容器真相,compose 覆盖的键逐条点名
部署前必问的三个问题,答案以前都藏在别的文件里,这次直接写进 .env.example 与 README §3.2。
一、.env 不是「开发用的那份」,是「每台机器一份的那份」
它 gitignored、不在部署包里(deploy.sh 的「不随包走」清单里就有它),仓库根这份是开发机的
(SQLite、Vite 端口、本机口令),服务器上那份由 cp .env.example .env 生成,两份互不影响。
之前 .env.example 头部没交代这件事,于是「根目录 .env 是配置开发的?那服务器上改哪」这个问题
只能靠人脑补答案。补上四行说明。
二、对外端口配在哪:服务器那份 .env 的 PORT 一行,不在 compose 里
compose 只是引用它(ports: "${PORT:-${HOST_PORT:-8000}}:8000"),读 .env 读两遍:
先替 ${PORT} 插值得到端口映射,再整份注入容器当环境变量。
顺手填掉一个真坑:compose 的 environment 覆盖 DATABASE_URL / MEDIA_ROOT / SERVE_FRONTEND /
TASK_EXECUTOR / 容器内 PORT 这五个键,运维在 .env 里改前四个是**完全没反应**的——
这正是本仓最忌讳的「写了不生效」,而 .env.example 作为模板恰恰把它们写成生效态。
现在逐个点名:前四个标注「Docker 形态被 APP_* 覆盖」,容器内落点改 APP_DATABASE_URL /
APP_MEDIA_ROOT 那两行。
三、.env.example 的默认值改成单容器形态(原来那套会让人以为在用 Postgres)
模板里原先是 DATABASE_URL=postgresql+…@db:5432、TASK_EXECUTOR=celery、SERVE_FRONTEND=off、
POSTGRES_*/REDIS_URL 全生效,而 §3.2 又让你 cp 它去部署 Docker——照做之后文件说「Postgres +
Celery + 不托管前端」,实际跑的是「SQLite + inline + 托管前端」,读文件的人被指错方向。
现在默认 SQLite / inline / on(与 compose 强制的那套一致),Postgres/Redis/Celery 七个键
整段注释掉并注明「只在 -f docker-compose.scale.yml 时生效」。生效键从 45 降到 40:
留下的每一个都有读取方。
连带修掉 README §3.4 那句「模板里那套是 Postgres + Celery,cp 会起不来」——现在 cp 也能起来,
两条路径等价,这个矛盾说法本身就成了误导。
四、compose 里的 comfyui 服务:默认不参与,README 说明白
它带 profiles: ["comfy"],docker compose config --services 只有 app,不 --profile comfy 就
不会起,GPU 预留也不生效。算力在远端(模型中心里那三条 base_url)时它就是死代码,
只是给「算力恰好装在本机、想用容器跑一份 ComfyUI」留的开关。§3.2 与常用改动表各补一句。
验证:docker compose config --services 仍只有 app,published 仍随 PORT 变化,
容器内 DATABASE_URL/MEDIA_ROOT/SERVE_FRONTEND/TASK_EXECUTOR 仍是挂载点内那套;
deploy.sh --check 全绿(215 文件/7.5M,数据包 8 条模型配置体检通过);
两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
|
2026-11-05 18:52:45 +08:00 |
mula.liu
|
1934fb8bcc
|
端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换
一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个
上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键:
Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。
听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。
一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」,
而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个:
PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、
开发态的后端也读它。
- docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退;
另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000
(EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂——
今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成
「映射 9000:8000 但进程监听 9000」,容器直接不通。
- server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。
取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT
只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件,
写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。
- 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。
- 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印
backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内
PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。
二、.env / .env.example:只留配置本身
模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_*
一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引
(去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。
.env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。
顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。
APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。
键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉,
但写错字得能立刻看出来)。
三、ffmpeg:镜像里装了,而且源现在可换
回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它,
时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py);
缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。
实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1,
libass/xfade/subtitles/loudnorm 全 true)。
但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」——
名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org,
不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下,
一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。
四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条;
docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。
backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过;
docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
|
2026-11-05 18:44:30 +08:00 |
mula.liu
|
890f1ee589
|
模型配置全部交给数据库,.env 只管进程参数;media 从库里搬出来单独一个挂载点
上一版把容器收成一个之后,剩下的口径不一致是「模型配在哪」有两处说法:
.env 里能写 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*,模型中心页面也能改,
而运行时 config_json 优先——于是"改了没生效"和"到底哪条说了算"变成日常问题。
搬家的判据写成一句话放进工程规范:**换模型要不要重启进程**。要,就说明它站错了队。
另外三条理由:① 换 GPU 机是日常操作,不该要求改 .env 再 up --force-recreate;
② API / worker / beat 三个进程必须读同一份模型事实,写 .env 就是三份;
③ 地址与 Key 进库才有审计(谁改的、什么时候)与探测记录。
media 分家是同一批的诉求:产物只涨不跌,会长到几十上百 GB,迟早要单独挪大盘、
做增量备份、被 rsync 与剪辑软件直接读,和"一个不能写坏的 SQLite"绑在同一个挂载点
就得整目录停服拷走。代价说清楚:备份清单从一条变两条。
改动
· 划界:.env / .env.example 里 VIDEO_* / COMFYUI_* / TTS_* 一律清零(脚本核对过,
43 个键全部对应 Settings 字段或 compose 插值键,无未知键、无模型键),模板头部
写明"为什么这里没有模型配置"与新的排障口径(先去页面点 🔌 探测)。补回四个
原本漏在模板外的进程参数 FFMPEG_BIN/FFPROBE_BIN/QC_VISUAL_*/QC_ASR_ENABLED。
· Dockerfile / docker-compose.yml / docker-compose.scale.yml:MEDIA_ROOT 从
/app/data/media 改成 /app/media 并新增 ./media 挂载;worker 同步挂两个目录
(否则「worker 写完了页面看不到」),beat 不读写产物所以不挂;compose 里删掉
COMFYUI_BASE_URL 透传,注释说明"去模型中心改 base_url,改完即生效"。
· 后端三处悄悄降级要一起清掉,否则 env 一空就把真实默认位打回 Mock:
api/system.py 不再用 settings.video_provider/tts_provider 覆盖页面默认位;
services/audio.py 的 resolve_tts_spec 候选去掉 settings.tts_provider(未设供应商的
声线会静默 Mock 配音,只有听成片才发现);providers/registry.py 的 _dedupe_defaults
改按「真实模型 > 启用 > 登记顺序」裁决,两条 mock 行的 is_default 交给
_has_real_spec 闸门而不是 env。config.py 的模型字段保留为代码级兜底并写明两个用处。
· 两个启停脚本原来都是 curl .env 里的 COMFYUI_BASE_URL 探活——现在探的是废弃地址,
绿字反而误导:dev.sh / server.sh 的 status 改成登录取 /api/providers,
把库里在册且启用的 base_url 去重后逐个探(comfy 探 /system_stats)。
dev.sh 顺带修两处历史问题:/api/providers 在 AUTH_ENABLED=true 下 401 被打印成
"模型注册表读取失败"(现在先登录);非 2xx 被 urllib 当异常抛,LLM 根路径 404
会误判 unreachable(有 HTTP 应答即算机器活着,真可用性以页面探测为准)。env_value
随之无人引用,两个脚本各删一份。
· 文档:README §3.2 挂载表 3 行→4 行(含"少挂 media 会怎样")+ 备份清单两条、
「常用改动」表把 ComfyUI 一行改成页面操作、§4.0 重写(事实源 + 三条理由 +
三种接入路径 + COMFYUI_BASE_URL 逃生门 + 排障顺序);工程规范 §5 加"配置分两层"、
硬约束 #3 与数据边界表同步;deploy.sh / dev.sh 提示语同步。
验证(真跑)
· 全量后端用例 502 passed / 1 skipped;conftest 新增钉住 COMFYUI_BASE_URL,
否则 comfyui 三条不登记,断言会跟着开发机 .env 漂(这正是删完 .env 才暴露的隐性污染)。
· HOST_PORT=8010 docker compose up -d --build → 12 秒 healthy;容器里没有任何模型 env,
/api/providers 仍是 8 条、默认位四条全真(comfyui/minimax-h3 · qwen-image-2.1-turbo ·
indextts2 · qwen/qwen3.7-plus),默认位是 entrypoint 从 ./scripts/seed 灌进去的。
· media 挂载双向实测:容器内写 /app/media/_mount_probe.txt → 宿主 media/ 立即可见;
宿主已有 1.8G 产物经容器读回 200(/media/1/generated/shot-02-task2.mp4 2.8MB video/mp4);
走真实接口 POST /api/projects/1/assets 上传,落盘 media/1/reference/*.png 并能在页面直出。
· ./scripts/deploy.sh --check 19 项全绿;seed.py doctor/boundary 通过;
dev.sh status 与 server.sh status 均正确报出 http://10.100.53.199:9200 reachable、
dashscope 报 HTTP 404(有应答)。冒烟产生的 media 两个探针文件与 ./data 移入
.trash/2026-11-05/smoke-media-mount/,宿主库与产物未留垃圾。
|
2026-11-05 18:18:00 +08:00 |
mula.liu
|
517720cf62
|
打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层
compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」
时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给
app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管——
就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面:
连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。
新增
· Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败,
比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的
硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局
backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N]
反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。
BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。
· .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。
· scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED=
only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的);
末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置
反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。
· docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat,
页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。
改动
· docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000,
与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、
./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。
· seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警,
--only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上
必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。
· deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/;
server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节;
README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、
§3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。
验证(真跑,不是纸面推演)
· docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。
· docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的
python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。
· HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」
「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。
· / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB;
/api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 +
四个默认位;/app/scripts/seed 确认 Read-only file system。
· 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock;
AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。
· 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。
· 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
|
2026-11-05 17:39:12 +08:00 |
mula.liu
|
9614b2d225
|
v 0.1.1
|
2026-11-05 16:53:24 +08:00 |
mula.liu
|
9d62b88b05
|
规范与闸门收口:R19 反馈四级、R20 标题前不挂图形写进硬规则,探针补到十道
这一笔只动文档、审计与闸门,代码一行没改——前三笔(b6a1df6 反馈表面、552b6b0 门牌图形)
把事做完了,但规范和闸门还停在第十八条 / 六道探针的状态:新规矩没进 §0 那张硬规则表就
等于没立;探针不落地,下一轮改动照样能悄悄长出第五套反馈皮肤。
补进去的规矩(§0 从 18 条到 20 条):
· R19 反馈只有四级表面,各有唯一实现:行内 `ErrorText`/`LineHint` → 页面 `Notice` →
结果 `notify*`(自绘吐司)→ 确认 `confirmAction`(自绘确认框);`window.confirm` /
`window.alert` / `Modal.confirm` / antd `message` / `notification` / 裸 `<Alert>`
全站清零,也不许再给它们打样式补丁。新增 §13.3 一整节写四级的分工、吐司的四件事
(右下角堆叠 / 倒计时条与 JS 同源 / 同句去重成 ×N / 一屏最多 5 颗)和确认框的键盘映射。
· R20 标题前面不挂图形:门牌与卡头的一级标题左侧不许出现图标、色块、头像。
· 旧口径逐条纠正(10 处锚点全部命中才落盘):R16 ③ 与 §13.1 那张表里 `Notice`=antd
`Alert`、§13.1 正文「图标由 Alert 自带」、§6.5 外壳表里 `App.tsx` 的「系统异常
`Alert` → 页面」、§6.1「Content 里除了异常 Alert 就是 `<Outlet />`」、§15.6 tagcheck
的豁免语「整段 Notice / Alert 保留 antd 语义底」、§13.3 症状里那个被真实换行截断的
code span。站内已经没有 `Alert` 这个名字了,文档留着它就是在教人写回旧写法。
· `docs/工程规范.md`:目录职责图与「谁可以 `import 'antd'`」那段摘掉 `stores/notice.ts`
——吐司自绘之后它不再 import antd,白名单从四处收成三处。
· README:闸门命令块补 `aligncheck` / `symmetrycheck` / `feedbackcheck` 三行,硬规则
摘要补第 6、7 两条审计的说明。
闸门:
· `classaudit.mjs` 从五条判据加到七条。第 6 条静态禁反馈默认件(`window.confirm(` /
`window.alert(` / `Modal.confirm(` / `message.xxx(` / `notification.xxx(` / 裸
`<Alert`),实现本体白名单只有 `components/ui/{Toast,Confirm,Panel,Button,tone}.tsx`
与 `stores/{notice,confirm}.ts`;第 7 条钉住 R20——门牌与卡头标题里不许再挂前置图形。
同时把第 5 条 R8 的白名单里那第四处 `stores/notice.ts` 删掉:留着它就等于给「以后
谁想在 store 里 import 组件库」开后门。
· 新增第 9 道 `scripts/ui/feedbackcheck.py`:静态审计查不出两件事实——运行时是否真有
某条老路径弹出过原生对话框、自绘吐司是否真的**显示出来了**(`ToastHost` 挂错位、
provider 没渲染、store 被引成第二份实例,都会让 `notify()` 静默返回而静态审计照样
是 0)。它按真实路径逐项验 A~F:全站零 `dialog`、/users 保存后吐司落在右下角且
`.ant-message` 一个不许有、悬停时 `animation-play-state` 必须 paused、同句去重成 ×2、
连推 7 句只留 5 颗、关闭键生效、/ 上点删除出确认框(两层文案 + 恰好一颗 dangerous
primary)、Esc 关掉后项目数不变。
· 实测(明暗两档):`classaudit` 七条全 0 · `feedbackcheck` 通过 · `btnrowcheck`
`BTNROWS_TOTAL 0` / `HEAD_BREAK_TOTAL 0`(413 组动作排 / 59 处竖排豁免)·
`footercheck` `FOOTER_PROBED 30` / `FOOTER_BAD_TOTAL 0` · `aligncheck` 0 ·
`symmetrycheck` `SYM_TOTAL 0` · `tsc --noEmit` 与 `npm run build` 绿。
手册 12 张插图按「改完 UI 必须重跑 `helpshots.py`」的口径整批重拍(1600×1000@2x →
LANCZOS、锁 light、主角项目 12):旧图还是带主色方块门牌与卡头品牌 N 的那一版。
|
2026-11-03 23:58:44 +08:00 |
mula.liu
|
552b6b0163
|
门牌与卡头标题前的图形全部摘掉,跨页页头改成同一把尺量
症状(用户原话「1、不要图标 2、垂直居中对齐,和其它子页面要一致。请检查。」+ 两张截图:
门牌上那枚主色方块、调度中心那一排浮在卡头顶部的只读胶囊):
① 上一笔刚给门牌接上「菜单同款图标」,用户看了还是不要。那枚方块的语义是「图形 =
这一站」,可这句话左栏高亮项、顶栏流程条、项目概况抽屉已经各说一遍(R18),门牌
再摆一次就是给同一条信息配第二个视觉锚点;它还和顶栏的品牌 N、统计卡的色块同形状
同圆角,一屏三颗方块互相抢注意力。
② 标题前挂着 42px 的方块,门牌标题的左缘就比下面每一张卡正文的左缘右移 42px,
「门牌与正文同一条竖线」这件事在有图标的情况下做不到。
③ 跨页从来没人量过:aligncheck 量的是**同一个容器内**同一行的中线,逐页看都不算错,
连着切页就是晃。总控台卡头把 `<Mark>N</Mark>` 和标题拼进同一个标题槽,方块的
自然高度决定那一行的行高,22px 的文字跟着整排错位。
④ 调度中心那一排只读胶囊(任务执行 / 已取消 / 失败 / 已跳过 / 已完成)套在卡头标题
槽外面那个**行内 span** 里,块级 div 装进行内先撑出一段匿名行盒,实测整排浮到卡头
中线上方 6.5px,同页其它单行卡头只偏 0.5px——肉眼就是「这排贴顶、下面空一截」。
做法:
· `components/ui/Page.tsx`:`PageHead` 删掉 `icon` 形参与 `navItemAt()` 反查、标题行
只剩 `Title level=3`——菜单图形那一层整层撤掉,不是传 `icon={null}` 豁免;不在菜单
里的账号页 / 手册页也不再自己补 `IconUser` / `IconBook`。窄屏那一档换法:
`HEAD_ACTIONS = 'max-lg:w-full'`,不再写 `[&>button]:flex-1`——`useAutoStack()` 的
自然宽度只在「子项都按内容定尺」时量得到,等分一挂上自动档就永远认为量不到,
三颗主操作在窄屏折成 2 + 1,正是 `btnrowcheck.BTNROWS` 点名的破法。
· `pages/project/AgentConsole.tsx`:卡头标题去掉 `<Mark>N</Mark>`,标题槽只留文字
(`Mark` 组件本身留着——登录页的品牌方牌还在用,那一处是品牌不是导航)。
· 跨页这把尺:新增 `scripts/ui/symmetrycheck.py`(站内第 10 道常驻像素闸)。它收齐
13 个页面同一个量的实测值,要求每个量**收敛到单值**:门牌标题左缘、标题行中线、
主操作右缘三个集合的 `len` 必须 == 1,另加三条页内判定(标题行高 >= controlHeight、
标题里不许再有 svg / `*-mark` / `ant-avatar`、卡头标题与 extra 同心 + 正文卡左缘 ==
门牌标题左缘)。`aligncheck.py` 补上它原来漏掉的卡头 extra 与匿名行盒这一类。
· `components/ui/{Controls,grid}.tsx` 一并落地(见下方记账):门牌的窄屏方案现在直接
踩在 `ActionGroup` 的自动档上——量「整组的自然宽 vs 能给它的最窄祖先」,放不下整组
就整组竖排等宽。少了这一半,本笔的门牌在窄屏会退回 2 + 1。
实测:明暗两档各 13 页 `SYM_TOTAL 0`、`aligncheck` 0 处不同心;三个跨页集合实测都是单值
——门牌左缘 {273}、标题行中线 {109}、主操作右缘 {1391},跨页最大跳动 0.0,主操作中线与
标题中线 Δ 全 0.0,controlHeight 32 == 32。反向验证两发都响:往标题里塞一枚
`nex-stat-mark` → `SYM_TOTAL 13`(全页点名「标题前不许有图形」);把 `actions` 从第一行
挪进说明行 → `SYM_TOTAL 10` 并点名「⚠主操作不在标题那一行(中线 153.0 vs 标题 109.0)」。
探针自己修过两处漏判:`'max-w-full'.includes('w-full')` 的子串误伤(改
`:scope > .nex-action-group`)和「动作离开第一行被当成这一页没动作」(改抓游离的
`.nex-action-group`)。
⚠ 记账两笔:
① `Controls.tsx`(`ActionGroup` 自动档 + `Ctlbar` 栅格末格贴右缘)与 `grid.tsx`
(`FILL_AT`)是并行会话在途的按钮行收口,本轮门牌依赖它才自洽,所以提前落地;顺带
把 `e5ccbe0` 遗留的那条 tsc 红修好了——那一笔提交了用 `<ActionGroup auto={false}>`
的 `Page.tsx` 却没提交带 `auto` 的 `Controls.tsx`,`e5ccbe0` 与本分支上一笔 b6a1df6
的树都是红的(`npm run typecheck` 在 `src/components/ui/Page.tsx:169` 报 TS2322),
到这一笔才绿;`auto` 这个开关在本笔里连同它的豁免一起删掉了,窄屏怎么排只留一个答案。
② 上一笔 b6a1df6 的 `app.css` 是整文件提交的,里面已经删掉了 `.nex-pagehead-mark`
那条尺,而它那一笔的 `Page.tsx` 还在挂色块:两笔之间那一格的门牌色块是没有皮肤的。
|
2026-11-03 23:49:31 +08:00 |
mula.liu
|
b6a1df6dfd
|
反馈四级表面全部自绘:吐司、确认框、提示条、Tooltip 不再用出厂件
症状(用户原话「整体修改系统中的所以提示窗、完成后的反馈 tips 等。不要使用默认组件」):
① 55 处 `notify()` 落的是 antd 出厂 `<message>`——页面顶部正中一颗纯黑药丸,只有
「一个图形 + 一行白字」:说完了「保存成功」却说不完后果(哪个版本、几个镜头、
能不能撤销);3 秒准时消失且**悬停不停**,错误里那句长文案根本读不完;同一次
批量操作连点五次就在原地叠五颗一模一样的胶囊;站内每一张卡、每一个信息块都有
描边、圆角、色块图标,只有它是另一家的长相。
② 12 处 `window.confirm()` 弹的是**操作系统**的窗口:主题、字号、按钮、层级、语言
全由 Chrome/macOS 决定,「会删掉什么、影响哪些产物」整段挤成一行灰字,不可恢复
的删除和有代价但可逆的切换长得一模一样,用户只能条件反射点确定;它还是同步阻塞
的,页面脚本停在原地,动画和轮询全冻住。
③ 页面里的提示条是 antd `Alert` 直封装,跟 R16.3 那把唯一的语义底纹尺(`BLOCK_TONE`)
是两套皮肤,同页并存;而且它没有 action 位——App.tsx 那条「后端连接异常」要挂
「重试」,只能绕过 kit 直接 import antd 的 Alert,R8 那道墙就是这么被自己的兜底
页凿穿的。
④ 纯图标按钮的说明(R11 的唯一出口)仍是 antd 出厂 Tooltip:`colorBgSpotlight` 走
反色文字基准,浅色下是一块死黑、深色下比正文还亮,跟站内浮层没有共同语言。
做法(四级从同一张语义表出发,`components/ui/tone.tsx` 是唯一的色调与图形来源):
· 语气表 `tone.tsx`:`ok/bad/warn/info/loading` 五档 → 底纹 `TONE_TINT`、图形
`TONE_ICON`、朗读名 `TONE_LABEL`、antd 词汇映射 `NOTICE_TONE`,色值全部取 antd
语义 token,页面里不出现新色。
· 吐司:状态留在 `stores/notice.ts`(**55 处调用点一个都没改**),皮肤换到
`components/ui/Toast.tsx`——右下角堆叠卡片、语义色块、标题 + 明细两层、底部倒计
时条、悬停/聚焦时动画与计时器同时暂停、同文案同语气去重成「×N」、同屏最多 5 颗
(超出挤掉最旧);`notifyLoading()` 改成 `startLoading()` 返回 `done()` 句柄,
进行中的那颗原地换语气换文案,不再「消失一下再弹一颗」。
· 确认框:新增 `stores/confirm.ts` 的 `confirmAction(): Promise<boolean>` +
`components/ui/Confirm.tsx`(浮层唯一实现 kit `Modal` + 语义色块 + 两层文案 +
图标按钮)。12 处原生调用清零,问话只留一句、后果写进 `desc`、主按钮把动作写成
动词(「删除 / 继续切换 / 仍然关闭 / 归档」),`danger` 给红描边。外层函数本来就
全是 `async`,一行 `await` 读起来和原来的 `if` 一样顺。已有一张开着时后来的请求
直接判取消——连按 Esc 不会排出一串窗口。
· 提示条:`Notice` 不再借 `Alert` 的皮肤,改读 `BLOCK_TONE`(与 `<Block>` 同一把
尺),左 20px 档色块、两行文案,新增 `action` 位与标准图标按钮关闭键;props 与
原来完全一致(含 antd 词汇的 `type`),32 处调用点零改动。App.tsx 的系统异常条与
ErrorBoundary 的兜底条从裸 antd `Alert` 收回 kit,并补上「重试」按钮。
· Tooltip:`theme/antd.ts` 只换两个 token(`colorBgElevated` 底 + `colorTextBase`
字),明暗自动跟主题、不引入新色值,描边与阴影那一圈在 `app.css` 的
`.ant-tooltip-inner` 补。不换自绘件:定位、延迟、触屏、aria-describedby 是它的
本职,「不要用默认组件」指的是那几张**反馈表面**。
· 两个宿主 `<ToastHost/>` / `<ConfirmHost/>` 挂在 `app/providers.tsx` 而不是
App.tsx:反馈队列是跨页面的全局状态(换页要清空、灯箱与抽屉之上也要显示),而
App.tsx 只画工作台,登录页走另一棵子树——挂在 Provider 层两边才是同一个长相。
· `app.css` 新增 38 条规则(`.nex-toast*` 17 / `.nex-confirm*` 12 / `.nex-notice*`
9),尺寸全部读 `--ant-*`;确认框的描边用 `:has([data-tone=…])` 落在 `.ant-modal`
上,为此给 kit `Modal` 加了 `className` 形参。抽屉/弹窗的吸底动作条交给
`ActionGroup`(同一套自动竖排量法),窄屏不再折成 2 + 1。
验证:`npm run typecheck` / `build` 绿;`scripts/ui/feedbackcheck.py`(本轮起的反馈表面
探针)明暗两档 0 违规——出厂 `message`/`Alert`/`window.confirm` 在 DOM 里已全部查不到,
吐司只有右下角一个 region、每颗都有色块与倒计时。反向验证:临时把一颗吐司换回
`message.success`,探针当场点名。
⚠ 本笔同时携带并行会话在途的改动,如实记账:`styles/app.css` 是整文件提交的,其中
`nex-head-stack`(4 行,配套 `Panel.tsx` 的 `<576` 卡头换行,本轮一起才自洽)、
`nex-steps` / `nex-opt-cell` / `nex-tag-text`(5 行,选择器暂时悬空,调用方在
`components/ui/{Steps,Status}.tsx`,那些文件留在他们那笔)共 9 行不是本轮主题。
|
2026-11-03 23:43:48 +08:00 |