Skip to content

dsh-chubby-whale

Verified

dsh-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(肥鲸)

LICENSE Gitee

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 校验通过):

  1. 打开 DSH「设置 → 插件市场」;
  2. 添加索引 URL:https://gitee.com/adengou/dsh-chubby-whale/raw/main/market-index.json;
  3. 在市场里找到「肥鲸 · 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 不算安全上下文。通用解法(不涉及任何私有域名):

  1. 电脑上用:http://127.0.0.1:<端口>/whale-mobile/ 属于安全上下文,麦克风直接可用
  2. 手机上用快捷键:浏览器地址栏固定页面的"添加到主屏幕"不改变协议,仍然不能用;改用输入法自带的语音键
  3. 要在手机上用页面录音:给 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/,与插件包分离。