sillyspec 3.31.0 → 3.32.1

package/src/ui-visual.js

@@ -23,10 +23,13 @@ export const UI_EVIDENCE_FILENAME = 'visual-evidence.md'
 
 /* ── 检测启发式（正反例单测锁定；误判面=默认档一行警告，误漏面由文件面扩展名兜底）── */
 
+// 词表不含后端高频通用词「渲染/组件/样式」：CLI「渲染输出」「组件」「输出样式」是常规后端
+// 用语，2026-10-05-knowledge-stats-freshness 实测误触整段 UI 须知+探针 warn（描述该问题的
+// input 自己也复触一次）；真 UI 信号由页面/前端/UI/视觉/界面/布局等词与扩展名兜底承接。
 const UI_TOUCH_PATTERNS = [
-  /页面/, /前端/, /\bUI\b/i, /视觉/, /样式/, /界面/, /布局/, /主题色/, /配色/,
+  /页面/, /前端/, /\bUI\b/i, /视觉/, /界面/, /布局/, /主题色/, /配色/,
   /\.tsx?\b/, /\.jsx\b/, /\.vue\b/, /\.svelte\b/, /\.css\b/, /\.scss\b/, /\.html\b/,
-  /组件/, /原型/, /截图/, /渲染/,
+  /原型/, /截图/,
 ]
 
 /** input/规约文本是否触及前端页面或 UI（关键词启发式，≥1 命中即算）。 */
@@ -47,12 +50,16 @@ export function detectUiTouchInPaths(paths) {
 
 export function buildUiGuidanceLines() {
   return [
-    `🎨 UI 变更执行须知（本变更触及前端页面或 UI——检测命中即插入，advisory 引导非门禁）：`,
-    `   1. 改前确认视觉基准：原型产物、黄金页或该页现有截图——没有基准的「改好看」无法验收；`,
-    `   2. 边改边渲染对照：每完成一个页面任务单元就渲染实页与基准并排比对，差异清零再勾任务；`,
-    `   3. 证据随手落盘：对照截图与结论逐页记入变更目录 ${UI_EVIDENCE_FILENAME}（干活时顺手写，收口只验在场）；`,
+    `🎨 UI 变更执行须知（本变更触及前端页面或 UI——advisory 引导非门禁）：`,
+    `   1. 定稿原型必须是可复跑的真码产物（与实现同方言、能被本项目工具链构建）——手绘单文件`,
+    `      仅限一次性粗选对比，不作为交付原型（2026-09-28 frontend-apple-style 实证：手绘定稿后每条意见都要反向翻译回真实代码）；`,
+    `   2. 开工先就近发现本项目原型管线：查本次变更触达项目自己的脚本、任务与工具链（多项目仓`,
+    `      按触达路径就近，不假设全仓共享一套）；已有则复用，没有则现场搭最小管线并把入口留在`,
+    `      项目惯例位置——下一个会话能自己发现；`,
+    `   3. 边改边渲染对照：每完成一个页面任务单元就渲染实页与基准并排比对，差异清零再勾任务；`,
+    `      对照截图与结论随手落变更目录 ${UI_EVIDENCE_FILENAME}（干活时顺手写，收口只验在场）；`,
     `   4. 视觉降级须用户裁决留痕：执行中因约束对不齐基准而降级（结构收敛、范围缩小、样式统一级）`,
-    `      必须带对比截图停下找用户签字，裁决记录写进 ${UI_EVIDENCE_FILENAME}（含「用户裁决」字样段）——`,
+    `      必须停下找用户签字，裁决记录写进 ${UI_EVIDENCE_FILENAME}（含「用户裁决」字样段）——`,
     `      静默降级会在收口被「UI 视觉证据」探针硬拦（error 门）。`,
   ]
 }
@@ -70,7 +77,13 @@ export function readUiVisualGate(specBase) {
   }
 }
 
-const DOWNGRADE_LINE = /(降级|样式统一级|partial)/
+// 降级声明判定词=绑定窗口而非裸词「降级」：裸词在后端/机制讨论语境高频（探针档位、性能
+// 降级），与远处视觉词同行共现时分属两个讨论对象——2026-10-05-uivisual-word-narrow 实测
+// 「error 档（降级无裁决）……渲染/组件/样式」同行共现被误判、error 档阻断收口（自举陷阱）。
+// 窗口语义：降级与视觉词 ≤6 字内同短语（两侧顺序皆认，经既有正例「视觉收敛降级」标定）；
+// 绑定词表与 VISUAL_LINE 同集（含页面——评审 P2：缺页面时「六个页面降级为三个」漏判）；
+// 样式统一级独立短语与 \bpartial\b 词边界保留。纯结构判定，D-003 封闭面不变。
+const DOWNGRADE_LINE = /((视觉|样式|界面|页面|UI)[^\n]{0,6}降级|降级[^\n]{0,6}(视觉|样式|界面|页面|UI)|样式统一级|\bpartial\b)/i
 const VISUAL_LINE = /(视觉|UI|页面|样式|界面)/
 
 /** design/requirements 是否声明「视觉降级」（同行共现口径——行级命中防跨行误配；runUiVisualProbe 内部消费）。 */
@@ -138,6 +151,28 @@ export function runUiVisualProbe({ changeDir, gate = 'warn' }) {
   }
 }
 
+/**
+ * execute 收口的前置 advisory（2026-10-07-flow-friction-batch3 task-05）：UI 触达变更的
+ * visual-evidence.md 应在执行期随手落盘，但执法只在 verify 收口（error 档）——postmortem
+ * （provider-model-list）实证 agent 到 verify 末步才发现缺证据。本函数供 execute --done 的
+ * gates 调用（warn 级提示，不阻断 execute；verify 的 error 档语义不动）：UI 触达且证据
+ * 缺失时返回提示串，否则 null（非 UI / 证据在场 / gate off 零打扰）。
+ * @param {{ changeDir: string, specBase?: string }} opts
+ * @returns {string|null}
+ */
+export function uiEvidenceExecuteAdvisory({ changeDir, specBase = null }) {
+  try {
+    const gate = readUiVisualGate(specBase || join(changeDir, '..', '..', '..'))
+    const probe = runUiVisualProbe({ changeDir, gate })
+    if (!probe.applicable) return null
+    if (probe.evidencePresent) return null
+    const hard = gate === 'error'
+    return `UI 触达变更但变更目录尚无 ${UI_EVIDENCE_FILENAME}——渲染对照证据应在执行期随手落盘（截图/对照结论，收口只验在场不产新证据）${hard ? '；本仓 ui_visual_gate=error，verify 收口会硬拦' : '；verify 收口会警告'}。落盘路径：${join(changeDir, UI_EVIDENCE_FILENAME)}`
+  } catch {
+    return null // fail-soft：探测异常零打扰（verify 侧同款口径兜底）
+  }
+}
+
 /** design 文件变更清单行的路径粗提（反引号/裸路径行——探针侧仅作 UI 扩展名兜底命中，不追求全解）。 */
 function extractQuotedPaths(designText) {
   if (!designText) return []