sync: 更新d8d-dev技能 #20

Merged
d8dfun merged 1 commits from sync/d8d-skills-20260412-025222 into master 2026-04-12 11:14:22 +08:00
2 changed files with 33 additions and 32 deletions

View File

@@ -378,6 +378,7 @@ Story 验证全部通过 ≠ 用户能正常使用系统。旅程模式弥补这
- 修复后重测:重新 browser_take_screenshot + analyze_image 确认问题已修复
- 修复失败 → 标记 journey-step-fail → 继续下一步骤
- 步骤 4修复阶段仅处理功能断言 FAIL不处理视觉验证 FAIL
f. 如涉及数据变化 → browser_evaluate 或 curl 验证数据(✅ 允许 curl 补充)
6. ⛔ **旅程步骤原型/Pencil 视觉对比验证**(⛔ 强制 — 针对操作时产生的动态状态)
目的: 捕获并验证操作时才会出现的视觉状态hover、选中、弹窗、展开、加载中、错误提示等这些状态在静态原型对比中无法覆盖

View File

@@ -66,11 +66,11 @@
}
```
- 标记Epic 0 完成后此文件才可生效(项目目录需先存在)
- ⛔ **HMR 降级策略(备选)**:配置了 `allowedDevOrigins` 后,外网域名的 HMR 通常可以正常工作。仅在以下情况下降级到生产模式:
- 配置了 `allowedDevOrigins` 后 HMR 仍失败
- 需要最大化测试稳定性(生产模式无 HMR 干扰)
降级步骤(`next start` 替代 `next dev`
- ⛔ **HMR 降级策略(备选)**:配置了 `allowedDevOrigins` 后,外网域名的 HMR 通常可以正常工作。仅在以下情况下降级到生产模式:
- 配置了 `allowedDevOrigins` 后 HMR 仍失败
- 需要最大化测试稳定性(生产模式无 HMR 干扰)
降级步骤(`next start` 替代 `next dev`
```bash
npx next build
pm2 stop app && pm2 delete app
@@ -188,37 +188,37 @@
- Next.js 可能需要清缓存:删除 `app/admin/.next` 后重启
**注意事项**
当通过外网域名(如 `*.dev.d8d.fun`)访问 Next.js 开发服务器时,必须在 `next.config.ts` 中配置 `allowedDevOrigins`,否则会出现 "Invalid Host header" 错误。
**配置示例**
```typescript
// next.config.ts
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
allowedDevOrigins: [
"*.dev.d8d.fun",
"localhost",
],
};
export default nextConfig;
```
**配置后重启服务**
```bash
pm2 restart vividspark
```
详见 `./reference/platform-nextjs.md` §10
4.9. **MinIO 外网地址注入(⛔ 强制)**
- 如果使用 localhost fallback步骤 4.6 的 Step 3 结果),.env.local 值写 `http://localhost:3001`
- 此步骤创建的 .env.local 不应提交到 git应在 .gitignore 中排除)
- 更新 pipeline-context.md 记录注入状态
4.8. **Next.js allowedDevOrigins 配置(⛔ 外网域名访问时强制)**
当通过外网域名(如 `*.dev.d8d.fun`)访问 Next.js 开发服务器时,必须在 `next.config.ts` 中配置 `allowedDevOrigins`,否则会出现 "Invalid Host header" 错误。
**配置示例**
```typescript
// next.config.ts
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
allowedDevOrigins: [
"*.dev.d8d.fun",
"localhost",
],
};
export default nextConfig;
```
**配置后重启服务**
```bash
pm2 restart vividspark
```
详见 `./reference/platform-nextjs.md` §10
4.9. **MinIO 外网地址注入(⛔ 强制)**
4.8. **MinIO 外网地址注入(⛔ 强制)**
检测容器环境变量 `MINIO_HOST`,将外网地址注入到 `.env` 中的 `S3_PUBLIC_URL`