前言¶

DSH 的理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。如果經常在 dsh web 中使用 Harness，需要快速看到當前會話是等待、思考、運行工具還是出錯，Harness Pet 提供了一個較輕量的頁面內觀察方式：在 Harness 頁面中渲染一隻像素鯨魚，並響應 DSH 客戶端運行時暴露的結構化會話信號。

下面介紹 cakeni/harness-pet 的定位、安裝方式和已覈實用法。

這是什麼¶

Harness Pet 是一個原生 DSH web 插件，不是瀏覽器擴展。它在 Harness 頁面中渲染像素鯨魚，用九種視覺狀態映射會話狀態，並在鯨魚上方顯示最新本地用戶 prompt、Harness 回覆和進度。

倉庫信息：

• 倉庫：cakeni/harness-pet
• 許可證：MIT
• 定位：非官方社區項目，未與 DeepSeek 關聯、背書或由其維護。

核心功能¶

• 支持九種視覺狀態：idle、thinking、working、searching、bash、editing、waiting、error、success。
• 在鯨魚上方顯示最新本地用戶 prompt、Harness 回覆和進度。
• 點擊鯨魚可播放鰭部波浪；拖拽可移動位置，位置保存在 localStorage。
• 提供尺寸、透明度、啓用/禁用、重置位置和減少動態控制。
• 支持 English、Simplified Chinese、Japanese、Korean 界面即時切換。
• 可選 Chromium 桌面窗口模式，將寵物保持在 always-on-top Document Picture-in-Picture 窗口中。
• 支持調試狀態覆蓋、自動狀態循環和即時狀態徽章。
• 無遙測，不向第三方發送對話數據。
• 插件不獨立發起 fetch、分析、遙測、雲同步或第三方請求。
• 僅在瀏覽器 localStorage 保存設置，不請求瀏覽器權限。
• 顯示中的對話文本不會被持久化。

安裝與啓用¶

前置條件¶

要求 Harness 0.1.0-rc.6，並且 pnpm 在 PATH 中。

npm 包名保留給未來發布；未發佈前使用 Git 或本地鏈接安裝。瀏覽器擴展模式不支持。

Git 安裝¶

先執行下面的命令，從 GitHub 安裝插件：

dsh plugin --profile web add github:cakeni/harness-pet

安裝或移除插件後，需要重啓 dsh web 進程。經過上面的步驟，重啓進程後即可在 Harness 頁面中使用該插件。

pnpm prepare 構建被阻止¶

如果 pnpm 阻止 prepare 構建，在 profile 的 pnpm-workspace.yaml 中添加：

allowBuilds:
  harness-pet: true

然後重複上面的安裝命令。

本地開發鏈接安裝¶

從倉庫父目錄運行：

dsh plugin --profile web add link:../harness-pet

同一 profile 不要運行多個 link 安裝。

開發構建¶

在倉庫中執行：

pnpm install
pnpm run typecheck
pnpm test
pnpm bundle

如果只是重新構建當前目錄，也可以進入插件目錄後執行：

cd harness-pet
pnpm bundle

典型用法¶

1、點擊鯨魚播放鰭部波浪；拖拽移動鯨魚，位置保存在 localStorage。

2、雙擊、長按或點擊齒輪按鈕打開設置。

3、在設置中選擇 Language，即時切換界面語言；支持 English、Simplified Chinese、Japanese、Korean。

4、使用設置控制尺寸、透明度、啓用/禁用、重置位置和減少動態。

5、啓用 Open Floating Pet 後，主 Harness 窗口可最小化，寵物保留在獨立 always-on-top 窗口中；桌面窗口模式需要 Chromium 116+ 的 Document Picture-in-Picture，不支持的瀏覽器會保持該控制禁用。

6、點擊灰色 follow-up 圖標打開輸入框；Enter 提交到當前 Harness session。

適用場景與注意¶

適合使用 DSH web 插件，希望在 Harness 頁面內觀察會話狀態、查看最新 prompt、Harness 回覆和進度，並本地調整尺寸、透明度和動態效果的人。

注意事項：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴和許可證。
• 非官方社區項目，未與 DeepSeek 關聯、背書或由其維護。
• 後續 0.1.x 預發佈版本未驗證；客戶端 API 在 1.0 前可能變化。
• 插件不獨立發起 fetch、分析、遙測、雲同步或第三方請求。
• 顯示中的對話文本不會被持久化。
• 僅設置保存在瀏覽器 localStorage，插件不請求瀏覽器權限。

結尾¶

Harness Pet 的價值比較集中：它是原生 DSH web 插件，用九種狀態把 Harness 會話信號映射成像素鯨魚，同時提供本地設置、懸浮窗口和調試控制。安裝前仍應檢查源碼與許可證。

倉庫鏈接：

• GitHub：https://github.com/cakeni/harness-pet