智能 AI 双流通信系统

项目采用 pnpm workspace 与 Turbo 组织 Django 后端、Vue 前端和 VitePress 文档站。

目录	内容	默认开发地址
packages/server	Django、Celery、聊天与知识库接口	http://127.0.0.1:4900
packages/site	Vue 3 前端	http://localhost:4904
docs	配置说明与验证指南	http://127.0.0.1:4909

接入与验证

阿里云百炼接入与验证包含控制台资源准备、环境变量、数据库迁移、聊天与知识库验收，以及从 Coze 迁移时的注意事项。

线上部署

线上按 Docker 部署流程 操作，包含 deploy/.env 配置、宿主机 MySQL、域名 HTTPS、端口与数据卷映射、验收和更新步骤。宿主机 Nginx 可使用仓库中的 deploy/nginx.host.conf.example。

本地运行

从仓库根目录执行：

pnpm install
pnpm dev:docs   # 仅启动文档站
pnpm dev        # 同时启动后端、前端和文档站

前后端运行前需准备根目录 .venv、后端 .env、MySQL 和 Redis，详见接入指南。

文档端口可以单独调整：

DOCS_PORT=4910 pnpm dev:docs

构建与预览

pnpm build:docs     # 输出到 docs/.vitepress/dist
pnpm preview:docs   # 本地预览构建产物
pnpm build          # Turbo 构建前端和文档站

在 docs/ 中编写 Markdown 页面，在 .vitepress/config.mts 中维护导航与侧栏。文档构建会检查站内链接；构建产物和开发缓存不会提交到 Git。