前言¶
在 DeepSeek Harness（DSH）裏和助手來回對話，經常會出現「這條回覆以後還要用」的情況：一段可複用的代碼、一條排查思路、或某次對話裏的關鍵結論。常見做法是複製到筆記軟件，或靠會話標題和搜索碰運氣——前者多一步手工，後者很難精確回到某條消息。
下面介紹 dsh-bookmarks（維護者 penguin-oo）。它是 DSH Web UI 上的書籤插件，分類爲「記憶」，可在每條已完成的助手回覆上打書籤、寫備註和標籤，並在統一面板裏跨會話瀏覽、搜索與導出。
這是什麼¶
dsh-bookmarks 爲 DSH 提供「按消息收藏助手回覆」的能力：在每條 finalized 的助手回覆旁增加歸檔按鈕，可附帶備註與逗號分隔的標籤；所有書籤彙總到一箇中心面板，支持全文搜索、標籤篩選、內聯編輯與刪除，並可一鍵導出爲 Markdown。
插件當前版本爲 0.1.2，採用 MIT 許可證，在 GitHub 上約有 12 個 star。它通過 DSH 的插件機制接入 Web 配置檔（web profile），不依賴 DeepSeek 或幻方官方應用商店；社區目錄頁見 SkillHub。
核心功能¶
單條消息書籤¶
每條已完成的助手回覆右側（緊鄰 👍/👎 反饋按鈕）會出現歸檔按鈕。點擊後可內聯編輯備註和標籤（逗號分隔）。即使不寫備註，書籤也會保存服務端從實際回覆派生的文本預覽（snippet），中心面板仍可瀏覽。
跨會話書籤中心¶
側邊欄底部提供中心面板入口，彙總所有會話與工作區中的書籤，支持：
- 全文搜索
- 按標籤篩選
- 內聯編輯與刪除
- 點擊條目一鍵跳回對應會話
任意位置按 Alt+B 可切換中心面板顯示。側邊欄收起時，可用該快捷鍵打開面板。
Markdown 導出¶
中心面板支持一鍵導出，下載文件名爲 dsh-bookmarks.md，便於歸檔或遷入其他筆記工具。
寫入安全¶
書籤數據通過 DSH storage domain 持久化，採用 per-item compare-and-set 版本號（多標籤頁安全）、服務端校驗，寫入策略與官方 message-feedback 的耐久屏障對齊。
安裝與啓用¶
在已安裝 DSH CLI 的環境中執行：
dsh plugin --profile web add dsh-bookmarks
然後重啓 DSH Web UI：
dsh web
插件會自動追加到 profile bundle 層，無需額外配置。
若從本地倉庫目錄安裝（開發或自測）：
# 在插件倉庫根目錄執行
dsh plugin --profile web add file:./
配置項¶
可在 profile patch 層（$DSH_HOME/profiles/web/cordis.patch.yml）覆蓋以下限制，均爲可選：
| 配置項 | 默認值 | 含義 |
|---|---|---|
maxNoteBytes |
4096 |
單條備註最大 UTF-8 字節數（"" 清空備註；省略字段則保留原值） |
maxSnippetChars |
300 |
服務端派生回覆預覽的最大字符數 |
maxTags |
8 |
每條書籤最多標籤數；每個標籤 ≤ 32 字符，會 trim 並去重 |
示例：
- id: bookmarks
config:
maxNoteBytes: 2048
maxSnippetChars: 200
maxTags: 5
典型用法¶
- 安裝並重啓
dsh web後，打開任意會話，等待助手回覆完成。 - 在目標回覆右側點擊歸檔按鈕，填寫備註和標籤（如
排查,nginx），保存。 - 按
Alt+B或點擊側邊欄底部入口打開書籤中心，用搜索或標籤篩選定位條目。 - 需要離線歸檔時，在中心面板一鍵導出
dsh-bookmarks.md。 - 點擊某條書籤可跳回其所屬會話（當前版本跳轉到會話級，尚不能自動滾動到具體消息）。
實現概要¶
插件由一個 npm 包承載兩端：
- Host 端（
lib/index.js）：bookmarksRemote 服務（Typert），數據表位於$DSH_HOME/storages/bookmarks.json。put會讀取持久化會話日誌以校驗目標回覆並生成 snippet。 - Browser 端（
src/client，打包爲lib/client.js）：通過ctx.remote.$mount掛載 Remote，並註冊兩個 UI 插槽：conversation.chat.assistant-actions（單條消息按鈕）與sidebar.footer.action（中心面板開關）。
適用場景與注意¶
適合：
- 長期在 DSH 中調試、寫方案，需要把零散的高質量回復沉澱下來
- 多會話並行，希望在一個面板裏按標籤或關鍵詞找回歷史要點
- 需要把書籤批量導出爲 Markdown 做二次整理
注意：
- 書籤存放在單一全局行，適合個人使用，不是多用戶共享存儲。
- 中心面板跳回的是書籤所在會話，暫不支持定位到具體消息。
- 插件以當前
dsh進程權限運行，安裝前建議查看 源碼 與 MIT 許可證。 - DSH 生態遵循「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結語¶
dsh-bookmarks 把「收藏某條助手回覆」做成 DSH 內的一等操作：單條打標、跨會話檢索、一鍵導出，減少複製粘貼和翻找會話的成本。目錄頁：SkillHub - dsh-bookmarks；源碼與文檔：GitHub - penguin-oo/dsh-bookmarks。
