From a874f07098e338fc8317e4a5cb92173350b66fac Mon Sep 17 00:00:00 2001 From: zyh Date: Sun, 12 Apr 2026 02:52:42 +0000 Subject: [PATCH] =?UTF-8?q?sync:=20=E6=9B=B4=E6=96=B0d8d-dev=E6=8A=80?= =?UTF-8?q?=E8=83=BD=20-=20journey-mode.md:=20=E6=96=B0=E5=A2=9E=E6=97=85?= =?UTF-8?q?=E7=A8=8B=E6=AD=A5=E9=AA=A4=E5=8E=9F=E5=9E=8B/Pencil=E8=A7=86?= =?UTF-8?q?=E8=A7=89=E5=AF=B9=E6=AF=94=E9=AA=8C=E8=AF=81=E7=AB=A0=E8=8A=82?= =?UTF-8?q?=20-=20phase-00-setup.md:=20=E6=9B=B4=E6=96=B0HMR=E9=99=8D?= =?UTF-8?q?=E7=BA=A7=E7=AD=96=E7=95=A5=EF=BC=8C=E6=96=B0=E5=A2=9ENext.js?= =?UTF-8?q?=20allowedDevOrigins=E5=A4=96=E7=BD=91=E5=9F=9F=E5=90=8D?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E7=AB=A0=E8=8A=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/skills/d8d-dev/journey-mode.md | 1 + .claude/skills/d8d-dev/phase-00-setup.md | 64 ++++++++++++------------ 2 files changed, 33 insertions(+), 32 deletions(-) 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`：