mirror of
https://github.com/Wx-2025/ST-Amily2-Chat-Optimisation.git
synced 2026-06-13 02:15:51 +00:00
0d7e3b799e
### 新功能 - **翰林院向量化质量升级**： - **边界感知切块**：替换四个来源（聊天记录/小说/世界书/手动）的纯字符硬切——优先在段落边界断开，其次句末标点（含中文引号闭合），极端长串才硬切；句子/对话不再被拦腰截断，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 判断
190 lines
8.6 KiB
Markdown
190 lines
8.6 KiB
Markdown
# TODOList — 待办任务总览
|
||
|
||
> 用于派工与进度跟踪。任务卡格式统一，可拆分给不同执行者（人 / Claude / GPT / 其他模型）。
|
||
>
|
||
> 关联文档：
|
||
> - [51TODO.md](51TODO.md) — 跨方向重构计划（Bus tool-call 升级 / 跨议题决策点）
|
||
> - [TableTODO.md](TableTODO.md) — 表格模块 IAD 深度重构计划（Phase 0/B/C）
|
||
> - [TODO.md](TODO.md) — 旧版本变更日志（保留作为发布记录）
|
||
>
|
||
> 最后更新：2026-06-11，对应 v2.2.5+（2603 分支）。
|
||
|
||
---
|
||
|
||
## 一、最近落地（v2.2.0 → 当前）
|
||
|
||
> 上下文摘要，让接手者了解当前状态。代码细节看对应 commit。
|
||
|
||
| commit | 内容 | 涉及范围 |
|
||
|--------|------|--------|
|
||
| `d283ff4` | 表格模块 IAD 解耦 + API 自定义参数 + 厂商预设连接 | `core/table-system/*` dto/infra/actions；`assets/api-vendor-params.json`；UI |
|
||
| `671c1b2` | profile 优先级修正：profile 分配后即权威 | `core/api.js` 6 处 `getApiSettings` |
|
||
| `8b4b6b0` | 二级填表死锁修复 + 强制中断按钮（AbortController 贯穿） | `secondary-filler.js` |
|
||
| `dc57a1d` | memory-blocks Phase 1：占位符工作流抽象层，sulv1-4 迁入 | `core/memory-blocks/*`；`summarizer.js` |
|
||
| `91ceecc` | memory-blocks Phase 2：ai_call handler + 自定义块 UI 与持久化 | `core/memory-blocks/*`；剧情优化面板 |
|
||
| `6ad1354` | T-002：cwb / autoCharCard 纳入 legacy 自动迁移（迁移版本化 v2） | `ApiProfileManager.js` |
|
||
| `784bd70` | T-006：profile 已分配时参数控件 informational 化 | `ui/profile-slider-guard.js` + 4 面板 |
|
||
| `ef45e74` | T-007 / Phase 0.4：manager.js 抽出 ui-mutations + events-dispatch | `core/table-system/*` |
|
||
|
||
**核心架构现状**（接手必读）：
|
||
|
||
- **状态权威**：`utils/config/ApiProfileManager.js` 是 API 配置单一指挥所；profile 分配后即权威，旧字段不再覆盖 profile；legacy 迁移已版本化（`_legacyProfileMigrationVersion`，当前 v2 覆盖 8 个 chat slot）
|
||
- **表格模块**：核心在 [core/table-system/](core/table-system/)，IAD 拆分（dto/infra/actions/rendering.js/templates.js/preset.js/events-dispatch.js）；manager.js 已收缩至 ~600 行编排层，19 个 UI 突变在 [actions/ui-mutations.js](core/table-system/actions/ui-mutations.js)（manager re-export 兼容）
|
||
- **memory-blocks**：[core/memory-blocks/](core/memory-blocks/) 占位符驱动工作流，static + ai_call 两种 handler，自定义块 UI 在剧情优化面板；Phase 3（JSON 导入导出 / 战斗系统 plugin handler）未做
|
||
- **API 厂商识别**：[utils/api-vendor.js](utils/api-vendor.js) detectVendor 为单一入口，业务路径散乱 includes 已清零
|
||
- **VS Code 类型校验**：[jsconfig.json](jsconfig.json) checkJs 开启，[types/sillytavern.d.ts](types/sillytavern.d.ts) 提供全局声明
|
||
|
||
---
|
||
|
||
## 二、已完成任务（2026-06-11 核对）
|
||
|
||
| ID | 内容 | 状态 |
|
||
|----|------|------|
|
||
| T-001 | 死代码清理 | ✅ 3 处死绑定已删。**例外**：`core/fractal-memory.js` 刻意保留——非本人设计，原作者未弃坑，留作坑位，勿删 |
|
||
| T-002 | cwb / autoCharCard legacy 自动迁移 | ✅ `6ad1354`。cwb 实际字段为 snake_case（`cwb_api_url`）；autoCharCard 双角色嵌套对象，仅 planner 空/同 executor 时自动迁 |
|
||
| T-003 | NCCS 等支路透传 customParams | ✅ Nccs / Ngms / Jqyh / Sybd 四个 API 文件均已接入 |
|
||
| T-004 | hint panel 点击参数名插入 | ✅ `.amily2_param_hint_btn` + `_insertParamToCustomParams` |
|
||
| T-005 | 散乱 vendor URL 检查迁 detectVendor | ✅ `f7781c2` 收尾。保留项：`_detectVendorFromUrlSync`（迁移 IIFE 自包含）、RequestBody.js 兜底（即目标模式） |
|
||
| T-006 | profile 已分配时 slider informational | ✅ `784bd70`。范围：参数滑条（main / plotOptConc / cwb / sybd 四面板）；URL/Key/模型输入框见 T-012 |
|
||
| T-007 | manager.js 抽出 ui-mutations.js | ✅ `ef45e74`。含 events-dispatch.js 抽出；manager↔ui-mutations 运行时环留待 0.8 解 |
|
||
|
||
---
|
||
|
||
## 三、待办任务
|
||
|
||
### 🟡 中等任务
|
||
|
||
#### T-009: 表格 Phase B — JSON formatter
|
||
|
||
- **类型**：feature
|
||
- **难度**：🟡 中等
|
||
- **建议执行者**：GPT 或 Claude
|
||
- **依赖**：无（不依赖 Bus 升级）
|
||
|
||
**详见**：[TableTODO.md#五-phase-b-json-formatter](TableTODO.md)
|
||
|
||
**核心交付**：
|
||
- `core/table-system/formatters/json.js`：教 LLM 输出 `{"operations":[...]}`，解析为 Op[]
|
||
- 设置项 `table_filling_format: 'legacy'|'json'|'toolcall'`，默认 `legacy`
|
||
- UI 加 dropdown 切换
|
||
- fillerShared 调用统一 formatter dispatcher
|
||
|
||
**预估**：0.5 天
|
||
|
||
---
|
||
|
||
#### T-012: URL / Key / 模型输入框的 profile 压制提示（T-006 续）
|
||
|
||
- **类型**：feature / UX
|
||
- **难度**：🟡 中等
|
||
- **建议执行者**：GPT 或 Claude
|
||
- **依赖**：无（复用 [ui/profile-slider-guard.js](ui/profile-slider-guard.js)）
|
||
|
||
**背景**：T-006 只覆盖了参数滑条。各模块面板的 API URL / Key / 模型输入框在 profile 分配后同样失效，且涉及「测试连接 / 拉取模型」按钮的联动判断（这些按钮读的是 profile 还是 DOM 因模块而异），需逐面板核对后接入 `watchProfileSliderGuard`。
|
||
|
||
**验收**：
|
||
- [ ] profile 分配后各面板 URL/Key/模型输入框 disable + 提示
|
||
- [ ] 测试连接按钮行为与提示一致（测的是 profile 配置就保持可用）
|
||
|
||
---
|
||
|
||
#### T-013: 剧情优化面板 top_p / presence / frequency 输入为死配置
|
||
|
||
- **类型**：bug / cleanup
|
||
- **难度**：🟡 中等（需决策）
|
||
- **建议执行者**：Human 决策 + 任意执行
|
||
- **依赖**：无
|
||
|
||
**背景**：`plotOpt_top_p` / `plotOpt_presence_penalty` / `plotOpt_frequency_penalty` 只有 UI 在读写（[plot-opt-bindings.js](ui/plot-opt-bindings.js)），core 请求路径无人消费——用户改了完全没效果。二选一：
|
||
1. 接上：在 plotOpt 请求体里带上这三个参数（profile 的 customParams 机制已能覆盖此需求，可能多余）
|
||
2. 删掉：移除 UI 控件 + 默认值 +（已在 clearLegacyConfig 列表中）
|
||
|
||
---
|
||
|
||
### 🔴 高耦合 / 架构任务
|
||
|
||
#### T-008: Bus tool-call 能力升级
|
||
|
||
- **类型**：feature / 架构
|
||
- **难度**：🔴 高
|
||
- **建议执行者**：Claude（涉及 Bus 架构判断）
|
||
- **依赖**：无（独立于表格重构）
|
||
|
||
**详见**：[51TODO.md#二-phase-a-bus-tool-call-升级](51TODO.md)
|
||
|
||
**核心交付**：
|
||
- `SL/bus/tool/ToolRegistry.js` 私有工具注册表
|
||
- `register(pluginName)` 返回的 context 加 `tool` 能力
|
||
- `Options.js` / `RequestBody.js` 支持 `tools` / `toolChoice` 字段
|
||
- `context.model.callWithTools(messages, options, { maxSteps, onToolError })` agent loop
|
||
|
||
**预估**：1.5 天
|
||
|
||
---
|
||
|
||
#### T-010: 表格 Phase C — ToolCall formatter
|
||
|
||
- **类型**：feature
|
||
- **难度**：🟡 中等
|
||
- **建议执行者**：Claude
|
||
- **依赖**：T-008 完成 + T-009 完成
|
||
|
||
**详见**：[TableTODO.md#六-phase-c-toolcall-formatter](TableTODO.md)
|
||
|
||
---
|
||
|
||
#### T-011: 表格 Phase 0.7-0.9 收尾
|
||
|
||
- **类型**：refactor
|
||
- **难度**：🔴 高（filler 三方差异需小心对齐 / 解循环依赖 / Service 重写）
|
||
- **建议执行者**：Claude
|
||
- **依赖**：T-007 已完成 ✅，可随时开工
|
||
|
||
**详见**：[TableTODO.md#四-phase-0](TableTODO.md) 0.7-0.9
|
||
|
||
- 0.7: `core/table-system/filler/shared.js` —— 三个 filler 重复代码消除
|
||
- 0.8: 解循环依赖（manager ↔ secondary-filler；新增的 manager ↔ ui-mutations 一并处理）
|
||
- 0.9: TableSystemService 真正变成门面
|
||
|
||
**预估**：1 天
|
||
|
||
---
|
||
|
||
#### T-014: memory-blocks Phase 3
|
||
|
||
- **类型**：feature
|
||
- **难度**：🟡 中等
|
||
- **建议执行者**：Claude
|
||
- **依赖**：Phase 2 已完成 ✅（`91ceecc`）
|
||
|
||
**核心交付**：
|
||
- 自定义块 JSON 导入导出（`replaceContextBlocks` 已就位）
|
||
- 战斗系统通过 `plugin` handler 接入（types.js 契约已预留）
|
||
- summarizer 链路补 AbortController，让 ai_call 块可中断（handler 的 signal 透传已就位）
|
||
|
||
---
|
||
|
||
## 四、派工建议
|
||
|
||
### GPT 或 Claude 都可以
|
||
|
||
- T-009 JSON formatter
|
||
- T-012 URL/Key informational（机械，照 T-006 模式）
|
||
|
||
### 建议留给 Claude 或人
|
||
|
||
- T-008 Bus tool-call 升级（架构核心）
|
||
- T-010 ToolCall formatter（依赖前置）
|
||
- T-011 表格 Phase 0 收尾（filler dedup 风险高）
|
||
- T-013 死配置决策（需 Human 拍板接上还是删掉）
|
||
- T-014 memory-blocks Phase 3
|
||
|
||
---
|
||
|
||
## 五、未列入但可能的小项
|
||
|
||
- 自动迁移完成后给所有 chat 类型 slot 加默认 link 选项（不只 tableFilling）
|
||
- profile 分配 UI 加"复用现有 profile"快捷按钮（避免用户为每个 slot 重复创建相同配置）
|
||
- 51TODO.md 第三节决策点中"是否合并发版"等问题做最终决定记录
|
||
- TODO.md（旧版本变更日志）的 v2.2.x 版本条目补全
|