前言¶
DeepSeek Harness (DSH) 採用了插件化架構。在開發智能體或進行長對話時，開發者通常需要將當前會話的關鍵信息或上下文沉澱下來，以便在後續會話中快速引用。dsh-notebook 插件將這一功能直接集成到了 DSH 的官方右側邊欄中，提供了一套輕量級的筆記記錄與引用機制。
這是什麼¶
dsh-notebook 是一個運行在 Web 環境下的 DSH 插件。它不依賴第三方 UI 包，直接掛載在 DSH 的官方右側邊欄。插件的核心功能是允許用戶創建包含標題、正文和圖片的筆記條目，並通過點擊標題複製正文、輸入 @ 符號引用筆記等方式，將這些信息注入到當前的對話流中。
核心功能¶
創建與存儲¶
- 基礎結構：每條筆記包含單行標題、正文區域和圖片縮略條。圖片以磁盤文件形式存儲，路徑位於
$DSH_HOME/storages/notebook-attachments/<noteId>/。 - 寫入機制：支持原子寫入。如果
$DSH_HOME不可寫，系統會自動降級到內存模式運行，此時所有響應都會攜帶degraded: true標記。 - 內容限制：僅支持圖片，拒絕視頻格式。圖片上傳有大小限制（單個約 10MB）和數量限制（單條筆記最多 20 張）。
交互方式¶
- 複製正文：點擊筆記的標題，會將正文複製到剪貼板。複製的內容中，圖片會轉換爲
[image: name]格式的文本行，並附帶字數提示。 - 引用筆記：在編輯器中輸入
@，會彈出筆記列表供選擇。選中後，僅筆記的正文內容會被髮送給模型。 - 快捷保存：
- 選中文本：在 Composer 中選擇文本，會出現懸浮的 “To notebook” 按鈕，點擊即可將選中內容保存爲筆記（標題自動命名爲“未命名1”、“未命名2”等）。
- 整條回答：在回答末尾的操作欄中，點擊保存圖標，可將當前會話的整個回答保存爲筆記，標題使用當前會話的標題。
安裝與啓用¶
插件依賴 DSH 版本 >=0.2.0-rc.2。安裝前請確保使用 pnpm 作爲包管理器。
dsh plugin --profile web add github:wyzh0117/dsh-notebook
安裝後，在右側邊欄的 + 列表中找到該插件並啓用。默認情況下，新建會話時側邊欄不會自動打開，需手動開啓“Open the notebook for new sessions”選項。
典型用法¶
- 添加筆記：點擊側邊欄右上角的
+按鈕，輸入標題和正文，粘貼圖片後按Cmd/Ctrl + Enter或點擊 Done 保存。 - 複製內容：在筆記列表中點擊某條筆記的標題，將正文內容複製到剪貼板，隨後在 Composer 中粘貼使用。
- 引用上下文：在 Composer 輸入
@，從彈出的列表中選擇一條筆記。模型將僅讀取該筆記的正文內容。 - 快速歸檔：在 Composer 中選中一段代碼或文本，點擊浮動的保存按鈕，將其轉化爲一條結構化的筆記。
適用場景與限制¶
- 適用場景：需要頻繁記錄技術細節、代碼片段或會話摘要的開發者；需要在多個會話間共享特定上下文的用戶。
- 已知限制：
- 無富文本編輯器：僅支持純文本和圖片，不支持 Markdown 或富文本格式。
- 無雲同步：數據存儲在本地磁盤，不提供雲端同步。
- 無版本歷史：刪除筆記後無法恢復。
- 全局筆記：筆記列表是全局共享的，不屬於特定會話。
結語¶
dsh-notebook 在 DSH 官方側邊欄中提供了一個輕量級的筆記記錄與引用入口。它通過本地磁盤存儲和原子寫入機制，爲開發者提供了一個無需雲同步、數據完全離線的記憶輔助方案。
