> ## Content Index
> Fetch the complete content index at: https://yinguobing.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 算盘：一个专门给AI用的记账工具
- URL: https://yinguobing.com/blog/suanpan-a-skill-for-ai-agent-openclaw/
- Published: 2026-05-18T03:26:38.000Z
- Updated: 2026-09-08T02:18:26.000Z
- Description: 让AI管账？它把退款也算进支出了。折腾两天后我意识到，有些事就不该让AI做。
- Author: 尹国冰
- Tags: AI, Agent

事情是这样的。

我有将近 20 年的个人账本，一直用随手记。后来开始用 AI 助手，就想着让它帮我对对账。

结果算不对。

账本里有些支出是负数，其实是退款。但 AI 不知道，它把退款也算进支出了。我折腾了两天，放弃了。不是它不努力，是这个事它就不该干。

那换个思路。AI 擅长的是拿到准确数据以后做分析、做总结。但底层用 Decimal 还是 f64，它分不清，也不该让它去分。所以干脆写了个 CLI 工具，专门管精确计算。账本丢给它，AI 只管调用结果就行。

这就是**算盘**。

## 为什么叫这个名字

算盘是中国传统计算工具，意象就是精确、可靠。我觉得挺合适，就拿来用了。

## 设计思路

这个工具和传统软件不一样。传统软件是为用户设计的，用户要看 UI、要点按钮、要有交互。但算盘的使用者不是人，是 AI。

那 AI 需要什么？

**CLI 接口。** 对 AI 来说，命令行是最自然的交互方式。没有界面，没有按钮，输入输出都是纯文本，AI 调用起来非常舒服。

**精确计算。** 用 rust\_decimal，不会因为浮点精度算错账。这是个记账工具，算错数就没意义了。

**本地优先。** 所有数据存在本地，单文件数据库。AI 可以离线用，数据不往外传。账本这种东西放本地才放心。

就这几点，没有很复杂的设计。

## 效果怎么样

把算盘交给 AI 以后，同样的账本，结果完全不一样了。AI 调 `suanpan stats` 拿到精确数据，然后用自己的能力做分析。环比同比趋势，什么花样都能整。

因为底层的数是对的了，它就不用再靠猜了。

## 技术细节

Rust + SurrealDB，CLI 用 clap。用 Rust 主要图省事——编译成一个二进制文件，不需要装 Python 也不需要配环境，丢给 AI 就能跑。

可以直接从 GitHub 下载预编译版本，也可以自己编译：

```shell
curl -sSL https://raw.githubusercontent.com/yinguobing/suanpan/main/install.sh | bash

```

然后告诉你的 AI：「这是我的记账工具，用法看 README，以后账你帮我管。」就行了。

## 一点感想

做完这个东西我有一个感觉：未来给 AI 用的工具和给人用的工具，设计思路可能完全不一样。

人喜欢好看的东西。AI 不喜欢——它只关心接口清不清晰、输入输出有没有歧义、能不能精确执行。

人要的是一个漂亮的 App。AI 要的是一份清晰的文档加一个可执行文件。

如果你也在用 AI 处理事情，可以试试这个思路——遇到 AI 搞不定的事情，别跟它较劲，写个工具给它用就好了。

源代码开放：

[https://github.com/yinguobing/suanpan](https://github.com/yinguobing/suanpan?ref=yinguobing.com)