dsh-columbina-pet

哥伦比娅 2D live 桌宠 · DeepSeek Harness 插件

四套形象 · 76 句三语原声台词 · 天气播报 · 真实物理 · 表情包时刻

这是什么

把愚人众第三席「少女」哥伦比娅放进 DeepSeek Harness 的桌面：她会浮在窗口最上层，被拖动时有真实的物理摆动，会按时间与场景轻声说话，会用官方原声念出台词，也会播报今天的天气。

本仓库是 dsh-pet（MIT）的2D 专用分支：保留并深化了 2D live 形象、语音台词、菜单与物理，移除了尚未完善的上游 3D 形象切换，补上了天气播报与开源所需的文档、占位与版权说明。

英文简介：A 2D live desktop pet of Columbina for DeepSeek Harness — four sprite sets, 76 official voice lines in zh/ja/en with synced subtitles, weather reports, and real physics. 3D mode from upstream has been removed on purpose. See NOTICE.md for asset licensing.

预览

天气菜单	表情时刻

特性

四套 2D live 形象：official（官方表情包）、nochoker（去眼罩）、open（带眼罩·睁眼）、closed（带眼罩·闭眼）。右键菜单「2D live 形象」即时切换，每套自带待机 / 点击 / 拖拽 / 事件动作树（共 246 个 webm）。
三语原声台词：76 句哥伦比娅官方语音，按中 / 日 / 英整理为 94 段切片。配音语言与字幕语言分开设置；有声音必有字幕，一句长台词会按播放进度分段换字幕。
按场景碎碎念：问候、午夜、安慰、感谢、提问、玩耍、友人、睡前、认真、俏皮十组场景池，按时间与近期出镜率抽签，不连续重复；开局前 12–22 秒保持安静。
工作气泡优先：正在向用户汇报时，桌宠不会抢走气泡；它的话结束后自动把气泡还给工作状态。
天气播报（v10.4）：菜单「天气 → 今天的天气」，先用气泡给出摘要（城市、天气、当前温度、今日温度区间），隔一拍再用原声台词接一句应景的话；断网时给一句兜底台词，不会卡死。
真实物理：拖拽甩出弧度、松手下落、落地回弹、窗口贴边停靠，参数全部可配。
菜单即设置：切换间隔、2D live 形象、语言（配音 / 字幕 / 菜单）、模型大小 0.5–3×、原声台词勾选、碎碎念开关，菜单本身也随语言切换。
时刻表情包：12 张心情图（好耶 / 抱抱 / 期待 / 出发 / 好吃 / 思考 / 睡觉 / 困了 / 贴贴 / 唱歌 / 谢幕 / 晚安），由台词标签与场景挑选。

环境要求

项	要求
DSH	0.2.x（已在 0.2.1-rc.2 桌面版长期使用）
Node.js	≥ 22.12
系统	Windows / macOS / Linux
Electron	43.3.0（首次运行自动下载，或手动 `node scripts/ensure-electron.mjs`）

安装

ℹ️ 可以与上游 dsh-pet 并存（1.0.4 起）：本插件的路由前缀、bridge scheme、用户目录、会话身份都已迁到 dsh-columbina-pet* 命名空间，不再和上游抢 /dsh-pet-7340。为兼容旧书签仍会尝试注册旧前缀，旧前缀被上游占用时静默跳过。

通过 DSH 插件管理安装（推荐）

打开 DeepSeek Harness 桌面端 → 设置 → 插件 → 添加插件
在输入框里粘贴仓库地址：
```
github:Yuanawaqwq/dsh-columbina-pet
```
也可以贴完整地址 https://github.com/Yuanawaqwq/dsh-columbina-pet。
安装完成后完整退出 DSH 再打开（关窗口、刷新页面都不算重启）。
第一次桌宠没出现，说明本机还没有 Electron 运行时：按提示再重启一次，或手动运行
```
node node_modules/dsh-columbina-pet/scripts/ensure-electron.mjs
```

手动装进 profile

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

然后把它加进 profile 的 package.json：

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

完整退出 DSH 再打开（关窗口、刷新页面都不算重启）。

从 GitHub 安装

cd ~/.dsh/profiles/<你的 profile>
npm install github:Yuanawaqwq/dsh-columbina-pet

从本地源码安装

cd ~/.dsh/profiles/<你的 profile>
npm install file:C:\path\to\dsh-columbina-pet
# 或 Linux/macOS
npm install file:/path/to/dsh-columbina-pet

说明：仓库自带约 150 MB 的 2D 形象与语音素材，打包后超过 180 MB。npm 公共仓库对包体积有上限，建议用上面的 GitHub 安装方式，或发布 GitHub Release 附 tar 包；也欢迎你替换成自己的素材后瘦身再上架。

国内网络加速（可选）

先看一眼自己走哪条线更快（数字越小越快）：

curl -o /dev/null -s -w 'github %{time_total}s
' https://github.com
curl -o /dev/null -s -w 'npmmirror %{time_total}s
' https://registry.npmmirror.com

如果 github 明显慢于 npmmirror，按下面的镜像走：

环节	常规地址	国内镜像写法
插件安装	`github:Yuanawaqwq/dsh-columbina-pet`	`https://ghfast.top/https://github.com/Yuanawaqwq/dsh-columbina-pet`（或把前缀换成 `https://gh-proxy.com/`）
依赖安装	`npm install`	`npm install --registry=https://registry.npmmirror.com`
Electron 运行时	`node scripts/ensure-electron.mjs`	先设 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/`，再运行同一命令
语音包（外置素材）	`node scripts/ensure-voice.mjs`	`DSH_VOICE_PACK_URL=https://ghfast.top/https://github.com/Yuanawaqwq/dsh-columbina-pet/releases/download/v1.1.0/dsh-columbina-pet-voice-1.1.0.tar.gz node scripts/ensure-voice.mjs`

Windows PowerShell 里设置环境变量：

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:DSH_VOICE_PACK_URL = "https://ghfast.top/https://github.com/Yuanawaqwq/dsh-columbina-pet/releases/download/v1.1.0/dsh-columbina-pet-voice-1.1.0.tar.gz"

镜像都是第三方服务，可用性会变；下载失败就换一个前缀，或直接走仓库自带的 dsh-columbina-pet-*.tar.gz（Release 附件里另有一份完整包）。

素材外置（可选，1.0.2+）

素材可以从插件目录里搬出去，放在 ~/.dsh/columbina-pet/assets/：宿主按「外置根优先、包内兜底」读取，形象、表情包、字体、图片与 config.jsonc 都适用。

# 复制到外置根（保留包内原文件）
node scripts/migrate-assets.mjs
# 校验后删除包内素材（插件目录立即瘦身）
node scripts/migrate-assets.mjs --move

健康检查

宿主在 GET /dsh-pet-7340/healthz 暴露一次自检：版本、Electron 路径、Helper 是否在跑、素材根，以及最近的启动错误（launch-error.json）。排障时先看它：

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

assetRoots.externalActive 为 true 且 externalFileCount > 0 时，说明外置素材已经命中（1.0.3+）。

第一次启动

首次使用需要 Electron 运行时（约 100 MB，从 npmmirror 下载，可用环境变量换源）：

node node_modules/dsh-columbina-pet/scripts/ensure-electron.mjs
# 可选环境变量：DSH_PET_ELECTRON_VERSION / DSH_PET_ELECTRON_MIRROR

下载好后桌面会出现哥伦比娅；右键她可以打开全部设置。

右键菜单

菜单	作用
切换间隔	碎碎念与动作的间隔（常说话 / 适中 / 安静 / 很安静 / 只动手）
2D live 形象	四套形象即时切换
语言	配音语言、字幕语言、菜单语言分别切中 / 日 / 英
模型大小	0.5× – 3×，窗口限制在屏幕工作区内
天气	今天的天气 / 重新定位
原声台词	按场景分组勾选允许说的句子；「打开设置面板」看完整清单
碎碎念设置	开 / 关桌宠主动说话

配置

配置分三层，后面的覆盖前面的：

包内默认：assets/config.jsonc
用户覆盖：~/.dsh/dsh-pet/main-config.jsonc（只写要改的键即可，pets 按 id 合并）
单只宠物覆盖：~/.dsh/dsh-pet/pet/<id>.jsonc

素材同样支持用户覆盖（优先于包内）：

素材	用户目录	包内目录
live 形象	`~/.dsh/dsh-pet/main-animation/webm/`	`assets/webm/`
表情包	`~/.dsh/dsh-pet/memes/`	`assets/memes/`
外置素材根（1.0.2+，优先级最高）	`~/.dsh/columbina-pet/assets/`	—

常用字段（assets/config.jsonc 内有完整注释与默认值）：

键	说明
`pets[].name` / `size` / `position`	名字、初始大小与出现位置
`physics`	重力、回弹、阻尼、贴边等物理参数
`animations`	动作树：待机、点击、拖拽、事件、动作分组
`memes`	表情包文件名与触发标签
`workStatusTexts`	会话工作状态气泡文案
`whisperPrompt`	桌宠人设（供对话 / 主动说话使用）

语音系统

语音是一个 classic script sidecar：runtime/electron-helper/voice/voice.js，在 Electron 页面里直接跑，不需要构建。

语音索引：runtime/electron-helper/voice/voice-index.js（window.__COLUMBINA_VOICE，含台词表、语义词组、四套 skins、表情包标签）。
音频：runtime/electron-helper/voice/official/<lang>/<n>.<ext>（76 句 × 三语），切片音频在 voice/clips/。
设置镜像：runtime/electron-helper/voice/voice-settings.js 是默认值的静态副本；菜单里的调整也会写进浏览器 localStorage（键 columbina-voice-local-v1）。
想加台词：在 voice-index.js 的 lines / menu 里加条目，把音频放进对应语言目录，重启桌宠即可。菜单标签会映射到台词下标，改标签别忘了同步改 menu。
想换角色：替换四套 webm 动作、assets/memes、voice/official/* 与 voice-index.js，再把 assets/config.jsonc 里的名字与人设改成你的角色。

「打开设置面板 / 选择台词」的侧边栏面板由姊妹插件 dsh-columbina-theme 提供，本仓库不含它。不装也能用右键菜单完成所有设置。

天气播报

定位：ipwho.is 的 IP 归属（城市、经纬度），只在需要时请求一次，缓存 24 小时。
预报：open-meteo.com 免费接口，取当前温度、湿度、风速、当日最高 / 最低温与 WMO 天气码，缓存 20 分钟。
城市名本地化：当字幕语言是中文且定位在中国时，用 open-meteo geocoding 反查中文城市名。
天气码 → 天气词 → 台词场景（雨 / 雷 / 雪 / 风 / 其他），再按字幕语言给出中文 / 日文 / 英文摘要。
断网或超时（9 秒）会弹一句兜底台词并结束，不阻塞后续交互。
调试接口：页面内 window.__columbinaVoice.weatherInfo(true) 返回当前天气对象，.weather() 触发一次播报。

目录结构

dsh-columbina-pet/
├─ lib/                    # 预构建的宿主与浏览器插件（DSH 实际加载这里）
├─ src/                    # TypeScript 源码（参考；构建配置未随包发布）
├─ runtime/electron-helper # 桌宠运行时：主进程、精灵、渲染、语音 sidecar
│  └─ voice/               #   voice.js、voice-index.js、官方原声与切片
├─ assets/
│  ├─ webm/                #   四套形象的动作素材
│  ├─ memes/               #   12 张时刻表情
│  ├─ fonts/               #   气泡字体
│  ├─ pic/                 #   光标与通知图标
│  ├─ preview/             #   README 预览图（不随 npm 包发布）
│  ├─ config.jsonc         #   默认配置
│  └─ logo.png             #   插件图标（≤256 KiB）
├─ scripts/ensure-electron.mjs
├─ cordis.patch.yml        # 挂载声明
├─ NOTICE.md               # 素材版权声明
└─ package.json

二次开发

lib/ 是打包产物，DSH 运行时加载的是它；src/ 只是源码参考。修改 src/ 后需要自己按 TS 工程重建 lib/（上游构建配置未随包发布）。
runtime/ 下是可直接改的 classic script，改完 node --check <file>.js 自检，重启桌宠即生效。
页面里调试：window.__columbinaVoice 暴露 state()、speak(text)、whisper(scene, force)、weatherInfo(force)、weather(force)、setLang、setScale、setSkin 等接口。

已知限制

本分支只含 2D 形象，上游的 3D 形象切换已移除。
assets/fonts/上首软糖体.ttf 是非开源字体；对外分发或商用前请确认授权，或替换成自己的字体。
官方语音、形象与表情属于同人二创素材，仅建议个人非商业使用，详见 NOTICE.md。
lib/ 与 src/ 可能存在版本差（以 lib/ 实际行为为准）。

致谢与版权

角色与素材：详见 NOTICE.md。
2D 形象：「官方表情包」版由本项目整理；「去眼罩 / 睁眼 / 闭眼」三套由 B站 UP 主 @渲琳使用 EmoteLab 制作，原作见【EmoteLab】捏了哥伦比娅和桑多涅！。感谢作者分享，如作者希望下架请联系移除。
主题与设置面板：dsh-columbina-theme。

License

MIT —— 代码部分。素材部分见 NOTICE.md。

dsh-columbina-pet

Install

README