前言¶

在長週期項目（軟件開發、學術研究、產品設計）中，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 通過三層快照機制，在本地構建了可移植的記憶庫，適合需要保持長期項目連續性的開發者使用。

• 文檔站點: shadowquill.github.io/DialogueContextBridge
• GitHub: ShadowQuill/DialogueContextBridge