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
|
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
|
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
|
4521c9f926
|
前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。
用户连着三轮指出「字段标题、控件不对齐」「下拉控件的样式不对」,最后点名技术栈。真正的病不在
antd 还是 Radix,而在同一件事有三千种写法:左导航内边距一页 11px 一页 12px,白名单要从页面
className 上抄切片才能命中。上一轮 Radix 只外包了行为,皮肤仍由 30 多个页面自己拼,且没有任何
机制阻止分叉长回来。这一轮改的是词汇表:页面只准说业务,控件怎么长由 kit 层 + 一份令牌说了算。
底座(读数见报告 26.2):react 19.3.1→18.3.1、react-router-dom 7.18.5→6.30.6(点名为 18/6,是
降级,代价见 26.6)、新增 antd 5.29.3 + @ant-design/icons 6.3.4,@radix-ui/* 5 包与
class-variance-authority 清零;zustand/vite/tailwindcss 4.3.3 不变,Tailwind 留作皮肤 utility。
删 components/primitives/(11 文件 1133 行)与 styles/{base,tokens}.css;净 +488 行不是「少一千行」,
是同样面积的代码从三十个页面挪进两个目录——省的不是字节,是分叉次数。
新增:
- app/providers.tsx:ConfigProvider + <App> 唯一入口(主题、zh_CN、button.autoInsertSpace:false、cssVar),
命令式 message/notification/modal 挂 antdApi 供 stores/ 使用;React Router 的 v7 future flag 一处收口。
- theme/{palette,antd,css-vars,metrics}.ts:数字只有一个来源 metrics.ts → 同时喂 antd ThemeConfig 与
--ctl-h-*/--radius-*/--text-*,antd 控件与自绘区读同一把尺子,结构上长不歪了。
- components/ui/{Input,Checkbox,Menu,Rail,Tile,Overlay,field-labels};lib/layers.ts(Esc 先看有没有 antd
浮层压着,否则分镜检查器里关一个下拉整层抽屉一起没)、lib/ref.ts、hooks/use-narrow.ts(触摸档必须
同时喂给 antd 的 JS 数字,否则 560/430 一屏混着 31/38 与 36/40 两把尺子——首跑量出的 61 项就这么来的)。
- styles/app.css 接替 base+tokens,只留元素默认值与三处必须靠 CSS 的 antd 集成。
- scripts/ui/ 三件套首次入库:audit.py 七项机器判据 × 14 视图、vocab.py 六条源码词汇表闸、metrics.py。
修掉四个探针全绿也看不见的静默 bug:
1) 探针会假绿:浮层用例找不到抽屉时兜底 scope=main 把页面重量一遍,分镜「检查器」29 字段/57 输入
/35 按钮(在 main 外面的 aside 里)一条都没测过。
2) Select 选中 null 回显成灰色 placeholder:antd 把 null 当无值,而「不绑定/无台词/未指定」的真实值
就是 null(接口收 null,10 处)。kit 内折哨兵 nex-null,出入口各折一次,页面 API 一字未改。
3) JSX 子节点上的 /* */ 不是注释而是文本,挂在应用外壳之上把整站下推约 30px;移到 JSX 外并立词汇表规则 6。
4) 抽屉可以整块开在屏幕外面:Overlay 用 getContainer={false} 让 antd 就地渲染,rootStyle 的 absolute
于是相对文档定位——入口按钮在折叠线以下时抽屉 y=-scrollY(1440 lib_edit 只剩 201px,430 assets_gen
完全不可见,用户点了「AI 生成」像没反应)。改 fixed 后四档 10 个浮层全部 y=0 完整可见。为此给 audit
加第 7 项判据 surface(浮层完整落在视口内 + 中心点 elementFromPoint 命中自己),反向验证:改回
absolute 后 430 下 4 红 exit=1;判据取「有交集」太松(42px 也算过),收紧为「完整在视口内」才对。
验收(复跑读数):audit --only page 1440/1280/900 × 明暗 6 组 84 行视图全 0、exit=0;--only overlay
1440/900/560/430 × 明暗 8 组 exit=0,surface 80/80 绿,72 个下拉样本 popW==trigW、inViewport、
optClipped=false、popOnTop=false 计 0;vocab 85 文件/皮肤常量 79(账实相符)exit=0;
npm run build(tsc+vite)exit=0(ui chunk 881.94 kB / gzip 278.63);probe_nullopt CLEAN、probe_secretref PASS。
文档同步:UI规范 §8 判据清单五项→七项(补 surface)、§1.3 新增「抽屉可以整块开在屏幕外面」;
工程规范 §1.1 体检器职责改为 10 浮层 × 4 宽度 × 七项;README 六项→七项判据;报告补第二十六章
26.1–26.9(选型换向、版本读数、四条根因、改法、逐项验收、降级代价、注释泄漏、仍未做、抽屉开在屏外)。
|
2026-11-02 21:57:13 +08:00 |
mula.liu
|
83d262a199
|
文档把选型决策、R7 与探针口径写死:UI规范新增 §0.6「标准控件组 = Radix primitives + 自有皮肤」,报告补第二十五章。
UI规范.md:§0.6 一次讲清四层分工(尺子 tokens.css / 行为 primitives / 皮肤 layers.ts / 语义 ui+forms)、
否掉 antd-MUI-Arco 的三条量化理由(两套尺子、preflight 抢深浅主题、深色皮肤要覆盖八成)、
以及规矩(页面与 ui/ 不许直接 import @radix-ui/*、新浮层必须先在 primitives 落原语再登记、
层级只用一套、Esc 先看 floatingLayerOpen()、Content 上写 fixed 会让 Radix 量到 0 高)。
另立「两个咬过人的陷阱」:① [&>*]:min-w-0 与 min-w-(--label-w) 特指度平票会无声清零标签下限;
② Playwright 的 locator.click() 先做 DOM.scrollIntoViewIfNeeded 把目标居中,
「开抽屉把页面顶回顶部」就是这么造出来的假 bug——量滚动位移前基线必须在 scroll_into_view_if_needed() 之后取。
硬规则从六条升到七条(R6 从「不用裸 select」扩成「控件不用浏览器原生外观」,新增 R7 字段形态唯一);
§0.5 对照表补 Checkbox/Slider/Popup/Menu/Dialog 与 floatingLayerOpen 六行;§3 的 hint 栅格写法
从 grid-cols-[auto_minmax(0,1fr)] 更新成 minmax(var(--label-w),max-content)_minmax(0,1fr);
§8 登记 align4(五判据各 0 组)与 ctl4(31 项)为新口径。
工程规范.md:§1.1 依赖链插入 components/primitives/ 这一层(附「一个用户就进,不等第二个用户」的例外),
扩展点加「加一类控件行为」一行,§4 补依赖卫生判据:grep 出的 import 集合必须等于 package.json。
README:分层表加 primitives/ 一行,并写清「不引成套组件库」的结论与 5 个 radix 包全部有 import。
报告第二十五章:现象归因表(对齐是 CSS bug、下拉与原生外观才是组件库该管的)、选型对照表、
三个根因的读数、逐项验收表(30 字段五判据 0 组、31/31、原生残留 0、13 装 6 用 → 5 装 5 用),
以及仍然没做的四条(MediaLightbox/RecordAudio 自绘 overlay、检查器刻意非模态、Tabs/tooltip 无用户先卸包、
日期与命令面板按需再补)。
|
2026-11-02 16:17:20 +08:00 |
mula.liu
|
9467e1bb97
|
v 0.1.0
|
2026-11-01 16:18:07 +08:00 |