dsh-chubby-whale
Manifest validDesktop pet for the DSH web UI: a whale companion anchored in the page corner that can be dragged with position memory, blinks, chats on click, speaks with TTS, recites poems and tells stories, and li
dsh-chubby-whale(肥鲸)
LICENSE | NOTICE(版权与素材来源) | 素材许可说明(LICENSE-ASSETS)
徽章由 dsh.so 独立维护,仅作参考。
DSH 网页版桌面宠物:蓝发女仆鲸鱼娘,常驻 harness 页面右下角。可拖拽(带惯性、位置记忆)、会眨眼、能说话、能说书念诗弹琴,也能听懂你说话。
版权与素材来源:代码为 MIT 许可(Copyright (c) 2026 adengou); 角色立绘与全部背景图由作者 adengou 使用 seedream 5 系列模型(豆包)生成; 诗词与古籍原文均为公有领域作品,弹琴曲谱为传统/公有领域曲目。 详见 NOTICE。
| 渠道 | 地址 |
|---|---|
| 主仓库(GitHub) | https://github.com/adengou/dsh-chubby-whale |
| 镜像(Gitee) | https://gitee.com/adengou/dsh-chubby-whale |
| npm 包 | https://www.npmjs.com/package/dsh-chubby-whale |
| 更新日志 | CHANGELOG.md |
版本现状(2026-11-18 核查):GitHub 主仓库、Gitee 镜像与 npmjs 均为 1.10.3; 国内 npm 镜像可能滞后(同日核查为 1.10.2)。安装前请以各渠道实际版本为准,不要默认三渠道同版。
语音待命的信号处理设计与调参:见 docs/耳朵算法.md 发版规范(GitHub 必发;Gitee 与 npm 同步同一版本):见 docs/发布规范.md
鱼账本(2026-11-07 起):
/fishfood除 token 总量外,还会给出输入/输出拆分、缓存命中数与 人民币估算(按官方价目 × 高峰/空闲 × 缓存命中,价格来源与核对日期写在响应里)。 金额是估算、且只在拿到 usage 拆分时才计——拿不到就说「暂无可拆分用量」,不显示 ¥0.00 冒充花了 0 元。
安装(三种来源任选)
# ① npm 包(最省事,装发布版)
dsh plugin --profile web add "dsh-chubby-whale"
# ② 从 GitHub 装(主仓库)
dsh plugin --profile web add "git+https://github.com/adengou/dsh-chubby-whale.git"
# ③ 从 Gitee 装(镜像,连通时与 GitHub 同一版本)
dsh plugin --profile web add "git+https://gitee.com/adengou/dsh-chubby-whale.git"
# ④ 本地 link(开发调试)
dsh plugin --profile web add "link:C:\Users\<你>\.dsh\plugins\dsh-chubby-whale"
# 装完重启 dsh web
dsh web
桌面端(desktop profile)安装说明
注意:--profile desktop 不能用 CLI 安装。 DSH 会拒绝:
error: profile "desktop" is managed exclusively by the Electron application
这是 DSH 的设计——桌面 profile 由 Electron 应用独占管理。桌面端用户请按下面任一种方式安装:
方式 A(推荐,官方途径):打开 DSH 桌面端 →「设置 → 插件(市场)」→ 添加索引或搜索安装「肥鲸 · Chubby Whale」→ 启用 → 重启桌面端。
方式 B(手动注册,适合离线/内网):把插件包放进桌面 profile 的 node_modules,并在 ~/.dsh/profiles/desktop/package.json 里登记:
{
"dependencies": {
"dsh-chubby-whale": "link:C:/Users/<你>/.dsh/plugins/dsh-chubby-whale"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-chubby-whale" // ← 加这一行
]
}
}
}
然后彻底退出桌面端再重开(托盘图标右键退出,不是关窗口),肥鲸就会出现在右下角。
桌面端与网页版共用同一套插件代码与
data/;区别只在 profile 的注册方式。 如果安装后看不到肥鲸:先确认「设置 → 插件」里它是启用状态,再看桌面端日志里有没有dsh-chubby-whale的加载错误。
通过插件市场索引(方式五)
仓库根附一份符合 DSH 插件市场格式 1 的索引 market-index.json(已用官方 parseMarketIndex 校验通过):
- 打开 DSH「设置 → 插件市场」;
- 添加索引 URL:
https://gitee.com/adengou/dsh-chubby-whale/raw/main/market-index.json; - 在市场里找到「肥鲸 · Chubby Whale」,点安装即可(安装源固定到 Git 提交,可复现)。
装完刷新页面即可看到肥鲸。Key 一般不用自己配——肥鲸会按下面顺序找:
- 包外配置:
~/.dsh-chubby-whale/config.json(Windows 是C:\Users\<你>\.dsh-chubby-whale\config.json)——推荐,重装/升级插件都不会动它; - 环境变量:
CHUBBY_WHALE_DEEPSEEK_KEY(回退到通用的DEEPSEEK_API_KEY); - DSH 自己已配好的 Key:读
~/.dsh/.credentials.yaml里的refs.DEEPSEEK_API_KEY——桌面端 GUI 里配过 Key 的话,肥鲸直接复用,不用再配。
包外配置文件的写法:
// ~/.dsh-chubby-whale/config.json(包外,重装不丢)
{
"deepseekKey": "sk-..." // 聊天 + 语音识别(官方 ASR),一个 Key 全包
}
为什么不再推荐放在插件包里:插件包目录(
<profile>/node_modules/dsh-chubby-whale)在重装/升级时会被整体替换,放在里面的config.json会被覆盖丢失(2026-11-16 实际发生过)。 现在的读取顺序是「包外配置 → 环境变量 → DSH 凭据」,包里那份只作最后兜底。
2026-11-14 起不再需要旧 ASR Key:语音识别改走 DeepSeek 官方
/v1/tools/asr, 旧配置里残留的旧 ASR字段会被忽略,不影响启动。
自我进化(可选,都能关)
肥鲸会随成长学一点东西,两个开关默认开启,写进 config.json 即可关闭:
| 配置键 | 默认 | 作用 |
|---|---|---|
personalityLearning | true | 每 20 次真实回复、且距上次 ≥6 小时,从最近对话里提取主人的口头禅 / 偏好 / 备注(各有条数与字数上限;名字、家人、生日、语言规则等核心设定锁死,永不自动改) |
personalityWriting | true | 每 20 次真实回复、且距上次 ≥24 小时,写一句**≤80 字的「近期心境」**;输出里若出现「我是 / 改名 / 爸爸 / 妈妈 / 生日 / AI」等身份词,整句丢弃不写盘 |
asrLanguage | zh | 语音识别语言:zh / en / auto;zh 时纯外语输出一律当噪声丢弃(2026-11-07 起生效) |
- 存储:
~/.dsh-chubby-whale/personality.json(原子写;坏文件自动隔离为.bad-<时间戳>;只保留最近 20 条变更历史); - 查看:
GET /api/chubby-whale/personality; - 回滚:
POST /api/chubby-whale/personality/revert(一次撤一条,可连按;也支持回滚「近期心境」); - 关掉后已存内容仍会注入,只是不再学习、不再写新心境。
本地开发(link 方式)
dsh plugin --profile web add "link:C:\Users\<你>\.dsh\plugins\dsh-chubby-whale"
卸载
dsh plugin --profile web remove dsh-chubby-whale
运行数据在 ~/.dsh-chubby-whale/(记忆、亲密度、成长、鱼粮、提醒、缓存),卸载插件不会删它。
功能
| 分类 | 能力 |
|---|---|
| 陪伴 | 立绘常驻右下角、拖拽惯性、位置记忆、自动眨眼、说话时嘴动、喂食冒爱心、情绪表情(🐳待机 / 🍚饿 / 💤困 / ✨兴奋 / 💗害羞 / 💢生气 / 🍙护食) |
| 聊天 | 气泡对话(DeepSeek),人设固定(名字/爸妈/生日/出生地),支持中英双语,长期记忆摘要;流式与普通路径同口径记账(亲密度/经验/摘要);聊天框自动聚焦 |
| 语音 | 文字转语音(9 种音色、可关、可停)、语音待命(常驻听写)、语音聊天开关;稿子分段合成并导出 mp3 + srt 逐句字幕(支持 txt/md/json/log/csv/docx,单次 ≤20000 字);时长估算按语种分离(中文按字/英文按词) |
| 文化 | 说书(17 本古籍,念原文、进度记忆、不重复、进度按数据源隔离)、念诗(737 首)、典故(261)、成语(834)、民间故事(696)、对联(51 副 11 类);选本书 ▸ 书单、今日一句、今日简报 |
| 音乐 | 11 首曲子 Web Audio 合成播放(含升降号与低/高音) |
| 工具 | 提醒(口语时间:9点 / 明天9点 / 半小时后 / 每天8点;管理面板:回数字删除、回 d 顺延 10 分钟)、看图、拖文件(图片识别 / 文本总结)、成长与亲密度、鱼粮账本、余额、清除记忆、数据导出/导入、使用统计 |
| 官方全家桶 | OCR(截图/表格/PDF 取准确文字,拖图时自动先取字再问答)、文件解析(拖入 PDF/Word/PPT 由官方服务端解析后整份问答)、联网搜索(菜单开关,默认关;问到实时的事会查网页并附来源) |
| 天气 | 问「上海今天天气怎么样」「北京天气」→ 宿主查 wttr.in(免费、不需 Key),气泡 + 朗读,按温度给一句穿衣提醒;查不到就说没查到,不编温度;「天气晚来秋」这类诗句不劫持 |
| 感知 | 神经感知(可一键关):只读感知主人活动、昼夜与宿主事件(session/event、agent/status),归约成「唤醒 × 心情」二维情绪再映射表情;事件流本地环形缓冲,宿主事件带冷却与会话聚焦;夜潜把昨天的事件反刍成一句梦话(数据不足就闭嘴) |
| 界面 | 界面语言(中文默认 / 英文)、右键菜单键盘导航(↑↓/Enter/Esc)、「让它游走」可逆(右下角「○」或 Ctrl+Shift+W 恢复)、多标签页各自独立 |
手机简版(/whale-mobile)
同一个插件里自带一个手机端简版页面:聊天 / 文化 / 提醒,安卓优先,纯静态无构建。
# 装好后打开(本机)
http://127.0.0.1:<端口>/whale-mobile/
# 手机(同一局域网,dsh web 用 --host <电脑IP> 启动)
http://<电脑IP>:<端口>/whale-mobile/
- 装了本插件、电脑端 dsh web 开着,手机浏览器打开
http://<电脑IP>:<端口>/whale-mobile/即可 - 文化:说书(17 本古籍连载,逐段推进)、念诗(737 首)、典故、成语、民间故事、对联、今日一句 + 今日简报——与桌面端同一套数据与接口- 模型与 Key 复用本插件自己的(
config.json的deepseekKey,逐级回退到环境变量) - 数据落在
$DSH_HOME/whale-mobile/state.json(与桌宠的data/分开) - 页面顶部会自述依赖:电脑端 dsh web(硬依赖)+ 伴生桌宠版本
- 关掉:
config.mobile === false,或删掉mobile/与dist/host/mobile.js - 扩展说明(路由、数据、怎么加分类/加标签页):docs/MOBILE.md
- 手机访问 / 麦克风限制 / 双入口脚本:见 docs/MOBILE.md 第 9 节(scripts/lan-proxy.mjs)
它不是独立 App:离开电脑端的 dsh web 进程,页面只剩空壳。
语音功能的前置条件
| 能力 | 要求 | 说明 |
|---|---|---|
| 说话(TTS) | 电脑端装了 python + edge-tts | 没装时页面提示,文字聊天不受影响 |
| 听你说话(录音) | 页面必须是安全上下文(HTTPS,或 http://localhost) | 浏览器规定:http:// + 局域网 IP 时 navigator.mediaDevices 直接不可用 |
| 转文字(ASR) | config.json 配了 deepseekKey | 走 DeepSeek 官方语音识别(只收 WAV,页面会自动转码) |
录音在手机上打不开,不是手机的问题,是 http://192.168.x.x 不算安全上下文。通用解法(不涉及任何私有域名):
- 电脑上用:
http://127.0.0.1:<端口>/whale-mobile/属于安全上下文,麦克风直接可用 - 手机上用快捷键:浏览器地址栏固定页面的"添加到主屏幕"不改变协议,仍然不能用;改用输入法自带的语音键
- 要在手机上用页面录音:给 dsh web 配 HTTPS(
dsh web --tls-cert <证书> --tls-key <私钥>),或走你自有的 HTTPS 反代;只代理/whale-mobile/与/api/chubby-whale/,别把整个 dsh 暴露到公网
目录结构
dsh-chubby-whale/
dist/ 编译产物(已提交,安装无需构建)
src/ 源码(TS)
data/ 内容数据(必需,33MB)
story/ 17 本古籍 JSON
culture/ 典故 / 成语 / 民间故事
poems.json 737 首诗
melodies.json 11 首曲子
assets/ 立绘
cordis.patch.yml 插件注册配置
依赖
| 依赖 | 用途 | 必需性 |
|---|---|---|
| Node.js ≥ 22 | 运行宿主端 | 必需 |
config.json 的 deepseekKey(或环境变量 CHUBBY_WHALE_DEEPSEEK_KEY / DEEPSEEK_API_KEY) | 聊天、总结、语音识别、OCR、文件解析、联网 | 聊天与语音必需 |
Python 3 + edge_tts(pip install edge-tts) | 语音合成 | 语音必需 |
官方能力按量计费(同一个 DeepSeek Key,无额外 Key):OCR 与文件解析 1.5 元/1000 页,联网搜索/抓取 5 元/1000 次,语音另计;聊天 token 之外的费用都记进鱼粮账本。
没有 Key 也能用:说书、念诗、典故、成语、民间故事、弹琴、提醒、成长全部离线可用,不消耗 token。
首次安装没有 Key 会怎样(实测行为):
- 插件照常加载,不报错、不阻止使用离线功能
- 没配 DeepSeek Key:页面加载后会提示一次「还没配 Key」;聊天时回复会明确说缺 Key(不发模型请求)
- 语音识别也用同一个 DeepSeek Key:没配时开语音后第一次识别会提示一次,并停止继续上传识别(不会反复重试、不刷屏);打字和离线功能不受影响
- 语音合成(edge-tts)不需要 Key;若本机 python 环境缺依赖,客户端会自动回退浏览器朗读
安装
dsh plugin --profile web add link:<本目录>
然后重启 dsh web。首次打开页面点一下任意位置(浏览器要求用户手势才能开麦克风)。
配置
把 config.example.json 复制成 config.json,放在插件包根目录(见上方安装方式;config.json 已被 git 忽略,不会误提交):
{
"deepseekKey": "",
"dataSource": "local"
}
Key 读取优先级:config.json → 专属环境变量(CHUBBY_WHALE_DEEPSEEK_KEY)→ 通用环境变量(DEEPSEEK_API_KEY)。
本插件刻意不读 ~/.dsh/.credentials.yaml,避免与其他插件互相牵连。
数据源:本地 / 云端
说书、念诗、典故、成语、民间故事、对联的数据来自 DataPort,默认读插件包内 data/。
把 dataSource 改成 cloud 后,改为按需从你自己部署的文化数据服务拉取(地址由 cloudBase 配置提供,仓库不内置任何域名):
{
"dataSource": "cloud"
}
local(默认):完全离线,行为与旧版一致。cloud:首次用到某本书/某类文化才下载,进程内缓存;清单manifest.json的version+generatedAt变化后才失效重拉。网络失败自动回退本地data/,日志记一条CLOUD-DATA-FAIL,60 秒内不再重试网络,错误不会冒到前端。- 环境变量兜底:
CHUBBY_WHALE_DATA_SOURCE=cloud。优先级:cordis 配置config.dataSource→config.json→ 环境变量 →local。 - 说书进度、念诗/文化已读记录仍写
~/.dsh-chubby-whale/,与数据源无关;前端接口与返回结构不变。 - 对联目前由前端内置库直接使用(构建时编入
dist/client.js),不经过宿主路由;DataPort.readDuilian()已备好,但切换数据源不会替换前端对联库。
插件开关
cordis.patch.yml 里的 config.enabled 是本插件的总开关(默认 true):
- insert:
- id: chubby-whale
name: dsh-chubby-whale
config:
enabled: false
改成 false 后重启 dsh web:宿主端不再注册任何 /api/chubby-whale/* 路由(聊天、说书、语音、提醒等全部停用),启动日志会打印 [chubby-whale] disabled by config。它只停宿主端;要连前端 bundle 一起停用,用条目自带的 disabled: true(dsh-client-modules 只扫描启用的 entry)。
常见问题
- 没有声音:检查本机是否装了
python与edge-tts(python -m edge_tts --help能跑通即可) - 听不懂说话:检查
deepseekKey(语音识别也用它);浏览器地址栏麦克风权限要允许 - 说书/念诗没内容:
dataSource=local时确认data/目录存在且完整(33MB);cloud时看日志里的CLOUD-DATA-FAIL(网络失败会自动回退本地) - 数据存哪:
memory.json、growth.json、reminders.json、说书进度、已读记录都在~/.dsh-chubby-whale/(插件升级不丢)
开发
npm install
npm run build # 生成版本号 + tsc + 客户端 tsc + esbuild → dist/
npm test # 导入规则/模块边界/诊断键/文字体检/单测/两端冒烟/判停基准
node tools/tts-bench.mjs # TTS 耗时实测(对运行中的实例)
node tools/voice-bench.mjs --chat # 语音链路测点(--chat 会花少量额度)
src/client.ts 由 esbuild 单独打包成 IIFE(tsconfig 里 exclude),其余模块走 tsc。
宿主侧改动要重启 dsh web 才生效,客户端改完 Ctrl+F5 即可;待生效清单见 docs/待重启生效.md。
升级
# 从 npm 升到最新发布版(推荐;也可换成 git+https://… 两种 git 源)
dsh plugin --profile web add "dsh-chubby-whale@latest"
# 装完必须重启 dsh web:宿主代码只在启动时加载
# (只刷新页面不够:客户端 dist/client.js 与宿主 dist/index.js 必须同一版本)
怎么核对装的是哪一版:
- 插件菜单里会显示版本号;
- 或直接读安装副本的
package.json:
node -e "console.log(require('~/.dsh/profiles/web/node_modules/dsh-chubby-whale/package.json').version)"
注意:
node_modules/dsh-chubby-whale若是普通目录(不是 link/junction),它不会自动跟随仓库变化, 必须显式dsh plugin add升级后重启;是 link 时则仓库一改、重启即生效。 发布包完整性可用node tools/check-installed.mjs --dir <安装目录>自检(文件集合、入口可达性、client.js 一致)。
数据热更新(改内容不用重启)
data/story/*.json、data/culture/*.json、data/poems.json 都按文件修改时间自动失效:
改完保存,下一次请求就会重新读取(无需重启 dsh web,也无需清缓存)。
运行数据(记忆/成长/鱼粮/提醒/说书进度/缓存)都在 ~/.dsh-chubby-whale/,与插件包分离。
发布
发版流程与检查清单见 docs/发布规范.md,关键命令:
node tools/check-release.mjs # 发版一致性(package / version.ts / dist / CHANGELOG / tag)
node tools/version-check.mjs # 四处版本核对(本地 / Gitee / GitHub / npm)
版本只留当前一个 tag;旧版本在 npm 上标记废弃、不删除(npm 政策不允许删超过 72 小时的版本)。
Comments
Loading…
Similar plugins
by Artificialimbecile
A talking whale desktop pet for the DSH web UI — persona-driven chat with persistent memory, plus scheduled autonomous web browsing that brings back a summarized message telling you what she found. Ba
★ 0
JavaScript
Nov 3, 2026
dsh plugin --profile web add dsh-whale-chatby Gjs9178U
A desktop pet for the DSH web GUI: an inline-SVG whale that bobs, blinks and sways, can be dragged anywhere and remembers where it was.
★ 7
NOASSERTION
JavaScript
Oct 20, 2026
dsh plugin --profile web add dsh-pet-indesktopby dleaf6211-hash
Whale girl desktop pet for DeepSeek Harness: browser floating mascot plus Windows desktop pet sharing one data backend, with real-time balance board, task notices, head-pat interaction, 19 pre-synthes
★ 4
↓ 817/wk
MIT
HTML
Oct 20, 2026
dsh plugin --profile web add dsh-whale-pet-pluginby FaMuer
A 3D-rendered whale desktop pet that swims around the lower-right corner of the dsh web UI and reacts to task events with attention animations and whale-call sounds.
★ 0
JavaScript
Sep 6, 2026
dsh plugin --profile web add dsh-real-fish-petby reisen-ww
敲盆宠物 · DSH 悬浮小鲸鱼插件:出错掉钢管、敲铁盆、讨白饭
★ 0
JavaScript
Sep 19, 2026
dsh plugin --profile web add dsh-bonk-petby Kris8888888
A whale or pixel-crab pet for DeepSeek Harness that reacts to your sessions.
★ 1
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add dsh-desktop-pet