mirror of
https://github.com/Wx-2025/ST-Amily2-Chat-Optimisation.git
synced 2026-06-13 20:55:50 +00:00
2dad292d70
### 新功能
- **翰林院向量化质量升级**：
- **边界感知切块**：替换四个来源（聊天记录/小说/世界书/手动）的纯字符硬切——优先在段落边界断开，其次句末标点（含中文引号闭合），极端长串才硬切；句子/对话不再被拦腰截断，embedding 质量同步受益。仅影响新录入，已有向量无需重建
- **注入时序重排**：检索结果注入提示词前按时序重排（聊天记录按楼层、小说按卷/章/节——中文数字章节号可解析），rerank 只决定"选哪些块"，不再决定呈现顺序；修复"不打不相识的剧情之后紧跟关系亲密"这类因按相关度排序导致的认知时间错乱
- **断层提示**：聊天记录相邻块楼层跳跃时自动插入"与上文相隔约 N 楼，并非连续发生"提示行，消除中间剧情缺失造成的割裂感
- **时间标识**：新录入的聊天记录块在来源标识中带上消息发送时间（ST 向量存储不持久化元数据，时间必须写入块文本才能在检索后取回；旧格式块兼容解析）
- **记忆块工作流（memory-blocks）**：剧情优化新增"自定义记忆块"体系——占位符驱动的并发工作流框架
- 在剧情优化面板「匹配替换 (sulv)」下方可增删自定义块：每个块定义一个占位符，执行剧情优化时主/拦截提示词中的占位符会被块的产出替换
- **静态块**：直接输出固定内容；**AI 调用块**：用所选 API 功能槽独立请求一次，把回复（或其中指定 `<标签>` 的内容）作为替换值
- 原有 sulv1-4 速率占位符迁入同一框架，行为与旧版逐字节一致
- 块定义为纯 JSON、随设置持久化，为后续导入导出与战斗系统接入预留扩展点
- 框架层新增**顺序拼接式 Chain**（`composeChain`）：与占位符替换并列的第二种组合范式——同链的块并发执行后按 `order` 排序、以 `separator` 拼接并可选 `header/footer` 包裹，产出一个完整注入块；为记忆注入合成块与战斗系统"底部战报块"预留的承载结构，本版本暂无 UI 入口
- **渐进记忆（开发中功能，暂未对外开放）**：主菜单新增独立入口（点击提示"开发中，未来版本开放"），后续完善后放出。当前已落地的设计：
- 按"近期完整、远期摘要"的时间梯度，从指定表格（默认总结表，行序旧→新）采样历史并注入上下文：最新 X 行全量保留 + 其余历史对半拆分，较近一半等距取 Y 行、较远一半等距取 Z 行（中心对齐等距采样，不随机、不首尾加权，避免内容扎堆或事件结局被规律性忽略）
- 经 `setExtensionPrompt` 直接注入当回合上下文——内容独立、不写世界书、不随聊天/角色卡导出，生命周期天然跟随会话（区别于超级记忆的世界书条目路线）
- 注入位置 / 深度 / 角色 / 模板（含 `{{progressive_memory}}` 占位符）均可在面板配置；采样参数 X/Y/Z 默认 5/5/3，全部纯 JSON 持久化
- 采样器 `sampler.js` 为纯函数，参数结构与 memory-blocks 工作链对齐，后续可平移为 `progressive_sample` 节点
- **超级记忆 · 首行常驻**（表格专属配置新增开关，默认关闭）：表格第一行通常是总调/全局定义行（基调、主线目标等），原先与普通行一样走绿灯——没人提到主键就永远不注入；开启后该行详情条目升为蓝灯常驻，切换即时生效
- **API 连接配置**：
- 角色世界书（cwb）与一键生卡（autoCharCard）纳入旧配置自动迁移：老用户首次加载会把旧 URL / Key / 模型自动迁移为连接配置并分配槽位（一键生卡仅在规划者与执行者配置一致或规划者为空时迁移，避免悄悄改变行为）
- **profile 已分配时参数控件 informational 化**：主面板 / 并发剧情优化 / 角色世界书 / 术语表的温度、maxTokens 控件在槽位分配 profile 后自动禁用并显示"由连接配置控制"提示，消除"改了没效果"的用户陷阱
- **profile 状态卡新增"本设备无 Key"警示**：API Key 仅保存在最初填写它的设备/浏览器上（安全设计，不随云端设置同步），换设备后状态卡会直接亮出警示徽标，不必等到调用报错才发现
### 修复
- **独立聊天记忆从摆设变真功能**：此前向量数据"随卡不随聊天"——开启"独立聊天记忆"后录入仍存进角色库、查询却去查一个从未被写入过的聊天集合、计数恒为 0，整体静默失效。现已重构为聊天级分桶：
- 独立模式下，聊天记录类向量按当前聊天隔离存储与检索，同一张卡开多个聊天（不同剧情线）的记忆互不污染
- 小说 / 世界书 / 手动录入属于"知识"，仍随角色卡跨聊天共享；全局库不受影响
- 知识管理列表为聊天专属库显示"聊天级"徽标；聊天级库禁止移动到全局
- 统一模式（默认关闭独立记忆）的存量数据与行为完全不变
- 已知限制：聊天专属记忆跟随聊天文件，重命名聊天文件会使其失联（与 ST 官方向量扩展同等限制）
- **超级排序截断顺序修正**：开启"超级排序"时，时序重排发生在 top_n 截断之前，导致保留的是"时序最早"而非"最相关"的块，检索结果长期偏向最旧的聊天记录。现改为先按相关度截取 top_n、再做时序排序
- **翰林院向量化失败（"向量化块数量不识别"反馈）**：
- 一次性清洗 profile-sync 历史污染：`retrieval/rerank.apiKey` 中的掩码占位符在持久层根治（此前仅读取侧防御）；`apiEndpoint` / `rerank.apiMode` 的非法值（如被旧版写入的空字符串）归一化为 `custom`
- 修复 `apiEndpoint` 为空/非法时请求被硬定向到 `api.openai.com`、无视用户自定义 URL 的问题（CSP 拦截 / 401 的元凶）
- 修复**本地代理（LM Studio/Ollama）模式**自始就缺少 URL 分支、同样被错误定向到 openai.com 的问题
- API 模式下拉补全 `OpenAI 官方` / `Azure` 选项；默认 API 模式改为 `custom`（与默认 URL 配套），新用户不再因选项缺失导致首次保存写入空值
- profile-sync 给下拉框赋不存在选项值的污染源头修复（影响所有模块面板，不止翰林院）
- **Rerank "测试成功但实际请求报 API Key 未提供"（路径分叉根因）**：实际重排调用 `executeRerank(query, docs, settings.rerank)` 直接把 legacy 嵌套设置当连接传入，绕过了 `getRerankSettings()` 的 profile 解析；而「测试连接」传 `null` 会正常解析 profile——于是用 API Profile 配 rerank 的用户测试通过、实际生成时却拿到空 apiKey/stale url 报错。现实际调用点统一走 `getRerankSettings()`（profile 优先、legacy 兜底），与测试路径一致；`enabled / notify / hybrid_alpha` 等行为开关仍读 legacy 设置
- **Rerank "API Key 未提供"报错升级**：当原因是"连接配置在本设备没有可用 Key"时，报错会直接说明 Key 的设备本地性并指引到 API 连接配置重新填写（向量化 Google 直连、获取模型列表同步处理）
- **旧配置迁移**：一键生卡迁移时排除掩码占位符，避免把历史污染的假 Key 迁入新连接配置
- **超级记忆稳定性专项**（针对"工作不大稳定"反馈，4 处根因一次修复）：
- **切聊天竞态污染**：CHAT_CHANGED 时超级记忆立即全量同步，而表格系统延迟 100ms 才加载新聊天的表格，导致【旧聊天】的表格内容被写进【新角色】的记忆世界书；两边表名不同时旧表条目无 GC 兜底会**永久残留**（"记忆串台"元凶）。现 CHAT_CHANGED 只确保世界书存在，新状态同步交由 `loadTables()` 完成后的自动推送，单次且时序正确
- **死代码双轨存储拆除**：`saveStateToMetadata` / `tryRestoreStateFromMetadata` 把表格状态写到 `msg.metadata`——该字段非 ST 持久化位（同 v2.2.5 二次填表修过的坑），写入即蒸发、恢复永远为空，且每次同步还白调一次 `saveChat()`。整条链路删除，表格状态唯一信源为表格系统的 `msg.extra.amily2_tables_data`
- **`awaitSync()` 穿透**：同步队列正忙时 `pushUpdate` 会用一个立即 resolve 的空 Promise 覆盖 `_syncPromise`，Pipeline Stage 4 等待形同虚设、后续阶段在同步未完成时被放行。现忙时不覆盖，正在运行的 drain 循环自然吃掉新入队项
- **开关打开不生效**：启动时若总开关为关，初始化早退且不注册监听器；此后在 UI 勾选开关只写设置，超级记忆直到刷新页面前都是死的。现勾选即触发初始化（幂等）
- 附带：`forceSyncAll` 的表格角色推断改为复用 `events-schema.inferTableRole`，消除两处重复逻辑漂移风险；每次切聊天的双倍全量同步（restore 路径一次 + 显式一次）随死代码移除归一
### 重构
- 表格核心 `manager.js` 瘦身（约 1050 → 600 行）：19 个 UI 突变操作拆分至 `actions/ui-mutations.js`，SuperMemory 事件分发拆分至 `events-dispatch.js`；全部经 re-export 保持兼容，外部调用路径零改动
- 角色世界书最后 2 处散乱的厂商 URL 判断迁移至 `detectVendor` 统一入口，业务路径上不再有硬编码的 URL substring 判断
Amily2号聊天优化助手 (ST-Amily2-Chat-Optimisation)
欢迎使用 Amily2号聊天优化助手！这是一个为 SillyTavern (酒馆) 量身打造的综合性增强插件，旨在通过全方位的智能化功能，为您带来更连贯、更沉浸、更具深度的角色扮演体验。
本插件集成了多项创新功能，让您的 AI 角色不仅拥有“超强记忆”，还能随着剧情发展不断成长。
💡 推荐阅读：记忆管理系统使用教程
这是由繁华与可乐老师设计的进阶记忆方案，在记忆细节（如心动瞬间、誓言）上表现优异，强烈推荐阅读！
🌟 核心功能亮点
1. 📖 动态角色档案 (Character World Book)
告别千篇一律的角色卡！插件会在聊天过程中，自动感知角色的性格变化、经历过的重要事件以及当前状态，并实时更新到角色的档案中。
- 自动记录：无需手动编辑，AI 会自动为您维护角色的最新设定。
- 即时更新：角色的每一次成长和变化都会被记录下来，确保长期聊天的一致性。
- 数据驱动：为未来的复杂互动（如关系网分析）打下坚实基础。
2. 📊 智能表格系统 (Table System)
这是插件的数据基石，赋予 AI 像 RPG 游戏一样的状态追踪能力。
- 结构化管理：以表格形式精确记录物品栏、任务日志、当前时间、地点等关键信息。
- 自主更新：AI 能够理解剧情并自动对表格数据进行增删改查，无需人工干预。
- 多模式填表：支持“分步填表”和“批量填表”，利用独立 API 处理数据，准确高效且不污染主对话。
3. 🧠 超级记忆系统 (Super Memory)
基于表格系统的数据，让 AI 拥有过目不忘的能力。
- 万物皆可记：将表格中的物品、任务、线索等信息转化为世界书条目，被清晰地记录在案。
- 智能检索：AI 会在需要时自动回忆起相关信息，不再出现“吃书”或遗忘关键设定的情况。
- 时光倒流：支持在回退聊天时自动恢复记忆状态，确保记忆与剧情进度一致。
4. 🕸️ 人物关系图谱 (Relationship Graph)
不仅仅是文字，我们让 AI “看见”关系。
- 关系可视化：通过直观的图谱展示角色之间错综复杂的社交网络。
- 深度理解：帮助 AI 更好地理解人物之间的亲疏远近和爱恨情仇，做出更符合逻辑的互动。
- 图谱增强检索 (Graph RAG)：利用图谱结构增强 AI 的上下文理解能力。
5. ✍️ 文本与剧情优化
让每一次对话都如小说般精彩。
- 回复增强：智能分析并提升 AI 回复的文笔和逻辑，提供更高质量的阅读体验。
- 即时优化：在 AI 生成回复后，自动提取核心内容并进行润色。
6. 📚 翰林院 (RAG 知识库)
强大的检索增强生成系统，让 AI 能够利用海量的外部知识。
- 忆识宝库：将聊天记录、手动输入的文本或世界书条目转化为向量数据，存入“忆识宝库”。
- 精准检索：在聊天时自动检索宝库中最相关的内容，注入到提示词中，让角色“记起”相关信息。
- 忆识精炼 (Rerank)：对初步检索结果进行二次排序，选出最相关的几条，提高知识注入的精准度。
7. 📜 国史馆 (Historiographer)
负责长篇内容处理的超级模块。
- 自动总结：在后台默默记录剧情发展，生成精炼的摘要。
- 世界书精炼：自动整理和优化世界书条目，保持记忆库的整洁和高效。
8. 📝 密折司 (Prompt Inspector)
强大的提示词实时审查与编辑工具。
- 最后一道防线：在 AI 生成请求发送前的“最后一刻”拦截并审查提示词。
- 御笔亲批：允许用户直接修改最终发送给 AI 的提示词，确保一切尽在掌握。
9. 🌍 世界书编辑器 (World Editor)
功能强大的表格化世界书管理工具。
- 高效管理：提供类似 Excel 的界面，支持批量编辑、复制、删除等操作。
- 高级视图：支持按关键词搜索、排序和过滤，轻松管理庞大的设定集。
10. 📖 术语表与小说处理 (Glossary)
- 小说导入：支持上传小说文本，自动分块并生成剧情摘要和结构化数据。
- 世界书重组：智能合并和整理分散的世界书条目。
11. 🎨 沉浸式 UI 体验
- 动态面板：支持在聊天气泡中直接显示状态栏、日历等动态内容，增强游戏的代入感。
- 便捷操作：提供悬浮窗和快捷指令，让您随时随地掌控全局。
- 优化前文查看器：直观展示剧情优化前后的文本差异。
12. ⚙️ 预设设置 (Preset Settings)
- 可视化编辑：通过拖拽和点击，轻松定制各个功能模块的提示词链。
- 多场景适配：支持创建和切换不同的预设，适应不同的聊天场景和模型。
13. 🤖 自动角色卡生成器 (Auto Char Card)
类 CL 架构的智能代理，为您自动设计和优化角色卡。
- 单代理循环：采用先进的 Think-Act-Observe 循环，确保逻辑连贯，自我修正。
- 动态规则注入：支持自定义风格指南和世界观规则，AI 会像查阅资料一样遵守这些规范。
- 智能工具调用：AI 拥有全套工具，可以自主规划、执行并反思，为您打造独一无二的角色设定。
14. 🌐 在线互动
- 实时统计：可以看到当前有多少位同好正在一起使用本插件，感受社区的陪伴。
🚀 如何开始
安装本插件后，您可以在 SillyTavern 的扩展栏中找到 Amily2 的相关设置。插件的大部分功能在后台自动运行，您只需专注于享受与角色的互动即可。
祝您在 Amily2 的辅助下，谱写出更多动人的故事！
⚖️ 授权协议 (License)
本项目采用 CC BY-NC-ND 4.0 (署名-非商业性使用-禁止演绎) 协议授权。
简要说明：
- 允许：您可以免费下载、安装并使用本插件。
- 禁止二改：您可以出于学习目的修改代码，但严禁在任何平台分发修改后的版本（包括但不限于修改插件名、功能逻辑或 UI）。
- 禁止倒卖：本插件完全免费，严禁将其用于商业盈利行为或加入收费整合包中。
详细条款请参阅项目根目录下的 LICENSE 文件。