v0.4.0

v0.4.0 (2026-08-15)

新增

• tally_export(format="html")：生成自包含 HTML 账目报告（tally-report-YYYY-MM.html，浏览器双击即开，无需服务）
  • 统计卡片：支出/收入/结余、环比、预算进度
  • 类别占比条形图（纯 CSS）
  • 月份/类别筛选 + 关键词搜索、"显示已删"开关
  • 嵌入全部月份数据，数据注入做 < 转义防 script 逃逸
• 新增 report.js（HTML 模板模块，与核心逻辑分离）
• CSV 导出行为不变（默认 format="csv"）

测试

• 36 个零依赖断言（新增 HTML 生成/结构/数据嵌入/script 防逃逸/空当月仍生成）

v0.3.0

v0.3.0 (2026-08-15)

四个实用功能全部落地：

新增

• tally_batch — 批量记账：一句话补记多笔（entries 数组，字段同 tally_add），合法项整体写入、非法项跳过并按序号报告
• 环比洞察 — tally_stats 月度汇总自动带上月对比（较上月 +12.3%（上月 ¥165.60）），上月无支出时提示
• 软删除 + 撤销 — tally_remove 改为软删除（数据保留），tally_restore 随时恢复；tally_list(includeDeleted: true) 查看已删条目（带 [已删] 标记）；统计/导出默认过滤已删
• 预算进度提醒 — 支出达预算 80% 时 tally_stats 自动提示 ⚠️ 已使用 80%（超支时仍显示超支额）

测试

• 33 个零依赖断言（25 → 33：批量写/非法跳过、环比计算/无上月数据、软删隐藏/includeDeleted/恢复、80% 进度/超支边界）

v0.2.2

v0.2.2 (2026-08-15)

修复

• tally_export 真正写文件：之前只返回 CSV 文本预览（模型说"导出完成"但没有文件落盘；复制/粘贴或自存文件时编码丢失，Excel 仍乱码）。
• 现在默认写入 <账本目录>/exports/tally-YYYY-MM.csv（UTF-8 BOM），返回文件路径 + 前 3 行预览；path 参数可自定义位置；空月不写文件。
• render 精简：预览仅表头 + 前 3 行（省 token）。

验证

• 25 个零依赖断言（新增文件落盘/BOM 字节/自定义 path/空月不写文件）。

v0.2.1

v0.2.1 (2026-08-15)

修复

• tally_export 的 CSV 加 UTF-8 BOM：修复中文 Windows 下 Excel/WPS 按 GBK 打开导致中文乱码（餐饮 → 椁愰ギ）。
• 修复后 CSV 保存为 .csv 文件，字节以 EF BB BF 开头，Excel 双击打开中文正常显示。

v0.2.0

v0.2.0 (2026-08-15)

Roadmap 三项全部落地：

新增

• tally_budget — 月度预算：设置/覆盖/查询（预算·已支出·剩余·超支标记），tally_stats 同步显示预算状态（超支 ⚠️ 提醒）
• tally_stats(year=...) — 年度统计：全年 12 个月逐月汇总 + 全年总计
• tally_export — CSV 导出：date,type,category,amount,note（RFC-4180 转义），默认当月

兼容性

• 存储新增 budgets 字段，旧数据文件自动兼容（loadLedger 向后兼容）

测试

• 24 个零依赖断言（14 → 24：预算设置/覆盖/超支/联动、年度 12 月聚合、CSV 转义/排序/空月）

v0.1.0

• tally_add / tally_list / tally_stats / tally_remove（二次确认）
• 中文分类、¥ 格式化、原子写 + 串行队列、零依赖纯本地

v0.1.0

v0.1.0 (2026-08-15)

个人记账插件（DeepSeek Harness），DSH 生态首个个人收支记账工具（现有 50+ 财务类插件均为 token 成本台账/企业会计）。

功能

• tally_add — 记一笔：金额校验（>0、两位小数）、收支类型、中文分类（内置 10 类可自定义）、备注、日期
• tally_list — 查账：按月/类别/关键词过滤，日期倒序，每笔一行含 8 位短 id
• tally_stats — 月度汇总：支出/收入/结余/笔数/日均/类别 Top5，一行紧凑输出
• tally_remove — 删错账：二次确认防误删（首次返回待删详情，confirm 后才删）

设计

• 零依赖（Node 内置 fs/crypto/JSON），无网络请求、无数据上传
• 本地 JSON 存储：$DSH_HOME/plugins/tally.json（storagePath 可配置）
• 原子写入（tmp+rename）+ 串行写入队列（PTC 并行调用不丢账）
• 紧凑文本 render、静态 schema（KV 缓存友好）、协作超时
• 中文交互：内置分类（餐饮/交通/购物/居住/娱乐/医疗/教育/人情/工资/其他）+ ¥ 格式化

验证

• 14 个零依赖断言全过（增删查改/月度汇总/类别Top/空月/持久化/10 并行写不丢账/金额日期校验）
• 真实 DSH 环境端到端验证：add ¥28 餐饮 → stats 本月汇总 → remove 二次确认删除 → 清零 ✅