release: v2.2.6 [2026-06-13 01:02:05]

### 新功能
- **翰林院向量化质量升级**:
  - **边界感知切块**:替换四个来源(聊天记录/小说/世界书/手动)的纯字符硬切——优先在段落边界断开,其次句末标点(含中文引号闭合),极端长串才硬切;句子/对话不再被拦腰截断,embedding 质量同步受益。仅影响新录入,已有向量无需重建
  - **注入时序重排**:检索结果注入提示词前按时序重排(聊天记录按楼层、小说按卷/章/节——中文数字章节号可解析),rerank 只决定"选哪些块",不再决定呈现顺序;修复"不打不相识的剧情之后紧跟关系亲密"这类因按相关度排序导致的认知时间错乱
  - **断层提示**:聊天记录相邻块楼层跳跃时自动插入"与上文相隔约 N 楼,并非连续发生"提示行,消除中间剧情缺失造成的割裂感
  - **时间标识**:新录入的聊天记录块在来源标识中带上消息发送时间(ST 向量存储不持久化元数据,时间必须写入块文本才能在检索后取回;旧格式块兼容解析)
- **记忆块工作流(memory-blocks)**:剧情优化新增"自定义记忆块"体系——占位符驱动的并发工作流框架
  - 在剧情优化面板「匹配替换 (sulv)」下方可增删自定义块:每个块定义一个占位符,执行剧情优化时主/拦截提示词中的占位符会被块的产出替换
  - **静态块**:直接输出固定内容;**AI 调用块**:用所选 API 功能槽独立请求一次,把回复(或其中指定 `<标签>` 的内容)作为替换值
  - 原有 sulv1-4 速率占位符迁入同一框架,行为与旧版逐字节一致
  - 块定义为纯 JSON、随设置持久化,为后续导入导出与战斗系统接入预留扩展点
  - 框架层新增**顺序拼接式 Chain**(`composeChain`):与占位符替换并列的第二种组合范式——同链的块并发执行后按 `order` 排序、以 `separator` 拼接并可选 `header/footer` 包裹,产出一个完整注入块;为记忆注入合成块与战斗系统"底部战报块"预留的承载结构,本版本暂无 UI 入口
- **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 未提供"报错升级**:当原因是"连接配置在本设备没有可用 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 判断
This commit is contained in:
Jenkins CI
2026-06-13 01:02:05 +08:00
parent 1a4a10d42d
commit 0d7e3b799e
35 changed files with 1981 additions and 1034 deletions

View File

@@ -14,6 +14,18 @@ import { createDrawer } from '../ui/drawer.js';
import { pluginAuthStatus } from "../utils/auth.js";
import { configManager } from '../utils/config/ConfigManager.js';
import { SENSITIVE_KEYS } from '../utils/config/sensitive-keys.js';
import { showHtmlModal } from './page-window.js';
import { escapeHTML } from '../utils/utils.js';
import { SLOTS } from '../utils/config/ApiProfileManager.js';
import {
listCustomBlocks,
getCustomBlock,
addCustomBlock,
updateCustomBlock,
deleteCustomBlock,
syncCustomBlocksFromSettings,
} from '../core/memory-blocks/index.js';
import { watchProfileSliderGuard } from './profile-slider-guard.js';
// ========== Prompt Cache (module-level state) ==========
@@ -625,6 +637,9 @@ function bindConcurrentApiEvents() {
if (!concurrentToggle || !concurrentContent) return;
// plotOptConc 槽分配 profile 后maxTokens 由 profile 权威控制T-006 informational 化)
watchProfileSliderGuard('plotOptConc', ['#amily2_plotOpt_concurrentMaxTokens']);
const settings = extension_settings[extensionName] || {};
// Initial Load
@@ -969,6 +984,180 @@ function opt_purgeGarbageKeys() {
}
}
// ========== 自定义记忆块memory-blocks Phase 2 ==========
// 该面板管理的块固定挂在剧情优化流水线;其他 context如战斗系统由各自模块注册
const MEMORY_BLOCK_CONTEXT = 'plotOptimization';
function opt_renderCustomBlocks(panel) {
const list = panel.find('#amily2_opt_custom_blocks_list');
if (list.length === 0) return;
const blocks = listCustomBlocks(MEMORY_BLOCK_CONTEXT);
if (blocks.length === 0) {
list.html('<div style="opacity: 0.6; font-style: italic; padding: 4px 0;">尚无自定义块。</div>');
return;
}
const rows = blocks.map(b => {
const typeBadge = b.generator?.type === 'ai_call'
? '<span style="font-size: 0.8em; padding: 1px 6px; border-radius: 3px; background: rgba(88,166,255,0.25);">AI 调用</span>'
: '<span style="font-size: 0.8em; padding: 1px 6px; border-radius: 3px; background: rgba(120,200,120,0.25);">静态</span>';
return `
<div class="amily2-custom-block-row" data-id="${escapeHTML(b.id)}" style="display: flex; align-items: center; gap: 8px; padding: 6px 8px; margin-bottom: 4px; background: rgba(0,0,0,0.15); border-radius: 4px;">
<input type="checkbox" class="mb-enabled" ${b.enabled !== false ? 'checked' : ''} title="启用/停用此块">
<span style="flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">
<b>${escapeHTML(b.name || '(未命名)')}</b>
<code style="margin-left: 6px;">${escapeHTML(b.placeholder)}</code>
</span>
${typeBadge}
<button class="menu_button mb-edit" title="编辑" style="padding: 2px 8px;"><i class="fa-solid fa-pen"></i></button>
<button class="menu_button mb-delete" title="删除" style="padding: 2px 8px;"><i class="fa-solid fa-trash-alt"></i></button>
</div>`;
});
list.html(rows.join(''));
}
function opt_showCustomBlockModal(panel, blockId) {
const existing = blockId ? getCustomBlock(blockId) : null;
const gen = existing?.generator || {};
const isAiCall = gen.type === 'ai_call';
// API 槽下拉:仅列出 chat 类型功能槽
const slotOptions = Object.entries(SLOTS)
.filter(([, def]) => def.type === 'chat')
.map(([key, def]) => `<option value="${key}" ${key === (gen.apiSlot || 'main') ? 'selected' : ''}>${escapeHTML(def.label)} (${key})</option>`)
.join('');
const formHtml = `
<div class="amily2-mb-form" style="display: flex; flex-direction: column; gap: 12px;">
<label>显示名称
<input id="mb_name" class="text_pole" type="text" value="${escapeHTML(existing?.name || '')}" placeholder="例如:战况摘要">
</label>
<label>占位符(在主/拦截提示词中按字面量匹配替换)
<input id="mb_placeholder" class="text_pole" type="text" value="${escapeHTML(existing?.placeholder || '')}" placeholder="例如:{{combat_state}} 或 myBlock1">
</label>
<label>生成方式
<select id="mb_type" class="text_pole">
<option value="static" ${!isAiCall ? 'selected' : ''}>静态内容</option>
<option value="ai_call" ${isAiCall ? 'selected' : ''}>AI 调用</option>
</select>
</label>
<div id="mb_static_fields" style="${isAiCall ? 'display: none;' : ''}">
<label>静态内容
<textarea id="mb_static_value" class="text_pole" rows="4">${escapeHTML(gen.value !== undefined ? String(gen.value) : '')}</textarea>
</label>
</div>
<div id="mb_ai_fields" style="display: ${isAiCall ? 'flex' : 'none'}; flex-direction: column; gap: 12px;">
<label>API 槽(使用该功能槽的连接配置独立请求一次)
<select id="mb_api_slot" class="text_pole">${slotOptions}</select>
</label>
<label>系统提示词(可选)
<textarea id="mb_system_prompt" class="text_pole" rows="3">${escapeHTML(gen.systemPrompt || '')}</textarea>
</label>
<label>用户提示词(必填)
<textarea id="mb_prompt_template" class="text_pole" rows="5">${escapeHTML(gen.promptTemplate || '')}</textarea>
</label>
<label>提取标签(可选,只取回复中 &lt;标签&gt;...&lt;/标签&gt; 的内容;标签缺失时回退完整回复)
<input id="mb_extract_tag" class="text_pole" type="text" value="${escapeHTML(gen.extractTag || '')}" placeholder="例如result">
</label>
</div>
</div>`;
showHtmlModal(existing ? '编辑记忆块' : '新增记忆块', formHtml, {
okText: '保存',
onShow: (dialog) => {
dialog.find('#mb_type').on('change', function () {
const aiMode = $(this).val() === 'ai_call';
dialog.find('#mb_static_fields').toggle(!aiMode);
dialog.find('#mb_ai_fields').css('display', aiMode ? 'flex' : 'none');
});
},
onOk: (dialog) => {
const placeholder = String(dialog.find('#mb_placeholder').val() || '').trim();
if (!placeholder) {
toastr.warning('占位符不能为空。');
return false;
}
const conflict = listCustomBlocks(MEMORY_BLOCK_CONTEXT)
.find(b => b.placeholder === placeholder && b.id !== blockId);
if (conflict) {
toastr.warning(`占位符 "${placeholder}" 已被块 "${conflict.name || conflict.id}" 占用。`);
return false;
}
const type = dialog.find('#mb_type').val();
let generator;
if (type === 'ai_call') {
const promptTemplate = String(dialog.find('#mb_prompt_template').val() || '');
if (!promptTemplate.trim()) {
toastr.warning('AI 调用块的用户提示词不能为空。');
return false;
}
generator = {
type: 'ai_call',
apiSlot: dialog.find('#mb_api_slot').val() || 'main',
promptTemplate,
};
const systemPrompt = String(dialog.find('#mb_system_prompt').val() || '');
if (systemPrompt.trim()) generator.systemPrompt = systemPrompt;
const extractTag = String(dialog.find('#mb_extract_tag').val() || '').trim();
if (extractTag) generator.extractTag = extractTag;
} else {
generator = { type: 'static', value: String(dialog.find('#mb_static_value').val() || '') };
}
const patch = {
name: String(dialog.find('#mb_name').val() || '').trim(),
placeholder,
context: MEMORY_BLOCK_CONTEXT,
generator,
};
try {
if (existing) {
updateCustomBlock(blockId, patch);
toastr.success('记忆块已更新。');
} else {
addCustomBlock(patch);
toastr.success('记忆块已创建。');
}
} catch (error) {
toastr.error(`保存失败: ${error.message}`);
return false;
}
opt_renderCustomBlocks(panel);
},
});
}
function bindCustomBlockEvents(panel) {
// settings → registry 重放一次,确保面板与执行器看到同一份块清单
syncCustomBlocksFromSettings();
opt_renderCustomBlocks(panel);
panel.on('click', '#amily2_opt_add_custom_block', () => opt_showCustomBlockModal(panel, null));
panel.on('click', '.amily2-custom-block-row .mb-edit', function () {
opt_showCustomBlockModal(panel, $(this).closest('[data-id]').attr('data-id'));
});
panel.on('click', '.amily2-custom-block-row .mb-delete', function () {
const row = $(this).closest('[data-id]');
const id = row.attr('data-id');
const block = getCustomBlock(id);
if (!confirm(`确定删除记忆块 "${block?.name || id}"`)) return;
deleteCustomBlock(id);
opt_renderCustomBlocks(panel);
toastr.success('记忆块已删除。');
});
panel.on('change', '.amily2-custom-block-row .mb-enabled', function () {
const id = $(this).closest('[data-id]').attr('data-id');
updateCustomBlock(id, { enabled: this.checked });
});
}
export function initializePlotOptimizationBindings() {
const panel = $('#amily2_plot_optimization_panel');
if (panel.length === 0 || panel.data('events-bound')) {
@@ -1079,6 +1268,7 @@ export function initializePlotOptimizationBindings() {
});
opt_loadSettings(panel);
bindCustomBlockEvents(panel);
bindJqyhApiEvents();
bindConcurrentApiEvents();
bindConcurrentPromptEvents();