dsh-foxy-memory

dsh-foxy-memory 是 dsh-foxy 的可选记忆子插件。它把 Foxy 会话写成本地 JSONL，并在下一轮把最近记忆注入 Foxy 的 persona。

它本身不依赖 ChatLuna/LivingMemory；只装 dsh-foxy + dsh-foxy-memory 就能得到能记住对话的 Foxy。

依赖关系

• 必需：dsh-foxy（提供 foxyMemory 扩展契约）。
• 可选：koishi-plugin-chatluna-foxy-memory（QQ 侧/跨平台记忆中枢）。在 provider 设置为 livingmemory 并把 bridgeUrl 指向其 /foxy-memory 时启用；旧的 koishi-plugin-foxy-memory-bridge 不再需要。
• 平台子插件 dsh-foxy-bili / dsh-foxy-weibo 会把事件写入本插件暴露的 foxyMemory provider。

记录格式

默认文件：

%USERPROFILE%\.dsh\foxy\memory\entries.jsonl

每条记录：

{
  "id": "uuid",
  "presetId": "foxy3",
  "sessionId": "session-id",
  "platform": "dsh",
  "sourceLabel": "DSH",
  "speaker": "kunfox",
  "role": "user",
  "type": "conversation",
  "status": "active",
  "content": "今天在 DSH 做了……",
  "keywords": [],
  "summary": "",
  "importance": 0.5,
  "createdAt": 1790000000000,
  "updatedAt": 1790000000000
}

注入时会格式化成：

- [2026-11-06 20:00] [DSH] kunfox: 今天在 DSH 做了……
- [2026-11-06 20:00] [DSH] Foxy: 记住啦。

platform 统一小写（dsh），显示时用 sourceLabel（如 DSH）；presetId 允许 Foxy 主预设和 Character 预设分开存档。

配置

字段	默认	说明
dataDir	$DSH_HOME/foxy/memory	数据目录
entriesFile	entries.jsonl	文件名
maxEntries	5000	超过后丢弃最旧记录
maxContentChars	4000	单条内容截断
maxContextEntries	20	最多注入条数
maxContextChars	6000	注入内容总字符上限
userLabel	kunfox	用户显示名
assistantLabel	Foxy	助手显示名
provider	livingmemory（配置 bridgeUrl 时）/ local	记忆写到哪个 provider
bridgeUrl	空	Koishi 桥地址，如 http://127.0.0.1:5140/foxy-memory
bridgeToken	空	与桥的 token 一致；公网部署必须设置
bridgePresetId	foxy3（Character）	写入 LivingMemory 的 preset
bridgeTimeoutMs	15000	桥请求超时
batchSize	8	累积多少条消息后调用 /ingest
flushIntervalMs	30000	未满一批时的定时冲刷间隔
extractModel	deepseek/deepseek-flash	桥提取记忆使用的模型

DSH 侧不再逐条写记忆：record 只把消息放进 pending，满 batchSize 或到 flushIntervalMs 时调用桥的 /ingest，由模型提炼成中文第一人称记忆。stats() 会显示 pending。

Foxy 面板的「记忆桥设置」可以修改这些值，保存到 $DSH_HOME/foxy/settings.json；插件启动时读取，保存后尝试热重载。/api/dsh-foxy/settings 在 DSH host 内提供。

服务

加载后提供：

ctx.foxyMemory.record({ role, text, presetId, sessionId, platform, speaker })
ctx.foxyMemory.context({ presetId, limit })
ctx.foxyMemory.list({ presetId, status, limit })
ctx.foxyMemory.search(query, { presetId })
ctx.foxyMemory.archive(id)
ctx.foxyMemory.stats()

同时通过 ctx.foxy.registerMemoryProvider('local', ...) 和（配置了桥时）registerMemoryProvider('livingmemory', ...) 注册到 Foxy 的 provider 注册表。

与 LivingMemory 的关系

本地 JSONL 是默认实现，不是 chatluna-livingmemory 的替代品，也不直接写它的 koishi.db/PGlite 索引。

如果要把 DSH 记忆写回 QQ 侧的 foxy3（Character） 池，安装并配置 koishi-plugin-foxy-memory-bridge：

# DSH 侧 dsh-foxy-memory 配置
provider: livingmemory
bridgeUrl: http://127.0.0.1:5140/foxy-memory
bridgeToken: 与桥一致的随机串
bridgePresetId: foxy3（Character）

DSH 侧只向桥发送 record/context 请求；桥内调用：

ctx.chatluna_living_memory.createMemory(scope, input, speakerKeys)

不要直接 INSERT SQLite，否则会绕过 speaker key、profile 和向量索引。桥不可用时会自动回退本地 JSONL，不会丢消息。

安装

dsh plugin --profile desktop add "file:D:\path\to\dsh-foxy-memory"

需要同时安装 dsh-foxy；重启 DSH 后，Foxy 会话会使用当前 provider。默认是本地 JSONL；配置 bridgeUrl 后默认切到 LivingMemory 桥（也可显式 provider: local 保持本地）。

License

MIT