前言¶
DeepSeek Harness（DSH）能讀自己的窗口和它能訪問的文件，但看不到別的軟件界面、系統彈框、裝機嚮導或遊戲畫面。你在這些界面上卡住時，往往只能切回 DSH、口述或複製粘貼，效率低且容易漏細節。
社區插件 dsh-pet（維護者 HeiBai-king，GitHub 倉庫 HeiBai-king/dsh-pet）在 Windows 上提供一隻浮在所有窗口之上的「桌面球」，點一下即可截當前屏並投遞到你選定的 DSH 會話，回答回寫到球旁氣泡。它不替你點擊或改設置，只是把「畫面 + 問題」交給會話，由你按回答自己操作。本文介紹其定位、能力與安裝用法；事實以倉庫 README 與 package.json（當前版本 0.2.2）爲準。插件歸類爲客戶端，可在社區目錄 SkillHub 條目 查看索引信息。
這是什麼¶
dsh-pet 是一鍵「截圖問 DSH」的 DSH 插件：宿主跑在 DSH 的 Node 進程裏，桌面球由 PowerShell 5.1 + WPF 獨立進程繪製。流程可以概括爲：
點一下球 → 截當前屏 → 發給 DSH 裏某一段會話 → 會話回覆 → 答案顯示在氣泡裏
插件聲明 npm 依賴爲零，除把消息投給你本機 DSH 會話外 不聯網。它不使用瀏覽器調試端口、不讀網頁 DOM，只有你點菜單裏的按鈕纔會截屏。
環境要求¶
不滿足任一條則不必安裝（README 明確說明 Linux / macOS 裝了也不會顯示球）。
| 要求 | 說明 |
|---|---|
| 操作系統 | 僅 Windows（package.json 中 os: ["win32"]） |
| DSH | 已安裝且能正常打開頁面；文檔 驗證過 0.2.0-rc.2（web profile）。插件使用 DSH 內部接入點，版本差異過大可能導致掛件不顯示 |
| Node | >= 20（通常由 DSH 自帶） |
| PowerShell | 5.1（Windows 10/11 自帶） |
| 不需要 | 單獨 npm install、改瀏覽器調試端口、必填配置文件、外部服務 |
裝好後還需：① 重啓 DSH；② 在球上先選一段會話（未選就點「截當前屏幕問會話」會提示「還沒選會話」）。
核心功能¶
桌面球與頁面膠囊¶
插件加載後桌面球默認會自動出現（可通過配置關閉自動啓動）。DSH 頁面右下角可能出現鯨魚小圓圖標「膠囊」——靠注入 DSH 頁面實現，注入失敗時 沒有膠囊也能用球。
- 左鍵點膠囊：顯示 / 隱藏桌面球
- 右鍵拖膠囊：移動位置（會記住）
- 球可拖動、縮放，位置與大小持久化；拖到屏幕左半邊時角色會自動轉向屏幕內
球上菜單¶
鼠標移到角色上，右上角浮出菜單按鈕。常用項包括：
| 菜單項 | 作用 |
|---|---|
| 大小 / 翻轉 | 調節球大小、自動翻轉開關 |
| 當前會話：XXX | 只讀，顯示消息發往哪段會話 |
| 截當前屏幕問會話 | 截整屏，可附補充說明，發給當前會話 |
| 發消息（不截圖） | 只發文字 |
| 選擇會話… | 按工作區分組選會話 |
| 收起鯨魚球 | 關閉球（下次開 DSH 可再出現，或由膠囊喚起） |
氣泡行爲：球剛啓動時不顯示舊內容；提問後先顯示「正在思考…」，回答返回後保留至下次提問；超過約 3 分鐘無回寫會自動超時（見 README 故障表）。
明確不做的事¶
- 不會自動截屏，僅在你點按鈕時截屏
- 不會替你操作界面
- 不替代 DSH 本體權限邊界：仍以當前 DSH 進程能做的事爲上限
安裝與啓用¶
前置條件¶
Windows + 可用的 DSH（建議接近文檔驗證版本）。若 DSH 數據目錄改過，配置與日誌可能在 $DSH_HOME\pet\ 下，而非默認 ~\.dsh\pet\。
裝法一：安裝腳本（推薦，DSH 正在運行時也可用）¶
倉庫 README 給出的步驟：將包放到本機目錄後執行 tools\install.ps1。腳本會建立目錄聯接、更新 profile\package.json 的 dependencies 與 dsh.profile.bundles，並在改前備份 package.json。
無 git 時可下載 zip 解壓，再執行：
powershell -ExecutionPolicy Bypass -File "<解壓出來的目錄>\tools\install.ps1"
有 git 時 README 示例爲克隆到用戶目錄後執行同一腳本（完整命令見 GitHub README 安裝節）。
裝法二：DSH 未運行時用 CLI¶
dsh plugin --profile web add link:"<包目錄，正斜槓>"
DSH 正在運行時此命令可能報 EPERM（native 模塊被佔用），此時應改用裝法一。
裝完必做¶
重啓 DSH。模塊圖與注入表在啓動時確定，不重啓不生效。
自檢（三件事）¶
- 頁面右下角出現鯨魚膠囊（無膠囊時仍可能已起球，見下文排錯）
- 點膠囊或已有球，桌面球能出現
- 菜單選會話 →「截當前屏幕問會話」→ 氣泡出現「正在思考…」隨後有回答
可選：在包目錄運行 node tools\selfcheck.mjs，README 期望通過 29 項自檢。
日誌路徑（默認用戶下）：
C:\Users\<你>\.dsh\pet\pet-host.log
C:\Users\<你>\.dsh\pet\pet-ball.log
典型用法¶
第一次使用可按 README 三步走：
- 確認屏幕上有鯨魚球；若無，點右下角膠囊或在 DSH 窗口按 Ctrl+R 重載頁面
- 移到角色 → 菜單 → 選擇會話… → 選一段會話
- 確認「當前會話」正確 → 截當前屏幕問會話
不想一開 DSH 就顯示球時，可在 ~\.dsh\pet\config.json 寫入：
{"ball":{"autoStart":false}}
改完後需按 README 說明理解生效方式（點膠囊喚起球）。
可選配置¶
配置文件：~\.dsh\pet\config.json（不存在則全默認）。常用鍵：
| 鍵 | 默認 | 說明 |
|---|---|---|
askSession |
空 | 默認投遞會話；空則優先球上上次選擇，再退回 DSH 主 Bot 當前會話 |
pickWorkspaces |
[] |
選擇框只列指定工作區；空爲全部 |
trustedHosts |
[] |
DSH 部署在非迴環地址時使用 |
ball.useRegion |
false |
把球窗裁成鯨魚形狀；README 建議默認關閉 |
ball.autoStart |
true |
加載後自動顯示球 |
環境變量優先級高於文件：DSHW_PET_ASK_SESSION、DSHW_PET_PICK_WORKSPACES、DSHW_PET_TRUSTED_HOSTS、DSHW_PET_USE_REGION、DSHW_PET_AUTO_START_BALL。
查看當前生效值：
node "<包目錄>\tools\write-config.mjs"
卸載¶
在包目錄執行：
powershell -ExecutionPolicy Bypass -File "<包目錄>\tools\uninstall.ps1"
會移除聯接並還原 package.json 相關條目（先備份），默認 不刪除 ~\.dsh\pet\ 數據；需一併清除時加 -PurgeData。卸載後同樣 重啓 DSH。
適用場景與注意¶
適合：在 Windows 上常用 DSH，且經常在 DSH 窗口外遇到問題界面——安裝程序、第三方工具、全屏應用——需要會話「看一眼屏幕」再給操作步驟，又不想反覆切換窗口描述畫面。
注意：
- 僅 Windows；多屏與不同縮放比 README 標明未充分實測。
- 插件以 當前 DSH 進程權限 運行，截圖與投遞都發生在本機；安裝前應閱讀源碼與 MIT 許可證（見倉庫），自行評估是否納入工作環境。
- 依賴 DSH 內部接入點，升級 DSH 後若異常，先看
pet-host.log自檢行與 README「兼容性」表。 - 分享日誌前請脫敏（含會話標題與路徑）。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立索引，與 DeepSeek / 幻方無官方從屬關係，本文僅作技術介紹。
結尾¶
dsh-pet 把「當前屏幕」變成可投遞給指定會話的上下文，用浮窗和氣泡縮短「問 DSH 看不見的地方」的路徑。需要索引與簡介時可打開 SkillHub 插件頁，安裝與排錯以 GitHub 倉庫 README 爲準。
