# 功能变更需求文档（20260419_2344）

## 需求 1：切换模板时重置 AI 对话内容

### 问题背景
当前在顶部下拉框切换模板时，代码只替换了编辑器内容和 reportData，但右侧 AI 聊天面板中的历史对话（chatMessages）和输入框内容（chatInput）仍然残留，与新模板不匹配。

### 需求描述
在 `ReportEditor.tsx` 模板切换的 `useEffect` 中，同步清空 AI 相关状态：
- `setChatMessages([])`
- `setChatInput('')`
- `setAiUploadedImages([])`
- `setAiSelectedFrames([])`

---

## 需求 2：修复"AI 修改确认"弹窗原始版本段落间距过大

### 问题背景
Diff 弹窗左侧"原始版本"中，段落之间的间距明显过大（截图显示有大段空白），而右侧"AI 提议版本"间距正常。

### 根因分析
`stripHtml` 函数中手动在每个 `</p>` 后插入 `\n`：
```ts
tmp.innerHTML = html.replace(/<\/p>/gi, '</p>\n').replace(/<br\s*\/?>/gi, '\n');
```
而浏览器 `innerText` 本身就会在块级 `<p>` 元素之间自动插入换行。两者叠加导致双换行 → `computeDiffHtml` 将 `\n` 转为 `<br>` → 左侧显示双 `<br>` 间距。

### 需求描述
移除 `stripHtml` 中 `</p>\n` 的手动插入，仅保留 `<br>` 转 `\n` 的逻辑，让 `innerText` 自然处理段落间距。

---

## 需求 3：修复 API 密钥在 DOM 源码中暴露

### 问题背景
即使 `type="password"`，浏览器的 Elements 面板中仍可直接看到 `<input value="sk-2IAFn8ORoSdUcCxYX6DmXJWbH7BxftSSA8kN88mD1KUDTmkv">` 的完整明文。

### 需求描述
将 API Key 输入框从 React 受控组件（`value={...}`）改为 ref 控制的非受控组件：
- JSX 中不写 `value` / `defaultValue` prop
- 通过 `useEffect` + `useRef` 在 JavaScript 层面设置 DOM 的 `value` property（非 HTML attribute）
- 当 provider 切换或 apiKey 变化时，ref 同步更新 input 值
- 添加安全检查：仅当 ref 当前值与目标值不同时才设置，避免覆盖用户正在输入的字符

---

## 需求 4：默认模型名改为 moonshot-v1-32k-vision-preview

### 需求描述
将 Kimi 默认模型从 `moonshot-v1-auto` 改为 `moonshot-v1-32k-vision-preview`，支持视觉输入。

---

## 影响范围
- `src/pages/ReportEditor.tsx`
- `src/pages/SystemSettings.tsx`
- `src/types.ts`