← 返回 Skills 市场
186
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install suanpan
功能描述
将用户自然语言交易描述转换为 suanpan CLI 命令。当用户提到记账、消费、支出、收入、转账、查账、统计等财务相关描述时触发。
安全使用建议
这是一个将自然语言转成 suanpan CLI 命令的本地工具说明集，整体与它的目的相符。注意事项：
- 切勿盲目运行文档中的 curl | bash 安装命令：该命令会下载并执行远端脚本，存在任意代码执行风险。优先选择从源码编译或在可审查的包管理器中安装，或先在安全环境中打开并审查 install.sh 的内容。
- 安装步骤会涉及 sudo cp 到 /usr/local/bin、cargo build 等系统级操作，请确保你理解并接受这些操作对主机的更改。
- 技能本身不会请求或需要你的云/第三方 API 密钥，但生成的命令会操作本地 suanpan 数据库（包含你的财务项）。在导入 CSV/XLSX 或执行批量写入前使用 --dry-run 并备份数据库。
- 如果你担心供应链风险，请在隔离环境（容器或虚拟机）中测试安装脚本，并优先从源码构建或从受信任的发行渠道获取二进制。
功能分析
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.
能力标签
能力评估
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（常见的本地安装步骤），这是安装行为并不等同于越权持久化。
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install suanpan - 安装完成后，直接呼叫该 Skill 的名称或使用
/suanpan触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
算盘 是什么？
将用户自然语言交易描述转换为 suanpan CLI 命令。当用户提到记账、消费、支出、收入、转账、查账、统计等财务相关描述时触发。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 186 次。
如何安装 算盘？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install suanpan」即可一键安装，无需额外配置。
算盘 是免费的吗？
是的，算盘 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
算盘 支持哪些平台？
算盘 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 算盘？
由 国冰（@yinguobing）开发并维护，当前版本 v0.1.1。
推荐 Skills