跳转到主要内容
当前仓库适合采用 双应用部署
  • 主站单独部署
  • docs 子应用单独部署

推荐方案一:子域名部署

主站

  • 仓库根目录作为项目根
  • 构建命令:npm run build
  • 输出目录:dist
  • 绑定域名:www.tidemind.ai

文档站

  • 项目根目录指向 docs/
  • 构建命令:npm run build
  • 启动命令:npm run start
  • 绑定域名:docs.tidemind.ai
这是最清晰也最稳定的方式。

推荐方案二:同域路径 /docs

如果你希望文档挂到主站路径下:
  • 主站仍保留在 www.tidemind.ai
  • 通过网关、Nginx 或平台层的 rewrite / proxy,把 /docs 转发到 docs 应用
这种方式用户体验更统一,但部署层更复杂。

当前代码里的衔接规则

主站中 docs 链接统一通过环境变量和默认值生成:
VITE_DOCS_URL=https://docs.tidemind.ai
如果未设置:
  • 开发环境默认:http://localhost:3001
  • 生产环境默认:/docs

本地联调

启动主站

npm run dev

启动文档站

npm run docs:dev

构建检查

主站

npm run build

文档站

npm run docs:build

搜索索引

文档站在 postbuild 中会自动运行 pagefind
pagefind --site .next/server/app --output-path public/_pagefind
因此生产构建完成后,会生成 docs/public/_pagefind 供搜索使用。