Preface¶
In DSH (DeepSeek Harness), a common request for personal accounting isn’t to put data in an external service, but to complete recording, querying, summarizing, budgeting, and exporting directly within the conversation. dsh-tally is a DeepSeek Harness personal accounting plugin designed for personal income and expense recording scenarios. It stores data in a local JSON file while maintaining zero dependencies and no network requests.
What is it¶
dsh-tally provides capabilities for recording, querying, summarizing, budgeting, and exporting. The repository owner is 2672243194 and the license is MIT. As of 2026-09-03, the current version is 0.4.0, and the runtime environment requires Node >= 20.
Data is stored by default at:
$DSH_HOME/plugins/tally.json
It does not upload data and does not rely on API keys.
Core Features¶
The following introduces core features based on daily usage paths.
-
Recording
- Record expenses or income.
- Supports built-in Chinese categories and custom categories.
- Supports batch recording for quick entry of multiple items in one go.
-
Querying
- Supports querying by month, category, and keyword.
- Output is kept compact, one line per entry, making quick verification easy.
-
Summary
- Supports monthly and annual summaries.
- View Top 5 categories, daily average expenses, and month-over-month changes.
-
Budget
- Supports setting monthly budgets.
- Alerts are triggered when over budget or when the budget progress reaches a threshold (auto-alert at 80% used).
-
Delete & Restore
- Uses soft delete and requires confirmation.
- Deleted items can be recovered via restore operations.
-
Export
- Supports CSV export with
UTF-8 BOM. - Supports generating self-contained HTML financial reports.
- Supports CSV export with
-
Local Run
- Local JSON storage.
- Zero dependencies, no network requests, no ads, no data collection.
Installation¶
Before installing, confirm that the local Node version meets:
Node >= 20
Install from GitHub:
npx @deepseek-ai/dsh plugin --profile web add github:2672243194/dsh-tally
After installation, you can use the recording commands below in DSH conversations. The plugin runs with the permissions of the current DSH process; write operations are protected by DSH permissions/approval policies. Before installing, check the source code and license, and confirm access permissions for the directory containing $DSH_HOME/plugins/tally.json.
Typical Usage¶
The following examples can be used directly as conversation commands.
Record:
记一笔:今天午饭 28 元,餐饮
Batch record:
帮我把这几笔记上:昨天奶茶 15、打车 12、周三聚餐 85
Query & Stats:
这个月花了多少钱?统计一下
查一下上个月“交通”类目
统计一下今年
Delete & Restore:
记错了,删掉那笔 id 是 a1b2c3 的
刚才删错了,恢复那笔 id 是 a1b2c3 的
Budget:
这个月预算 3000 元
看看这个月预算还剩多少
Export:
把这个月的账导出成 CSV
Applicable Scenarios & Notes¶
Suitable for these scenarios:
- Use DSH to manage personal daily expenses and income.
- Want the ledger data stored locally without relying on extra services.
- Need to query monthly, summarize annually, set budgets, and export files.
- Want delete operations to support soft delete and recovery.
Usage Notes:
- The plugin runs with the permissions of the current DSH process; write operations are protected by DSH permissions/approval policies.
- Before installing, it is recommended to check the source code and the
MITlicense. - The ledger file is located at
$DSH_HOME/plugins/tally.jsonby default and should be treated as local sensitive data. - Delete operations require confirmation, but it is still recommended to verify important records before deleting.
Links¶
Project Repository:
https://github.com/2672243194/dsh-tally
Directory Page:
https://www.skillhub.cn/plugins/2672243194/dsh-tally