前言¶
做智能體或長會話時，資料和鏈接往往散在瀏覽器收藏夾裏，和 DeepSeek Harness（DSH）主界面是兩套入口。靠記憶或臨時翻 Chrome 書籤欄，成本高，也不方便在對話裏直接引用某條收藏。
星河書籤（dsh-bookmarks-desk）是 DSH 生態裏分類爲「記憶」的插件，把本機 Chromium 系瀏覽器的書籤以只讀方式接進側欄：索引列表與書脊書架兩套視圖、自建無限層級分類、搜索與卡片詳情，分類與備註落在本地目錄，不寫回瀏覽器書籤文件。下面介紹它是什麼、能做什麼、如何安裝與典型用法。
這是什麼¶
安裝並啓用後，DSH 側欄會多一個「星河書籤」面板。插件讀取本機瀏覽器書籤文件（只讀不改），在面板裏展示收藏，並在 ~/.dsh/bookmarks-desk/ 保存你自己的分類樹、改名、簡介等覆蓋數據。
維護者爲 GitHub 用戶 hanxiaoxin0715，倉庫 hanxiaoxin0715/dsh-bookmarks-desk，當前 package 版本爲 0.1.0，許可證 MIT。社區目錄頁：SkillHub 插件頁（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
兩套視圖¶
- 索引視圖：一行一條，展示標題、域名、簡介、分類、添加時間；
Ctrl K搜索，↑↓選擇，Enter打開。 - 書脊視圖：按分類分層的書架，每條收藏像一本書；懸停出浮層，點開在右側停靠卡片。兩種視圖可一鍵切換，滾動位置和選中項會保留。
分類與系統視圖¶
分類由你自己建立，插件不預置分類體系。左欄可內聯新建主分類，在任意分類的 ⋯ 菜單裏新建子分類，層級不限；支持雙擊改名，以及上移、下移、刪除（刪父級會級聯刪子分類，書籤退回「未分類」，不刪瀏覽器裏的原始收藏）。
系統視圖包括：全部收藏、最近添加、未分類，計數隨數據更新。左欄搜索框可按分類名過濾，命中項連同祖先鏈一起顯示。
卡片詳情與交互¶
卡片展示簡介、分類（下拉直接改歸類）、文件夾路徑、添加時間、來源、網址；可操作：打開、複製鏈接、發到新會話、記到備註。浮層會根據鼠標在左半屏或右半屏自動出現在對側，減少遮擋；點開卡片後列表會爲停靠卡片讓位。
安全與數據¶
插件只對瀏覽器書籤文件做 readFile，不寫入 Chrome 等配置。本地數據目錄 ~/.dsh/bookmarks-desk/ 中，overrides.json 存分類與覆蓋信息，enrich.json 存助手生成的簡介緩存，pins.jsonl 存置頂；README 說明插件無上報邏輯。
安裝與啓用¶
環境要求：DSH >= 0.2.1-rc.5（package.json 中爲 <0.3.0），Node >= 20。
方式一：DSH Desktop¶
打開 設置 → 插件，搜索 dsh-bookmarks-desk 安裝，然後重啓應用。
方式二：命令行（GitHub）¶
dsh plugin --profile desktop add github:hanxiaoxin0715/dsh-bookmarks-desk
裝完後重啓 dsh web 或 DSH Desktop，側欄會出現「星河書籤」。--profile desktop 可換成你自己的 profile 名；DSH Desktop 自帶 profile 建議用應用內插件設置，命令行無法改其運行中狀態。
方式三：命令行（npm，發佈到 npm 之後）¶
dsh plugin --profile desktop add dsh-bookmarks-desk
卸載¶
dsh plugin --profile desktop remove dsh-bookmarks-desk
本地面板數據在 ~/.dsh/bookmarks-desk/；若要一併清除，需手動刪除該目錄。
瀏覽器與配置¶
默認只讀 Chrome。Windows、macOS、Linux 上支持 Chrome、Chrome Beta、Edge、Brave、Chromium。主力瀏覽器讀不到書籤時會自動嘗試其它瀏覽器，避免面板爲空。已登錄 Chrome 時優先讀 AccountBookmarks，否則退回普通 Bookmarks。
合併多個瀏覽器時設置環境變量：
# macOS / Linux
export BOOKMARKS_DESK_BROWSERS=chrome,edge,brave
# Windows PowerShell
$env:BOOKMARKS_DESK_BROWSERS = "chrome,edge"
可用值：chrome、chrome-beta、edge、brave、chromium。
典型用法¶
日常瀏覽與歸類¶
- 在側欄打開「星河書籤」，在索引視圖用
Ctrl K搜標題或域名，用Enter在系統瀏覽器打開。 - 切換到書脊視圖，按自己的項目建分類樹，在卡片詳情裏用分類下拉把收藏歸到對應節點。
- 使用「全部 / 最近添加 / 未分類」系統視圖處理新導入或未歸類的條目。
本地預覽（無需安裝 DSH）¶
倉庫提供虛構示例數據 examples/demo-bookmarks.json。可在插件目錄執行：
node scripts/preview.mjs
會在本機啓動預覽服務（README 示例爲 http://127.0.0.1:62605/），用示例數據注入真實面板 UI，改 panel/index.html 後刷新即可，無構建步驟。
批量歸類（可選）¶
scripts/classify.mjs 按你已建好的分類名，結合文件夾同名、域名/標題命中、內置主題詞典或 --rules ./my-rules.json 做批量歸類；只寫入 overrides.json，不寫瀏覽器書籤。
node scripts/classify.mjs # 只打印分佈，不寫入
node scripts/classify.mjs --write # 寫入（自動備份 overrides.json）
node scripts/classify.mjs --inbox 收件箱 --write # 未命中項歸到「收件箱」
適用場景與注意¶
適合在 DSH 裏做研發、寫作或長對話、又大量依賴 Chromium 收藏夾作爲「外腦」的用戶：側欄即可檢索、分類、把鏈接發到新會話或記備註，無需來回切瀏覽器。
安裝前建議自行查看倉庫源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，會讀本機瀏覽器書籤路徑；雖聲明只讀且不上傳，仍屬敏感本地數據，環境應在你可控的機器上使用。
不支持 Safari 等非 Chromium 書籤格式；多瀏覽器合併依賴 BOOKMARKS_DESK_BROWSERS 與環境中的實際安裝情況。
結尾¶
星河書籤把瀏覽器收藏只讀接進 DSH 側欄，用自建分類與雙視圖把鏈接管理和對話上下文放在一起，本地存儲、不寫回瀏覽器。進一步瞭解可看 SkillHub 目錄頁 與 GitHub 倉庫。
