@routerhub/agent-rules 1.5.106 → 1.5.107

package/AGENTS.base.md

@@ -56,6 +56,11 @@
 - ⚠️ **截图是可视化证据，图注必须写清「这张图证明了什么」**，并标注关键行/关键数据（红框、箭头放在空白区，不遮挡原内容）。
 - ⚠️ **结论用「证据并列」呈现**：逐条列出每类证据的关键数值和可复查标识（执行 ID / 时间戳），最后一句量化修复效果（如"陈旧窗口从约 30 分钟压缩到 ≈0"）。
 
+## ⚠️ 页面功能验证铁律（真实数据 + 真实交互）
+
+- ⚠️ **编写 HTML 页面或前端功能后，必须用测试环境的真实数据验证，禁止用虚构/mock 数据自测。** 虚构数据只能验证「代码不报错」，无法验证「功能在真实场景下正常工作」——真实数据会暴露边界情况（空值、超长文本、特殊字符、异常关联关系等），虚构数据碰不到这些。测试环境有真实数据时优先用测试环境；测试环境数据不足时，从生产环境脱敏导出。
+- ⚠️ **页面功能验证必须通过实际的页面交互操作来完成**（打开浏览器、点击按钮、填写表单、观察渲染结果），模拟真实用户操作路径。禁止只靠代码审查、单元测试断言或静态分析代替实际页面操作验证——用户最终是通过页面交互使用功能的，不是通过测试断言。能用浏览器手动操作的，就用浏览器手动操作一遍。
+
 ## Git 规范
 
 - 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.106",
+  "version": "1.5.107",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {

package/rules/global.md

@@ -56,6 +56,11 @@ name: "通用规则"
 - ⚠️ **截图是可视化证据，图注必须写清「这张图证明了什么」**，并标注关键行/关键数据（红框、箭头放在空白区，不遮挡原内容）。
 - ⚠️ **结论用「证据并列」呈现**：逐条列出每类证据的关键数值和可复查标识（执行 ID / 时间戳），最后一句量化修复效果（如"陈旧窗口从约 30 分钟压缩到 ≈0"）。
 
+## ⚠️ 页面功能验证铁律（真实数据 + 真实交互）
+
+- ⚠️ **编写 HTML 页面或前端功能后，必须用测试环境的真实数据验证，禁止用虚构/mock 数据自测。** 虚构数据只能验证「代码不报错」，无法验证「功能在真实场景下正常工作」——真实数据会暴露边界情况（空值、超长文本、特殊字符、异常关联关系等），虚构数据碰不到这些。测试环境有真实数据时优先用测试环境；测试环境数据不足时，从生产环境脱敏导出。
+- ⚠️ **页面功能验证必须通过实际的页面交互操作来完成**（打开浏览器、点击按钮、填写表单、观察渲染结果），模拟真实用户操作路径。禁止只靠代码审查、单元测试断言或静态分析代替实际页面操作验证——用户最终是通过页面交互使用功能的，不是通过测试断言。能用浏览器手动操作的，就用浏览器手动操作一遍。
+
 ## Git 规范
 
 - 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。