将 CCWiki 部署到腾讯 EdgeOne Pages

01这个项目如何运行

CCWiki 是 Vite + React 静态应用。构建后生成 dist 目录，可以通过 EdgeOne Pages 托管；文章和索引在构建时随站点发布，搜索在浏览器完成。

部署知识库本身不需要模型 API 密钥。后续若增加实时模型能力，再把鉴权和上游请求放在服务端，并独立评估函数运行限制。

02先完成可重复构建

在干净依赖环境中执行安装与构建，再预览产物。构建成功之后仍需检查正文、搜索、收藏和移动端导航。

• Git 导入时选择项目根目录。
• 构建命令填写 npm run build。
• 产物目录填写 dist。
• 运行时选择项目 package.json 要求的 Node.js 版本。

npm ci
npm run build
npm run preview

03建立预览与生产发布流程

先用预览部署检查页面，再绑定生产域名。自定义域名、DNS 和证书按 EdgeOne 当前控制台步骤配置，等待解析生效后验证 HTTPS。

站点使用清晰的文章和资源路径，并在生产构建时生成对应 HTML。直接打开文章链接和刷新都应能命中正确页面；发布前同时检查静态输出、EdgeOne 路由规则与浏览器导航。

04发布验收清单

按以下项目逐项核对，记录实际环境与结论。

• 首页与文章分享链接能直接打开并刷新。
• JS、CSS、字体和图标返回正确状态与 MIME 类型。
• 内容搜索、语言链接、收藏与本地投稿导出可用。
• 404、浏览器离线和空搜索有清晰反馈。
• 生产环境没有测试地址、调试日志和前端密钥。

05部署完成但页面异常时

首页空白时先检查浏览器控制台和网络请求：脚本是否 404、路径是否与部署根目录一致、返回内容是否实际上是 HTML。若脚本被错误回退成 index.html，通常会出现模块 MIME 类型错误。

内容没有更新时核对最新部署是否成功，再检查入口 HTML 缓存和资源文件名。不要首先清空所有生产缓存，先确定请求命中了哪一版本。

• 构建失败：查看第一条错误，核对 Node.js 版本和锁文件。
• 静态资源 404：检查输出目录和 Vite 的 base 配置。
• 自定义域名不可达：检查 DNS 与证书状态。
• 功能仅在本机可用：排查对 localhost 或本地文件路径的引用。