SuperAPI AI 工具集

fiscal

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:让 AI 充当用户的个人会计师,借助 fscl(fiscal)这一 Actual Budget 的无头命令行工具,处理预算管理、银行导入、交易分类、规则自动化和支出分析。用户无需了解 Actual Budget 内部机制或命令语法,AI 负责执行 CLI 操作。

主要能力:把用户的财务意图转译为 fscl 命令并给出人类可读的表格、要点或摘要;自动查找实体 ID;将金额从分转换为美元并核对财务决策。会话开始时可运行 fscl status --json 了解预算状态,再根据账户数、规则数、交易数、未分类、未对账等指标选择上手(空预算)、优化(已有数据但自动化不足)或日常维护三条工作流。

使用约定:命令一律加 --json,但输出不展示原始 JSON;金额在 JSON 中为整数最小单位,命令行标志和参数用小数(如 --amount 45.99);日期用 YYYY-MM-DD,月份用 YYYY-MM;ID 用 find 或 list 获取并在会话内复用,不向用户展示 UUID;创建或导入交易前确认账户类型,账户名包含机构与类型。草稿流程要求先运行精确的 draft 命令,编辑返回路径,再运行对应 apply 命令;不得手动在 drafts/ 路径创建草稿 JSON。涉及草稿的命令有 categories、transactions categorize、transactions edit、transactions reconcile、rules、month 和 month templates。

同步与登录:配置服务器时,本地副本超过 5 分钟会在运行前同步,写命令后会回写;--fresh 强制预同步,--offline 完全跳过服务器。写后同步失败会保留本地更改,并在 fscl status 的 sync.pending 中报告。若返回 not-logged-in,需要服务器密码并运行 fscl login [server-url] --password <pw> 后重试。若提示 No config found,说明未初始化,需运行 fscl init 并选择新建本地预算或连接现有服务器。

适用场景与限制:适合个人预算、账单、消费与债务管理,支持按参考文档进行导入、规则、信用卡策略与查询。资料未提供具体平台、收费、价格及效果信息;各项能力以实际命令行为与参考文件为准。