# 03. AI 与多语言设计

## 1. AI 分层

AI 在这个项目里不只是聊天窗口，而是产品能力的一部分。

建议分成两层：

- AI 体验层
  - 面向前端页面
  - 负责流式聊天、建议卡片、交互状态
  - 推荐使用 `Vercel AI SDK`
- AI 编排层
  - 面向服务端
  - 负责工具调用、知识库、排障链路、多步骤推理
  - 推荐使用 `LangChain`

后续如果工作流变复杂，再升级到 `LangGraph`。

## 2. 第一阶段 AI 目标

优先做 3 个高价值能力：

- AI 映射助手
  - 根据自然语言生成 draft 建议
- AI 排障助手
  - 解释 Agent 离线、发布失败、端口冲突
- AI 发布解释器
  - 告诉用户某次 revision 影响了什么

## 3. 多语言支持范围

不是所有端都要同时做多语言。

建议如下：

- 官网：必须双语
- 登录 / 注册：双语
- 客户管理端：双语
- 正式后台 `/admin`：先中文优先，但代码结构要 i18n 化
- 内部运维台 `/ops`：固定中文

## 4. 核心数据怎么存

核心表只存稳定 code，不直接存展示文案：

- `queued`
- `running`
- `succeeded`
- `failed`
- `online`
- `offline`

前端再根据语言环境翻译。

## 5. 内容层怎么做多语言

内容类数据建议走 Directus：

- 帮助中心
- FAQ
- SOP
- 产品说明
- 条款
- 公告

第一阶段可以先做双语字段：

- `title_zh`
- `title_en`
- `content_zh`
- `content_en`

后期内容多了，再升级成翻译表。

## 6. AI 的多语言策略

前端请求 AI 时，必须携带 `locale`。

AI Gateway 根据 `locale` 控制：

- 返回语言
- 提示词语言
- 知识库检索语言
- 状态词解释语言

目标是避免：

- 页面英文，AI 回中文
- 页面中文，AI 用一堆英文状态词

## 7. 第一阶段实现要求

- 官网、登录、注册、客户端页面预留语言切换入口
- 后台所有菜单与文案改成 i18n key 结构
- `/ops` 保持中文，不参与多语言