AI助手应用导出功能全解析：数据主权时代的技术必修课

// 传统方式：手动复制聊天记录
const conversation = [];
while (有更多对话) {
  const message = 手动选中文本 + 复制 + 粘贴到文本文件();
  conversation.push(message);
}
// 耗时、易错、无法自动化

┌─────────────────────────────────────────────────────────┐
│                    AI助手数据主权                         │
├─────────────────────────────────────────────────────────┤
│                                                         │
│    ┌──────────┐         ┌──────────┐                   │
│    │  导出     │ ◄─────► │  导入     │                   │
│    │ (Export)  │         │ (Import)  │                   │
│    └────┬─────┘         └────┬─────┘                   │
│         │                    │                          │
│         ▼                    ▼                          │
│   JSON / Markdown / CSV   ZIP / JSON / 各平台专有格式    │
│                                                         │
│   数据备份     模型微调     平台迁移     知识沉淀         │
└─────────────────────────────────────────────────────────┘

前端触发 → 后端聚合 → 客户端保存

// 前端：点击导出按钮，发起API请求
async function exportSession(sessionId, format = 'markdown') {
  const response = await fetch(`/api/export/session?sessionId=${sessionId}&format=${format}`, {
    method: 'GET',
    headers: { 'Authorization': `Bearer ${userToken}` }
  });
  
  if (response.ok) {
    // 处理文件下载
    const blob = await response.blob();
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = `session-${sessionId}.${format === 'markdown' ? 'md' : 'json'}`;
    a.click();
    URL.revokeObjectURL(url);
  }
}

// Next.js API 路由：/api/export/session
import { getSessionMessages, verifySessionOwnership } from '@/lib/db';

export async function GET(request) {
  const { searchParams } = new URL(request.url);
  const sessionId = searchParams.get('sessionId');
  const format = searchParams.get('format') || 'markdown';
  const userId = await getUserIdFromToken(request);
  
  // 🔐 第一道防线：验证用户是否有权访问该会话
  const hasAccess = await verifySessionOwnership(sessionId, userId);
  if (!hasAccess) {
    return new Response('Unauthorized', { status: 401 });
  }
  
  // 📦 拉取消息树（注意：非线性结构，保留分支关系）
  const messageTree = await getSessionMessages(sessionId);
  
  // 🎨 格式化输出
  let output, contentType;
  if (format === 'json') {
    output = JSON.stringify(messageTree, null, 2);
    contentType = 'application/json';
  } else {
    output = formatToMarkdown(messageTree);
    contentType = 'text/markdown; charset=utf-8';
  }
  
  // 💾 设置响应头，触发浏览器下载
  return new Response(output, {
    headers: {
      'Content-Type': contentType,
      'Content-Disposition': `attachment; filename="session-${sessionId}.${format === 'markdown' ? 'md' : 'json'}"`
    }
  });
}

function formatToMarkdown(messageTree) {
  let markdown = ` ${messageTree.title || '对话记录'}\n`;
  markdown += `> 创建时间：${new Date(messageTree.createdAt).toLocaleString()}\n`;
  markdown += `> 更新时间：${new Date(messageTree.updatedAt).toLocaleString()}\n\n`;
  
  for (const message of messageTree.messages) {
    const role = message.role === 'user' ? '👤 用户' : '🤖 AI助手';
    markdown += ` ${role}\n\n`;
    markdown += `${message.content}\n\n`;
    
    // 处理代码块
    if (message.codeBlocks?.length) {
      markdown += '```' + (message.language || '') + '\n';
      markdown += message.codeBlocks.join('\n');
      markdown += '\n```\n\n';
    }
  }
  
  return markdown;
}