前言¶

在 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）¶

典型用法¶

适用场景与注意¶

结尾¶

精选优惠券

相关文章