koishi-plugin-chatluna-scene-rules 0.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 妖祀
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# koishi-plugin-chatluna-scene-rules
+
+> **ChatLuna livingmemory 记忆池别名器。** 让**同一个角色的多个预设**(私聊版 / 群聊版 / 语音版 / 旧版…)
+> **共享同一个 livingmemory 记忆池**。运行时接管 `chatluna_living_memory` 服务的 `createScope` / `resolvePresetId`,
+> 在 presetId 上套一层别名映射——**不改 chatluna-livingmemory 任何文件,插件停用即自动还原**。
+
+> ℹ️ 包名 / 配置块键沿用旧名 `chatluna-scene-rules`(早期是「场合判定」插件),与现在的「记忆池别名」功能名字
+> 不完全对应、但仅是个名字;`{scene_rules()}` 之类的旧用法已无关。
+
+完整的安装 / 配置 / 验证 / 排障(以「髭切」为例)见仓库的
+[**安装与使用指南**](https://github.com/ningningningning0420-ui/koishi-chatluna-plugins/blob/main/docs/记忆池别名器-安装与使用指南.md),这里只放速查。
+
+## 为什么需要它
+
+livingmemory 默认按 **presetId** 给每个预设单独开一个记忆池(角色预设的 presetId 形如 `名字（Character）`)。
+你若把一个角色拆成「私聊版」「群聊版」两份独立预设 → 两个不同 presetId → 两个互不相通的记忆池
+→ 私聊里聊过的事,群聊里它不记得。
+
+本插件把这些 presetId 都映射到**同一个共享池 key**,于是它们读写同一个池,记忆打通。
+
+## 依赖
+
+- `koishi` ^4.17
+- `chatluna`
+- `chatluna-character`(角色预设;非本插件 service 硬依赖,但角色场景需要)
+- **`chatluna-livingmemory`**(提供 `chatluna_living_memory` 服务,本插件的真正硬依赖)——
+  必须先装好并能正常记忆;它自身依赖的 embeddings/向量库是它的事,本插件不碰。
+
+## 三步启用
+
+1. 安装:在 Koishi 控制台的**插件市场**搜 `chatluna-scene-rules` 直接安装;或命令行
+   ```bash
+   npm i koishi-plugin-chatluna-scene-rules
+   ```
+   (从源码用:把本目录放到 koishi app 的 `external/` 下,再 `npm i ./external/koishi-plugin-chatluna-scene-rules`。)
+2. `koishi.yml` 启用,填别名映射(**键 = presetId,全角括号；值 = 共享池 key**):
+   ```yaml
+     chatluna-scene-rules:main:
+       debug: true                       # 首次开！日志里抄准确的 presetId
+       aliases:
+         髭切-本丸语音版（Character）: 髭切-通用版（Character）
+         髭切-私聊版（Character）: 髭切-通用版（Character）
+         髭切（Character）: 髭切-通用版（Character）
+   ```
+3. 触发一次对话,看日志确认映射命中,稳了把 `debug` 关掉。**改 aliases 后重启 koishi** 最稳。
+
+## 配置项
+
+| 配置 | 默认 | 说明 |
+|---|---|---|
+| `aliases` | `{}` | 别名字典。**键** = 预设 presetId(角色预设通常是 `预设名（Character）`,**全角括号**);**值** = 共享池 key。命中的预设读写同一个 livingmemory 池。 |
+| `debug` | `false` | 打印每次 presetId 解析 + 映射结果(`原样使用` 或 `→ 共享key`),首次配置务必开,用来抄准确键名。 |
+
+## 关键坑
+
+- **键名是全角括号 `（Character）`,不是半角 `(Character)`**;差一个字符就不命中。务必先开 `debug` 抄日志里的原样字符串。
+- **共享池 key 不要求真有一个同名预设存在**——它只是个字符串池名(常用一个退役/专设的「通用版」名字,池里就是合并后的记忆)。
+- 打通**之前**各预设旧池里的历史记忆不会自动迁移/合并;本插件只让此后的读写落到同一个池。
+
+## 回滚
+
+`koishi.yml` 把 `chatluna-scene-rules:` 改成 `~chatluna-scene-rules:`(禁用)→ 自动还原服务方法,各预设回到各自独立池。
+
+## 许可
+
+MIT

package/index.js

@@ -0,0 +1,65 @@
+const { Schema } = require('koishi')
+
+exports.name = 'chatluna-scene-rules'
+
+exports.inject = ['chatluna_living_memory']
+
+exports.Config = Schema.object({
+    aliases: Schema.dict(Schema.string())
+        .default({})
+        .description(
+            '记忆池别名映射：键 = 预设的 presetId（通常为「预设名（Character）」），值 = 共享池 key。命中映射的预设读写同一个 livingmemory 记忆池，实现多预设（如私聊版/群聊版）共享记忆'
+        ),
+    debug: Schema.boolean()
+        .default(false)
+        .description('打印每次 presetId 解析与映射结果（首次配置时用它核对键名拼写）')
+})
+
+// 记忆池别名器：运行时接管 livingmemory 服务的 createScope（主 hook，
+// 召回/入库/快照/注入都经它构造记忆作用域）与 resolvePresetId（兜底旧路径），
+// 在 presetId 上套一层别名映射。不修改 livingmemory 任何文件，
+// 插件停用时自动还原原方法。
+exports.apply = (ctx, config) => {
+    const logger = ctx.logger('chatluna-scene-rules')
+    const svc = ctx.chatluna_living_memory
+    const mapId = (id) => {
+        if (id == null) return id
+        const mapped = config.aliases[id]
+        if (config.debug) {
+            logger.info(
+                `presetId ${id}${mapped ? ` → ${mapped}` : '（未映射，原样使用）'}`
+            )
+        }
+        return mapped ?? id
+    }
+    // 接管前先确认方法存在：不同 chatluna-livingmemory 版本若改了方法名/签名，
+    // 这里 warn-and-skip 而不是直接 throw 崩掉插件加载。停用时只还原接管过的方法。
+    const restorers = []
+
+    // 总闸：所有记忆 scope（召回/入库/快照/注入）都经 createScope 构造，
+    // 在这里对 presetId 套别名。character 路径不走 resolvePresetId，
+    // 而是直接拼 `${presetName}（Character）` 后调 createScope。
+    if (typeof svc.createScope === 'function') {
+        const origScope = svc.createScope.bind(svc)
+        svc.createScope = (conversationId, presetId, userId, channelId, options = {}) => {
+            return origScope(conversationId, mapId(presetId), userId, channelId, options)
+        }
+        restorers.push(() => { svc.createScope = origScope })
+    } else {
+        logger.warn('chatluna_living_memory.createScope 不存在（livingmemory 版本不兼容？），记忆池别名未生效')
+    }
+
+    // 兜底：部分旧路径仍经 resolvePresetId（其结果随后也会进 createScope；
+    // 已映射的值不在别名键里，不会发生二次映射）。
+    if (typeof svc.resolvePresetId === 'function') {
+        const origResolve = svc.resolvePresetId.bind(svc)
+        svc.resolvePresetId = (message, fallbackPresetId) => {
+            return mapId(origResolve(message, fallbackPresetId))
+        }
+        restorers.push(() => { svc.resolvePresetId = origResolve })
+    }
+
+    ctx.effect(() => () => {
+        for (const restore of restorers) restore()
+    })
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "koishi-plugin-chatluna-scene-rules",
+  "version": "0.5.1",
+  "description": "ChatLuna livingmemory 记忆池别名器:把同一角色多个预设(私聊版/群聊版/语音版)的 presetId 映射到同一个共享记忆池,实现多预设共享 livingmemory 记忆;运行时接管服务方法,不改 chatluna-livingmemory 任何文件",
+  "main": "index.js",
+  "license": "MIT",
+  "author": "妖祀",
+  "homepage": "https://github.com/ningningningning0420-ui/koishi-chatluna-plugins/tree/main/packages/koishi-plugin-chatluna-scene-rules#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ningningningning0420-ui/koishi-chatluna-plugins.git",
+    "directory": "packages/koishi-plugin-chatluna-scene-rules"
+  },
+  "bugs": {
+    "url": "https://github.com/ningningningning0420-ui/koishi-chatluna-plugins/issues"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "koishi",
+    "plugin",
+    "chatluna",
+    "chatluna-livingmemory",
+    "livingmemory",
+    "memory",
+    "alias",
+    "chatbot"
+  ],
+  "peerDependencies": {
+    "koishi": "^4.17.0",
+    "koishi-plugin-chatluna": "*",
+    "koishi-plugin-chatluna-livingmemory": "*"
+  },
+  "koishi": {
+    "description": {
+      "zh": "livingmemory 记忆池别名器：把同一角色的多个预设（如私聊版/群聊版/语音版）的 presetId 映射到同一个共享记忆池 key，让它们共享 livingmemory 记忆。运行时接管服务方法，不改 chatluna-livingmemory 任何文件，停用即还原。",
+      "en": "LivingMemory pool aliaser for ChatLuna: map several presets of one character (e.g. private/group/voice variants) onto a single shared memory-pool key so they share livingmemory. Wraps the service methods at runtime; touches no chatluna-livingmemory file and restores on unload."
+    },
+    "service": {
+      "required": [
+        "chatluna_living_memory"
+      ]
+    }
+  }
+}