0015 官网与网页版域名分工

• 状态：已采纳
• 日期：2026-10-25

背景

云食册需要包含真实产品展示、服务信息、iOS 发布状态和文档的官网。此前文档目录已设计交互落地页，微信审核整改另有静态 /about/ 页面；同时 cook.yunle.fun 与 cook.yunyoujun.cn 都在提供网页版，产品入口重复。

决定

• cook.yunle.fun 根路径作为云食册官网，复用文档中的食材入锅与手机演示设计，和使用指南、开发文档、隐私政策共用一套 VitePress 站点。
• cook.yunyoujun.cn 继续提供食用手册网页版，官网的主要使用入口明确跳到该域名。
• docs.cook.yunle.fun 仅保留历史链接兼容：由独立的 Cloudflare Worker cook-docs-redirect 按原路径与查询参数返回 HTTP 301，目标为 https://cook.yunle.fun。2026-10-25 验证官网内容、独立重定向和托管证书后，已删除 Cloudflare Pages cook-docs，不再维护第二份站点部署。
• App、仓库公开链接及平台资料中的文档 URL 统一使用官网；App Store Connect 原先保存的 cook-docs.pages.dev 隐私政策地址与 TestFlight 的旧域名链接均已更新并回读，GitHub 仓库主页也已改为官网。具体操作与验收记录见官网、文档与网页版部署。
• 微信审核已经填写的 cook.yunyoujun.cn/about/ 和协议继续保留；本次不重新修改微信申请地址。
• 下载入口按真实发布状态提供。尚未上架或没有公开安装邀请时，提供版本状态与体验报名说明，不制造下载链接。

方案对比

直接把 cook.yunle.fun 改为纯文档产物最简单，但会移除旧应用路径。同域的登录事务保存在 sessionStorage，用户的本机记录也不会自动跨域迁移，因此不能直接将回调重定向到网页版域名。

采用独立组合产物 dist-site：以 VitePress 首页与文档为主，保留旧应用的 Nuxt 资源和明确路径，让已有回调和数据导出继续可用。常规网页版产物仍为 dist，两个发布项目不混用。脚本验证输入和路径冲突后才替换组合产物，不改输入目录。

影响

• 产品介绍只有一个新的主入口，页面主体构建时生成 HTML，交互作为增强。
• 旧应用兼容路径增加了官网部署体积；在原域名用户迁移方案明确前，不随意移除。
• 首页明确提供旧版记录迁移指南，原域名数据不自动上传、转移或清除。
• 网站服务信息与备案号按对应域名维护；微信应用审核和登录能力审核仍是独立流程。
• 发布配置和验收路径见官网、文档与网页版部署。