#!/usr/bin/env python3 # -*- coding: utf-8 -*- """项目切换的数据生命周期(第 14 道常驻探针 · 2026-11-10 · NEX 阶段 33 · 用户第 2 条)。 为什么要有这一道(真缺陷,不是假想敌): store 里「路由现在是哪个项目」和「手上这份数据属于哪个项目」以前是**同一个字段**。 同一次会话里从 A 切到 B(点项目列表的链接、点平台动态里的那条、点概况抽屉里的七站跳转, 走的都是 react-router 的 in-app transition,不重载页面):`id` 立刻变成 B, 而 `project` / `workflow` / `stats` 还是 A —— 概览页于是把上一个项目的 12 个节点 顶在 B 的地址下面(改前实测命中 +40 / +80 ms 两次)。 更糟的是 B 已经被别处删掉:详情 404 只写 `error`,`project` 永远停在 A, 「未找到项目」永远出不来。这不是理论——项目列表 20 秒自刷 (`pages/Dashboard.tsx` 的 `useAutoRefresh`),另一个标签页删掉项目之后, 这一行的链接最多 20 秒内还在,点下去就是这一条。 改前读数:`reports/ui_evidence/nex-p33/projspa_before.log`(缺陷 2 条)。 修法:`stores/project.ts` 增加 `loadedId`(只在拉成功时与数据同写、同清), 非 silent 换项目先清(由 `ProjectDetail.tsx` 既有的骨架态接管), 消费方比 `loadedId` 而不是 `project?.id`;再加请求序号,旧响应不许盖新数据。 没有常驻闸,「先清」这一句会在下一次重构里被静默删掉:它不影响任何单页首次载入, 只有**换项目**才看得出来,而换项目恰好没人截图。 三条判据(退出码 = 缺陷条数,0 = 全绿): ① 换项目不残留 路由已经在 B,页面节点表就不许等于 A 的节点指纹。 中途允许的是「这份数据还不可用」的形态(骨架 / 空表),不是 A 的旧数据。 落定必须是 B 的真值(`SETTLE_MS` 内等不到才算缺陷,避免慢机器假红)。 ② 404 必须认错 切到一个详情 404 的项目:必须出现「未找到项目」的 Empty, 节点表必须清空,顶栏胶囊必须退成「项目 #<路由号>」而不是上一个项目的名字; 并且**切回真项目要能恢复**(证明 store 没被一次失败永久污染)。 ③ 静置不许闪 停在同一个项目上跨过一整轮 6 秒轮询(`IDLE_MS`,默认 8 秒): 节点表必须一直在,不许出现骨架。这条钉的是反向退化—— 有人把「清」加到 silent 通道上,就会变成每 6 秒整屏闪一次骨架。 判据用的探测器 `matches()` 是纯函数,夹具与自证在同文件的 `selftest()`, 由 `scripts/ui/gateprobe.py` 判据 ㉘ 反向验证(它退化成长驻 True / 恒 False 时自证必须红)。 环境要求:一台跑着的前端(默认 :5173)+ 库里至少两个「节点指纹不同」的项目。 凑不齐时直接 EXIT=2 并说明原因,不伪装成绿(§15.1「恒 0 也要说出来」的反面:没量到要说没量到)。 切换用 pushState + popstate:react-router 就是靠 popstate 走 in-app transition, 与点内链走的是同一条路径,不新增 Tab 停靠点、不改任何业务操作。 NEX_BASE=http://127.0.0.1:5173 .venv/bin/python scripts/ui/projectswitchcheck.py NEX_SHOTS=/tmp/p34 NEX_THEME=dark … # 顺手落三张过程截图(切换途中 / 落定 / 404)。 「切换途中」那张是三条判据跑完之后的**证据补拍**:重新走一遍 A→B、在 +80 ms 处读一次并截图, 不参与任何判据(采样窗口只有几十毫秒,截图本身比窗口长,量了就不准)。它的作用是让人眼直接看到 「清空期显示的是骨架 / 空表,不是上一个项目的节点」——把这条突变回改前行为,同一张图就变成残留。 """ import importlib.util import json import os import pathlib import sys HERE = pathlib.Path(__file__).resolve().parent ROOT = HERE.parents[1] def _load(name, rel): spec = importlib.util.spec_from_file_location(name, str(ROOT / rel)) mod = importlib.util.module_from_spec(spec) spec.loader.exec_module(mod) return mod sc = _load("nex_semanticcheck_for_login", "scripts/ui/semanticcheck.py") BASE = os.environ.get("NEX_BASE", sc.BASE) WIDTH = int(os.environ.get("NEX_WIDTH", "1440")) IDLE_MS = int(os.environ.get("NEX_IDLE_MS", "8000")) SETTLE_MS = int(os.environ.get("NEX_SETTLE_MS", "8000")) SHOTS = pathlib.Path(os.environ["NEX_SHOTS"]) if os.environ.get("NEX_SHOTS") else None THEME = os.environ.get("NEX_THEME", "") # light / dark;只影响截图,判据与主题无关 GHOST = os.environ.get("NEX_GHOST_ID", "999999") # 详情必然 404 的项目号 # 概览页节点表每行的「状态 | 名字 key」前缀 = 这个项目的节点指纹。 # 认 key(`import_script` 这类稳定英文标识)而不是认中文状态,是为了让「同一批节点、 # 状态变了」也算换了指纹——那正是「显示的是不是这一份数据」要看的东西。 STATE_CN = {"done": "已完成", "active": "进行中", "failed": "需处理", "pending": "待处理"} READ = r"""() => { const tx = (e) => (e && e.innerText || '').replace(/\s+/g, ' ').trim(); const rows = [...document.querySelectorAll('.nex-table tbody tr')] .map(tr => [...tr.querySelectorAll('td')].map(tx)).filter(r => r.length); // 概览页的「流程节点明细」表:认「名字 key」那一列,别的表不算 const nodes = rows.map(r => r.join(' | ')).filter(s => /[a-z_]{4,}/.test(s)); return { url: location.pathname, rows: rows.length, nodes: nodes, firstCells: (rows[0] || []).slice(0, 4), skeleton: !!document.querySelector('.ant-skeleton'), notFound: document.body.innerText.includes('未找到项目'), hdr: tx(document.querySelector('header')).slice(0, 160), obs: window.__nexObs ? { removedTR: window.__nexObs.removedTR, batches: window.__nexObs.batches } : null }; }""" LIST = r"""async () => { const j = await (await fetch('/api/projects')).json(); const list = j.projects || (j.result || {}).projects || []; // 列表接口自带 workflow(与详情接口同源);取 state/label/key 三样拼指纹 return list.map(p => ({ id: String(p.id), name: p.name, workflow: (p.workflow || []).map(n => ({ state: n.state, label: n.label, key: n.key })) })); }""" NAV = r"""(path) => { history.pushState({}, '', path); dispatchEvent(new PopStateEvent('popstate')); }""" # 为什么要有观察器:本地接口一次往返只有几毫秒,「清 → 立刻填回来」的窗口比任何 # 轮询采样都短——实测把「清」错加到 silent 通道上(每 6 秒清一次),400 ms 采一次 # 采 20 次一次都没抓到(`/tmp/p34/mutB.log` 缺陷 0),③ 于是成了一条看不见的闸。 # MutationObserver 不吃采样运气:行被摘掉一次就记一次。 # 只数「被摘掉的 」,不数文字变化——轮询把相对时间从「4 分钟前」刷成「5 分钟前」 # 是 characterData,不是重挂载,那是正常行为,不能算闪。 ARM = r"""() => { // 只数「和节点表那一族有关的移除」:被摘掉的整行 ,或装着它的更大块 // (ProjectDetail 换骨架时会把整个内容子树一起摘走——那是一次 childList // 变化,发生在被观察节点的**祖先**上;MutationObserver 不看祖先, // 所以观察面必须直接铺在 body 上,否则「清空」这件事恰好看不见)。 const isNodeRow = (tr) => /[a-z_]{4,}/.test(tr.textContent || ''); const rowish = (n) => { if (!n || n.nodeType !== 1) return false; if (n.tagName === 'TR') return isNodeRow(n); if (!n.querySelector) return false; return [...n.querySelectorAll('tr')].some(isNodeRow); }; const bodies = [...document.querySelectorAll('.nex-table tbody')] .filter(tb => [...tb.querySelectorAll('tr')].some(isNodeRow)); if (!bodies.length) return { armed: false, why: '页面上找不到节点表 tbody' }; window.__nexObs = { removedTR: 0, batches: 0, bodies: bodies.length }; window.__nexConn && window.__nexConn.disconnect(); window.__nexConn = new MutationObserver((list) => { for (const m of list) { let hit = 0; for (const n of m.removedNodes) if (rowish(n)) hit++; if (hit) { window.__nexObs.batches++; window.__nexObs.removedTR += hit; } } }); window.__nexConn.observe(document.body, { childList: true, subtree: true }); return { armed: true, bodies: bodies.length }; }""" SET_THEME = r"""(mode) => { if (!mode) return document.documentElement.getAttribute('data-theme'); localStorage.setItem('nex-the', mode); document.documentElement.setAttribute('data-theme', mode); return mode; }""" def fingerprint(workflow): """节点指纹:逐项「<中文状态> |