← Back to Skills Marketplace
186
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install suanpan
Description
将用户自然语言交易描述转换为 suanpan CLI 命令。当用户提到记账、消费、支出、收入、转账、查账、统计等财务相关描述时触发。
Usage Guidance
这是一个将自然语言转成 suanpan CLI 命令的本地工具说明集，整体与它的目的相符。注意事项：
- 切勿盲目运行文档中的 curl | bash 安装命令：该命令会下载并执行远端脚本，存在任意代码执行风险。优先选择从源码编译或在可审查的包管理器中安装，或先在安全环境中打开并审查 install.sh 的内容。
- 安装步骤会涉及 sudo cp 到 /usr/local/bin、cargo build 等系统级操作，请确保你理解并接受这些操作对主机的更改。
- 技能本身不会请求或需要你的云/第三方 API 密钥，但生成的命令会操作本地 suanpan 数据库（包含你的财务项）。在导入 CSV/XLSX 或执行批量写入前使用 --dry-run 并备份数据库。
- 如果你担心供应链风险，请在隔离环境（容器或虚拟机）中测试安装脚本，并优先从源码构建或从受信任的发行渠道获取二进制。
Capability Analysis
Type: OpenClaw Skill
Name: suanpan
Version: 0.1.1
The skill bundle provides a natural language interface for the 'suanpan' financial CLI tool. It is classified as suspicious primarily because the SKILL.md file includes a high-risk 'Quick Install' instruction that uses the 'curl | bash' pattern to download and execute a remote script (https://raw.githubusercontent.com/yinguobing/suanpan/main/install.sh). While this is a common installation method for CLI tools, it bypasses package management security and poses a significant risk of remote code execution or supply chain compromise if the source repository is compromised.
Capability Tags
Capability Assessment
Purpose & Capability
技能声明是将自然语言的财务描述转换为 suanpan CLI 命令；SKILL.md 和 references 文档均仅描述 suanpan 的命令、参数和使用场景，所需项（无环境变量、无外部凭据）与目的匹配。包含的安装与使用说明与 suanpan 工具本身相关，未请求与功能不相干的权限或凭据。
Instruction Scope
运行时指令集中主要是提取交易要素并构建/展示 suanpan 命令，未直接要求读取系统中与任务无关的敏感文件或外发用户数据。但文档建议用户安装并运行 suanpan（包括 curl | bash 安装脚本、从源码编译、sudo cp 到 /usr/local/bin），这些操作会在本地主机上执行并改变系统状态——这是与工具使用相关的合理行为，但属于需要用户审查的风险点（见下文）。
Install Mechanism
技能为 instruction-only，但文档推荐使用 curl -sSL https://raw.githubusercontent.com/yinguobing/suanpan/main/install.sh | bash 来安装。该 URL 是 GitHub raw（常见托管），但以管道方式直接执行远端脚本会执行任意远端代码；另提供从源码编译的替代方法（git clone + cargo build）。建议在信任源码和发布者前避免无审查地执行 curl|bash。
Credentials
manifest 未声明任何环境变量或凭据，SKILL.md 也未要求访问额外的密钥或跨服务凭证。技能只涉及本地命令和本地数据导入路径（如导入 CSV/XLSX），请求的权限与其陈述的功能相称。
Persistence & Privilege
技能没有 always:true，也不请求修改其他技能或系统范围的 agent 配置。文档中有建议将二进制复制到 /usr/local/bin（常见的本地安装步骤），这是安装行为并不等同于越权持久化。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install suanpan - After installation, invoke the skill by name or use
/suanpan - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- 添加了“安装与依赖”说明，详细介绍了 Rust 依赖、快速安装脚本和源码编译流程。
- 小幅调整文档结构，将安装说明置于文档前部，提升易用性。
- 去除月度报表示例。该功能面向人类用户。
- 其余说明和命令模板保持不变。
v0.1.0
Initial release of Suanpan skill for CLI-based personal finance management:
- Converts users' natural language financial descriptions (e.g., expense, income, transfer) into suanpan CLI commands.
- Supports automatic extraction of transaction details (amount, type, category, account) from user input.
- Provides comprehensive guidance for adding, querying, modifying, and deleting transactions.
- Includes usage instructions for reporting, analytics, and account/category management.
- Offers practical examples and common troubleshooting tips to streamline bookkeeping workflow.
Metadata
Frequently Asked Questions
What is 算盘?
将用户自然语言交易描述转换为 suanpan CLI 命令。当用户提到记账、消费、支出、收入、转账、查账、统计等财务相关描述时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 186 downloads so far.
How do I install 算盘?
Run "/install suanpan" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 算盘 free?
Yes, 算盘 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 算盘 support?
算盘 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 算盘?
It is built and maintained by 国冰 (@yinguobing); the current version is v0.1.1.
More Skills