fix(editor): AI只聊天不修改——解绑SystemPrompt目标区域依赖 + 增加光标插入降级

- systemPrompt条件从'aiModifyEnabled && targetRegionEl'改为'aiModifyEnabled',确保开启修改模式后大模型始终返回updatedHtml
- 接收updatedHtml逻辑增加if/else分支:targetRegionEl存在时走diff弹窗,不存在时调用execCmd('insertHTML')降级插入光标位置
- 参考参考-ReportEditor.tsx中injectAIText的降级机制
This commit is contained in:
2026-04-19 03:47:14 +08:00
parent 854a00c2fa
commit c1d2438d2b
5 changed files with 217 additions and 9 deletions

View File

@@ -650,3 +650,34 @@ ReportEditor 采用 `useRef` 作为自动保存的数据快照机制(避免 Re
**D. 后续如何避免问题**
- 在复杂 React 组件(尤其是与 contentEditable 共存)中使用 Checkbox 时,**优先使用 `<label>` 直接包裹 `<input>`** 的写法,避免依赖 `id`/`htmlFor`。
- 向大模型发送局部修改请求时,**必须同时提供全局上下文**,否则 AI 无法基于文档其他部分的信息进行推理和修改。
---
## 记录 30AI「只聊天不干活」——System Prompt 过度依赖目标区域 + 缺少降级插入
**A. 具体问题**
用户在 report-editor 中输入「请随机填充文本内容」AI 聊天面板有输出,但编辑器中的 AI 可编辑区域没有任何更新。
**B. 产生问题原因**
1. **System Prompt 条件过于严苛**`systemPrompt` 的构建条件是 `aiModifyEnabled && targetRegionEl`。由于 `aiTargetRegion` 默认值为 `'none'`,如果用户未在下拉框中明确选中区域,`targetRegionEl` 为 `null`systemPrompt 降级为纯聊天模式,大模型根本不会返回 `updatedHtml` 字段。
2. **接收逻辑缺少降级**`responseJson.updatedHtml` 的接收条件是 `aiModifyEnabled && targetRegionEl`,同样因为 `targetRegionEl` 为 `null` 而被跳过。即使大模型返回了 HTML也会被丢弃。
3. **缺少光标插入降级**:参考代码 `injectAIText` 中,当找不到目标区域时,会调用 `execCmd('insertHTML', htmlContent)` 将内容直接插入当前光标位置。当前代码完全没有这种降级机制。
**C. 解决问题方案**
1. **解绑 System Prompt**:将条件从 `aiModifyEnabled && targetRegionEl` 改为 `aiModifyEnabled`,让大模型在「允许修改正文」开启时始终返回 `updatedHtml`。
2. **增加降级插入逻辑**
```ts
if (responseJson.updatedHtml && aiModifyEnabled) {
if (targetRegionEl) {
setDiffModal({...}); // 原有流程:目标区域存在时走 diff 弹窗
} else {
execCmd('insertHTML', responseJson.updatedHtml); // 降级:插入光标位置
}
}
```
3. 复用当前代码已存在的 `execCmd` 辅助函数,自动处理 focus、contentRef 更新和草稿保存。
**D. 后续如何避免问题**
- 设计「修改/生成」类 AI 功能时,**systemPrompt 的条件应尽量只依赖用户意图开关**(如 `aiModifyEnabled`),而非依赖具体 UI 状态如某个下拉框是否选中。UI 状态应只影响「如何注入结果」,不应影响「是否要求模型生成结果」。
- 任何「目标区域注入」逻辑都必须配备**降级方案**(如光标处插入),防止因用户未选中区域而导致功能完全失效。