# Changelog

本文档记录所有重要的版本变更。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

---

## [Unreleased]

### 计划中
- 更多 AI 服务支持
- 性能优化

---

## [0.4.7] - 2025-02-04

### 插件核心功能
- **修复**：插件拦截有几率失败导致插件无法启用的问题
- **新增**：主界面插件开关添加开启/关闭 toastr 通知提示

### 剧情优化助手
- **修复**：API 界面选择多个世界书导致无法单独选择条目的问题
- **修复**：剧情优化助手界面无法额外选择世界书的问题

### 发送前检查功能
- **修复**：未启用发送前检查功能导致插件无法正常生效的问题
- **改进**：默认显示流程配置按钮

### 汇总检查功能
- **新增**：添加编辑功能，方便对最终发送内容进行修改

### 多 AI 生成功能
- **新增**：预设提示词列表内容预览功能
- **修复**：单个提示词拖拽功能区域问题
- **修复**：提示词列表中聊天历史轮次设置显示问题

### 标签过滤功能
- **新增**：用户消息与 AI 消息独立标签过滤
- **修复**：前文内容来源未应用标签过滤配置的问题
  - `getRecentContext()` 现在正确使用 `filterContentByRole()` 处理新格式配置
  - `processor.js` 中最近剧情截取也已修复
  - `plot-optimize.js` 中剧情优化助手预览和面板的前文内容也已修复
- **改进**：在 `tag-filter.js` 添加调用位置汇总注释，方便后续维护

### 世界书控制
- **新增**：世界书条目多选支持
- **改进**：统计卡片可折叠，优化界面空间
- **改进**：选中状态持久化保存

### 配置管理
- **新增**：提示词/流程配置持久化缓存
  - 加载优先级：持久化缓存 → 服务器 → 回退到缓存
  - 解决网络不稳定时加载卡住或失败的问题
  - 支持离线使用已缓存的配置
- **改进**：恢复默认功能从服务器强制刷新获取最新内置配置
- **改进**：提示词编辑器切换类型时不再卡顿

### 技术细节
- `prompt-template.js`：使用 `BUILTIN_CACHE_PREFIX` 区分内置缓存和用户导入
- `flow-config.js`：使用 `FLOW_CONFIG_CACHE_KEY` 持久化默认流程配置
- `prompt-editor.js`：文件列表和内容加载均支持持久化优先
- `ui/panel.html`：添加作者栏区域注释，方便版本号定位

---

## [0.4.1] - 2025-01-21

### 重大变更
- **模块化重构**：将 18,000+ 行单文件拆分为模块化架构
- 使用 Webpack 打包，入口文件从 `index.js` 改为 `dist/index.js`
- 打包后体积从 729KB 减少到 123KB

### 新增
- 完整的模块化源代码目录 `src/`
- 模块参考手册 `docs/MODULE_REFERENCE.md`
- 路径别名支持（@core, @config, @ui 等）

### 改进
- 提示词编辑器：修复另存为后切换类型文件消失的问题
- 提示词编辑器：优化文件类型识别（优先使用文件名前缀）
- 移除 HEAD 请求探测（SillyTavern 不支持），改用 manifest.json
- 修复 CSRF Token 缺失问题

### 模块结构
```
src/
├── core/       # 核心模块（日志、常量、错误处理、ST API）
├── config/     # 配置管理（配置、默认值、世界书、提示词）
├── worldbook/  # 世界书处理（API、解析、刷新）
├── api/        # AI API 调用（适配器、各提供商）
├── memory/     # 记忆处理（处理器、合并、提示词构建）
├── hooks/      # 钩子拦截（发送按钮、拦截器）
├── ui/         # 用户界面（组件、弹窗、事件）
└── utils/      # 工具函数（消息、标签过滤、模板）
```

---

## [0.4.0] - 2025-01-20

### 重大变更
- 切换到官方 Generate Interceptor API，替代不稳定的发送按钮 Hook 机制
- 修复浏览器刷新后消息拦截失败的问题

### 新增
- 标准化数据持久化（使用 SillyTavern extensionSettings API）
- 自动从 localStorage 迁移旧数据
- 事件监听器清理机制，防止内存泄漏
- 自定义错误类型和统一错误处理

### 改进
- 移除约 200 行不稳定的发送按钮 Hook 代码
- 规范化 API 使用，添加详细注释说明
- 简化初始化流程
- 配置默认值递归合并，支持版本升级时自动补充新字段
- 插件开关移至主界面顶部，改为开关按钮样式
- AI 配置和配置管理改为折叠卡片样式
- 优化日志输出：Logger.warn 受 showLogs 控制

### 修复
- 修复刷新后拦截器失效问题
- 修复数据持久化不一致问题
- 修复各折叠容器间距不一致问题
- 修复总结世界书内容读取问题
- 兼容 SillyTavern 的 disable 字段
- 修复总结世界书分类识别问题

### 安全
- 修复 XSS 漏洞（使用 DOMPurify 清理 HTML）
- 修复 CSRF 令牌问题
- 清理死代码和注释代码块

### 文档
- 创建独立的 README.md 项目概览
- 创建 CHANGELOG.md 版本历史
- 完善 manifest.json 元数据
- 重组文档目录结构

---

## 版本说明

v0.4.0 之前的版本为早期开发阶段，未维护详细更新日志。
从 v0.4.0 开始，所有变更将严格记录在此文档中。

### 早期版本概要

**v0.3.0**
- 插件开关移至主界面顶部
- 优化日志输出
- UI 样式改进

**v0.2.x**
- 配置存储改��使用 SillyTavern 扩展设置 API
- 移除悬浮球，改为使用酒馆扩展菜单入口
- 新增世界书自动监听功能
- 发送消息前自动刷新世界书数据

**v0.1.x**
- 初始版本
- 基本的记忆检索和注入功能
- 进度条和任务管理
- 移动端适配

---

[Unreleased]: https://github.com/Cola-Echo/memory-manager-concurrent/compare/v0.4.0...HEAD
[0.4.0]: https://github.com/Cola-Echo/memory-manager-concurrent/releases/tag/v0.4.0