前言¶
在 DeepSeek Harness（DSH）里做助手开发，常见需求之一是「记一笔、查本月花了多少」——若每次都手写脚本或临时 JSON，口径容易和面板不一致，也不方便做预算与趋势。社区插件 dsh-ledger（维护者 laomaogu，SkillHub 分类：记忆）面向 DSH Web 场景：在侧边栏提供记账本面板，同时向 Agent 注册记账与报表工具，统计与提示由 Host 统一计算，数据只落在本机一个 JSON 文件里。
下面介绍它是什么、能做什么、如何安装启用，以及使用时需要注意的限制。
这是什么¶
dsh-ledger 是 DeepSeek Harness 的个人记账插件：记录每一笔收支，按时间、分类、支付方式、星期、月度五个维度做分析，给出预算相关提示，并用内联 SVG 图表展示。不上传云端；HTTP 请求先经过 DSH 的 connection 信任检查。
- 目录页：https://www.skillhub.cn/plugins/laomaogu/dsh-ledger
- 源码与文档：https://github.com/laomaogu/dsh-ledger
- 许可证：MIT（
package.json版本 1.0.0） - 插件行 id 为
personal-ledger，启用 bundle 名为dsh-ledger
SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与 LICENSE。
核心功能¶
面板与记账¶
- 快速记账：支出 / 收入、金额、14 个固定分类、日期、5 种支付方式、备注；点按记录编辑，悬停删除（二次确认）。
- 三个页签：概览（KPI、图表、本月小结、最近记录）、明细（搜索与分类筛选）、设置（月度预算、数据文件路径、导出当前月 CSV / JSON）。
- 概览 KPI：本月支出、收入、结余、日均支出、预算剩余（含进度条）。
五种图表（纯 SVG / CSS，无第三方图表库，跟随亮暗主题）¶
- 每日支出趋势（面积 + 折线，标出今天）
- 支出构成环形图（分类占比 + 图例）
- 支付方式横向条形图
- 星期分布柱状图（区分工作日 / 周末）
- 近六个月支出与收入对比柱状图
消费分析与自动提示¶
概览会汇总本月支出 / 收入 / 结余 / 日均 / 预算剩余，并按剩余预算折算每日额度、按当前速度预测月末支出。根据数据最多生成 6 条建议（预算超支、分类上涨、环比变化、周末偏高、大额支出、重复消费、储蓄率等），按 warn → tip → ok → info 排序，警告优先。规则为启发式，不构成财务建议；阈值可在 Host 的 buildInsights() 中调整（见 README 表格）。
对话记账（Agent 工具）¶
装上并启用插件后，可对助手用自然语言记账或查账。注册三个工具：
| 工具 | 作用 |
|---|---|
ledger_add |
记一笔：amount（必填）、type、category、date、method、note |
ledger_report |
某月汇总：总额、分类、支付方式、星期、环比、提示、最近 10 条（含 id） |
ledger_delete |
按 id 删除一条 |
示例说法（来自 README）：
记一笔：午饭 25 元
昨天打车 38，用支付宝
这个月花了多少？帮我看看哪里可以省
删掉刚才那笔咖啡
说明：Agent 工具返回的报告文本目前固定中文；面板文案支持中英双语（zh / en）。
数据与隐私¶
- 存储路径：
~/.dsh/personal-ledger/ledger.json（目录权限700、文件600，UTF-8，原子写入）。 - 无法解析的 JSON 会改名为
ledger.json.corrupt-<时间戳>，从空账本继续。 - 无遥测；删除无回收站，需留档请先导出。
Host 在 buildSnapshot() 中统一算统计与提示，面板与 Agent 共用同一口径。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前应确认信任维护者与代码。
方式一：插件管理器（推荐）¶
- 打开 DSH Web 的「插件」页（左栏风车图标）。
- 安装：选择本地目录，或填写本仓库地址 / npm 包名。
- 在插件列表里启用
dsh-ledgerbundle。 - 左栏底部出现钱包图标 记账本 即表示成功。
方式二：命令行¶
本地目录（会创建 link 依赖）：
dsh plugin --profile <profile> add /path/to/dsh-ledger
或从 GitHub 安装：
dsh plugin --profile <profile> add github:laomaogu/dsh-ledger
随后在「插件」页启用 dsh-ledger bundle（或让助手通过插件管理器完成启用）。
兼容性（README 写明）：开发与验证环境为 DSH 0.2.1-rc.5、Node 22.23.4；package.json 要求 node >= 22.19.0、dsh ^0.2.1-alpha.2。仅使用 Node 内置模块，无第三方运行时依赖。
典型用法¶
- 记一笔：面板右上角按钮 → 选类型、金额、分类、日期、支付方式、备注 → 保存；录入后自动跳到该笔所在月份。
- 看分析：在概览页阅读图表与「本月小结」。
- 找记录：明细页搜索备注 / 分类 / 金额，按分类过滤；点记录编辑，悬停删除。
- 设预算：设置页填写月度预算（0 或留空表示不设），提示逻辑会随之变化。
- 导出：设置页导出当前月份的 CSV 或 JSON。
Host 就绪时日志会打印 [dsh-ledger] host ready: <数据文件>，便于确认加载的数据路径。修改 client.js 后刷新页面即可；改 Host 需重启 DSH 进程。面板约每 25 秒或窗口重新聚焦时刷新，非实时推送。
适用场景与注意¶
适合：已在用 DSH Web、希望本机记账并在同一环境里让 Agent 记一笔 / 查报表的开发者或个人用户；需要预算提示和多维度 SVG 概览、且接受固定分类集合的场景。
已知限制（README）：
- 单币种（人民币
¥），金额上限 10 亿、备注 120 字、最多 5 万条记录。 - 分类为内置集合，UI 暂不支持自定义。
- 无账单导入、无多账户 / 多人共享。
Roadmap 包括自定义分类与多币种、支付宝 / 微信 CSV 导入、提示阈值可配置等，以仓库 CHANGELOG / Issue 为准。
结尾¶
dsh-ledger 把「录入—统计—图表—预算提示—Agent 工具」收进一个 DSH 插件，数据留在 ~/.dsh/personal-ledger/ledger.json，适合作为 Harness 生态里本机个人财务记忆的起点。
- SkillHub：https://www.skillhub.cn/plugins/laomaogu/dsh-ledger
- GitHub：https://github.com/laomaogu/dsh-ledger
