前言¶
DeepSeek Harness（DSH）裏，會話和工作區通常要在主窗口側邊欄裏操作。如果你已經裝了 dsh-pet 桌面寵物，想在不打開主窗口的情況下選會話、看歷史、繼續聊，或者隨手框選屏幕提問，就需要一個掛在寵物右鍵菜單上的入口。dsh-pet-assistant 就是爲此做的客戶端插件：卡片即輕量會話端，能力對齊側邊欄裏可見的會話列表與消息流。
這是什麼¶
維護者 Chuzhidezhuzhuboy 在 GitHub 開源的 dsh-pet-assistant（當前版本 0.1.0，MIT 許可），分類爲客戶端插件。它給 dsh-pet 增加一塊桌面小卡片：右鍵寵物 →「進入會話」，即可列出會話、瀏覽最近歷史、繼續對話、框選截圖提問、新建工作區、歸檔會話，以及從回答裏保存或定位真實文件。
硬依賴：必須先安裝 dsh-pet（菜單項通過它的第三方菜單註冊表掛載）。插件本身零運行時依賴，只使用 Node 內置模塊；Electron 可執行文件路徑與 dsh-pet 一致，例如 ~/.dsh/electron/electron.exe。
安裝前需要知道的事¶
本插件會向 dsh-pet 寫入 2 行補丁（lib/client.js 與 runtime/electron-helper/sprite.js 的菜單組裝處），目的是讓「進入會話」出現在一級菜單，而不是「更多」子菜單。補丁帶 [dsh-pet-assistant] 標記、冪等、可還原，不改 dsh-pet 的其他邏輯；dsh-pet 升級後插件每 30 秒自檢並自動補回。若介意對 dsh-pet 文件的改動，請不要安裝。插件以當前 DSH 進程權限運行，安裝前建議自行查看倉庫源碼與許可證。
核心功能¶
| 能力 | 說明 |
|---|---|
| 進入會話 | 列出與側邊欄一致的會話（不顯示空白/子會話/已歸檔），運行中會話帶綠點 |
| 看歷史 | 最近 60 條用戶/助手消息；圖片點擊後才加載，可滾輪縮放 |
| 繼續聊 | Enter 發送、Shift+Enter 換行；回答迴流同一張卡，顯示等待時長與進度片段 |
| 框選截圖 | 點「截圖」→ 卡片隱藏 → 全屏凍結 → 拖框 → 右鍵或回車確認；卡片只顯示縮略圖 |
| 新建工作區 | 選目錄註冊爲工作區（側邊欄出現同名分組）並新建會話 |
| 歸檔 | 會話行懸停可歸檔；「顯示已歸檔」裏可取消歸檔 |
| 文件 | 從回答中識別真實存在的文件，可「保存到…」或「文件夾」定位 |
| 調大小 | 右下角拖拽；手動調整後不再自動改尺寸 |
卡片由本地 HTTP 接口支撐，掛在 DSH webServer 的 /pet-assist 前綴下（如 GET /sessions、POST /submit 等，詳見倉庫 README）。
安裝與啓用¶
裝完後需重啓一次 DeepSeek Harness。右鍵桌面寵物，菜單裏出現「進入會話」即表示啓用成功。
方式一：插件頁安裝（推薦，桌面版）
- 打開 DeepSeek Harness → 插件
- 在安裝輸入框粘貼 release 包鏈接
- 安裝完成後重啓 DSH
https://github.com/Chuzhidezhuzhuboy/dsh-pet-assistant/releases/download/v0.1.0/dsh-pet-assistant-0.1.0.tgz
方式二：命令行（需已安裝 dsh CLI；桌面版優先用方式一）
下載 dsh-pet-assistant-0.1.0.tgz 後，在該文件所在目錄執行：
dsh plugin install ./dsh-pet-assistant-0.1.0.tgz
方式三：從源碼裝（本機需有 git）
dsh plugin install github:Chuzhidezhuzhuboy/dsh-pet-assistant
典型用法¶
- 確認
dsh-pet在運行，並已安裝本插件且重啓過 DSH。 - 在桌面寵物上右鍵，點「進入會話」。
- 在卡片裏選擇一條會話，查看歷史；在輸入框繼續聊，Enter 發送。
- 需要帶圖提問時，點「截圖」，按提示框選區域確認；縮略圖會出現在輸入區附近。
- 要新開目錄工程：點「＋ 新建工作區」，選文件夾；側邊欄會出現對應分組與新會話。
- 回答裏若提到本機真實路徑的文件，卡片會列出，可用系統另存爲或打開所在文件夾。
卡片位置按點菜單時的鼠標位置定位；離屏幕邊緣過近時會被夾進工作區。
排查與卸載¶
- 菜單沒出現：確認 dsh-pet 在跑；插件每 30 秒重註冊菜單。
- 點「進入會話」無反應：可查看
~/.dsh/dsh-pet-assistant/card.log（需把lib/index.js裏CARD_LOG_ENABLED與lib/helper/main.js裏LOG_ENABLED改爲true纔會寫入）。 - 找不到補丁錨點：插件只打日誌，功能仍可用，菜單項可能退回到「更多」子菜單。
卸載示例（資料中爲 PowerShell 寫法）：
pnpm dsh plugin remove dsh-pet-assistant
卸載後 dsh-pet 裏補丁行仍可能存在但不影響運行；要徹底還原 dsh-pet，可重裝一次 dsh-pet（插件不在時補丁不會自動重打）。
結尾¶
dsh-pet-assistant 把 DSH 會話能力收到桌寵右鍵菜單的一張卡片裏，適合已經用 dsh-pet、又希望少開主窗口的開發者。社區目錄與 GitHub 倉庫由維護者獨立維護，與 DeepSeek / 幻方無官方從屬關係。
