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
|
a8348d9edd
|
v 0.1.2
|
2026-11-07 13:03:58 +08:00 |
mula.liu
|
ce91173a6c
|
v 0.1.2
|
2026-11-07 00:48:17 +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
|
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
|
9614b2d225
|
v 0.1.1
|
2026-11-05 16:53:24 +08:00 |
mula.liu
|
d853560fa7
|
前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场
外壳三段交还 antd:Layout.Header(56) / Layout.Sider 两级 Menu / Content。
全局多页签条(PageTabs + stores/tabs)删掉——内容页不做多 Tab,菜单只到两级,
指定项目的二级挂在「当前项目」下;页签回到页面内部:
资产 3 类、项目资产 4 面板、模型 4 能力、分镜 4 检查器。
Tabs(换看不同内容)与 ViewSwitch(同一批数据换排法)的判据写在 components/ui/Tabs.tsx。
删:theme/{metrics,palette,css-vars}.ts、icons/{Icon,glyphs}.ts、hooks/use-narrow.ts、
app/layout/{AppBar,SideNav,PageTabs,NoticeToast}.tsx、nav.ts、components/ui/Rail.tsx。
尺子只改三类(品牌色 / 表面色 / 少量结构性 token),几何、字阶、圆角、间距、断点
一律等于 antd 默认;图标全站唯一入口 components/icons/index.ts(语义登记表)。
一并收进本轮与并行线程查出的静默故障(tsc/build 全绿但页面是坏的):
- frontend/package.json 结尾的字面量 \n;line-height 被写成 px 让全站文字塌陷;
Tailwind v4 @layer 层叠反转(preflight 与 antd 收进同一层,R13)
- 值型控件的宽度预算错给了「标签 + 控件」整字段,23 处下拉当前值被省略号咬
(91>70 / 77>70 / 77>46)::has 规则把 flex-basis 交回内容 + 面板按内容加宽折行;
整句型选项值(时间线字幕/语音来源/原声策略、交付字幕)挂 nex-prose-value 显式登记
- ViewSwitch 传 block 把「全部素材」最后一个字裁掉半格;AgentConsole 一键指令双重省略号;
总览「下一步建议」按钮在 430 档捅出视口
- 时间线 / 交付页在没有版本时白调 /timeline 与 /timeline/report,两条 404 换来一片假绿
(先拿版本清单,清单为空就别问)
注:并行线程「迁移前端到React+Tailwind」在同一份工作区落了下拉档宽、下拉面板加宽折行、
上述时间线 404 闸门与浮层底部动作口径(R14),本 commit 一并收进,不代表那条任务已收尾。
|
2026-11-03 12:42:16 +08:00 |
mula.liu
|
20e8f19eca
|
前端统一收尾:图文手册从 public/help.html 搬成站内 React+Tailwind 页面 /help,SPA 深链回落与未知接口 404 拆成纯函数补自检,新增 ErrorBoundary 兜住分包加载失败
|
2026-11-01 19:25:47 +08:00 |
mula.liu
|
e8e5a1cd2b
|
文档与脚本同步 React+Tailwind:UI 规范增加词汇→原语对照,工程规范补 frontend/src 分层与扩展点,README 目录/构建口径更新
|
2026-11-01 19:01:03 +08:00 |
mula.liu
|
9467e1bb97
|
v 0.1.0
|
2026-11-01 16:18:07 +08:00 |