前言¶
DeepSeek Harness（DSH）側邊欄裏，工作區只能靠拖拽調整順序，沒有「常用項固定在頂部」這一層；插件面板行的順序也隨註冊順序固定，沒法把經常用到的面板拎到最上面。插件多、工作區多時，每次都要在列表裏找，成本不高但會重複發生。
下面介紹社區插件 @polunzh/dsh-pin：在 Web 桌面側欄爲工作區行和插件面板行增加置頂按鈕，狀態可持久化，取消置頂時儘量回到原來的位置。
這是什麼¶
dsh-pin 由維護者 polunzh 發佈，歸類爲客戶端插件（dsh.client.platform 爲 web）。它解決兩類問題：
- 將指定 Workspaces 下的工作區行固定到列表頂部（多枚置頂時，最近置頂的在最前）。
- 將側欄中的插件面板行（第三方面板、
Plugins、Automation tasks等）固定到面板區域頂部，其餘面板仍按註冊順序排列。
主機端（host）側爲無操作實現；邏輯集中在 lib/client.js。
與 DSH 自帶能力的對比¶
| 能力 | DSH 內置 | dsh-pin 增加 |
|---|---|---|
| 工作區順序 | 僅拖拽 | 可置頂到頂部 |
| 工作區置頂狀態 | 無 | 持久化，取消時儘量還原到原槽位 |
Session 置頂（pinnedSessionIds） |
有 | 不改動 |
面板 order |
註冊時固定 | 可置頂，順序按瀏覽器本地記錄 |
核心功能¶
工作區置頂¶
鼠標懸停 Workspaces 下任意一行，點擊 📌，該行移到頂部。再次點擊 📌，或點擊已置頂行上常駐的小圖釘，即取消置頂；插件會嘗試把該行插回原先緊跟其後的那個工作區之前，錨點不存在時落到列表末尾。
工作區順序通過宿主自帶的 workspaces.insertBefore RPC 寫入持久註冊表，多客戶端會對齊。新建工作區默認在註冊表頭部創建時，插件會監聽順序變化，把仍被置頂項拉回頂部，其餘順序儘量不動。
插件面板置頂¶
懸停側欄中任意插件面板行並點擊 📌，該行在面板區域內置頂。未置頂的面板保持註冊順序。面板順序僅作用於 DOM，並記錄在本地鍵 dsh-pin.panels.v1 下；取消置頂時按註冊時的槽位恢復。
實現上通過 MutationObserver 在 React 重渲染後重新注入按鈕，並重放面板順序。按鈕爲 24×24 點擊區域，樣式貼近原生行按鈕，且不會誤觸展開或摺疊背後的工作區文件夾。已置頂行會常駐顯示圖釘，無需懸停即可辨認狀態。
持久化與調試¶
置頂狀態在重載頁面、重啓 DSH 後仍保留。調試時可使用 window.__dshPin（如 workspaceOrder()、panelPins、lastError、reassertPins()）。
安裝與啓用¶
在資料給出的命令下，爲 desktop 配置檔安裝 npm 包：
dsh plugin --profile desktop add @polunzh/dsh-pin
README 還提到可用 github:polunzh/dsh-pin、link:/path/to/dsh-pin，或在 DSH 設置中的插件市場裏安裝。安裝後需重啓 DSH 或重載 profile 後生效。
當前 package.json 版本爲 1.0.4，許可證 MIT。插件以當前 DSH 進程權限在瀏覽器側運行，安裝前建議自行查看 GitHub 倉庫 源碼與許可證。
典型用法¶
- 固定常用工作區：懸停目標工作區行 → 點擊 📌 → 該工作區出現在 Workspaces 列表頂部。
- 固定常用面板：懸停側欄插件行 → 點擊 📌 → 該面板在面板區頂部；多枚置頂時以最近操作爲準排在更前。
- 取消置頂：再次點擊行內 📌，或點擊已置頂行上的常駐圖釘。
注意：先置頂再往下拖拽，置頂項會被拉回頂部；若需改變相對位置，應先取消置頂。
適用場景與限制¶
適合：長期通過 DSH Web GUI 或桌面 Web 層使用側欄的用戶，希望把少數工作區或面板固定在頂部以減少查找。
不支持或需注意：
- 僅 Web GUI / 桌面 Web 層；TUI 無側欄，無法使用。
- Ungrouped 不是真實工作區，不能置頂。
- 工作區順序在 host 全局；面板置頂順序 按瀏覽器 分別保存。
- 已置頂工作區若被拖拽下移，會彈回頂部，需先 unpin。
- 依賴內部 DOM（如
data-row-key、panelRow、React fiber），DSH 大版本升級後選擇器失效時，按鈕可能不可用，需等待插件更新。 - 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源；與 DeepSeek / 幻方無官方從屬關係。
結尾¶
@polunzh/dsh-pin 在不大改 DSH 自帶 session 置頂與面板註冊模型的前提下，補上了工作區與側欄插件面板的「置頂到頂部 + 取消時儘量還原」能力。若你主要在桌面 profile 裏用側欄，可按上文命令安裝，並在使用前確認源碼與權限邊界。
- 目錄頁：https://www.skillhub.cn/plugins/polunzh/dsh-pin
- 源碼與說明：https://github.com/polunzh/dsh-pin
