#!/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):
"""节点指纹:逐项「<中文状态> |