个人记账本2672243194/dsh-tally

dsh-tally

dsh-tally

DeepSeek Harness 个人记账插件：记一笔、查账、汇总、预算、导出，纯本地零依赖。

- 记支出/收入，内置中文分类（餐饮/交通/购物/居住/娱乐/医疗/教育/人情/工资/其他，可自定义）
- 批量记账：一句话补记多笔
- 按月/类别/关键词查账，紧凑一行一笔
- 月度/年度汇总：支出/收入/结余、类别 Top5、日均支出、环比变化（vs 上月）
- 月度预算 + 超支/进度提醒（用掉 80% 自动提示）
- 删除软删除 + 可恢复（tally_restore），防误删
- CSV 导出（UTF-8 BOM，Excel/WPS 直接打开）
- 数据存本机 $DSH_HOME/plugins/tally.json，不上传、无 API key

为什么做它

DSH 生态的"财务类"插件有 60+ 个，但全部是 token 用量/成本监控（记录"DSH 烧了多少 token 钱"）或企业会计工作流（dsh-finance 的分录/对账/审计）。个人收支记账是真空——dsh-tally 是第一个。

竞品调研

2026-08-15 GitHub API 交叉验证，检索范围：英文 bookkeeping / expense / ledger / accounting / money / budget / spending / finance / reimburse + 中文 记账 / 账单 / 收支 / 账本 / 预算 / 消费，逐条核对 60+ 个"财务类"插件，分三类：

| 类别 | 数量 | 代表 |
|---|---|---|
| token 用量/成本监控 | 50+ | TokenLedger、dsh-cost、usage-ledger、balance-monitor |
| 企业会计工作流 | 1 | dsh-finance（分录/对账/报表/SOX 审计） |
| 量化金融 | 2 | 行情/投资 |

个人收支记账：无——dsh-tally 填补该空位。

安装

从 GitHub（推荐）
npx @deepseek-ai/dsh plugin --profile web add github:2672243194/dsh-tally

本地开发
npx @deepseek-ai/dsh plugin --profile web add ./dsh-tally

重启 DSH 后，设置 → 插件列表应看到 dsh-tally 已启用。

使用

直接对话：

记一笔：今天午饭 28 元，餐饮
帮我把这几笔记上：昨天奶茶 15、打车 12、周三聚餐 85
这个月花了多少钱？统计一下
查一下上个月"交通"类目
记错了，删掉那笔 id 是 a1b2c3 的
刚才删错了，恢复那笔 id 是 a1b2c3 的
这个月预算 3000 元
看看这个月预算还剩多少
统计一下今年
把这个月的账导出成 CSV

工具

tally_add(amount, type?, category?, note?, date?) — 记一笔

| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| amount | number | 必填 | 金额（元，>0，最多两位小数） |
| type | string | expense | expense 支出 / income 收入 |
| category | string | 其他 | 内置分类或自定义 |
| note | string | 空 | 备注（≤50 字，可搜索） |
| date | string | 今天 | YYYY-MM-DD |

tally_batch(entries) — 批量记账：一次写多笔（每项字段同 tally_add，amount 必填）；合法项整体写入，非法项跳过并按序号报告

tally_list(month?, category?, keyword?, limit?, includeDeleted?) — 查账（默认当月、日期倒序、每笔一行含短 id；includeDeleted: true 显示已删条目并带 [已删] 标记）

tally_stats(month?, year?) — 汇总
- 传 month：月度汇总（紧凑单块），自动带上月环比与预算状态：
[2026-08] 支出 ¥186.00 · 收入 ¥8,000.00 · 结余 +¥7,814.00 · 12 笔 · 日均支出 ¥75.50
类别 Top：餐饮 ¥860 · 交通 ¥420 · 购物 ¥380
较上月 +12.3%（上月 ¥165.60）
预算 ¥3,000.00 · 剩余 ¥2,814.00        （用掉 80% 显示 ⚠️ 提醒；超支显示超支额）
- 传 year（不带 month）：全年报告，逐月列出 + 全年总计：
[2026] 全年支出 ¥15,432.00 · 收入 ¥96,000.00 · 结余 +¥80,568.00 · 215 笔
1月 支出 ¥1,200.00 · 收入 ¥8,000.00 · 结余 +¥6,800.00 · 18 笔
...

tally_remove(id, confirm?) — 删错账：首次调用返回待删详情，传 confirm: true 才会删除；删除为软删除，可随时用 tally_restore 恢复

tally_restore(id) — 恢复已删账目（先用 tally_list(includeDeleted: true) 找到 id）

tally_budget(month?, amount?) — 预算：传 amount 设置/覆盖当月预算，省略则查询（预算/已支出/剩余/是否超支）；tally_stats 同步显示预算状态

tally_export(month?, path?, format?) — 导出
- format: "csv"（默认）：真正写文件（默认 /exports/tally-YYYY-MM.csv），带 UTF-8 BOM（Excel/WPS 双击打开中文正常），返回文件路径 + 前 3 行预览；
- format: "html"：生成自包含 HTML 账目报告（tally-report-YYYY-MM.html，浏览器双击即开）：统计卡片（支出/收入/结余/环比/预算进度）、类别占比图、月份/类别筛选 + 搜索、显示已删开关——嵌入全部月份数据，无需服务；
- 传 path 自定义输出位置（相对路径基于 DSH home 解析）。

存储与安全

- 数据：$DSH_HOME/plugins/tally.json（storagePath 配置可迁移）；
- 原子写入（tmp + rename）+ 串行写入队列（并行调用不丢账）；
- 零依赖、无网络请求、无数据上传；
- 删除需二次确认，写操作受 DSH 权限/审批策略保护。

省 token 设计

- 紧凑文本 render（模型直接读，无需解析 JSON）；
- tally_list 默认 20 条并提示"共 N 笔，显示前 20"；
- tally_stats 单块汇总，不 dump 全量；
- 静态 schema（配置变更不影响 KV 缓存前缀）。

开发

node test.mjs          # 36 个零依赖断言（增删查改/批量/汇总/环比/预算/软删恢复/CSV+HTML导出/并发/持久化）

端到端验证（临时环境，不污染真实账本）
export DSH_HOME=./.dsh-tally-verify
dsh plugin --profile headless add ./dsh-tally
dsh --profile headless "用 tally_add 记一笔早餐 12 元，然后 tally_stats 统计本月"

Roadmap

已完成：
- [x] 月度预算 + 超支提醒（tally_budget + tally_stats 联动）
- [x] 年度统计（tally_stats(year=...) 全年逐月报告）
- [x] CSV 导出（tally_export，真正写文件 + UTF-8 BOM）
- [x] 批量记账（tally_batch）
- [x] 环比洞察（stats 自动对比上月）
- [x] 软删除 + 撤销（tally_restore）
- [x] 预算进度提醒（用掉 80% 自动提示）

后续想法：
- [ ] 多账本（工作/生活分开记账）
- [ ] 周期账（每月自动重复的固定支出）
- [ ] CSV 导入（从其他记账 App 迁移数据）
- [ ] tally_web 本地网页服务（网页里直接编辑写回账本——静态 HTML 受浏览器沙箱限制只能看不能改，需要本地服务才支持）

支持

如果 dsh-tally 对你有帮助，欢迎在 GitHub 点个 ⭐ Star。

- 完全免费开源（MIT），本地存储、无广告、无数据收集、无 API key；
- 独立开发维护，Star 数量是我判断是否继续投入迭代的直接依据；
- 用的人越多，功能越完善——下一个功能很可能就是你需要的那个。

一个 Star 不花一分钱，但能让这个项目走得更远。谢谢 ⭐

License

MIT