# 分会话弹幕库

[English](./session-pools.md) | [中文](./session-pools.zh-CN.md)


弹幕如何按会话记忆、衰减回放、归档、恢复与编辑——让弹幕像*你的*弹幕，而非随机噪声。

## 分会话 `.jsonl` 池

每个会话有独立弹幕池：

```
$DSH_HOME/danmaku-pools/<sessionId>.jsonl
```

（`$DSH_HOME` 默认 `~/.dsh`，Windows 上即 `C:\Users\<你>\.dsh`。）

每行一个 JSON 条目：`id`、`content`、`source`（0.6.13 起只写 `ai`；旧文件里可能还有 `preset`/`user`）、`at` 时间戳、`tags`、`weight`、`likes`。只追加 LLM（`source: 'ai'`）弹幕——预设与手发只用于当前显示，不落盘；旧 preset/user 行保留在磁盘但回放时过滤。池上限 `maxPoolEntries`（默认 200，裁最旧）。

> [!IMPORTANT]
> 会话被**用户删除**（`api-session/removed`）时池文件删除。`session/disposed`（内存驱逐，非用户删除）**不**删池——重新打开仍列表的会话仍有历史。
>
> **卸载插件**时若服务仍在运行，会清空整个 `danmaku-pools` 目录。也可在库编辑器右上角用红色「清空弹幕库」一键清空（二次确认），或 `POST /api/danmaku/pools/clear`。

## 历史回放

`historyReplayEnabled: true`（默认）让旧 **AI 池条目**作为环境弹幕重现，按以下打分：

- **时间衰减**——半衰期 `halfLifeDays`（默认 7）。越旧指数越低。
- **点赞加权**——每赞 `+15%`。
- **权重**——条目 `weight`（1–10，点赞时提升）。
- **标签匹配**——条目标签与当前上下文标签（近期事件 + 关键词）重叠度。低于 `matchThreshold`（默认 0.35）跳过。

前 `historyReplayMax`（默认 12）条高分回放。所以聊过"正则"的会话会重新浮现旧的正则相关弹幕。

旧 preset/user 行仍在文件里、仍可经池 API 查询，但不参与回放打分。

## 点赞

点赞 AI 弹幕（`POST /api/danmaku/like`，`source: 'ai'`）提升其 `likes` 与 `weight`（上限 10），使其更常浮现。只有 `source: 'ai'` 条目可操作：点赞预设或手发条目是 no-op（`{ok: true, liked: false}`），不会写池。若被赞的 AI 内容不在池中，作为点赞 AI 条目追加——可临时推广 AI 评论。

## 归档与恢复

为保持活跃池精简，超过 `archiveAfterDays`（默认 60）的条目移入**归档**子目录：

```
$DSH_HOME/danmaku-pools/archive/<sessionId>.jsonl
```

归档条目不参与活跃回放，但可通过池 API 查询（`scope=archive` 或 `scope=all`）。`restoreMaxAgeHours`（默认 168h / 7 天）内可**恢复**归档条目回活跃。超窗恢复返回 `too_old`，条目保持归档。

## 弹幕池编辑器

设置卡内置**池编辑器**（"Open pool editor…"）：

- 列出所有会话及其**真实会话名称**（如「帮我写一个……」）与活跃/归档数和时间范围——名称由 Host 通过 `ctx.sessionQuery.readTitleSnapshots()` 一次批量折叠会话标题得到（与 dsh 侧边栏会话列表同源；无标题时回退到截断的 sessionId）
- 按会话浏览活跃 + 归档
- **整会话删除**：卡片右侧 **×** 按钮（0.6.10）——弹出二次确认（注明会话名与删除范围），确认后只删该会话的活跃 + 归档缓存（`DELETE /api/danmaku/pool/session`），其他会话不受影响
- 内联编辑内容/权重/标签
- 删除条目（活跃或归档）
- 恢复归档条目（窗口内）

所有编辑走池 HTTP 路由——无需手动改文件。

## 热度与池

`/api/danmaku/heat`（见 [interaction.md](interaction.md)）与池列表（`/api/danmaku/pools`）共同构成"谁在、多忙"的画面，覆盖层据此呼吸。