Mdeical_Sur_Report/工程分析/20260419_2249/功能变更实现方案文档.md

功能变更实现方案文档（20260419_2249）

实现方案 A：Kimi k2.5 参数拦截

变更点

ReportEditor.tsx 中 handleAIGenerate 函数的请求体构建部分（当前行号约 948-962）。

具体实现

1. 在构建 body 前，先创建一个 payload 对象：

   const payload: any = {
     model: modelName,
     messages: [
       { role: 'system', content: systemPrompt },
       { role: 'user', content: messageContent }
     ],
     temperature: 0.3
   };
   

2. 增加条件判断：

   const isKimiK25 = settings.activeAiProvider === 'kimi' && /k2\.5/i.test(modelName);
   if (isKimiK25) {
     delete payload.temperature;
     delete payload.top_p;
     delete payload.presence_penalty;
     delete payload.frequency_penalty;
   }
   

3. fetch 的 body: JSON.stringify(payload)

设计理由

• 使用 delete 而非覆盖为固定值，是因为 Kimi 官方文档明确禁止这些参数出现；即使设为 1.0 仍可能触发校验失败
• 条件判断放在 settings 读取后立即执行，确保使用用户实际配置的 provider 和 modelName
• 正则 /k2\.5/i 兼容可能的模型 ID 变体（如 kimi-k2.5、kimi-k2.5-preview 等）

---

实现方案 B：完善 AI 日志导出

变更点 1：新增 lastExchangeLog 状态

在 ReportEditor.tsx 的 state 定义区（chatMessages 附近）新增：

const [lastExchangeLog, setLastExchangeLog] = useState<{
  startTime: string;
  modelConfig: { provider: string; endpoint: string; modelName: string };
  requestPayload: any;
  responsePayload: any | null;
  errorDetail: { status: number; statusText: string; responseText: string; message: string } | null;
} | null>(null);

变更点 2：在 handleAIGenerate 中记录日志

将函数重构为在关键节点捕获数据：

A. 请求前记录：

const logEntry = {
  startTime: new Date().toISOString(),
  modelConfig: { provider: settings.activeAiProvider || 'kimi', endpoint: apiEndpoint, modelName },
  requestPayload: { ...payload },
  responsePayload: null,
  errorDetail: null
};

B. 错误处理增强： 当前错误处理只有：

if (!response.ok) throw new Error(`API 请求失败: ${response.status}`);

改为：

if (!response.ok) {
  const errorText = await response.text();
  logEntry.errorDetail = {
    status: response.status,
    statusText: response.statusText,
    responseText: errorText,
    message: `API 请求失败: ${response.status}`
  };
  setLastExchangeLog(logEntry);
  throw new Error(`API 请求失败: ${response.status} - ${errorText}`);
}

C. 成功响应记录： 在解析 responseJson 后：

logEntry.responsePayload = responseJson;
setLastExchangeLog(logEntry);

变更点 3：更新导出按钮

在「导出 AI 日志」按钮的 onClick 中，将 lastExchangeLog 加入导出数据：

const data = {
  exportAt: new Date().toISOString(),
  url: window.location.href,
  messages: chatMessages,
  lastExchange: lastExchangeLog,
  metadata: { ... }
};

设计理由

• lastExchangeLog 只记录最后一次调用，避免无限增长导致内存/状态膨胀
• 错误时捕获 response.text() 获取 Kimi 官方返回的详细错误 JSON（通常包含 error.code 和 error.message）
• requestPayload 深拷贝防止后续 delete 操作污染日志记录
• 使用 useState 而非 useRef，因为导出按钮需要读取最新值并触发重渲染显示状态

---

依赖与兼容性

• 无新增 npm 依赖
• TypeScript 类型在组件内部定义，不影响 src/types.ts
• 向后兼容：旧数据无 lastExchangeLog，导出时字段为 null