C
dsh-plugin-whale-butler
cybeshi/dsh-plugin-whale-butler
DSH 로컬 우선 원장입니다. 한 문장이나 스크린샷으로 지출·수입을 기록하고 계좌, 분류, 환불, 할부, 대출, 빚을 관리합니다. 오프라인 HTML 차트도 있습니다. 데이터는 로컬 JSONL 파일에 남습니다.
설치
dsh plugin --profile web add github:cybeshi/dsh-plugin-whale-butlerREADME
鲸娘管家 · DSH 插件
“说人话”就能记的本地账本。
截一张图、说一句话，鲸鱼娘就能帮你把账记好。她还能帮你统计收支、生成离线图表。不用懂会计科目，也不用学记账——人能听懂的，她都懂。
本项目是社区维护的非官方插件，与深度求索公司及 DeepSeek 官方无关。 插件免费分发，不收费、不捆绑付费服务。
工具
| 工具 | 用途 |
|---|---|
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 | 待摊：按覆盖期自动分摊（供暖/学费/保险/房租等），也支持按期数等分 |
安装
需要 DSH 0.2.0 及以上、Node.js 20 及以上。纯 Host 插件，零依赖、零构建。
方式一：从插件索引安装（推荐）
- 打开「插件」页 → 「实验性插件」旁的「更多」→ 打开 自定义插件索引
- 切到 发现 → 添加索引源，粘贴：
https://cybeshi.github.io/dsh-plugin-whale-butler/index.json
- 找到「鲸娘管家」，点安装
- 新开一个会话，问一句「看一下余额」确认生效
方式二：从仓库源码安装
git clone https://github.com/cybeshi/dsh-plugin-whale-butler.git
在 DSH 的插件管理中从本地目录安装这个仓库，或让助手把仓库目录作为 bundle 安装；装完同样新开会话。
数据位置
默认写在当前工作区下的 whale-butler：
<工作区>\whale-butler\
一个工作区一本账；换工作区就是另一本账。账本是本地纯文件（JSONL + JSON），卸载插件不会删除。
也可以用环境变量强制指定账本：
$env:WHALE_BUTLER_DATA = '<你的目录>\whale-butler'
隐私
截图解析由模型完成，图片会随对话发到模型服务；账本文件始终只在本机。whale_snap 只在给了本机路径时复制图片原件。
图标与许可
图标为鲸鱼娘 Q 版形象（作者 @这个刀子真甜），依 CC BY-NC-SA 4.0 非商业使用。
- 代码：MIT，见 LICENSE
- 图标：CC BY-NC-SA 4.0，见 LICENSE-ASSETS
- 署名与来源：ATTRIBUTION.md
关于
- 账户树、类别、单据/分录/明细、购物车优惠摊销、退款、截图入账
- 债权、债务、分期、待摊、年费、进销存、定期存款、共享额度信用卡、代购
- 月报、收益汇总、离线 HTML 图表