前言¶
在 DeepSeek Harness（DSH）裏與模型長對話時，常有段落、表格或結論需要稍後回看；僅靠滾動歷史或複製到外部筆記，容易打斷當前會話，也難在多條會話之間統一查找。社區插件 dsh-bookmark（維護者 vaisramana）面向「記憶」類需求：在對話內選中內容即可書籤與高亮，並在右側欄與全局書籤頁中管理備註，必要時再引用回輸入框。下面介紹其定位、能力與安裝用法。
這是什麼¶
dsh-bookmark 是 DSH 的瀏覽器端插件，爲 DeepSeek Harness 提供會話內書籤、文本/表格高亮、行內備註，以及可摺疊的「全部會話」書籤視圖。數據默認保存在本機 localStorage，不改動會話日誌；只有你把書籤「引用」進輸入框時，纔會進入當前對話上下文。
核心功能¶
右鍵一鍵書籤與高亮¶
在任意消息中選中一段文字、多段落或整張表格（<table>），右鍵選擇 Bookmark。選區會在原位高亮，並出現在當前會話右側欄的 Bookmark 標籤頁。
對話內查找¶
使用 ⌘ + F / Ctrl + F，或點擊輸入區上方的 Find 入口，打開類似 Safari 的浮動查找條；匹配項在當次對話中高亮，用 Enter / Shift + Enter 在匹配之間跳轉。
行內備註¶
每條書籤卡片帶有無邊框備註輸入框；書籤後可立即輸入，或稍後點開卡片編輯。在失焦或按 Enter 時自動保存。
非破壞性高亮實現¶
高亮基於瀏覽器 CSS Custom Highlight API（::highlight(dsh-bm-mark)），通過偏移與上下文恢復定位，不直接改寫 React 管理的 Markdown DOM。
右側欄與輸入區入口¶
插件掛在 DSH 原生右側欄（sidebar.right.pane.tab），也可從輸入區旁的 Bookmarks 藥丸進入。點擊書籤可滾動到對話中的對應高亮；也可用 Quote 將 passage 與備註插入輸入框。
跨會話書籤頁¶
左側欄 Bookmarks、快捷鍵 Alt + B，或右側欄 All Sessions › 打開全部會話視圖。書籤按會話分組，支持按最近時間、會話標題或數量排序，會話塊可摺疊，支持全文搜索、跨會話跳轉定位，以及 Markdown 導出。
安裝與啓用¶
插件以當前 DSH 進程權限在瀏覽器中運行；安裝前建議在 GitHub 查閱源碼；許可證爲 MIT。
桌面應用（GUI）¶
在 DSH 中打開 Plugins，從 GitHub 或本地目錄安裝，倉庫標識爲：
github:vaisramana/dsh-bookmark
CLI¶
# Install into Desktop profile
dsh plugin --profile desktop add github:vaisramana/dsh-bookmark
# Or install into Web profile
dsh plugin --profile web add github:vaisramana/dsh-bookmark
本地目錄¶
在插件源碼目錄內，可用 file: 安裝（README 要求先進入該目錄再執行）：
dsh plugin --profile desktop add "file:$PWD"
package.json 中 dsh.client 標明平臺爲 web，並依賴宿主提供的 UI 與會話相關模塊；無額外 npm 運行時依賴。
典型用法¶
- 創建書籤：在消息內選中文字或表格 → 右鍵 → Bookmark。
- 寫備註：右側欄會自動打開並聚焦備註框；
Enter或點擊外部保存。 - 定位或引用：點擊引用片段或 Locate 平滑滾動到高亮處；Quote 將內容與備註填入輸入框。
- 瀏覽全部會話：左側 Bookmarks 或
Alt + B（或右側 All Sessions ›）；點擊會話標題可摺疊/展開該組書籤。
數據與架構要點¶
| 文件 | 職責 |
|---|---|
index.js |
宿主 bundle 入口（無狀態邏輯；狀態在瀏覽器本地） |
client.js |
瀏覽器模塊，註冊側欄、composer dock、overlay、面板列表等掛載點 |
cordis.patch.yml |
Profile bundle 補丁 |
locale/*.json |
中英文元數據 |
持久化鍵名爲 localStorage["dsh-bookmark/v1/items"]。插件只使用宿主提供的 react 與 --dsw-alias-* 主題 token。
適用場景與注意¶
適合需要在 DSH 內長期保留「對話片段 + 簡短批註」、並在多會話間檢索的開發者或重度對話用戶。查找與高亮能力依賴瀏覽器對 CSS Custom Highlight API 的支持；若環境不支持，需以實際表現爲準。
DSH 生態主張「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-bookmark 把「選中 → 高亮 → 備註 → 跨會話瀏覽 → 再引用」收攏在 DSH 界面內，減輕對外部筆記的往返切換。目錄頁：https://www.skillhub.cn/plugins/vaisramana/dsh-bookmark；源碼與文檔：https://github.com/vaisramana/dsh-bookmark。
