# 回归清单 · 界面语言切换基础：locale cookie、切换器与双语外壳

- 产品：CoDelphi
- 提交：[203cdca](https://github.com/gzhanlei/codelphi/compare/7bdc50b27c89ef1ae538a60379fd4a030af9ad58...203cdca7321b4393332f713c0d9df0ae41921a0b)
- 生成时间：2026-11-16 05:07 UTC

## locale 感知日期格式化
- [ ] [新增] 新增功能「locale 感知日期格式化」（行为变化）（待验证）
- [ ] [回归] EC-1 — 日期值为空或无法解析为合法日期 formatDateIn 执行（影响面推荐）（证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] EC-2 — 传入空值或无法解析的日期字符串 formatDateIn 执行（影响面推荐）（证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] HP-1 — 界面语言为 en 且设置页存在计费周期与订单记录 渲染设置页（影响面推荐）（证据路径命中 app/settings/page.tsx；证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] HP-2 — 界面语言为 en 且产品总览存在发布时间线 buildProductOverview 传入 locale=en 执行（影响面推荐）（证据路径命中 lib/format.ts；证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-3 — 传入合法日期与 locale formatDateIn 执行（影响面推荐）（证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] HP-4 — 需要展示日期与时间 formatDateTimeIn 执行（影响面推荐）（证据路径命中 lib/format.ts）（待验证）

## 产品总览仪表盘
- [ ] [移除] EC-10 — 「产品总览仪表盘」移除场景 EC-10（行为变化）（待验证）
- [ ] [移除] EC-11 — 「产品总览仪表盘」移除场景 EC-11（行为变化）（待验证）
- [ ] [移除] EC-12 — 「产品总览仪表盘」移除场景 EC-12（行为变化）（待验证）
- [ ] [移除] EC-13 — 「产品总览仪表盘」移除场景 EC-13（行为变化）（待验证）
- [ ] [移除] EC-2 — 「产品总览仪表盘」移除场景 EC-2（行为变化）（待验证）
- [ ] [移除] EC-5 — 「产品总览仪表盘」移除场景 EC-5（行为变化）（待验证）
- [ ] [移除] EC-6 — 「产品总览仪表盘」移除场景 EC-6（行为变化）（待验证）
- [ ] [移除] EC-7 — 「产品总览仪表盘」移除场景 EC-7（行为变化）（待验证）
- [ ] [移除] EC-8 — 「产品总览仪表盘」移除场景 EC-8（行为变化）（待验证）
- [ ] [移除] EC-9 — 「产品总览仪表盘」移除场景 EC-9（行为变化）（待验证）
- [ ] [移除] ER-2 — 「产品总览仪表盘」移除场景 ER-2（行为变化）（待验证）
- [ ] [移除] HP-11 — 「产品总览仪表盘」移除场景 HP-11（行为变化）（待验证）
- [ ] [移除] HP-2 — 「产品总览仪表盘」移除场景 HP-2（行为变化）（待验证）
- [ ] [移除] HP-7 — 「产品总览仪表盘」移除场景 HP-7（行为变化）（待验证）
- [ ] [移除] HP-8 — 「产品总览仪表盘」移除场景 HP-8（行为变化）（待验证）
- [ ] [回归] EC-1 — 最近发布中某场景级变化的对侧证据全部来自测试/文档 buildProductOverview 计算发布稿功能勾选计数（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] EC-14 — 某功能影响文本已满每功能上限 buildUserImpact 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] EC-3 — 连续多条零行为变化发布 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] EC-4 — 最新发布没有非空用户影响文本 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] ER-1 — 产品尚无任何发布 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-1 — 产品存在最近一次发布且含行为变化 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [变化] HP-10 — 「产品总览仪表盘」更新场景 HP-10（行为变化；证据路径命中 app/page.tsx）（待验证）
  情境：界面语言为 en 的用户打开仪表盘｜操作：访问 /｜结果：日期 chip 以英文格式显示当前日期（月/日/星期）
- [ ] [回归] HP-3 — 产品已有最新发布与行为变化 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-4 — 最新发布存在已落库的用户影响文本 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-5 — 最新发布的变化中场景证据全为测试/文档 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-6 — 最新发布同时存在实现证据与测试佐证的影响文本 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-9 — 最新发布含实现证据的行为变化 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）

## 产品页头部与演示只读入口
- [ ] [移除] EC-13 — 「产品页头部与演示只读入口」移除场景 EC-13（行为变化）（待验证）
- [ ] [移除] EC-14 — 「产品页头部与演示只读入口」移除场景 EC-14（行为变化）（待验证）
- [ ] [移除] EC-3 — 「产品页头部与演示只读入口」移除场景 EC-3（行为变化）（待验证）
- [ ] [移除] EC-4 — 「产品页头部与演示只读入口」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-5 — 「产品页头部与演示只读入口」移除场景 EC-5（行为变化）（待验证）
- [ ] [移除] EC-6 — 「产品页头部与演示只读入口」移除场景 EC-6（行为变化）（待验证）
- [ ] [移除] EC-7 — 「产品页头部与演示只读入口」移除场景 EC-7（行为变化）（待验证）
- [ ] [移除] EC-8 — 「产品页头部与演示只读入口」移除场景 EC-8（行为变化）（待验证）
- [ ] [移除] ER-4 — 「产品页头部与演示只读入口」移除场景 ER-4（行为变化）（待验证）
- [ ] [移除] ER-5 — 「产品页头部与演示只读入口」移除场景 ER-5（行为变化）（待验证）
- [ ] [移除] HP-4 — 「产品页头部与演示只读入口」移除场景 HP-4（行为变化）（待验证）
- [ ] [移除] HP-6 — 「产品页头部与演示只读入口」移除场景 HP-6（行为变化）（待验证）
- [ ] [移除] HP-7 — 「产品页头部与演示只读入口」移除场景 HP-7（行为变化）（待验证）
- [ ] [回归] EC-1 — 匿名演示访客打开演示产品页 渲染头部操作区（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] ER-3 — 匿名 demo 访客尝试触发写操作 服务端校验写权限（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] HP-1 — 编辑者打开产品页 渲染头部操作区（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] HP-3 — 编辑者访问产品页 渲染头部写操作入口（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] HP-5 — 匿名演示访客打开公开演示产品页 渲染产品页头部（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）

## 产品页头部与简介展示
- [ ] [移除] EC-4 — 「产品页头部与简介展示」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-6 — 「产品页头部与简介展示」移除场景 EC-6（行为变化）（待验证）
- [ ] [移除] HP-4 — 「产品页头部与简介展示」移除场景 HP-4（行为变化）（待验证）
- [ ] [移除] HP-5 — 「产品页头部与简介展示」移除场景 HP-5（行为变化）（待验证）
- [ ] [回归] EC-1 — 产品简介为空 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] EC-3 — 产品简介为空且当前用户只读 渲染产品简介行（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] HP-1 — 产品简介由分析生成并带证据 buildProductOverview 执行（影响面推荐）（证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-2 — 产品已有简介且当前用户可编辑 渲染产品简介行（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）

## 匿名演示态分析入口
- [ ] [移除] EC-4 — 「匿名演示态分析入口」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-5 — 「匿名演示态分析入口」移除场景 EC-5（行为变化）（待验证）
- [ ] [移除] EC-8 — 「匿名演示态分析入口」移除场景 EC-8（行为变化）（待验证）
- [ ] [移除] HP-4 — 「匿名演示态分析入口」移除场景 HP-4（行为变化）（待验证）
- [ ] [回归] EC-1 — 匿名演示访客查看演示外壳顶栏 渲染顶栏（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] ER-2 — 分析请求被额度闸门拒绝 点击「立即分析」（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）

## 只读演示下的分析入口
- [ ] [移除] EC-3 — 「只读演示下的分析入口」移除场景 EC-3（行为变化）（待验证）
- [ ] [移除] EC-4 — 「只读演示下的分析入口」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-6 — 「只读演示下的分析入口」移除场景 EC-6（行为变化）（待验证）
- [ ] [移除] EC-7 — 「只读演示下的分析入口」移除场景 EC-7（行为变化）（待验证）
- [ ] [移除] HP-3 — 「只读演示下的分析入口」移除场景 HP-3（行为变化）（待验证）
- [ ] [移除] HP-4 — 「只读演示下的分析入口」移除场景 HP-4（行为变化）（待验证）
- [ ] [移除] HP-5 — 「只读演示下的分析入口」移除场景 HP-5（行为变化）（待验证）
- [ ] [移除] HP-6 — 「只读演示下的分析入口」移除场景 HP-6（行为变化）（待验证）
- [ ] [回归] EC-1 — 登录只读成员查看分析入口 渲染组件（影响面推荐）（证据路径命中 components/app-shell.tsx）（待验证）
- [ ] [回归] EC-5 — 演示产品按组织与 slug 精确解析 打开演示详情页（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] ER-1 — 匿名 demo 访客绕过前端提交写请求 服务端校验写权限（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] ER-2 — 匿名访客访问非 demo 产品地址 解析公开演示产品（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] HP-2 — 匿名 demo 访客浏览产品规格 查看场景工作区（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）

## 演示模式分析入口
- [ ] [移除] EC-4 — 「演示模式分析入口」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-5 — 「演示模式分析入口」移除场景 EC-5（行为变化）（待验证）
- [ ] [移除] EC-8 — 「演示模式分析入口」移除场景 EC-8（行为变化）（待验证）
- [ ] [移除] EC-9 — 「演示模式分析入口」移除场景 EC-9（行为变化）（待验证）
- [ ] [移除] HP-4 — 「演示模式分析入口」移除场景 HP-4（行为变化）（待验证）
- [ ] [移除] HP-5 — 「演示模式分析入口」移除场景 HP-5（行为变化）（待验证）
- [ ] [移除] HP-6 — 「演示模式分析入口」移除场景 HP-6（行为变化）（待验证）
- [ ] [移除] HP-7 — 「演示模式分析入口」移除场景 HP-7（行为变化）（待验证）
- [ ] [回归] EC-1 — 匿名演示访客查看产品页头部 渲染分析入口（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] EC-2 — 匿名演示访客查看总览页 渲染发布入口（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] EC-6 — 匿名演示访客查看发布入口 渲染发布入口组件（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] ER-1 — 绕过前端直接向写接口发请求 服务端处理写请求（影响面推荐）（证据路径命中 app/products/[slug]/[product]/page.tsx）（待验证）
- [ ] [回归] HP-1 — 匿名演示访客打开演示产品页 渲染页面（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）
- [ ] [回归] HP-3 — 匿名 demo 访客打开产品页 渲染页面头部（影响面推荐）（证据路径命中 components/demo-shell.tsx）（待验证）

## 界面语言切换
- [ ] [新增] 新增功能「界面语言切换」（行为变化）（待验证）
- [ ] [回归] EC-1 — 请求未携带 codelphi_locale cookie 或 cookie 值非法 resolveUiLocale 执行（影响面推荐）（证据路径命中 lib/ui-locale-server.ts；证据路径命中 lib/ui-locale.ts）（待验证）
- [ ] [回归] EC-2 — 切换请求的 locale 不在 zh-CN/en 内，或 redirectTo 为绝对地址或 // 开头 POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] EC-3 — 点击当前已选中的语言 LanguageSwitcher 的 switchTo 执行（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] ER-1 — 切换请求进行中 再次点击任一语言按钮（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-1 — 用户在顶栏点击另一种界面语言 LanguageSwitcher 读取当前路径并 POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts；证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-2 — 界面语言为 en 时渲染外壳 AppShell/PublicShell/DemoShell/Brand 渲染（影响面推荐）（证据路径命中 components/app-shell.tsx；证据路径命中 components/language-switcher.tsx；证据路径命中 components/shell-frame.tsx）（待验证）
- [ ] [回归] HP-3 — 界面语言为 en 时加载页面 根布局与页面渲染（影响面推荐）（证据路径命中 app/layout.tsx；证据路径命中 lib/format.ts）（待验证）

## 界面语言切换与双语外壳
- [ ] [新增] 新增功能「界面语言切换与双语外壳」（行为变化）（待验证）
- [ ] [回归] EC-1 — 请求体 locale 为 fr 或 redirectTo 为 https://evil.example、//evil.example、null POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] EC-2 — cookie 缺失或值为未知语言（如 fr） resolveUiLocaleValue 执行（影响面推荐）（证据路径命中 lib/ui-locale.ts）（待验证）
- [ ] [回归] EC-3 — 用户点击当前已选中的语言按钮或切换请求尚未完成 点击语言切换器按钮（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] EC-4 — 切换器当前语言按钮被点击或请求进行中 点击语言按钮（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] EC-5 — 切换器渲染时当前语言为 en 渲染 LanguageSwitcher（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] EC-6 — 切换请求的 locale 不在枚举内或 redirectTo 不是同源路径 POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] EC-7 — 当前语言按钮被点击或切换请求进行中 LanguageSwitcher 处理点击（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] EC-8 — 请求 locale 不在 zh-CN/en 内，或 redirectTo 为绝对地址或 // 开头 POST /api/ui-locale 执行（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] EC-9 — 当前语言已是目标语言或切换请求进行中 点击语言 pill（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] ER-1 — 提交的 locale 不在 zh-CN/en 内，或 redirectTo 为站外地址、协议相对地址、非 / 开头 POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] ER-2 — 切换请求网络失败 LanguageSwitcher 的 switchTo 执行（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] ER-3 — 切换请求返回非成功状态 点击语言 pill（影响面推荐）（证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-1 — 界面语言为中文的用户在任意外壳页面 点击顶栏语言切换器中的 English（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts；证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-10 — 界面语言为 en 时查看仪表盘、设置页、成本观测页或产品总览 页面调用 formatDateIn/formatDateTimeIn 渲染日期（影响面推荐）（证据路径命中 app/admin/costs/page.tsx；证据路径命中 app/page.tsx；证据路径命中 app/settings/page.tsx；证据路径命中 lib/format.ts；证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-11 — 用户在任意外壳顶栏点击另一种界面语言 LanguageSwitcher 以当前 window.location 路径 POST /api/ui-locale（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts；证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-12 — 界面语言为英文时查看仪表盘、设置或成本观测页 页面渲染日期字段（影响面推荐）（证据路径命中 app/settings/page.tsx；证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] HP-13 — 请求携带合法 locale 与同源 redirectTo POST /api/ui-locale 执行（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] HP-14 — cookie 中 codelphi_locale 为 en 渲染根布局与外壳（影响面推荐）（证据路径命中 app/layout.tsx；证据路径命中 components/app-shell.tsx；证据路径命中 lib/ui-locale-server.ts）（待验证）
- [ ] [回归] HP-15 — 界面语言为 en 且页面展示日期 渲染仪表盘、设置页、成本观测页或产品总览（影响面推荐）（证据路径命中 app/admin/costs/page.tsx；证据路径命中 app/page.tsx；证据路径命中 app/settings/page.tsx；证据路径命中 lib/format.ts；证据路径命中 lib/product-overview.ts）（待验证）
- [ ] [回归] HP-2 — 界面语言为英文的用户打开应用外壳页面 渲染侧栏与顶栏（影响面推荐）（证据路径命中 app/layout.tsx；证据路径命中 components/app-shell.tsx；证据路径命中 lib/ui-strings.ts）（待验证）
- [ ] [回归] HP-3 — 匿名访客打开公开外壳页面 渲染顶栏（影响面推荐）（证据路径命中 components/public-shell.tsx）（待验证）
- [ ] [回归] HP-4 — 用户在任意外壳顶栏点击另一种界面语言 LanguageSwitcher 提交 POST /api/ui-locale 携带当前路径（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts；证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-5 — 界面语言 cookie 为 en 根布局与外壳渲染（影响面推荐）（证据路径命中 app/layout.tsx；证据路径命中 lib/ui-strings.ts）（待验证）
- [ ] [回归] HP-6 — 界面语言为 en 且页面展示日期 仪表盘、设置页、成本页或产品总览渲染日期（影响面推荐）（证据路径命中 app/page.tsx；证据路径命中 lib/format.ts）（待验证）
- [ ] [回归] HP-7 — 用户在产品页顶栏点击「English」 LanguageSwitcher 提交 POST /api/ui-locale，携带 locale=en 与当前 window.location 路径（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts；证据路径命中 components/language-switcher.tsx）（待验证）
- [ ] [回归] HP-8 — 请求携带合法 locale 与同源 redirectTo POST /api/ui-locale 执行（影响面推荐）（证据路径命中 app/api/ui-locale/route.ts）（待验证）
- [ ] [回归] HP-9 — 浏览器已带 codelphi_locale=en 访问页面 根布局与外壳组件调用 resolveUiLocale 渲染（影响面推荐）（证据路径命中 app/layout.tsx；证据路径命中 lib/ui-locale-server.ts；证据路径命中 lib/ui-strings.ts）（待验证）