WorkBuddy
1ad9793ea2
重构底部导航图标：照参考图重做形状与配色
...
- 5 个 Tab 图标形状改为参考图语言：房子(首页)/爱心(找对象)/对话气泡(消息)/日历加号(活动)/人物(我的)
- 配色改为参考图方案：默认态藏青蓝 #47528C、选中态玫红 #F4005A（与导航栏品牌色同系）
- 同步重生成 1x/2x/3x 共 30 张透明 RGBA PNG（Edge CDP 栅格化）
- app.json tabBar.color/selectedColor 对齐新配色
- 守卫 tabbar-icons.mjs 增加两态颜色与 app.json 一致性断言
- 静态预览复刻 tabBar 配色同步更新；DESIGN.md 同步
2026-09-23 16:30:32 +08:00
WorkBuddy
45e84722e1
fix(miniapp): 修复底部 tabBar 图标全部消失（开发者工具误删 app.json 专属图标）
...
根因：微信开发者工具（>=1.05.2112301）的 ignoreDevUnusedFiles 会按 WXML/JS 依赖分析过滤
"无依赖"文件。tabBar 图标仅在 app.json 中声明，不属于任何页面 WXML/JS 依赖，被误判为无用
文件从开发包剥离，导致 5 个图标全部加载失败（渲染为破图占位）。
修复：
- 在 project.config.json 与 miniapp/project.config.json 的 setting 中显式关闭
ignoreDevUnusedFiles / ignoreUploadUnusedFiles（false），阻止图标被过滤。
- 同步关闭本地 gitignore 的 project.private.config.json（DevTools 运行时实际读取项）。
- 预览通道 scripts/preview-miniapp.mjs：补全 /assets 绝对路径→相对路径重写，并手动复刻
原生 tabBar（原生 tabBar 不在任何页面 WXML 中，静态预览需自行复刻）。
- 回归守卫 ui-tests/tabbar-icons.mjs 扩充为 5 段，覆盖根因（配置开关）+ 预览复刻。
- miniapp/assets/tabbar/DESIGN.md 增加根因警示，防止后续被误开开关。
验证：UI 契约 23/23 全绿（tabbar-icons.mjs 位于 [19/23]）；CDP 渲染实测 127 张图 0 破图，
5 个 tabBar 图标 naturalW=81 全部加载，选中色 rgb(233,107,107)、未选 rgb(153,153,153)，
与 app.json selectedColor/color 一致。
2026-09-23 15:57:04 +08:00
WorkBuddy
f4e00b4d95
feat(miniapp): 首页 4×2 入口宫格图标改版为参考图 2 的渐变砖 + 白色图形
...
参考图 2 的视觉语言是「高饱和渐变圆角砖 + 白色描画图形 + 主标题/副标题双层文字」，
原实现是「浅色底砖 + 彩色线性 PNG + 单行标题」，两者差异较大，本轮按参考图重做。
- app.wxss：新增 8 个 --gradient-entry-* 渐变 token 与 --mini-entry-shadow。
白图形的判据取**非文本图形 3:1**（WCAG 1.4.11）；渐变是斜向的、图形又跨在两色之间，
故以「较亮端」为准逐色实算（3.00~3.02:1，较暗端 3.54~4.08:1），实算值写在 token 注释里。
- index.wxss：.entry-icon 由 72rpx 浅色砖改为 96rpx 渐变砖（radius 28rpx + 落影）；
图形改用 data-uri SVG 背景层（几何图形统一 24×24 viewBox），砖面走 --gradient-entry-*；
新增 .entry-sub（12px muted 副标题）；删除已无用的 .entry-icon-image。
小屏 @media(≤340px) 同步收紧，副标题不降到 micro —— micro 在本项目是「仅角标/装饰」档位，
这行字承载语义，不属于装饰。
- index.wxml：宫格项去掉 <image>，图标改为纯 CSS 砖；补 aria-label 承接图形语义。
- index.ts：tone 名与色相语义对齐（rose/orange/violet/blue/purple/pink/green/amber），
并补 subtitle；entry 不再持有 iconAsset（图标不再是图片资源）。
- preview-miniapp.mjs：首页 mock 同步 tone/subtitle，预览才能看到真实砖面与副标题。
渲染态实测（无头浏览器 + CDP，非真机渲染）：
- 8 个 .entry-item 均渲染出 label + subtitle；.entry-icon 计算样式 48×48px / radius 14px /
background-image 含 svg 且为两层（图形 26px + 渐变铺满）；label 14px/600；sub 12px #7D839B。
- 证据截图：artifacts/ui-redesign/miniapp/home-entries-page.png 与 home-entries-grid-zoom.png。
门禁：UI 契约 23/23；语种审计 0 命中；tsc --noEmit 通过；wcc/wcsc 真编译 88 WXSS + 86 WXML / 0 失败。
未改（需产品确认）：第 8 项业务名仍是「善缘服务站」（参考图 2 写作「万善缘地」），
副标题自拟为「就在身边」；渐变整体比参考图略深，以保证白图形对比度达标。
2026-09-23 15:22:23 +08:00
WorkBuddy
44f75acebe
fix(uat): 闭环 UAT 4 项硬阻塞（推荐恒空/保存即失败/越权端点/文档不一致）+ 小程序字段契约
...
UAT 走查（docs/UAT-WALKTHROUGH-2026-09-23.md）发现 4 项硬阻塞，本次闭环其中 3 项
（#2 微信登录、#5 照片直传不在本轮范围），并顺带修掉走查中新发现的跨端字段契约缺陷。
后端
- #6 推荐恒空：新增 MatchScoringService 作为唯一评分事实源（复用 UserPreference 既有
10 维权重，零新造常量）；RecommendationEngineService.calculateScore/generateReasons 由
桩（return 50.0）改为委托；MatchEligibilityService 3 处桩全部去雷。此前 50 < 阈值 60
→ GET /recommendations 恒返回空数组。
- #4 保存即失败：updateProfile / updateBasicProfile / savePreference 改为
「无则插入、有则更新」。注意 UserPreference 实体 @TableId=id 与库主键 user_id 不一致
（V037 后补的可空列），故按 user_id 定位更新而非 updateById（后者会静默不更新）。
gender / birth_date 为 NOT NULL 且向导不采集，缺失时从已通过实名认证的 user_identities
补齐，仍缺则抛 400 业务拒绝，不再让 DataIntegrityViolationException 渲染成 500。
GET /me/profile 的 preferences 补回 5 个此前未返回字段（regionPriority / maritalPriority /
minEducationCode / educationPriority / childrenPriority）。
- #8 越权端点：POST /activities/{id}/interests/confirm 不再直调「建 Match 原语」
RelationshipService.confirmActivityInterest，改为与 /activities/{id}/mutual/* 同一条
二阶段同意链路（createMutualConsent + confirmConnection），单方调用不再可能建 Match
（INV-014 / INV-015）。
- #10 文档不一致：MatchmakerController 类注释更正（operator 端点实际在 /operator/matchmaker）。
- 存量 500 家族：RuntimeExceptionThrowGuardTest 的正则只认 throw new RuntimeException(，
而 17 处裸抛写作 orElseThrow(() -> new RuntimeException(...))，整体绕过守卫（CI 全绿却
仍有 500 家族缺陷）→ 17 处全量改为 GlobalExceptionHandler.BusinessException；
守卫扩为「整段代码 + 该形态」，并加自检断言防止守卫退化成恒真空断言。
小程序（跨端字段名 / 取值契约）
- 字段名对齐后端规范名：hasChildren→childrenStatus、occupationCategory→occupationCode、
workRegion→workRegionCode、ageMin/ageImportance→minAge/agePriority、
educationAccepted/maritalStatusAccepted→minEducationCode/maritalStatuses。
此前字段名对不上，后端读不到 → 字段被静默丢弃。
- 取值修 4 类违反 DB CHECK（写入直接 500）的项：has→yes；high_school→senior_high、
phd→doctor（chk_profile_edu）；occasional→sometimes（chk_profile_smoking/drinking）。
- 预填改读服务端真实字段：此前读 profile.hasChildren / occupationCategory / workRegion，
而服务端返回的是 childrenStatus / occupationCode / workRegionCode → 表单永远回填不上。
- profile-confirm 完成度改为直接采用服务端 profileCompletion（AGENTS 第 9 条：DB 是
Source of Truth），废弃原先 22 条「读服务端不存在字段」的本地猜测式断言。
- 择偶条件页新增「展示形态 ↔ 服务端规范形态」适配器（toApiPayload / fromApiPayload）。
测试与门禁
- 新增 MatchScoringServiceTest、RecommendationEngineServiceBehaviorTest、
ProfileSaveUpsertBehaviorTest、ActivityInterestConfirmConsentBehaviorTest 与
ui-tests/miniapp-profile-contracts.mjs（桩 stores，真跑三个页面的事件处理与 onNext，
断言提交负载用规范字段名与枚举码）。
- MIN_GUARDS 21→23（并修正上一轮漏改：该值当时仍为 21，与守卫数不符，使「数量下限」
保护形同虚设）。
- 负向注入实测：把 #6 评分改回桩 50.0、#4 改回恒 insert、#8 改回绕开二阶段、并注入
orElseThrow 形态裸异常 → 4 个守卫全部变红（含精确定位到 RecommendationEngineService.java:282）。
- 后端：795 tests / 0 failures / 3 skipped；UI 守卫 23/23；语种审计 0 命中；tsc 通过；
wcc/wcsc 真编译 88 WXSS + 86 WXML / 0 失败。
仍未修（需产品/数据决策，见报告 8.3）
- regionScope 需 GB/T 2260 单值区划码，而小程序选项含「镇江其他辖区」这类非单值项 →
不臆造区划码（该约束默认 preferred 软约束，不误过滤）；
- occupationPreference 后端无对应列；settlementPreference 后端无取值字典。
2026-09-23 14:33:43 +08:00
WorkBuddy
c0298c27a5
fix(miniapp): 小程序界面全量中文化，消除英文/非中文枚举码上屏
...
- 新增 miniapp/constants/profileLabels.js 作为「枚举码→中文简体」唯一字典
（婚姻/子女/学历/职业/吸烟饮酒/择偶子女/红娘状态），覆盖表单值与种子
实际值两套并集，保证详情页无论后端返回哪种码都显示中文
- 修复「择偶条件-子女」下拉英文选项（any/accept/reject→不限/可接受/不接受），
改用 value/label 数组 + range-key="label"
- 修复 recommend-card / user-card / profile-detail / profile-confirm 直接渲染
后端枚举码（educationCode/maritalStatus/occupationCode…）的问题，改由
observers 派生中文 label 上屏
- 清理残留英文文案：Required 条件→必须符合的条件、喜欢TA/向Ta→喜欢对方/向对方、
U51 服务预约→服务预约、U64 公益服务记录→公益服务记录
- 修复 7 个英文窗口标题与 3 个英文占位页正文
- matchmaker 历史服务状态消除原始码兜底，统一走字典
- 加固 scripts/audit-miniapp-language.mjs（A 整行先剥离 mustache、B 排除
bind:action 处理器、F 窗口标题、JPG/PNG 入白名单）
- 新增 ui-tests/miniapp-language-contracts.mjs 语种守卫（复用审计脚本，断言 0 命中），
UI 契约门禁 MIN_GUARDS 21→22；已做负向注入验证判别力
2026-09-23 11:19:17 +08:00
WorkBuddy
1fc34f1bcd
fix(miniapp): 修复导航页与微信胶囊重合，并把首页两个栏目卡缩到 1/3
...
问题 1：五个导航页顶部与右上角胶囊按钮（··· ⊙）重合
- 根因：自定义导航用 env(safe-area-inset-top) 取的是设备物理安全区，
在 Android 上常为 0，完全不反映胶囊位置；且右对齐元素从未为胶囊让出宽度。
- 新增 miniapp/utils/nav-metrics.js 作为唯一事实源：以
wx.getMenuButtonBoundingClientRect() 实测胶囊矩形，反推并导出四个 CSS 变量
--nav-status / --nav-h / --nav-right / --nav-top，并提供无接口时的兜底值。
- nav-bar 组件改为自行获取导航度量（attached + observer 双触发），
标题按胶囊垂直居中并收窄 max-width；外部传参降级为兜底。
- index / discover / messages / activity / mine 五页根结点注入同一组变量，
WXSS 里的 env(safe-area-inset-top)、硬编码 88rpx 与右对齐 right:0 全量替换。
问题 2：首页「善缘公益服务」「善缘安全提醒」两个栏目过宽
- 根因：封面 <image> 只声明 width 未声明 height，小程序默认按 240px 计算，
实际把卡片撑到约 480rpx 高。
- 按「整体等比缩到 1/3」重构：两栏改为 mini-card 小卡，宽度
calc((100% - 2*gap)/3)、高度写死 168rpx，封面 height:100%；
公益服务一行三卡横向排布，安全提醒为「标题小卡 + 右侧文案条」，
长文案收进详情页，安全提示原文保留。
守卫与验证
- 新增 ui-tests/miniapp-capsule-safe-contracts.mjs：
A 层多机型断言导航行与胶囊垂直居中、右对齐让位、navTop 与兜底值；
B 层纯函数审计五个自带导航行页面（页面清单由文件系统推导，失配直接报红）；
C 层断言首页小卡宽为 1/3 且显式声明高度，并钉住旧 service-/safety- 选择器回归。
审计前剥离注释，避免守卫被自身示例文本误伤。
- 新增 scripts/audit-image-height.mjs：按属性名精确比对，审计全仓
「有 width 无 height」的 <image>，当前 30 个类 0 命中。
- 负向注入 N1~N7（含 nav-safe 未接入、旧选择器回归、极小屏幕、无胶囊兜底等）
全部被守卫咬住并 exit 1，还原后复跑通过。
- 真编译（wcc/wcsc）：WXSS 88 / WXML 86，失败 0；
tsc --noEmit 通过；UI 契约门控 21/21 PASS（新增第 21 个守卫并抬高 MIN_GUARDS）。
- 渲染探针实测：单卡 213rpx x 168rpx；五页右对齐元素右缘 423~528px，
均在胶囊右缘 365px 之外。
未纳入本次提交：miniapp/project.config.json（微信开发者工具自动改写，
仅追加若干布尔开关并删掉文件末换行）与生成的预览页 artifacts preview.html
（约 7900 行生成产物），以免淹没代码评审视线。
2026-09-23 09:55:40 +08:00
WorkBuddy
2c325136ab
fix(miniapp): 修复 WXSS 通配符导致编译失败，并把 WXSS 校验升级为真编译
...
问题
- v2 设计收敛在 app.wxss 新增 `.tap-gap > * + *`。WXSS 不支持通配符 `*`，
wcc/wcsc 编译期直接报 `error at token '*'`，整个小程序编译不过。
- 更值得警惕的是当时 19 个 UI 契约守卫全绿：静态守卫刻意只扫
`miniapp/components/`（page 的 wxss 允许标签选择器，套用会误报），
app.wxss 落在扫描范围外，且判据里根本没有通配符这一项。
修复
- 移除 `.tap-gap > * + *`。复检 v2 新增的 .tap-min / .tap-gap / .focusable / .pressable
四个工具类全仓零引用（等价能力已各自写在组件样式内，如 button/index.wxss 直接用
`min-height: var(--tap-min)`），且 `.focusable:focus` / `.pressable:active` 在 view 上
不生效（小程序须用 hover-class），属"写了等于没写"，故整块移除，只保留 token。
- 修掉同块注释里的嵌套 `/* */`：内层结束标记会提前终止外层注释，其后的文字会被
当成真实样式解析。该约束已写进注释，防止后人再踩。
守卫加固
- scripts/lib/wxss-selectors.mjs
* 新增 findUniversalSelectors（通配符判据，排除 `*=` 属性匹配符与注释内星号）
* 新增 findNestedComments（注释嵌套判据）
* 修 stripComments：原实现用等长空格替换，把注释内的换行也吃掉，导致报错行号
整体偏移（实测偏差 68 行）；现保留换行，并在定位时跳过选择器前的注释占位空白
- ui-tests/wxss-component-selector-contracts.mjs
* 第 1 级：miniapp/components/（原判据，保留）
* 第 2 级（新增）：全量 miniapp/**/*.wxss，覆盖 app.wxss 与 pages
* 第 3 级（新增）：注释嵌套
* 三级各自带正/反自检样例
新增
- scripts/miniapp-compile-check.mjs：直接调用微信开发者工具内置的 wcc/wcsc 做真编译预检
（wcsc 单独调用不解析 @import 相对路径，脚本会先内联再编译）。
CI runner 无该工具时输出 SKIPPED 并退出 0；刻意不挂进 run-ui-contracts —— 一个在 CI 里
什么都不做的守卫被计入"全绿"，正是本项目反复强调的假绿。CI 拦截由上面的静态守卫承担。
验证（均实际执行）
- node scripts/miniapp-compile-check.mjs → WXSS 88 个 + WXML 86 个，0 失败
- 负向注入：把 `.tap-gap > * + *` 改回去 → 预检 FAIL(exit 1)，报错与用户原始报错逐字一致
`app.wxss(364:12): error at token '*'`；已还原并复测通过
- node scripts/run-ui-contracts.mjs → 20 / 20 PASS
2026-09-23 08:25:11 +08:00
WorkBuddy
631e3000d3
管理端：设计系统 v2 收敛 + 修复漏斗卡恒为 0 的响应式缺陷
...
## 一、设计系统收敛
- theme/index.css 重写为 token 底座：品牌三级、语义五组、文字四级、
边框/背景/圆角/阴影/动效/热区/排版刻度
- 修复 Element Plus 派生色阶残留：--el-color-*-light-N 是 SCSS 编译期静态生成，
只覆盖基色不会带动它们 —— 数据统计页实测 133 处元素仍在用 EP 默认调色板
（其中主色蓝 8 处）。已按 mix(#fff,base,N*10%) / mix(#000,base,20%) 补全全部档位
- 新增 src/theme/tokens.ts：模板里 :style 需拼 8 位 hex（color + '15'），用不了 var()，
故以 TS 常量镜像色值；守卫会双向校验它与 index.css 同名取值一致
- 24 个 .vue 收敛：硬编码色值 97 处/67 种 → 0；越界字号 88 处（最低 9px）→ 0；
非法字重 650×6 → 0；触摸目标 17 处 <44px → 全部 ≥44px
- 对比度：text-tertiary 3.54:1、warning 2.33:1、coral 作文字 3.14:1 → 全部 ≥4.5:1
- 新增守卫 ui-tests/admin-design-tokens.mjs（含 WCAG 对比度实算）
## 二、修复既有功能性缺陷：数据统计页漏斗卡与安全卡恒显示 0
- 现象：同一张卡片里，上方漏斗数字全是 0，下方汇总表却是 12846/9217/8462/3812，
界面自相矛盾
- 根因：funnelStages / matchStages / safetyCards 是普通数组（const x = [...]），
loadFunnel() 直接改元素属性，模板读的却是同一个数组 —— 非响应式写入不触发重渲染。
同页凡走 ref 的值（汇总表、V11 区块）全部正常，规律清晰
- 修法（按根因）：三个集合改为 computed() 从既有 ref 派生，卡片与汇总表因此同源，
结构上不可能再出现「同一份数据的两处展示对不上」；另把 loadFunnel() 内遮蔽
颜色助手的局部变量 const token 改名 authToken
- 该缺陷无 TS/lint/构建报错，前 18 个守卫全绿也抓不到 —— 只有真跑起来看渲染结果才暴露
- 新增守卫 ui-tests/admin-reactivity-contracts.mjs：
①非响应式状态（普通声明 + 被当状态写 + 出现在模板里；未被写过的静态常量清单合法）
②数据统计页同源契约 ③颜色助手遮蔽
## 验证
- UI 契约门禁 20/20 PASS（MIN_GUARDS 18→20）
- 负向注入 3 例全部 FAIL(exit 1)，还原后复跑 exit 0（证明守卫有判别力）
- vue-tsc --noEmit exit 0
- vite build 成功（17.74s）
- 渲染态实测（Edge 无头 + CDP 读渲染后 DOM，同一 mock、同一路由，只差代码）：
修复前漏斗卡/安全卡全 0、比率全 '-' → 修复后 12846/9217/8462/3812/
48210/51236/7420/4380/1926/1284，安全卡 17/214/23/9
交付物：artifacts/admin-design-v2-preview.html
2026-09-23 01:06:57 +08:00
WorkBuddy
b67a56479e
fix(miniapp): 修 P0 请求层崩溃（一个下划线致所有请求卡死）+ 组件 WXSS 违规选择器，再补 3 项门禁
...
═══ 缺陷 1（P0，运行期）：utils/api.js 成功回调调用不存在的方法 ═══
控制台：
TypeError: _this._releaseIdempotencyKey is not a function
根因：类中定义的是 `releaseIdempotencyKey()`，成功回调写成了
`this._releaseIdempotencyKey(...)`（**多一个下划线**）。
**为什么一个字符的笔误是 P0**：该调用位于 `wx.request` 的 success 回调内、
且在 `resolve()` **之前**。抛错 → `resolve` 永不执行 → 该 Promise **永不 settle**
→ 所有页面永远停在 loading，同时 App.onError 刷屏。
即「一次成功请求」本应推进流程，实际把前端整成不可用。
修复不只是改名，而是纠正结构：
- **先 `resolve(body.data)`，再执行收尾动作** —— 收尾逻辑不允许挡在响应路径上；
- 释放动作自带 try/catch + console.warn：释放失败最多是"下次操作没拿到新键"，
不得升级为业务失败。
- 语义未变（勿改）：成功→释放（下次同域操作是新的一次）；失败→刻意不释放
（重试复用同一把键，后端才能识别重复投递）。
═══ 缺陷 2（编译期警告）：组件 wxss 用了标签选择器 ═══
Some selectors are not allowed in component wxss ... (components/recommend-card/index.wxss:1:1092)
实测违规 1 处（23 个组件样式文件全扫）：`.compact-like image` —— 组件 wxss 只允许类选择器。
改为 `.compact-like__icon` 并**同步在 WXML 补上类名**
（只改 wxss 会让样式静默落空，是另一种"假成功"）。
═══ 门禁：15 → 18（既有的全是源码内容断言，抓不到上述两类）═══
- 第15 `wxml-structure-contracts`（上一提交新增，本轮 MIN_GUARDS 基线顺带对齐）
- 第16 `miniapp-self-method-contracts`：扫描 `this._x(` / `self._x(` 等私有调用，
要求同文件有定义（方法简写 / 类字段 / `this._x = 值` / prototype 四种形态）。
**判据先自证假阳性**：首版正则不允许 `.` 前缀，把 `this._unsub = store.bind(this)`
形式误报为未定义（3 个页面）；修正并加反向自检样例固化了该坑。
- 第17 `wxss-component-selector-contracts`：组件 wxss 禁标签/ID/属性选择器。
**作用域刻意只限 miniapp/components/**（page 的 wxss 允许标签选择器，套上去必有误报）。
- 第18 `miniapp-api-client-behavior`：**唯一的行为断言** —— 桩掉 `wx.request` 真跑 api.js，
验证成功 resolve / 失败 retain 键 / 成功 release 键 / 收尾抛错不影响响应路径 4 组。
含 1s settle 超时，直接编码"永不 settle"这一失败模式。
- 新增 `scripts/lib/wxss-selectors.mjs` + `scripts/check-wxss-component-selectors.mjs`（CLI）。
- `MIN_GUARDS` 15 → 18；执行器措辞改为「源码结构与关键行为断言」。
═══ 验证 ═══
- `node scripts/run-ui-contracts.mjs` → **PASS 18 / 18**，退出 0；
- 负向注入：未定义私有方法 / 标签+ID+属性选择器 / 多余闭合标签 → 均精准变红，
且**合法样例（`this._x = 值`、纯类选择器、属性内含 `>`）不被误报**；
行为守卫的负向自证见下一提交/记录；`UI_GUARDS_MIN=99` 拒绝报绿。
- 文档口径同步：AGENTS.md、STATUS.md（4 处当前口径 + 新增 1.1.0-rc.18 行）、ci.yml 注释。
- **未验证**：微信开发者工具真实编译与真机渲染（本机无该环境）。
2026-09-19 11:40:38 +08:00
WorkBuddy
d036c9b986
fix(miniapp): 修复 2 个页面 WXML 结构缺陷，并补第 15 项门禁（WXML 结构守卫）
...
现象：微信开发者工具报
[ WXML 文件编译错误] ./pages/service-history/service-history.wxml
get tag end without start, near `</`
真实缺陷（实测 2 处，非 1 处）：
- pages/service-history/service-history.wxml 多 1 个 </view>
- pages/service-program/service-program.wxml 多 1 个 </view>
（均为单行压缩写法，随更早提交入库；全仓另外 84 个 WXML 结构自洽）
根因不是这两个文件写错，而是**门禁覆盖盲区**：
既有 14 项 UI 契约全是「源码内容 / 清单断言」，没有任何一条会解析 WXML，
所以「14/14 全绿」与「小程序能不能编译」之间没有因果关系。
修复：
1. 删掉两处多余闭合标签 → 86 个 WXML 结构全部自洽。
2. 新增 scripts/lib/wxml-structure.mjs：按**引号状态机**逐字符扫描标签。
不能用懒惰正则 —— 属性值里可以合法出现 `>`（`subtitle="{{unreadTotal > 0 ? ...}}"`），
正则会在引号内的 `>` 处提前收尾，把自闭合标签的 `/` 读掉，报出假阳性。
（首版实现即踩此坑，曾把合法的 messages.wxml 误判为坏文件；已复核排除。）
3. 新增 scripts/check-wxml-structure.mjs（CLI，退出码 0/1/2）。
4. 新增 ui-tests/wxml-structure-contracts.mjs：全量扫描 + **3 组内置自检样例**
（正向样例故意在属性值内放 `>`，把「假阳性」这个坑钉进门禁）。
5. scripts/run-ui-contracts.mjs：MIN_GUARDS 14 → 15（守卫被删/改名仍会拒绝报绿）。
6. 文档口径同步：AGENTS.md、STATUS.md（4 处当前口径 + 新增 rc.17 版本行）；
ci.yml ui-contracts job 注释 14 → 15。历史时点行保留原值。
负向验证（三项，全部通过）：
- 注入「多余闭合 / 未闭合」→ 退出 1，且只报坏文件、合法的 `>` 属性文件未被误报；
- UI_GUARDS_MIN=99 → 拒绝报绿（数量下限分支可自检）；
- CLI 直扫坏目录 → 退出 1。
验证：node scripts/run-ui-contracts.mjs → PASS 15 / 15，0 失败，退出码 0。
未跑：微信开发者工具真实编译（本机无该环境），结论仅由结构判据支撑。
2026-09-19 11:25:05 +08:00
WorkBuddy
d707fb1f60
ci(ui): 把 14 个 UI 契约门禁接入 CI，并新增统一执行器
...
Phase 23 收尾计划 批 1 Task 1.1 —— 此前 ui-tests/*.mjs 只在本地手工逐个执行，没有任何 CI
把关：改动破坏了源码结构契约也不会有任何信号。
- 新增 scripts/run-ui-contracts.mjs：逐个 spawn 子进程运行守卫 → 汇总 → 任一失败即非零退出，
并打印失败守卫的原始输出便于定位。零 npm 依赖（守卫只用 node 内建模块）。
- 两条防退化设计：
① 子进程 cwd 固定为仓库根 —— 守卫里 6 个用相对路径、8 个用 import.meta.dirname 自锚定，
不固定 cwd 会在 CI 上假红；
② 守卫数量下限校验（MIN_GUARDS=14，可用 UI_GUARDS_MIN 覆盖）—— 防止守卫被删除或改名后
依然报绿（Phase 19 教训：扫描清单本身会漏）。
- ci.yml 新增 ui-contracts job（checkout + setup-node + 跑执行器），与既有 test-shell-guard
同属「守门」类 job。
- 生产 compose 缺失的既有兜底确认可复用：ui-document-baseline-contracts.mjs 对不在版本控制内的
infrastructure/docker-compose.prod.yml 已做 existsSync 判定并显式打印跳过原因，CI 上不会假红。
验证：
- 基线 node scripts/run-ui-contracts.mjs → PASS 14/14，退出码 0；
- 负向注入（.workbuddy/tmp 下必然失败的守卫）→ FAIL、退出码 1，失败详情可见；
- 数量下限分支以 UI_GUARDS_MIN=99 自检 → 正确拒绝报绿（退出码 1）；
- .github/workflows/ci.yml 经 yaml.safe_load 解析通过，jobs 含 ui-contracts。
2026-09-18 21:30:15 +08:00
WorkBuddy
ae1bd2b734
test(phase23): KEEP-VERIFY — remove 44 pass shells + fake INV tests, add shell guard
...
Phase 23 "可信系统测试重建 (REFACTOR)" re-audit. STATUS claimed "10 E2E
files / ~80+ cases" and "INV-011~020 ✅ "; measurement showed the opposite.
D-23-A (Critical): V11InvariantsTest's 14 cases asserted only Constants
strings. INV-016 "Banner target types" actually asserted ARTICLE_STATUS_*;
INV-017 "home 8 entries" declared local arrays then asserted
firstRow.length == 4 (tautology, never called the home service);
INV-018/019/020 used appointment/article/account status constants as
stand-ins for permission and data-scope checks. Rewritten to 12 cases:
4 real service-behavior guards (INV-013 via real CounselingService.getDetail
— Matchmaker sees null userRequestSummary, with an assigned-Counselor
counter-proof so global sanitization cannot fake a pass; INV-016 reads the
production ALLOWED_TARGET_TYPES whitelist and asserts no external/http/url/
web entry; INV-017 calls real getHome and pins all 8 codes + order;
INV-019 asserts content_editor reads null), plus assertBehaviorTestExists
turning "行为验证见 XxxTest" pointers into executable Class.forName contracts.
D-23-B (High): 44 `pass` shells across 6 files in tests/e2e (4 files were
100% shells). Gate forbids skip/pass shells. Rewritten in place as honest
placeholders with the full scenario lists preserved.
D-23-C (High, residual): the pytest E2E suite is not executable at all —
no conftest.py anywhere, ~15 fixtures (api_client/verified_user/
banner_factory/...) do not exist. Only run_v11_tests.py really runs
(16 cases, needs a live stack + E2E_PASSWORD).
D-23-D (High, residual, NOT fixed): CI does not chain E2E as the plan
requires. Needs an infrastructure decision on how CI provisions a live
stack; not implemented rather than written unverified.
D-23-E (Medium): the CI migration job claimed to "验证 migration SQL 语法"
but only checked file non-emptiness, while the real syntax/baseline checks
live in MigrationValidationTest (already run by the backend job). Replaced
with a real sequence check (naming / non-empty / unique versions / no
gaps); verified by extracting the exact inline script and running it.
New gate: scripts/check-no-empty-tests.py (AST scan, blocks pass-only and
unconditionally skipped tests) + a CI test-shell-guard job. Verified both
ways: 0 findings on the real tree, 2 precise findings on injected shells.
Negative validation: 3 injected production defects (external_url in the
banner whitelist, swapped home entry order, isMatchmaker returning the full
record) turned exactly inv016/inv017/inv013 red, 9 others green, zero
unrelated failures; md5sum -c confirmed byte-identical restore.
Full regression: 655 tests / 652 passed / 0 failures / 0 errors / 3 skipped
(baseline 657; -2 because 14 vacuous cases were merged into 12). The 3
skips carry explicit reasons (2x @EnabledIfEnvironmentVariable(CI=true),
1x @Disabled "需要完整数据库连接") — none is a shell.
Phase 23 is PARTIALLY closed: fake coverage is gone, but the UAT gate
requires the end-to-end chain to actually execute, so "失败为零可进入 UAT"
is NOT claimed.
2026-09-18 11:49:18 +08:00
Codex
ce172ffd4f
feat(ui): activity 页迁 TS + 修复过期契约 + 新增 11 页静态预览器
...
## 背景
2026-09-13 UI 重设计方案的 13 个契约门禁中 3 个为红，逐一查明性质后分类处理。
## 1. activity 页迁移 TypeScript（11/11 页现已全 TS）
- activity.js → activity.ts（139 行），业务逻辑零改动，仅补类型
- 此前 STATUS.md 记「9/11 TS-only、3 页待迁」，但 messages/matchmaker
已在 4f91be0
2026-09-16 12:33:48 +08:00
Codex
1deda1e943
chore: inventory obsolete UI files
2026-09-13 20:15:33 +08:00
admin
4dd93db137
feat: redesign miniapp tabbar icons
2026-09-10 22:00:17 +08:00
admin
b46b48eb33
chore: establish V1.1 recovery baseline
2026-09-09 22:05:00 +08:00
WorkBuddy
admin