dsh-chubby-whale
Verifieddsh-chubby-whale · v1.3.9 · MIT · Web UI
DSH 网页版桌面宠物「肥鲸」——蓝发鲸鱼娘,固定在 harness 页面右下角:会眨眼、能拖拽、点击可聊天,支持语音对话、念诗说书、饭点提醒。
Install
dsh plugin add dsh-chubby-whale Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-chubby-whale(肥鲸)
DSH 网页版桌面宠物:蓝发女仆鲸鱼娘,常驻 harness 页面右下角。可拖拽(带惯性、位置记忆)、会眨眼、能说话、能说书念诗弹琴,也能听懂你说话。
| 渠道 | 地址 |
|---|---|
| 主仓库(Gitee) | https://gitee.com/adengou/dsh-chubby-whale |
| 镜像(GitHub) | https://github.com/adengou/dsh-chubby-whale |
| npm 包 | https://www.npmjs.com/package/dsh-chubby-whale |
| 更新日志 | CHANGELOG.md |
语音待命的信号处理设计与调参:见 docs/耳朵算法.md 发版规范(Gitee 必发;GitHub / npm 可达时同步同一版本):见 docs/发布规范.md
鱼账本(2026-11-07 起):
/fishfood除 token 总量外,还会给出输入/输出拆分、缓存命中数与 人民币估算(按官方价目 × 高峰/空闲 × 缓存命中,价格来源与核对日期写在响应里)。 金额是估算、且只在拿到 usage 拆分时才计——拿不到就说「暂无可拆分用量」,不显示 ¥0.00 冒充花了 0 元。
安装(三种来源任选)
# ① npm 包(最省事,装发布版)
dsh plugin --profile web add "dsh-chubby-whale"
# ② 从 Gitee 装(主仓库)
dsh plugin --profile web add "git+https://gitee.com/adengou/dsh-chubby-whale.git"
# ③ 从 GitHub 装(镜像,连通时与 Gitee 同一版本)
dsh plugin --profile web add "git+https://github.com/adengou/dsh-chubby-whale.git"
# ④ 本地 link(开发调试)
dsh plugin --profile web add "link:C:\Users\<你>\.dsh\plugins\dsh-chubby-whale"
# 装完重启 dsh web
dsh web
通过插件市场索引(方式五)
仓库根附一份符合 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/plugins/dsh-chubby-whale/config.json (或包安装目录下的 config.json)
{
"deepseekKey": "sk-...", // 对话/看图
"siliconflowKey": "sk-..." // 语音识别 + 语音合成
}
也可用环境变量:CHUBBY_WHALE_DEEPSEEK_KEY、CHUBBY_WHALE_SILICONFLOW_KEY
(最后才回退到通用名 DEEPSEEK_API_KEY / SILICONFLOW_API_KEY)。
自我进化(可选,都能关)
肥鲸会随成长学一点东西,两个开关默认开启,写进 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 种音色、可关、可停)、语音待命(常驻听写)、语音聊天开关;时长估算按语种分离(中文按字/英文按词) |
| 文化 | 说书(17 本古籍,念原文、进度记忆、不重复、进度按数据源隔离)、念诗(737 首)、典故(261)、成语(834)、民间故事(696)、对联(51 副 11 类);选本书 ▸ 书单、今日一句、今日简报 |
| 音乐 | 11 首曲子 Web Audio 合成播放(含升降号与低/高音) |
| 工具 | 提醒(口语时间:9点 / 明天9点 / 半小时后 / 每天8点;管理面板:回数字删除、回 d 顺延 10 分钟)、看图、拖文件(图片识别 / 文本总结)、成长与亲密度、鱼粮账本、余额、清除记忆、数据导出/导入、使用统计 |
| 界面 | 界面语言(中文默认 / 英文)、右键菜单键盘导航(↑↓/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 配了 siliconflowKey |
走硅基流动的语音识别 |
录音在手机上打不开,不是手机的问题,是 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) |
聊天、总结 | 聊天必需 |
Python 3 + edge_tts(pip install edge-tts) |
语音合成 | 语音必需 |
硅基流动 Key(config.json 的 siliconflowKey 或环境变量 SILICONFLOW_API_KEY) |
语音识别(Qwen3-ASR) | 语音输入必需 |
没有 Key 也能用:说书、念诗、典故、成语、民间故事、弹琴、提醒、成长全部离线可用,不消耗 token。
首次安装没有 Key 会怎样(实测行为):
- 插件照常加载,不报错、不阻止使用离线功能
- 没配 DeepSeek Key:页面加载后会提示一次「还没配 Key」;聊天时回复会明确说缺 Key(不发模型请求)
- 没配 SiliconFlow Key:开语音后第一次识别会提示一次,并停止继续上传识别(不会反复重试、不刷屏);打字和离线功能不受影响
- 语音合成(edge-tts)不需要 Key;若本机 python 环境缺依赖,客户端会自动回退浏览器朗读
安装
dsh plugin --profile web add link:<本目录>
然后重启 dsh web。首次打开页面点一下任意位置(浏览器要求用户手势才能开麦克风)。
配置
复制 config.example.json 为 config.json(config.json 已被 git 忽略,不会误提交):
{
"deepseekKey": "",
"siliconflowKey": "",
"dataSource": "local"
}
Key 读取优先级:config.json → 专属环境变量(CHUBBY_WHALE_DEEPSEEK_KEY / CHUBBY_WHALE_SILICONFLOW_KEY)→ 通用环境变量(DEEPSEEK_API_KEY / SILICONFLOW_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能跑通即可) - 听不懂说话:检查
siliconflowKey;浏览器地址栏麦克风权限要允许 - 说书/念诗没内容:
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/,与插件包分离。