前言¶

DeepSeek Harness（DSH）的核心理念是“一切皆插件”，開發者可以通過擴展來定製工作流。對於習慣長時間在終端或 Web 界面工作的開發者而言，屏幕上的反饋往往只有文字輸出，缺乏交互感。dsh-ds-vpet 插件旨在通過仿《虛擬桌寵模擬器》的交互體驗，爲 DSH Web 界面提供一個可視化的陪伴對象，同時兼顧實用功能。

插件簡介¶

dsh-ds-vpet（DSH 虛擬桌寵）由開發者 Kotegawa-Chisa 維護。這是一款基於 DSH Web 環境的客戶端插件，不涉及 DSH 核心邏輯的修改。它通過立繪切換、氣泡對話和桌面交互，模擬虛擬桌寵的行爲模式，支持通過 API 查詢賬戶餘額並提供視覺反饋。

核心功能¶

1. 多狀態立繪與交互

   • 立繪切換：支持常態、等待（隨機 2 選 1）、思考完成慶祝三種狀態，立繪會隨狀態自動變化。
   • 點擊互動：點擊人物可觸發連擊喵叫。
   • 拖拽與縮放：支持按住鼠標拖拽移動（拖拽時人物會有變形效果），使用鼠標滾輪可調整大小（30% 至 300%）。

2. 定時與對話系統

   • 按時說話：內置 8 個時間段（早晨、午休、深夜等）的專屬臺詞。
   • 雙語支持：所有臺詞支持中英文實時切換。
   • 思考檢測：當 DSH 模型處於思考狀態時，插件會監聽狀態變化；思考結束後，立繪會自動切換至慶祝狀態並發表評論。

3. 實用工具

   • 餘額計數器：通過 DEEPSEEK_API_KEY 憑據查詢賬戶餘額，實時顯示在界面上。當餘額低於設定的預警值時，計數器會變紅。
   • 齒輪設置：提供深藍色主題的設置面板，可配置最上層顯示、餘額計數器開關、隱藏/喚出桌寵、說話頻率以及語言偏好。

4. 自定義

   • 立繪替換：插件依賴 assets/ 目錄下的 PNG 文件。用戶可自行替換 1.png（常態）、2.png 和 3.png（等待）、4.png（慶祝）來更換立繪形象。

安裝與啓用¶

在安裝前，請確保已正確安裝 DeepSeek Harness，且 dsh web 服務能夠正常啓動。

1. 本地路徑安裝（推薦）

將倉庫克隆或下載到本地後，使用絕對路徑添加插件：

dsh plugin --profile web add /絕對路徑/dsh-ds-vpet

2. GitHub 子路徑安裝

dsh plugin --profile web add 'github:<你的用戶名>/dsh-ds-vpet#path:/'

3. 安裝後配置

1. 重啓服務：新增插件必須重啓 dsh web 才能加載。
2. 刷新頁面：在瀏覽器中刷新頁面（Ctrl+F5），桌寵通常會出現在頁面右下角。
3. 進入設置：打開 DSH 設置，找到「桌寵」選項卡，根據需要調整立繪大小、說話頻率、語言等參數。

典型用法¶

• 日常陪伴：插件會根據當前時間自動觸發問候或提醒臺詞。
• 餘額監控：在設置中開啓餘額計數器，實時關注 API 使用額度。
• 更換形象：將準備好的透明背景 PNG 圖片放入插件目錄的 assets/ 文件夾，保持文件名不變（如 1.png），刷新頁面即可生效。

注意事項¶

• 純展示層插件：該插件屬於客戶端插件，僅負責界面展示和交互，不修改 DSH 核心代碼。
• API 依賴：餘額計數器功能依賴於環境變量 DEEPSEEK_API_KEY，若未配置該憑據，餘額顯示將不可用。
• 素材來源：內置立繪素材來源於網絡，用戶自行替換時需注意素材版權。
• 緩存機制：餘額查詢結果有 30 秒的緩存刷新週期。

總結¶

dsh-ds-vpet 是一款結合了娛樂性與實用性的 DSH 插件。它通過模擬虛擬桌寵的交互方式，解決了長時間使用命令行工具的單調感，同時通過餘額監控等功能輔助開發決策。開發者可以根據自身需求，通過替換素材和調整配置，將其打造爲專屬的代碼伴侶。

GitHub 倉庫 | 社區目錄