dsh-ledger

DSH PLUGIN工具与能力

仓库 laomaogu/dsh-ledger · npm dsh-ledger

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH plugin 记账本:记录收支并按时间、分类、支付方式、星期与月度分析消费,附预算提示和 SVG 图表,数据只存本机。

一句话选型结论

按资料字段整理

dsh-ledger 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-03 创建于 2026-11-03
README 10.0 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:laomaogu/dsh-ledger
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=22.19.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求>=22.19.0来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-ledger可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-ledger:DeepSeek Harness 里的本地记账本

  • 快速记录收支与备注
  • 五种维度 SVG 图表分析
  • 预算与异常消费提示
  • 对话记账 Agent 工具
  • 数据本地存储可导出

适用场景

存储数据库

上游标签

deepseek-harnessdshdsh-desktopdsh-plugindsh-plugin-marketdsh-pluginsdsh-skill

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-ledger当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方laomaogu仓库 dsh-ledger · 默认分支 main
分类工具与能力finance
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-03 · 2026-11-03最后推送 2026-11-03
本站收录2026-11-03首次进入本站目录的时间

README 全文

10.0 KB
作者原文,中文版优先;只做安全转义,不改内容

记账本 · dsh-ledger

> 为 DeepSeek Harness 打造的个人记账插件:
> 记录每一笔收支,按时间、分类、支付方式、星期、月度五个维度分析消费,给出预算与异常提示,
> 并用内联 SVG 图表展示。数据只保存在本机,不上传。

English · 更新日志 · 发布指南 · MIT License


特性

  • 快速记账:支出 / 收入、金额、14 个固定分类、日期、5 种支付方式、备注;点按记录即可编辑,悬停删除(二次确认)。
  • 五种图表维度(纯 SVG / CSS,零图表依赖,跟随亮暗主题):
  • 每日支出趋势(面积 + 折线,标出今天)
  • 支出构成环形图(分类占比 + 图例)
  • 支付方式横向条形图
  • 星期分布柱状图(工作日 / 周末区分)
  • 近六个月支出与收入对比柱状图
  • 消费分析:本月支出 / 收入 / 结余 / 日均 / 预算剩余,按剩余预算折算的每日额度,按当前速度预测月末支出。
  • 自动提示:根据数据生成最多 6 条建议(预算超支、分类上涨、环比变化、周末偏高、大额支出、重复消费、储蓄率等),警告优先展示。
  • 对话记账:向 Agent 注册 ledger_add / ledger_report / ledger_delete 三个工具,可以直接说「记一笔:午饭 25 元」「这个月花了多少」。
  • 本地优先:数据是一个 JSON 文件,原子写入、权限 600、可随时备份;HTTP 接口先经过 DSH 的 connection 信任检查。
  • 中英双语:面板文案与插件元数据均提供 zh / en。

界面(示意)

概览页(纵向滚动)
├─ KPI 行:本月支出 · 本月收入 · 本月结余 · 日均支出 · 预算剩余(含进度条)
├─ 本月小结:一句话概括本月
├─ 每日支出趋势(整行,面积 + 折线)
├─ 支出构成(左,环形图) · 消费提示(右,最多 6 条)
├─ 支付方式 · 星期分布 · 单笔排行(三列)
├─ 近六个月支出 / 收入对比(整行)
└─ 最近记录(整行,点按编辑 · 悬停删除)

页签:概览 / 明细(搜索、分类筛选)/ 设置(月度预算、数据文件、导出 CSV / JSON)。

安装

方式一:插件管理器(推荐)

  1. 打开 DSH Web 的「插件」页(左栏风车图标)。
  2. 安装:选择本地目录,或填写本仓库地址 / npm 包名。
  3. 在插件列表里启用 dsh-ledger 这个 bundle。
  4. 左栏底部出现钱包图标 记账本 即安装成功。

方式二:命令行

# 本地目录(会创建 link 依赖)
dsh plugin --profile  add /path/to/dsh-ledger

# 或直接从 GitHub 安装
dsh plugin --profile  add github:/dsh-ledger

随后在「插件」页启用 dsh-ledger bundle(或让助手用插件管理器完成安装与启用)。

> 插件行 id 为 personal-ledger,包名为 dsh-ledger;两者都在
> cordis.patch.yml / package.json 中。

使用

  • 记一笔:右上角按钮 → 选类型、金额、分类、日期、支付方式、备注 → 保存。录入后自动跳到该笔账目所在月份。
  • 看分析:概览页按图表阅读;「本月小结」一句话概括本月。
  • 找记录:明细页搜索备注 / 分类 / 金额,按分类过滤;点记录编辑,悬停出现删除按钮。
  • 设预算:设置页填写月度预算(0 或留空表示不设),提示会据此变化。
  • 导出:设置页导出当前月份的 CSV / JSON。

对话记账

装上插件后可直接对助手说:

记一笔:午饭 25 元
昨天打车 38,用支付宝
这个月花了多少?帮我看看哪里可以省
删掉刚才那笔咖啡
工具 作用
ledger_add 记一笔支出 / 收入:amount(必填)、type、category、date、method、note
ledger_report 某月汇总:总额、分类、支付方式、星期、环比、提示、最近 10 条记录(含 id)
ledger_delete 按 id 删除一条记录

消费提示规则

最多 6 条,按 warn → tip → ok → info 排序。阈值可在 index.js 的 buildInsights() 中调整:

提示 触发条件
预算超支 / 紧张 / 健康 已用 ≥ 100% / ≥ 85% / 其余
每日额度 月中、未超预算时,剩余预算 ÷ 剩余天数
预计超支 按当前日均推算的月末支出 > 预算(且尚未超支)
分类集中 第一大分类占比 ≥ 45% 且本月支出 ≥ 300
分类上涨 前三大分类中,某类 > 上月同类 × 1.3 且多花 ≥ 100
环比上升 / 下降 较上月多花 ≥ 25% 且 ≥ 100 / 少花 ≥ 20% 且 ≥ 100
周末偏高 周末日均 > 工作日日均 × 1.5
大额支出 最大单笔 ≥ 本月支出的 40% 且 ≥ 200
重复消费 同一备注(非空)当月出现 ≥ 4 次
结余 / 收支倒挂 有收入时结余 ≥ 0 / < 0;无收入且 ≥ 5 笔支出时提示补录收入
支付集中 使用 ≥ 3 种支付方式且第一种占比 ≥ 60%(支出 ≥ 500)
日均参考 当月有已发生记录时

> 这些规则只是启发式建议,不构成财务建议。

数据与隐私

  • 文件:~/.dsh/personal-ledger/ledger.json(目录 700、文件 600,UTF-8 JSON,写临时文件后原子替换)。
  • 结构:
{
&quot;version&quot;: 1,
&quot;budget&quot;: 5000,
&quot;entries&quot;: [
{
&quot;id&quot;: &quot;m1abc2def3&quot;,
&quot;type&quot;: &quot;expense&quot;,
&quot;amount&quot;: 25.5,
&quot;date&quot;: &quot;2026-11-03&quot;,
&quot;category&quot;: &quot;food&quot;,
&quot;method&quot;: &quot;wechat&quot;,
&quot;note&quot;: &quot;午饭&quot;,
&quot;createdAt&quot;: &quot;2026-11-03T04:00:00.000Z&quot;,
&quot;updatedAt&quot;: &quot;2026-11-03T04:00:00.000Z&quot;
}
],
&quot;updatedAt&quot;: &quot;2026-11-03T04:00:00.000Z&quot;
}
  • 坏了也不会丢:无法解析的 JSON 会被改名为 ledger.json.corrupt-&lt;时间戳&gt;,然后从空账本继续。
  • 没有任何遥测;唯一的外部调用是浏览器到本机 DSH 的同源 fetch。
  • 删除无回收站;需要留档请先在设置页导出。

架构

浏览器(Client half, client.js)                 Host(index.js)
┌───────────────────────────┐   fetch    ┌──────────────────────────────┐
│ sidebar.panellist(图标)  │ ─────────▶ │ /dsh-ledger/api              │
│ main(整页面板)           │  同源 API  │  · connection 信任检查         │
│ · 概览 / 明细 / 设置       │ ◀───────── │  · 校验 + 存储(原子写)       │
│ · 5 种 SVG 图表            │  快照 JSON │  · 分析 + 提示规则            │
│ · 录入 / 编辑 / 删除       │            │  · Agent 工具(3 个)          │
└───────────────────────────┘            └──────────────┬───────────────┘
│
~/.dsh/personal-ledger/ledger.json
  • Host 负责唯一事实来源:统计、占比、提示都在 buildSnapshot() 里算好,面板只负责渲染;Agent 工具与面板因此不会出现口径不一致。
  • HTTP:GET /dsh-ledger/api?month=YYYY-MM 返回快照;POST /dsh-ledger/api 执行
    { op: &quot;add&quot; | &quot;update&quot; | &quot;remove&quot; | &quot;setBudget&quot;, ... } 并返回受影响月份的快照。
    两个入口都先调用 connection.requestRejection(req),未认证请求直接 401/403。
  • Client 只依赖主题 token(--dsw-alias-*)和浏览器内置的 React,不 import 任何 DSH Client 包。

开发

git clone
cd dsh-ledger

node --check index.js
node --check client.js
npm run check          # 同上

# 安装到某个 profile(会创建 link 依赖,改动即时生效)
dsh plugin --profile web add &quot;$PWD&quot;

目录:

dsh-ledger/
├── index.js            Host half:存储、分析、提示、HTTP API、Agent 工具
├── client.js           Client half:面板 / 图表 / 表单(window.__ModuleLoader__ 工厂)
├── cordis.patch.yml    插入 id=personal-ledger 的插件行
├── package.json        包清单(dsh.bundle + dsh.client)
├── locale/zh.json      插件管理器显示用元数据
├── locale/en.json
├── icon.svg            原始图标
└── README.md / README.en.md / CHANGELOG.md / LICENSE / PUBLISHING.md

调试提示:

  • Host 启动时会打印 [dsh-ledger] host ready: &lt;数据文件&gt;,用于确认加载的是哪一代代码。
  • 浏览器控制台可看到 slot 注册/崩溃信息;面板注册在 main(key ledger)与 sidebar.panellist(id ledger)。
  • 修改 client.js 后刷新页面(或等待 HMR)即可看到变化;Host 改动需要重启 DSH 进程。

兼容性

  • 开发与验证环境:DSH 0.2.1-rc.5、Node 22.23.4、Web GUI profile。
  • package.json:engines.node &gt;= 22.19.0,engines.dsh ^0.2.1-alpha.2。
  • 只使用 Node 内置模块(node:fs/promises、node:os、node:path),无第三方运行时依赖。

已知限制

  • 单币种(人民币 ¥),金额上限 10 亿、备注 120 字、最多 5 万条记录。
  • 分类固定为内置集合,UI 暂不支持自定义分类。
  • Agent 工具的报告文本目前固定中文(面板本身中英双语)。
  • 无账单导入、无多账户 / 多人共享。
  • 面板每 25 秒或窗口重新聚焦时刷新一次,不是实时推送。

Roadmap

  • [ ] 自定义分类与多币种
  • [ ] 支付宝 / 微信账单 CSV 导入
  • [ ] 提示阈值可配置(放进插件 Config)
  • [ ] 年度对比、日历热力图
  • [ ] 截图与演示 GIF

License

MIT © 2026 dsh-ledger contributors

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-ledger 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:laomaogu/dsh-ledger` 即可。对应的 npm 包名是 `dsh-ledger`。

dsh-ledger 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-ledger 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-ledger 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-ledger 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-ledger 需要什么运行环境?

Node.js >=22.19.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-ledger 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-ledger 有哪些功能?

快速记录收支与备注、五种维度 SVG 图表分析、预算与异常消费提示、对话记账 Agent 工具、数据本地存储可导出。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。