前言¶
在 DSH 里做个人记账,常见诉求不是把数据放到外部服务里,而是在对话中直接完成记一笔、查账、汇总、预算和导出。dsh-tally 是 DeepSeek Harness 个人记账插件,面向个人收支记录场景,把数据放在本机 JSON 文件里,并保持零依赖、无网络请求。
这是什么¶
dsh-tally 提供记一笔、查账、汇总、预算、导出等能力。仓库 owner 为 2672243194,许可为 MIT。截至 2026-09-03,当前版本号为 0.4.0,运行环境需要 Node >= 20。
数据默认存放在:
$DSH_HOME/plugins/tally.json
它不上传数据,也不依赖 API key。
核心功能¶
下面按日常使用路径介绍。
1、记账
- 记录支出或收入。
- 支持内置中文分类,也可自定义分类。
- 支持批量记账,用于一句话补记多笔。
2、查账
- 支持按月、类别、关键词查询。
- 输出保持紧凑,一行一笔,便于快速核对。
3、汇总
- 支持月度汇总和年度汇总。
- 可看到类别 Top5、日均支出和环比变化。
4、预算
- 支持设置月度预算。
- 超支或预算进度达到提醒条件时会提示,其中用掉 80% 会自动提示。
5、删除与恢复
- 删除采用软删除,并需要二次确认。
- 删除后可以通过恢复操作找回。
6、导出
- 支持 CSV 导出,使用
UTF-8 BOM。 - 支持生成自包含 HTML 账目报告。
7、本地运行
- 本地 JSON 存储。
- 零依赖,无网络请求,无广告,无数据收集。
安装¶
安装前先确认本机 Node 版本满足:
Node >= 20
从 GitHub 安装:
npx @deepseek-ai/dsh plugin --profile web add github:2672243194/dsh-tally
安装完成后,可以在 DSH 对话中使用下文示例里的记账指令。插件以当前 DSH 进程权限运行;写操作受 DSH 权限/审批策略保护。安装前应检查源码与许可证,并确认 $DSH_HOME/plugins/tally.json 所在目录的访问权限。
典型用法¶
以下示例可直接作为对话指令使用。
记一笔:
记一笔:今天午饭 28 元,餐饮
批量补记:
帮我把这几笔记上:昨天奶茶 15、打车 12、周三聚餐 85
查询与统计:
这个月花了多少钱?统计一下
查一下上个月“交通”类目
统计一下今年
删除与恢复:
记错了,删掉那笔 id 是 a1b2c3 的
刚才删错了,恢复那笔 id 是 a1b2c3 的
预算:
这个月预算 3000 元
看看这个月预算还剩多少
导出:
把这个月的账导出成 CSV
适用场景与注意¶
适合这些场景:
- 用 DSH 管理个人日常支出和收入。
- 希望账本数据保存在本机,不依赖额外服务。
- 需要按月查账、按年汇总、设置预算并导出文件。
- 希望删除操作有软删除和恢复空间。
使用前注意:
- 插件以当前 DSH 进程权限运行,写操作受 DSH 权限/审批策略保护。
- 安装前建议检查源码和
MIT许可证。 - 账本文件默认位于
$DSH_HOME/plugins/tally.json,应将其视为本地敏感数据。 - 删除操作有二次确认,但仍建议重要账目先核对再删除。
链接¶
项目仓库:
https://github.com/2672243194/dsh-tally
目录页:
https://www.skillhub.cn/plugins/2672243194/dsh-tally