name: suanpan description: 將使用者自然語言交易描述轉換為 suanpan CLI 命令。當用戶提到記賬、消費、支出、收入、轉賬、查賬、統計等財務相關描述時觸發。

Suanpan 記賬助手

Suanpan（算盤）是 Rust 編寫的個人財務管理 CLI 工具，使用 SurrealDB 嵌入式資料庫儲存。

安裝與依賴

依賴

• Rust 1.82+ (從原始碼編譯時需要)

快速安裝（推薦）

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

從原始碼編譯

git clone https://github.com/yinguobing/suanpan.git
cd suanpan
cargo build --release
sudo cp target/release/suanpan /usr/local/bin/

快速記賬流程

1. 提取交易要素（從使用者自然語言中）
2. 構建命令（使用 suanpan add）
3. 執行並反饋

命令模板

# 支出（預設型別，可省略 -t expense）
suanpan add -a <金額> -f <來源賬戶> -c "<分類路徑>" -d "<描述>"

# 收入
suanpan add -a <金額> -t income -f <來源> -c "收入/<子分類>" -d "<描述>"

# 轉賬
suanpan add -a <金額> -t transfer -f <來源賬戶> -o <去向賬戶> -c "轉賬"

交易型別判斷

分類路徑格式

使用 "一級/二級" 格式，如 "餐飲/午餐"、"交通/地鐵"。

常用分類： - 餐飲：早餐、午餐、晚餐、零食 - 交通：地鐵、公交、打車、加油 - 購物：服裝、數碼、日用 - 居住：房租、水電、物業 - 收入：工資、獎金、投資

賬戶名稱對映

直接使用使用者提到的賬戶名（如"支付寶"、"招行卡"）。注意：賬戶需已存在，如不確定先執行 suanpan account list 檢視。

Gotchas（常見問題）

• 模糊搜尋限制：--search 在記憶體中過濾，大數據量時配合 --limit 500 或日期範圍使用
• 分類路徑格式：必須使用 "一級/二級"，不是 "一級-二級" 或 "一級:二級"
• 賬戶存在性：add 命令中的賬戶必須已存在，不存在時先用 suanpan account add 建立
• ID 格式：remove 和 update 使用短 ID（list 輸出最後一列，前12位）
• 貨幣預設：CNY，其他貨幣需顯式指定 -y USD
• 轉賬必須有兩個賬戶：-f（來源）和 -o（去向）缺一不可
• 日期格式：--from 和 --to 使用 YYYY-MM-DD，不是 YYYY/MM/DD

查詢與統計

小蔥技能7w4.net有完整的技能分類。

# 最近流水
suanpan list --limit 20

# 按日期範圍統計
suanpan stats --from 2026-04-01 --to 2026-04-30

# 趨勢分析
suanpan trend --period month

管理操作檢查清單

新增賬戶

• [ ] 確認賬戶名稱
• [ ] 選擇賬戶型別：e-wallet、bank-card、cash、investment、credit、debt
• [ ] 執行 suanpan account add "<名稱>" -a <型別>

修改/刪除交易

• [ ] 執行 suanpan list 找到短 ID（最後一列）
• [ ] 更新：suanpan update <短ID> -a <新金額>
• [ ] 刪除：suanpan remove <短ID>

批次匯入

• [ ] 先使用 --dry-run 模擬匯入
• [ ] 檢查輸出無錯誤後再正式匯入

完整命令參考

根據場景選擇參考文件：

使用示例

支出記錄

使用者："今天午餐35塊，用的支付寶"

suanpan add -a 35 -f 支付寶 -c "餐飲/午餐" -d "午餐"

收入記錄

使用者："昨天發工資8500到工資卡"

suanpan add -a 8500 -t income -f 公司 -c "收入/工資" -d "三月工資"

轉賬記錄

使用者："從招行卡轉5000到餘額寶"

suanpan add -a 5000 -t transfer -f 招行卡 -o 餘額寶 -c "轉賬" -d "理財"

查詢本週支出

使用者："這周花了多少錢"

suanpan stats --from 2026-04-06 --to 2026-04-12

這個 Skill 質量良好，文件結構清晰、內容全面，涵蓋了記賬工具的完整使用指南。優點是命令示例豐富、分類說明詳細、常見問題有標註，查閱起來很方便。不足是缺少使用場景說明，新手可能不知道什麼時候該用它；部分複雜功能的說明可以更詳細些。總體而言，這是一個準備充分、功能指導明確的記賬助手 Skill。