前言¶

在 DeepSeek Harness（DSH）里長時間和智能體對話時，界面往往只有輸入框、狀態行和滾動內容，缺少「會話正在進行」的輕量反饋。VS Code 在官方 chat pet 文檔裏提供了 Blobby：會盯光標、會在思考時冒氣泡、會在回合結束時慶祝。社區插件 vscode-pet（維護者 96274zxc）把同一套官方雪碧圖、幀時序和交互規則移植到 DSH Web 輸入框上方，而不是另畫一個相似形象。下面介紹它是什麼、能做什麼、如何安裝，以及使用時需要注意的差異。

這是什麼¶

vscode-pet 是 VS Code 官方聊天寵物 Blobby 在 DSH Web Composer 上的非官方移植，npm 包名 vscode-pet，當前版本 1.2.27（MIT 許可證）。素材與邏輯來自 microsoft/vscode 中 chat pet 實現，上游 commit 鎖定爲 ce233327f26ef7791b7fff0143c24e81a8126bd2；完整派生文件清單見倉庫 NOTICE.md。它不是 Microsoft 或 DeepSeek 官方產品。

插件通過 Cordis patch 注入 Web 客戶端，依賴 DSH >=0.2.1-rc.1，在 SkillHub 社區目錄中歸類爲「趣味換裝」：96274zxc/vscode-pet。SkillHub 是獨立社區站點，與 DeepSeek / 幻方無官方從屬關係；安裝插件仍走 DSH 自身的 profile 與 bundle 機制。

核心功能¶

聊天與狀態反應¶

寵物浮在輸入框（composer）上方，隨會話變化：

• 目光跟隨指針；你在輸入時播放打字動畫；智能體處理中顯示思考氣泡（氣泡頂部錨在「深度求索」狀態行上方的分隔線，佈局或縮放變化時會重算）。
• 需要用戶確認時鼓掌；空閒約 20 秒後睡覺；單輪請求完成時播放按紅色按鈕的慶祝動畫。

拖拽、投擲與物理¶

• 可拖拽；帶速度鬆手會投擲；Shift+← / Shift+→ 朝兩側牆投擲；← / → 沿輸入框跳躍。
• 下落過程中用指針接觸或 Enter / 空格可彈跳；掉出落腳區會走官方風格的傳送門消失/重生。
• DSH 窗口可見時，落腳範圍以輸入卡片上沿爲界，重生下落高度也限制在卡片上方，而不是從整頁聊天頂部落下。

裝扮與小遊戲¶

• 右鍵菜單：帽子、顏色、跳跳樂、跑路 / 回來，以及內聯的縮小/放大與恢復大小。
• 官方 13 頂帽子，加上「顏色自定義」與 DSH 專屬的「不戴帽子」，共 15 個卡片、3 列布局；計數文案沿用 VS Code 的 “14 of 14 unlocked”，但 DSH 移植版不追蹤成就，所有帽子默認解鎖，初始爲 Insiders 配色 + 牛仔帽，不顯示解鎖條件與「新」標記。
• 顏色支持穩定版/預覽版、8 個官方純色預設與自定義十六進制；偏好寫入本地 localStorage['dsh.vscode-pet.prefs.v1']，不跨設備同步。
• 跳跳樂：空格蓄力起跳，左右瞄準，Esc 退出；含平臺、計分與本地最高分。

桌面顯示（僅 Windows 桌面端）¶

在 Windows 的 DSH 桌面應用中，右鍵可勾選 桌面顯示 與 智能隱藏。DSH 最小化、隱藏或被其他窗口遮住時，寵物可通過傳送門切到任務欄上方活動；重新聚焦 DSH 則回到窗口內。雙擊桌面上的 Blobby 可喚起 DSH 窗口。Web 版與非 Windows 環境不顯示相關菜單項，Host 也不會啓動桌面 helper。

與 VS Code 原版的差異（移植說明）¶

README 明確列出：DSH 版 不追蹤成就；VS Code 專屬的 painting/searching 狀態與鍵盤跳不適用；跳跳樂在 DSH 內打開。目錄簡介裏若提到 achievements，應以倉庫說明爲準——此處無成就進度，只有裝扮與反應玩法。

安裝與啓用¶

倉庫說明：當前 npm 包因發佈賬號 2FA 安全凍結暫未發佈，優先從 GitHub 安裝。

先做 Web profile 安裝（命令來自 README.zh.md）：

dsh plugin --profile web add github:96274zxc/vscode-pet

npm 恢復發佈後，同一 profile 可改爲：

dsh plugin --profile web add vscode-pet

Electron 桌面端可在 插件 → 添加插件 中填寫 vscode-pet，或在允許管理 desktop profile 的環境中使用相同 CLI 並指定 --profile desktop。安裝後把 bundle 啓用並刷新頁面；部分桌面端若未熱加載新 Loader，需重啓一次應用。

典型用法¶

寵物啓用後，多數操作在輸入框區域完成。Slash 命令與常用鍵位如下（摘自官方使用表）：

單擊、Enter 或空格可觸發隨機反應或喚醒睡覺中的 Blobby；約 1% 的點擊會觸發 yapping（摔倒張嘴），屬於官方 sprite 設計，不是缺圖。

適用場景與注意¶

適合誰：希望在 DSH 對話界面保留 VS Code 同款 Blobby 反饋、並願意用右鍵菜單換裝或玩跳跳樂的用戶；Windows 桌面用戶若常最小化 DSH，可評估「桌面顯示」是否值得開啓 helper 進程。

運行與權限：插件以當前 DSH 進程及其 Host 權限運行。窗口內功能僅使用客戶端 API（如 conversation.input.dock）；桌面顯示在 Windows 上會通過 Host 鑑權路由 /api/blobby/desktop/* 啓動本地 PowerShell/.NET WPF helper，不註冊模型工具，helper 只接收本地生成的幀與幾何信息、不訪問網絡。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認可接受本地 helper 與 localStorage 持久化。

生態：DSH 理念是「一切皆插件」；本插件不修改 DSH 核心或其他插件。調試時可加 ?blobbyDebug=1 或使用 localStorage["dsh.vscode-pet.debug"]="1"，通過 window.__dshBlobby.memory() 查看客戶端內存診斷（詳見 README）。

結尾¶

vscode-pet 把 VS Code 官方 Blobby 的 sprite、物理和聊天反應接到 DSH 輸入框上，並在此基礎上提供帽子、顏色、跳跳樂與（Windows 桌面端）任務欄旁駐留。若要從社區目錄跳轉說明頁，見 SkillHub：96274zxc/vscode-pet；源碼、NOTICE 與中文 README 見 GitHub：96274zxc/vscode-pet。