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