前言¶

在 DeepSeek Harness（DSH）里長時間跑任務時，界面往往只剩日誌、氣泡和進度條，缺少一個固定在桌面、又能和宿主狀態互動的視覺錨點。通用桌寵插件可以填這個空，但若你更在意角色一致性、官方語音與可配置的 2D live 動作，就需要專門面向某一角色的分支實現。

下面介紹社區插件 dsh-columbina-pet（維護者 Yuanawaqwq）：把《原神》愚人衆第三席「少女」哥倫比婭做成浮在最上層的 2D 桌寵，接入 DSH 的氣泡與本地服務。它源自上游 dsh-pet（MIT）的 2D 專用分支——保留並加深 2D live、三語臺詞與物理交互，有意移除了尚未完善的上游 3D 形象切換，並補上天氣播報與素材版權說明（見倉庫 NOTICE.md）。在 SkillHub 目錄中歸類爲「趣味換裝」；GitHub 倉庫當前約 1 star。插件以 MIT 發佈，標註兼容 DSH 0.2.x，支持 Windows、macOS、Linux；package.json 當前版本爲 1.2.1，要求 Node >= 22.12.0。

這是什麼¶

一句話定位：哥倫比婭 2D live 桌寵 · DeepSeek Harness 插件——四套 sprite 形象、76 句中/日/英官方原聲臺詞（整理爲 94 段切片）、按場景自動碎碎念、天氣播報、拖拽物理與 12 張時刻表情包。

桌寵會浮在窗口最上層；拖動時有可配置的慣性、下落與貼邊停靠；正在向用戶彙報工作時，桌寵不會搶工作氣泡，說完再把氣泡還給任務狀態。配音語言、字幕語言、菜單語言可分開設置，有聲音必有字幕，長句會按播放進度分段換字幕（1.2.1 起碎碎念字幕跟音頻實際進度走，拖動寵物時字幕浮層同步移動）。

核心功能¶

四套 2D live 形象¶

右鍵「2D live 形象」即時切換，設置會記住：

標識	說明
`official`	官方表情包（640×360 VP9）
`nochoker`	去眼罩
`open`	帶眼罩·睜眼
`closed`	帶眼罩·閉眼

四套共 246 段 webm，各自帶待機 / 點擊 / 拖拽 / 事件動作樹。後三套爲 500×500 VP8 + alpha。

三語原聲與碎碎念¶

入口：右鍵「語言」分別設配音 / 字幕 / 菜單；「原聲臺詞」可全選、全不選或逐句勾選，偏好寫入 prefs.json。
碎碎念：十組場景池（問候、午夜、安慰、感謝、提問、玩耍、友人、睡前、認真、俏皮），按時間與近期出鏡率抽籤，間隔默認 90 秒（60–180 秒可調），啓動後前 12–22 秒保持安靜。
夜間勿擾（1.2.0）：預設時段內只擋自動碎碎念，手動點「原聲臺詞」照常播。
音量與靜音（1.2.0）：五檔 20–100 % 與一鍵靜音，桌面與網頁共用同一套設置。

天氣、表情與待機¶

右鍵「天氣 → 今天的天氣」：先用氣泡給出城市、天氣、當前溫度與今日區間（溫度帶 ℃），再隔一拍用原聲接一句；斷網有兜底臺詞。城市名按字幕語言本地化（1.2.0）。
時刻表情包：12 張心情圖，由臺詞標籤與場景挑選。
待機動作（1.2.0）：精選 / 當前形象全部 / 「自己選…」打開可搜索勾選列表；省電模式（默認關）在鼠標 30 秒不動時暫停在播視頻。

素材自檢、物理與餘額¶

設置面板「語音包與素材」：檢查語音切片 / 動作 / 表情數量，缺語音包可一鍵修復（宿主接口 GET/POST 前綴下的 voice/health、voice/repair；1.2.1 桌面端面板與網頁菜單已對齊）。
真實物理：拖拽甩出、鬆手下落、回彈、貼邊停靠；參數在 assets/config.jsonc 的 physics 段可調，網頁端也可開關「真實物理」。
右鍵「查看餘額」：默認模型對應 API Key 服務商但本機無 DEEPSEEK_API_KEY 時，自動改查 DSH 賬號餘額（1.2.0）。

npm 包內自帶約 147 MB 2D 與語音相關素材（1.2.0 起沿用 1.1.11 原始 webm）；外置語音包由 ensure-voice.mjs 拉取，voicePack 在 package.json 中聲明 URL 與 sha256。可選把素材遷到 ~/.dsh/columbina-pet/assets/（migrate-assets.mjs）。

安裝與啓用¶

插件與上游 dsh-pet 可並存（1.0.4 起命名空間爲 dsh-columbina-pet*，路由前綴如 /dsh-columbina-pet-7340）。安裝後務必完整退出 DSH 再打開（關窗口或只刷新頁面不算重啓）；升級 1.2.x 同樣如此。

通過 DSH 插件管理（推薦）¶

打開 DeepSeek Harness 桌面端 → 設置 → 插件 → 添加插件。
在輸入框粘貼倉庫地址：

github:Yuanawaqwq/dsh-columbina-pet

也可使用 https://github.com/Yuanawaqwq/dsh-columbina-pet。

若首次桌寵未出現，說明本機可能還沒有 Electron 運行時，按提示再重啓一次，或手動執行：

node node_modules/dsh-columbina-pet/scripts/ensure-electron.mjs

可選環境變量：DSH_PET_ELECTRON_VERSION、DSH_PET_ELECTRON_MIRROR（國內可設 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/）。

裝進 profile（npm）¶

在 profile 目錄安裝並把包名加入 dsh.profile.bundles：

cd ~/.dsh/profiles/<你的 profile>
npm install dsh-columbina-pet@1.2.0

或使用 GitHub specifier：

npm install github:Yuanawaqwq/dsh-columbina-pet

package.json 中需包含依賴與 bundle，例如：

{
  "dependencies": {
    "dsh-columbina-pet": "^1.0.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "dsh-columbina-pet"
      ]
    }
  }
}

裝完後同樣完整退出 DSH 再打開。國內網絡慢時，README 提供了 npm 鏡像、GitHub 代理前綴與語音包 DSH_VOICE_PACK_URL 等可選加速方式。

典型用法¶

安裝並重啓後，桌面應出現哥倫比婭；右鍵桌寵是主入口。常用項包括：切換碎碎念間隔、換四套形象、設三語、調模型大小 0.5×–3×、查天氣、勾選原聲臺詞、開關碎碎念與夜間勿擾、音量、待機動作、省電模式、素材檢查等。網頁模式與桌面共用形象與大部分設置，改動後仍需完整重啓 DSH。

排障時可查健康接口（端口以本機 DSH 爲準）：

curl http://127.0.0.1:<DSH 端口>/dsh-columbina-pet-7340/healthz

響應含 version、activatedVersion、buildSha256、needsRestart 等；亦可查看 ~/.dsh/columbina-pet/activation.json。語音包狀態不對時，可運行：

node node_modules/dsh-columbina-pet/scripts/ensure-voice.mjs

配置分層：包內默認 assets/config.jsonc → 用戶 ~/.dsh/dsh-pet/main-config.jsonc → 單寵 ~/.dsh/dsh-pet/pet/.jsonc；外置素材根 ~/.dsh/columbina-pet/assets/ 優先級最高（1.0.2+）。

適用場景與注意¶

適合誰：已在 DSH 上日常開發或跑智能體、希望桌面有角色化 2D 陪伴、且需要官方三語語音與天氣/碎碎念等輕交互的開發者。若只需要極簡佔位 widget，上游通用桌寵可能更輕；本插件 tarball 約 148 MB 量級，首次還需 Electron 運行時。

安全與合規：

插件以當前 DSH 進程權限運行，會起本地 HTTP 路由與 Electron Helper；1.2.1 起對跨站寫請求做了來源校驗（帶 sec-fetch-site: cross-site 且外站 Origin 會 403）。安裝前請閱讀源碼、MIT LICENSE 與 NOTICE.md 中的素材歸屬說明。
角色與語音素材版權歸相應權利人所有；本倉庫是社區二次封裝，與 DeepSeek、米哈遊等無官方從屬關係。DSH 社區目錄（如 SkillHub 插件頁）是獨立站點，並非官方應用商店。

運維提示：同一版本號重新打包後，若未重啓 DSH，healthz 的 needsRestart 可能爲 true；換包後務必完整退出再開。語音下載停滯可調環境變量 DSH_COLUMBINA_VOICE_STALL_MS（README 1.1.11 變更說明）。

結尾¶

dsh-columbina-pet 把哥倫比婭的 2D live、三語原聲、碎碎念、天氣與物理交互收進 DSH 插件形態，並與上游桌寵命名空間分離，便於和 dsh-pet 共存。若要瀏覽簡介或跟蹤版本，可看目錄頁與 GitHub 倉庫：

目錄頁：https://www.skillhub.cn/plugins/Yuanawaqwq/dsh-columbina-pet
GitHub：https://github.com/Yuanawaqwq/dsh-columbina-pet
版本明細與 Release 包：https://github.com/Yuanawaqwq/dsh-columbina-pet/releases

dsh-columbina-pet：DSH 上的哥倫比婭 2D 桌寵

前言¶

這是什麼¶

核心功能¶

四套 2D live 形象¶

三語原聲與碎碎念¶

天氣、表情與待機¶

素材自檢、物理與餘額¶

安裝與啓用¶

通過 DSH 插件管理（推薦）¶

裝進 profile（npm）¶

典型用法¶

適用場景與注意¶

結尾¶

精选优惠券

dsh-columbina-pet：DSH 上的哥倫比婭 2D 桌寵

前言¶

這是什麼¶

核心功能¶

四套 2D live 形象¶

三語原聲與碎碎念¶

天氣、表情與待機¶

素材自檢、物理與餘額¶

安裝與啓用¶

通過 DSH 插件管理（推薦）¶

裝進 profile（npm）¶

典型用法¶

適用場景與注意¶

結尾¶

精选优惠券

相關文章