diff --git a/AGENTS.md b/AGENTS.md
index e8f1c5c..8a6ed76 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -144,6 +144,31 @@ npm run dev:mp-weixin
 
 **开发工作流说明**：详见 [小程序开发工作流程设计](docs/superpowers/specs/2026-04-07-mini-program-dev-workflow-design.md)
 
+#### 小程序 H5 测试登录凭证（强制默认）
+
+所有小程序功能的 H5 验收必须使用以下测试账号，**禁止在测试中使用真实手机号或重复触发验证码接口**：
+
+- **手机号**：`19928748688`（固定测试账号，11 位中国大陆手机号格式）
+- **验证码**：`123456`（固定 6 位数字，生产环境短信通道返回此固定值便于测试）
+
+**登录流程**（参考 `mini-program/src/pages/login/index.vue` + `mini-program/src/services/auth.js`）：
+
+1. 浏览器访问 `http://localhost:5180`，进入登录页
+2. 在手机号输入框填写 `19928748688`
+3. 点击「获取验证码」按钮，调用 `GET /api/auth/sms-code?phone=19928748688`，后端返回 `data.code: "123456"`
+4. 在验证码输入框填写 `123456`
+5. 点击「登录」按钮，调用 `POST /api/auth/login`，后端返回 JWT
+6. Token 写入 `uni.setStorageSync('access_token', ...)`（下划线键名）
+
+**为什么固定这两个值**：
+
+- 后端短信通道在测试模式下总是返回 `123456`，避免真实短信下发和验证码频繁失效
+- `19928748688` 是项目的固定测试账号，已绑定测试数据，避免污染真实用户数据
+
+#### 小程序页面固定端口
+
+小程序 H5 固定端口 **5180**（参考 `前端端口管理规则`）
+
 ### 一键部署
 
 ```bash
diff --git a/CLAUDE.md b/CLAUDE.md
index 91b5bc2..e58e2f3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -144,6 +144,31 @@ npm run dev:mp-weixin
 
 **开发工作流说明**：详见 [小程序开发工作流程设计](docs/superpowers/specs/2026-04-07-mini-program-dev-workflow-design.md)
 
+#### 小程序 H5 测试登录凭证（强制默认）
+
+所有小程序功能的 H5 验收必须使用以下测试账号，**禁止在测试中使用真实手机号或重复触发验证码接口**：
+
+- **手机号**：`19928748688`（固定测试账号，11 位中国大陆手机号格式）
+- **验证码**：`123456`（固定 6 位数字，生产环境短信通道返回此固定值便于测试）
+
+**登录流程**（参考 `mini-program/src/pages/login/index.vue` + `mini-program/src/services/auth.js`）：
+
+1. 浏览器访问 `http://localhost:5180`，进入登录页
+2. 在手机号输入框填写 `19928748688`
+3. 点击「获取验证码」按钮，调用 `GET /api/auth/sms-code?phone=19928748688`，后端返回 `data.code: "123456"`
+4. 在验证码输入框填写 `123456`
+5. 点击「登录」按钮，调用 `POST /api/auth/login`，后端返回 JWT
+6. Token 写入 `uni.setStorageSync('access_token', ...)`（下划线键名）
+
+**为什么固定这两个值**：
+
+- 后端短信通道在测试模式下总是返回 `123456`，避免真实短信下发和验证码频繁失效
+- `19928748688` 是项目的固定测试账号，已绑定测试数据，避免污染真实用户数据
+
+#### 小程序页面固定端口
+
+小程序 H5 固定端口 **5180**（参考 `前端端口管理规则`）
+
 ### 一键部署
 
 ```bash