前言¶
在长周期项目（软件开发、学术研究、产品设计）中，LLM/智能体的对话会话往往跨越多个会话。每次开启新对话，模型都会“失忆”，需要重新解释背景。这导致效率低、信息丢失和体验断层。DialogueContextBridge 是一个 DSH（DeepSeek Harness）插件，旨在解决跨会话上下文桥接问题。
是什么¶
DialogueContextBridge 是一个 DSH 插件，由 ShadowQuill 维护。它把一次对话里“已经了解的信息”打包成可移植的知识单元，支持一键引入新对话，让 AI 不必反复从头了解背景。
插件的数据只存在本机 ~/.dsh/，不上传任何服务器。快照是纯文本 Markdown 格式，支持跨设备/跨账号迁移记忆（文件导入导出）。
核心设计：三层快照¶
插件将快照设计为三层结构，以解决“摘要损失”问题。
1、关键消息原文：最终敲定的代码、决策结论、技术参数、硬性指令。策略是逐字保留，禁止压缩与截断。
2、结构化摘要：讨论背景、推导过程、中间试错、已排除方案。策略是由 /compile 压缩为分层要点（内置抽取式，或通过 summary.mode=llm 调用宿主 LLM）。
3、用户偏好与设定：风格偏好、角色设定、项目硬性约束。策略是按稳定 key 归档，便于跨快照裁决。
安装与启用¶
在 DSH 工作目录中安装插件。
npm install dsh-plugin-dialogue-context-bridge
在 DSH 配置中加载插件。
import bridge from 'dsh-plugin-dialogue-context-bridge';
ctx.plugin(bridge, {
maxTokens: 4096,
autoSave: false,
});
典型用法¶
插件提供了以下命令来跑通闭环。
1、编译与保存：
# 编译当前对话为快照草稿（仅在内存中）
/compile --title "上下文桥接架构评审" --tags 架构,phase1
# 确认无误后落库
/save
2、检索与引入：
# 按关键词找回快照
/snapshot-search 上下文桥接
# 在新对话里一键引入（默认仅新信息模式）
/import snap_a1b2c3
# 想融合历史快照？使用 merge 模式
/import snap_a1b2c3 --mode merge
3、跨设备迁移：
# 导出快照为 .md 文件
/dcb-export snap_a1b2c3
# 从文件导入快照（自动分配新 id，不覆盖）
/dcb-import ~/Desktop/my-snapshots/snap_a1b2c3__xxx.md --dry-run
注意事项¶
1、数据存储：所有数据只存在本机 ~/.dsh/，不上传任何服务器。
2、环境要求：Node.js >= 20（CI 矩阵为 20.x / 22.x）；SQLite >= 3.34（用于 FTS5 trigram 分词器，中文检索依赖它，低版本 SQLite 会自动回退到 unicode61 分词器）。
3、加密行为：数据目录若开启加密，导入内容会按本地策略重新加密落盘。
4、命令执行：在 DSH 0.1.1-rc.2 下，手打带参命令的气泡会常驻“执行中…”（结果已注入，发一条新消息即清）。建议使用无参命令（如 /dcb-import-last）或通过命令面板点选。
5、版本控制：被版本化的是快照 Markdown 明文，git 历史不加密。
短结尾¶
DialogueContextBridge 通过三层快照机制，在本地构建了可移植的记忆库，适合需要保持长期项目连续性的开发者使用。
