mirror of
https://github.com/Wx-2025/ST-Amily2-Chat-Optimisation.git
synced 2026-06-13 20:55:50 +00:00
### 新功能
- **翰林院向量化质量升级**:
- **边界感知切块**:替换四个来源(聊天记录/小说/世界书/手动)的纯字符硬切——优先在段落边界断开,其次句末标点(含中文引号闭合),极端长串才硬切;句子/对话不再被拦腰截断,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 判断
242 lines
10 KiB
JavaScript
242 lines
10 KiB
JavaScript
import { extensionName } from "../../utils/settings.js";
|
||
import { extension_settings } from "/scripts/extensions.js";
|
||
import { saveSettingsDebounced } from "/script.js";
|
||
import { initializeSuperMemory, purgeSuperMemory, forceSyncAll } from "./manager.js";
|
||
import { defaultSettings as ragDefaultSettings } from "../rag-settings.js";
|
||
import { getMemoryState } from "../table-system/manager.js";
|
||
|
||
const RAG_MODULE_NAME = 'hanlinyuan-rag-core';
|
||
|
||
function getRagSettings() {
|
||
if (!extension_settings[extensionName]) extension_settings[extensionName] = {};
|
||
const root = extension_settings[extensionName];
|
||
if (!root[RAG_MODULE_NAME]) {
|
||
root[RAG_MODULE_NAME] = structuredClone(ragDefaultSettings);
|
||
}
|
||
return root[RAG_MODULE_NAME];
|
||
}
|
||
|
||
export function bindSuperMemoryEvents() {
|
||
const panel = $('#amily2_super_memory_panel');
|
||
if (panel.length === 0) return;
|
||
|
||
panel.on('click', '.sm-nav-item', function() {
|
||
const tab = $(this).data('tab');
|
||
|
||
panel.find('.sm-nav-item').removeClass('active');
|
||
$(this).addClass('active');
|
||
|
||
panel.find('.sm-tab-pane').removeClass('active');
|
||
panel.find(`#sm-${tab}-tab`).addClass('active');
|
||
});
|
||
|
||
// 处理 Checkbox 变更
|
||
panel.on('change', 'input[type="checkbox"]', function() {
|
||
if ($(this).hasClass('sm-table-setting-check')) return; // Skip table settings checks here
|
||
|
||
if (!extension_settings[extensionName]) extension_settings[extensionName] = {};
|
||
|
||
const id = this.id;
|
||
|
||
// Super Memory 自身设置
|
||
if (id === 'sm-system-enabled') {
|
||
extension_settings[extensionName]['super_memory_enabled'] = this.checked;
|
||
saveSettingsDebounced();
|
||
// 【修复】启动时若开关为关,initializeSuperMemory 会早退且不注册监听器;
|
||
// 旧实现勾选后只写设置不初始化,导致开关"打开了但没反应"直到刷新页面。
|
||
// initializeSuperMemory 幂等(isInitialized 防重入),此处直接补初始化。
|
||
if (this.checked) {
|
||
initializeSuperMemory();
|
||
}
|
||
return;
|
||
}
|
||
if (id === 'sm-bridge-enabled') {
|
||
extension_settings[extensionName]['superMemory_bridgeEnabled'] = this.checked;
|
||
saveSettingsDebounced();
|
||
return;
|
||
}
|
||
|
||
// RAG 设置 (归档 & 关联图谱)
|
||
const ragSettings = getRagSettings();
|
||
|
||
if (id === 'sm-archive-enabled') {
|
||
if (!ragSettings.archive) ragSettings.archive = {};
|
||
ragSettings.archive.enabled = this.checked;
|
||
}
|
||
else if (id === 'sm-relationship-graph-enabled') {
|
||
if (!ragSettings.relationshipGraph) ragSettings.relationshipGraph = {};
|
||
ragSettings.relationshipGraph.enabled = this.checked;
|
||
}
|
||
|
||
saveSettingsDebounced();
|
||
console.log(`[Amily2-SuperMemory] Checkbox updated: ${id} = ${this.checked}`);
|
||
});
|
||
|
||
// 处理 Input 变更 (归档阈值等)
|
||
panel.on('change', 'input[type="number"], input[type="text"]', function() {
|
||
if (!extension_settings[extensionName]) extension_settings[extensionName] = {};
|
||
const id = this.id;
|
||
|
||
// SuperMemory 自身设置
|
||
if (id === 'sm-min-trigger-floor') {
|
||
extension_settings[extensionName]['superMemory_minTriggerFloor'] = Math.max(0, parseInt(this.value, 10) || 0);
|
||
saveSettingsDebounced();
|
||
console.log(`[Amily2-SuperMemory] Input updated: ${id} = ${this.value}`);
|
||
return;
|
||
}
|
||
|
||
// RAG 归档设置
|
||
const ragSettings = getRagSettings();
|
||
if (!ragSettings.archive) ragSettings.archive = {};
|
||
|
||
if (id === 'sm-archive-threshold') {
|
||
ragSettings.archive.threshold = parseInt(this.value, 10);
|
||
}
|
||
else if (id === 'sm-archive-batch-size') {
|
||
ragSettings.archive.batchSize = parseInt(this.value, 10);
|
||
}
|
||
else if (id === 'sm-archive-target-table') {
|
||
ragSettings.archive.targetTable = this.value;
|
||
}
|
||
|
||
saveSettingsDebounced();
|
||
console.log(`[Amily2-SuperMemory] Input updated: ${id} = ${this.value}`);
|
||
});
|
||
|
||
// 绑定刷新表格列表按钮
|
||
panel.on('click', '#sm-refresh-table-list', function() {
|
||
renderTableSettingsList();
|
||
});
|
||
|
||
// 绑定表格专属配置的 Checkbox
|
||
panel.on('change', '.sm-table-setting-check', function() {
|
||
if (!extension_settings[extensionName]) extension_settings[extensionName] = {};
|
||
if (!extension_settings[extensionName].superMemory_tableSettings) {
|
||
extension_settings[extensionName].superMemory_tableSettings = {};
|
||
}
|
||
|
||
const tableName = $(this).data('table');
|
||
const type = $(this).data('type'); // 'sync' | 'constant' | 'pinFirstRow'
|
||
const checked = this.checked;
|
||
|
||
if (!extension_settings[extensionName].superMemory_tableSettings[tableName]) {
|
||
extension_settings[extensionName].superMemory_tableSettings[tableName] = {};
|
||
}
|
||
|
||
extension_settings[extensionName].superMemory_tableSettings[tableName][type] = checked;
|
||
saveSettingsDebounced();
|
||
// 立即应用:首行常驻切换需要把该行详情条目在 蓝灯/绿灯 之间重写
|
||
forceSyncAll();
|
||
console.log(`[Amily2-SuperMemory] Table setting updated: ${tableName}.${type} = ${checked}`);
|
||
});
|
||
|
||
loadSuperMemorySettings();
|
||
|
||
console.log('[Amily2-SuperMemory] Events bound successfully.');
|
||
}
|
||
|
||
function renderTableSettingsList() {
|
||
const container = $('#sm-table-settings-list');
|
||
container.html('<div style="text-align: center; color: #888; padding: 20px;">正在加载...</div>');
|
||
|
||
const tables = getMemoryState();
|
||
if (!tables || tables.length === 0) {
|
||
container.html('<div style="text-align: center; color: #888; padding: 20px;">暂无表格数据。请先在聊天中使用表格功能。</div>');
|
||
return;
|
||
}
|
||
|
||
const settings = extension_settings[extensionName]?.superMemory_tableSettings || {};
|
||
|
||
let html = '';
|
||
tables.forEach(table => {
|
||
const tableName = table.name;
|
||
const tableConfig = settings[tableName] || {};
|
||
|
||
// Default values: Sync=True, Constant=True; PinFirstRow=False
|
||
const isSyncEnabled = tableConfig.sync !== false;
|
||
const isConstant = tableConfig.constant !== false;
|
||
const isPinFirstRow = tableConfig.pinFirstRow === true;
|
||
|
||
html += `
|
||
<div class="sm-control-block" style="border-bottom: 1px solid rgba(255,255,255,0.1); padding-bottom: 10px; margin-bottom: 10px;">
|
||
<div style="font-weight: bold; margin-bottom: 5px; color: #e0e0e0;">${tableName}</div>
|
||
<div style="display: flex; justify-content: space-between;">
|
||
<div style="display: flex; align-items: center;">
|
||
<label class="sm-toggle-switch" style="transform: scale(0.8); margin-right: 5px;">
|
||
<input type="checkbox" class="sm-table-setting-check" data-table="${tableName}" data-type="sync" ${isSyncEnabled ? 'checked' : ''}>
|
||
<span class="sm-slider"></span>
|
||
</label>
|
||
<span style="font-size: 0.9em; color: #ccc;">写入世界书</span>
|
||
</div>
|
||
<div style="display: flex; align-items: center;">
|
||
<label class="sm-toggle-switch" style="transform: scale(0.8); margin-right: 5px;">
|
||
<input type="checkbox" class="sm-table-setting-check" data-table="${tableName}" data-type="constant" ${isConstant ? 'checked' : ''}>
|
||
<span class="sm-slider"></span>
|
||
</label>
|
||
<span style="font-size: 0.9em; color: #ccc;">索引绿灯(常驻)</span>
|
||
</div>
|
||
</div>
|
||
<div style="display: flex; justify-content: flex-start; margin-top: 5px;">
|
||
<div style="display: flex; align-items: center;">
|
||
<label class="sm-toggle-switch" style="transform: scale(0.8); margin-right: 5px;">
|
||
<input type="checkbox" class="sm-table-setting-check" data-table="${tableName}" data-type="pinFirstRow" ${isPinFirstRow ? 'checked' : ''}>
|
||
<span class="sm-slider"></span>
|
||
</label>
|
||
<span style="font-size: 0.9em; color: #ccc;" title="第一行通常是总调/全局定义行,开启后升为常驻注入,不再依赖关键词触发">首行常驻</span>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
`;
|
||
});
|
||
|
||
container.html(html);
|
||
}
|
||
|
||
function loadSuperMemorySettings() {
|
||
const settings = extension_settings[extensionName] || {};
|
||
const ragSettings = getRagSettings();
|
||
|
||
// Super Memory 设置
|
||
$('#sm-system-enabled').prop('checked', settings.super_memory_enabled ?? false);
|
||
$('#sm-bridge-enabled').prop('checked', settings.superMemory_bridgeEnabled ?? false);
|
||
$('#sm-min-trigger-floor').val(settings.superMemory_minTriggerFloor ?? 0);
|
||
|
||
// 归档设置
|
||
if (ragSettings.archive) {
|
||
$('#sm-archive-enabled').prop('checked', ragSettings.archive.enabled ?? false);
|
||
$('#sm-archive-threshold').val(ragSettings.archive.threshold ?? 20);
|
||
$('#sm-archive-batch-size').val(ragSettings.archive.batchSize ?? 10);
|
||
$('#sm-archive-target-table').val(ragSettings.archive.targetTable ?? '总结表');
|
||
}
|
||
|
||
// 关联图谱设置
|
||
if (ragSettings.relationshipGraph) {
|
||
$('#sm-relationship-graph-enabled').prop('checked', ragSettings.relationshipGraph.enabled ?? false);
|
||
}
|
||
|
||
// 渲染表格列表
|
||
renderTableSettingsList();
|
||
}
|
||
|
||
window.sm_initializeSystem = async function() {
|
||
toastr.info('超级记忆系统正在初始化...');
|
||
$('#sm-system-status').text('初始化中...').css('color', 'yellow');
|
||
|
||
try {
|
||
await initializeSuperMemory();
|
||
toastr.success('超级记忆系统初始化完成。');
|
||
} catch (error) {
|
||
console.error(error);
|
||
toastr.error('初始化失败,请检查控制台。');
|
||
$('#sm-system-status').text('错误').css('color', 'red');
|
||
}
|
||
};
|
||
|
||
window.sm_purgeMemory = async function() {
|
||
if (confirm('您确定要清空所有由Amily2管理的超级记忆数据吗?\n这将删除世界书中所有以表格世界书的条目。')) {
|
||
toastr.info('正在清空记忆...');
|
||
await purgeSuperMemory();
|
||
$('#sm-system-status').text('已清空').css('color', '#ffc107');
|
||
}
|
||
};
|