FireflyBlog AI 功能完整指南

1
export const aiConfig = {
2
  // 是否启用 AI 功能
3
  enable: true,
4

5
  // DeepSeek API 配置
6
  apiEndpoint: 'https://api.deepseek.com/v1/chat/completions',
7
  model: 'deepseek-chat',
8
  maxTokens: 4096,
9
  temperature: 0.7,        // 问答模式
10
  summaryTemperature: 0.1,  // 概括模式（更稳定）
11

12
  // 功能开关
13
  chatEnabled: true,        // 启用 AI 问答
14
  summaryEnabled: true,     // 启用文章概括
15
  summaryAutoGenerate: false, // 是否自动生成概括
16

17
  // 博主信息
18
  authorName: 'Firefly',
19
  authorBio: '这是一个技术博客，分享编程、AI、Web 开发等技术内容。',
20
};

1
用户输入问题
2
    │
3
    ▼
4
前端构建请求 { messages, articleContent, articleTitle, headings }
5
    │
6
    ▼
7
POST /api/ai/chat
8
    │
9
    ├─ 1. 读取环境变量 AI_API_KEY
10
    │
11
    ├─ 2. 构建 System Prompt
12
    │     ├── SYSTEM_PROMPT（角色定义 + 输出格式）
13
    │     ├── 博主信息
14
    │     ├── 文章标题
15
    │     ├── 章节索引（用于引用编号）
16
    │     └── 文章全文
17
    │
18
    ├─ 3. 调用 DeepSeek API（stream: true）
19
    │
20
    └─ 4. 透传 SSE 流 → 浏览器

1
页面加载 / 点击「生成概括」按钮
2
    │
3
    ├─ 检查 sessionStorage 缓存
4
    │     ├─ 命中 → 直接渲染缓存结果
5
    │     └─ 未命中 → 发起请求
6
    │
7
    ├─ POST /api/ai/summarize
8
    │
9
    ├─ 服务端处理：
10
    │     ├── 读取文章内容
11
    │     ├── 构建章节索引
12
    │     ├── 组装 SUMMARIZE_PROMPT + 文章内容
13
    │     └── 调用 DeepSeek API → SSE 流
14
    │
15
    ├─ 前端流式渲染：
16
    │     ├── thinking 过程（可折叠）
17
    │     ├── 正文段落（支持行内 Markdown）
18
    │     ├── 引用链接（↗ + 章节编号）
19
    │     └── 提问建议标签
20
    │
21
    └─ 写入 sessionStorage

1
// 前端 SSE 解析核心逻辑
2
const reader = response.body?.getReader();
3
const decoder = new TextDecoder();
4

5
while (true) {
6
  const { done, value } = await reader.read();
7
  if (done) break;
8

9
  const chunk = decoder.decode(value, { stream: true });
10
  const lines = chunk.split('\n');
11

12
  for (const line of lines) {
13
    if (!line.startsWith('data: ')) continue;
14
    const data = line.slice(6).trim();
15
    if (data === '[DONE]') continue;
16

17
    const parsed = JSON.parse(data);
18
    const delta = parsed.choices?.[0]?.delta;
19

20
    // 处理思维链（thinking）
21
    if (delta?.reasoning_content) {
22
      thinkingContent += delta.reasoning_content;
23
    }
24

25
    // 处理正文内容
26
    if (delta?.content) {
27
      fullContent += delta.content;
28
    }
29
  }
30
}

1
// API 请求失败
2
if (!response.ok) {
3
  throw new Error('AI 服务暂时不可用');
4
}
5

6
// SSE 解析错误
7
try {
8
  const parsed = JSON.parse(data);
9
} catch (e) {
10
  // 忽略解析错误，继续处理下一个 chunk
11
}
12

13
// JSON 响应解析失败
14
try {
15
  const parsed = JSON.parse(fullContent);
16
} catch (e) {
17
  // 如果不是 JSON，保持原始内容
18
}