前言¶
在 DSH 里做助手时，记账往往有两条路：要么接第三方记账 App，要么自己维护表格或数据库。前者要授权和同步，后者要把「花了多少、记在哪个账户」拆成结构化字段，对话里稍一复杂就容易记错或漏记。
鲸娘管家（dsh-plugin-whale-butler）把账本做成工作区内的本地文件，通过一组工具让模型用「人话」或截图入账，并支持查询、改单和离线图表。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
鲸娘管家是社区维护的 DSH 插件，与深度求索公司及 DeepSeek 官方无关；插件免费分发，不收费、不捆绑付费服务。
定位是：截图或一句话就能记账的本地账本，模型侧不必写借贷科目，README 写明「人能听懂的，她都懂」。维护者为 cybeshi，在插件目录中归类为记忆；当前 GitHub 公开仓库星标为 0，package.json 版本 1.0.0。
账本数据默认落在当前工作区下的 whale-butler 目录，格式为 JSONL + JSON；一个工作区一本账，卸载插件不会删除这些文件。
核心功能¶
插件向 DSH 暴露多组工具，覆盖日常收支、复杂分录、购物车摊销、退款、截图入账，以及账户、类别、信用卡、商品与库存、定存、债权债务、待摊费用等。README 中的工具表如下（用途以仓库原文为准）：
| 工具 | 用途 |
|---|---|
whale_expense |
记一笔日常支出（模型不用写借贷方向） |
whale_income |
记一笔收入；红包券可传 coupon=true |
whale_record |
通用记账（复杂单据、多分录） |
whale_cart |
购物车：满减摊销、红包收入、多账户付款 |
whale_refund |
退款，挂原单 |
whale_snap |
截图入账（模型看图，存图和原文） |
whale_query |
余额、月报、账户流水、库存、经营毛利、进价历史、年费、理财、债权、分期、待摊、类别 |
whale_chart |
离线 HTML 图表 |
whale_account |
加账户、改名/加别名、找账户、设投资账户、补期初 |
whale_category |
查看/新增/改名/移动/删除/迁移支出或收入类别 |
whale_fix |
改单/重分类，保留修改历史 |
whale_card |
信用卡还款日、账单日、额度、年费政策、共享实体卡 |
whale_product |
商品：新增、列出、查找 |
whale_inventory |
进货、销售、客户退货、供应商退货、期初库存 |
whale_deposit |
借记卡下活期/定期：存入、查看、到期、提前支取 |
whale_receivable |
债权：借出、利率规则、计息、还款 |
whale_debt |
债务：期初欠款、借入、利息、还款 |
whale_prepaid |
待摊：房租/学费等，首期付款日、每月同日、自动摊销 |
技术形态上，README 写明其为纯 Host 插件，零依赖、零构建；package.json 要求 Node.js 20 及以上、DSH 0.2.0 及以上。
安装与启用¶
安装前请确认本机 Node.js 与 DSH 版本满足上述要求。仓库 README 给出的步骤是下载源码后在 DSH 中从本地目录安装，而不是通过一条固定的在线 dsh plugin add 命令（资料中未提供该形式）。
- 克隆或下载本仓库（路径以你本机为准）：
git clone https://github.com/cybeshi/dsh-plugin-whale-butler.git
- 在 DSH 的插件管理中，从本地目录安装这个仓库；或者让助手把仓库目录作为 bundle 安装。
- 确认安装、批准提示后，新开一个会话（插件按会话加载）。
- 在新会话里问一句「看一下余额」，能正常返回账本余额就说明生效。
插件以当前 DSH 进程权限运行。安装前应自行查看仓库源码与许可证（代码 MIT；图标 CC BY-NC-SA 4.0，见仓库内 LICENSE、LICENSE-ASSETS、ATTRIBUTION.md）。
数据位置与隐私¶
默认账本目录为工作区下的 whale-butler：
<工作区>\whale-butler\
换工作区即另一本账。也可用环境变量指定目录（README 示例为 PowerShell）：
$env:WHALE_BUTLER_DATA = '<你的目录>\whale-butler'
隐私方面：截图解析由模型完成，图片会随对话发到模型服务；账本文件始终只在本机。whale_snap 仅在给了本机路径时复制图片原件。
典型用法¶
资料中的验收方式是对话查询余额。日常记账由模型根据用户自然语言或截图调用对应工具，例如记支出、记收入、截图入账、查月报或生成离线图表等，无需在对话里手写会计分录。
可作起点示例（在新会话中）：
- 「看一下余额」——验证插件已加载。
- 用一句话描述一笔支出或收入，由助手选择
whale_expense/whale_income等工具入账。 - 提供账单截图路径或让助手处理截图，使用
whale_snap相关流程（需注意图片会发往模型服务）。
更复杂的场景（购物车满减、退款挂原单、债权债务、待摊房租等）对应上表中的 whale_cart、whale_refund、whale_receivable 等工具，具体参数以仓库实现为准。
适用场景与注意¶
适合希望在 DSH 对话内完成记账与统计、且愿意把账本留在本机工作区的开发者或个人用户。能力覆盖个人日常账、多账户、信用卡政策、简单进销存与经营类查询，并支持 whale_chart 输出离线 HTML 图表。
需注意：社区插件目录（SkillHub）与 DeepSeek / 幻方无官方从属关系；使用前请理解数据留在本地、截图走模型链路的边界。图标为鲸鱼娘 Q 版形象（作者 @这个刀子真甜），非商业使用须遵守 CC BY-NC-SA 4.0。
结尾¶
鲸娘管家把「说人话」和截图识别接到本地 JSON 账本上，在 DSH 里用工具链完成记、查、改与图表，避免单独维护一套记账后端。更多信息见插件目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/cybeshi/dsh-plugin-whale-butler
- GitHub：https://github.com/cybeshi/dsh-plugin-whale-butler
