跳转到主要内容
当前仓库已经分成两套前端:
  • 主站:React + Vite
  • 文档站:Next.js + Nextra
这样做不是重复建设,而是为了让两类目标各自最优。

为什么不把所有内容都塞进主站

如果开发文档继续放在主站页面里,后面会越来越难维护:
  • 侧边栏目录需要手写
  • Markdown 内容管理会越来越重
  • API 文档、教程、FAQ 混在一起不利于扩展
  • 搜索、分页、TOC、代码块能力都要自己补
Nextra 更适合承担真正的文档系统。

推荐分层

主站负责

  • 品牌展示
  • 解决方案叙事
  • 线索转化
  • 产品矩阵与定价
  • 文档入口页

文档站负责

  • 快速开始
  • 模型目录
  • API Reference
  • 集成流程
  • 部署与治理
  • 面向开发者的持续更新内容

页面衔接方式

当前已经做了这几层衔接:
  • 官网顶部导航增加 Docs 外链入口
  • 官网页脚增加 Developer Docs
  • 开放平台 页面中的 docs tab 和主 CTA 都会跳转到文档站

URL 建议

最推荐两种:
  1. docs.tidemind.ai
  2. www.tidemind.ai/docs
如果没有统一网关或反向代理,优先选子域名会更省心。