跳过主要内容
A

dsh-chubby-whale

adengou/dsh-chubby-whale

DSH 网页版桌面宠物「肥鲸」:蓝发鲸鱼娘常驻页面右下角,可拖拽并记住位置、会眨眼、点击可聊天,支持语音对话、念诗说书与饭点提醒。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。

安装

dsh plugin --profile web add github:adengou/dsh-chubby-whale

README

dsh-chubby-whale(肥鲸)

LICENSE | NOTICE(版权与素材来源) | 素材许可说明(LICENSE-ASSETS) Gitee

dsh.so risk dsh.so install · dsh 0.2.2-rc.1

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

  1. 打开 DSH「设置 → 插件市场」;
  2. 添加索引 URL:https://gitee.com/adengou/dsh-chubby-whale/raw/main/market-index.json;
  3. 在市场里找到「肥鲸 · Chubby Whale」,点安装即可(安装源固定到 Git 提交,可复现)。

装完刷新页面即可看到肥鲸。Key 一般不用自己配——肥鲸会按下面顺序找:

  1. 包外配置:~/.dsh-chubby-whale/config.json(Windows 是 C:\Users\<你>\.dsh-chubby-whale\config.json)——推荐,重装/升级插件都不会动它;
  2. 环境变量:CHUBBY_WHALE_DEEPSEEK_KEY(回退到通用的 DEEPSEEK_API_KEY);
  3. 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 即可关闭:

配置键默认作用
personalityLearningtrue每 20 次真实回复、且距上次 ≥6 小时,从最近对话里提取主人的口头禅 / 偏好 / 备注(各有条数与字数上限;名字、家人、生日、语言规则等核心设定锁死,永不自动改)
personalityWritingtrue每 20 次真实回复、且距上次 ≥24 小时,写一句**≤80 字的「近期心境」**;输出里若出现「我是 / 改名 / 爸爸 / 妈妈 / 生日 / AI」等身份词,整句丢弃不写盘
asrLanguagezh语音识别语言: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(一次撤一条,可连按;也支持回滚「近期心境」);
  • 关掉后已存内容仍会注入,只是不再学习、不再写新心境。
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 不算安全上下文。通用解法(不涉及任何私有域名):

  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)聊天、总结、语音识别、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 小时的版本)。

相关插件