技能介绍

要解决什么问题

家里或团队用 EasyAccounts 自部署记账时，常见诉求是：「记一笔午饭 30」「上个月花了多少」「按账户/分类筛流水」「导出某月账单」「看年度收支和净资产」。这些都要走 HTTP API，还要处理登录 token、typeId 与 actionId 区分、nginx 下 /api 路径，以及 Windows/Git Bash 下的编码问题。本技能把这类操作收敛成 scripts/ 里已测过的脚本，让模型按流程查主数据再写入，而不是手写 curl 猜接口。

技能如何工作

查询：accounts、types、actions 拿账户与可用分类；query_flows.sh 按时间、账户、分类、备注筛流水（默认时间倒序，超过 100 条会截断并提示用导出）。
记账：add_flow.sh / batch_add_flow.sh 记收支；内部转账走 handle=2 并传 accountToId；金额只传正数，日期由脚本处理。
报表：year_statistics 看年度收入/支出/盈余与账户结构；make_excel 按与查询相同的条件在服务端生成 Excel 文件名（需在前端或运维侧取文件，无直链）。
认证：EASYACCOUNTS_URL 只填 http(s)://host:port（不带 /api）；401 时用 login.sh，不要自拼登录请求。

边界与注意点

本技能不提供删除流水、删账户/分类/动作，也不在前端之外创建账户或分类——删改主数据请到 EasyAccounts 网页/桌面端。投资类（股票、基金、加密货币）不在范围内。JSON 字段名因接口不同可能是 name、aname、accountName，读列表与 get_flow 详情时不要混用。公告需过滤 expire 已过期的条目。