前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的理念，插件生態爲系統提供了豐富的擴展能力。在 Web UI 的日常使用中，獲取會話的特定信息（如 ID、路徑）或監控詳細指標可能需要多次點擊或查看不同區域。@comecaramelos/dsh-hover-information 插件旨在通過增強 Web UI 的交互細節，解決信息獲取不集中、操作繁瑣的問題。它爲懸停卡片、側邊欄工具欄以及後臺作業列表增加了實用的快捷操作和信息展示。
核心功能¶
懸停卡片增強¶
該插件主要增強了會話懸停卡片的顯示內容與操作便捷性：
- 快捷複製：在懸停卡片的頭部行，增加了
⧉ copy ID和⧉ copy path圖標，替代了原本僅有的整卡複製按鈕，允許你單獨複製會話 ID 或工作區路徑。 - 可配置指標塊：在卡片中增加了一個可配置的指標展示區域。該區域支持按需切換顯示以下指標：
- 輪次（turns）、步驟（steps）
- 發送/接收的 Token 數量
- 緩存 Token 數量
- 壓縮（compactions）、清理（purges）
- 上下文窗口大小
- 子代理（subagents）
- 模型（model）
- 工具調用（tool calls）
- 活躍時間（active time）、創建日期（created date）
側邊欄工具欄¶
在側邊欄的文檔預覽頭部工具欄中，插件增加了兩個額外的複製按鈕，方便快速複製當前打開文件的內容或路徑。
後臺作業管理¶
在會話頭部的「後臺作業列表」中，針對正在運行的任務行，增加了一個 ✕ 按鈕用於終止作業（取消操作，非強制終止）。
模型選擇器¶
在模型選擇器中，增加了提供者（Provider）的顯示。選擇器中不僅顯示模型名稱，還通過 Tooltip 和值顯示 Provider > Model 的層級信息。
安裝與啓用¶
安裝過程通過 DSH CLI 工具執行。由於瀏覽器端插件不支持熱更新，安裝後需要重啓服務。
官方安裝命令¶
dsh plugin --profile web add @comecaramelos/dsh-hover-information
手動安裝（備選方案）¶
如果需要手動安裝，需將插件鏈接到對應目錄，並在 package.json 中配置依賴：
mkdir -p ~/.dsh/profiles/web/node_modules/@comecaramelos
ln -s /path/to/dsh-hover-information \
~/.dsh/profiles/web/node_modules/@comecaramelos/dsh-hover-information
隨後編輯 ~/.dsh/profiles/web/package.json，添加以下配置：
{
"dependencies": {
"@comecaramelos/dsh-hover-information": "link:/path/to/dsh-hover-information"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@comecaramelos/dsh-hover-information"
]
}
}
}
重啓要求：安裝完成後，必須重啓 web 適配器。瀏覽器端插件不支持熱更新，且 DSH 的 live web 網關不會由工具自動重啓，需手動執行。
典型用法¶
- 配置指標顯示：進入設置頁面的「Plugins」卡片，根據需要開啓或關閉上述提到的各類指標項。
- 複製會話信息：在會話列表中將鼠標懸停在會話卡片上，點擊頭部行右側的
⧉ copy ID或⧉ copy path圖標。 - 終止後臺任務：在會話頭部查看後臺作業列表，找到正在運行的任務行，點擊行首的
✕按鈕進行取消。 - 查看模型來源：在模型選擇器中，點擊模型下拉項，查看 Tooltip 或選中項，確認其所屬的 Provider 信息。
注意事項¶
- 熱更新限制：該插件提供的瀏覽器端 Bundle 不支持熱更新功能，修改代碼或配置後必須重啓服務。
- 服務重啓：Live
dsh web網關不會由安裝工具自動重啓，務必在安裝後手動重啓服務以確保插件生效。
結語¶
@comecaramelos/dsh-hover-information 通過細化的 UI 交互改進，提升了 DSH Web UI 在信息查閱和操作上的效率。如果你在使用 Web 界面時頻繁需要複製路徑、查看詳細指標或管理後臺任務，該插件能提供即時的功能增強。
