@routerhub/agent-rules 1.5.26 → 1.5.27

package/AGENTS.base.md

@@ -143,6 +143,7 @@ Closes #456
 - 当用户要求截图时，必须截取整页（full page），不得只截可视区域。
 - 截图结果必须包含当前页面 URL（地址栏可见或在截图说明中明确写出完整 URL）。
 - 在截图上添加箭头、标注、提示文字等注释时，必须放在页面空白区域，不得覆盖页面原有内容（文字、按钮、表格数据等）。
+- 当用户要求生成 HTML 页面并同时要求截图时，所有截图必须以 base64 data URI 形式内嵌到 HTML 文件中，禁止将截图单独输出为独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件。他人只需打开单个 HTML 文件即可看到完整页面内容和截图，无需额外图片文件。
 
 ## 可视化汇报
 

package/package.json

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

package/rules/devops.md

@@ -4,10 +4,6 @@ applyTo: ["**/Dockerfile","**/Dockerfile.*","**/docker-compose*.yml","**/docker-
 outputName: "devops"
 ---
 
-## Docker 与部署
+## 部署规则
 
-- 默认本地 `docker build`，构建后 `docker push` 到 `ghcr.io`，推送前确保正确 tag。
-- 部署时打包镜像必须统一使用当前 git 提交的 hash 作为镜像 tag 和版本号；项目内所有服务/镜像都必须使用同一个值，无论该镜像是否有代码改动，确保所有镜像版本号一致后再发版。
-- 部署通过 Portainer 管理界面操作，禁止 SSH 手动执行 docker 命令；地址和账号配置在 `AGENTS.private.md` 或环境变量中，禁止硬编码。
-- 始终通过 Portainer API 更新 Stack 环境变量触发重新部署，不要 SSH 手动操作 Portainer 管理的容器。
-- 测试环境和生产环境都通过 Portainer 部署，严禁 SSH 手动操作。测试环境是 Edge Agent（endpoint 7, stack 31），tunnel 按需建立、空闲自动断开，调 API 前必须先请求 `/endpoints/7/docker/info` 预热 tunnel；推荐直接用 `python3 portainer-update-stack.py <VERSION>` 部署（内置 tunnel 预热 + 重试）。生产环境是 Docker API（endpoint 8, stack 26），`APP_VERSION` 三服务共用。
+- 部署方式因项目而异，具体部署规则请在项目 `AGENTS.private.md` 中按需定义。

package/rules/global.md

@@ -25,6 +25,7 @@ name: "通用规则"
 - PR Title 示例：`[auth] Fix token refresh race condition on concurrent requests`、`[payments] Add idempotency key to charge API`、`[infra] Migrate cache layer from Redis 6 to Redis 7`。
 - PR Title 禁止使用 `fix bug`、`update code`、`改了一下` 等无法表达实际改动的标题。
 - PR Description 必须足够充分，至少回答 What（改了什么）、Why（为什么改，解决什么问题或满足什么需求）、How（采用什么方案，为什么选该方案）。
+- PR Description 必须使用中文编写，方便团队成员阅读理解；涉及 UI 改动、交互流程、页面效果等可视化变更时，必须附上截图或录屏作为证据。
 - PR Description 和 Test Plan 的文字应尽可能简洁明了，优先用页面操作路径、按钮点击、表单输入、可见结果描述验证过程；尽量少用代码片段解释，除非代码是理解变更或复现问题的必要证据。
 - 涉及行为变更、接口变更、数据迁移、性能影响时，必须在 Description 中显式写出。
 - 有意不做的事、已知局限、后续 follow-up 必须写清楚，避免 reviewer 重复追问。
@@ -142,6 +143,7 @@ Closes #456
 - 当用户要求截图时，必须截取整页（full page），不得只截可视区域。
 - 截图结果必须包含当前页面 URL（地址栏可见或在截图说明中明确写出完整 URL）。
 - 在截图上添加箭头、标注、提示文字等注释时，必须放在页面空白区域，不得覆盖页面原有内容（文字、按钮、表格数据等）。
+- 当用户要求生成 HTML 页面并同时要求截图时，所有截图必须以 base64 data URI 形式内嵌到 HTML 文件中，禁止将截图单独输出为独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件。他人只需打开单个 HTML 文件即可看到完整页面内容和截图，无需额外图片文件。
 
 ## 可视化汇报