Plaid 是一个通过 plaid-cli 命令行工具与 Plaid 金融平台交互的技能。它用于链接金融机构、获取账户余额以及查询交易记录。使用过程中不应打印或记录任何机密信息（如 client id、secret、access token）。
安装
使用以下命令安装：
go install github.com/jverdi/plaid-cli@0.0.2
配置
需要导出以下环境变量：PLAID_CLIENT_ID、PLAID_SECRET、PLAID_ENVIRONMENT（sandbox 或 production）。
可选环境变量：PLAID_LANGUAGE（en、fr、es、nl）、PLAID_COUNTRIES（US、CA、GB、IE、ES、FR、NL）。
可选配置文件位于 ~/.plaid-cli/config.toml，格式如下：
[plaid] client_id = "..." secret = "..." environment = "sandbox"
数据目录为 ~/.plaid-cli，用于存储令牌和别名。
链接与别名
链接机构：运行 plaid-cli link（会打开浏览器），可选择设置别名。
重新链接：plaid-cli link <item-id-or-alias>。
别名管理：plaid-cli alias <item-id> <name>，使用 plaid-cli aliases 列出所有别名。
账户与余额
列出账户和余额：plaid-cli accounts <item-id-or-alias>。
搜索交易
按日期范围拉取交易为 JSON，然后在本地过滤：
plaid-cli transactions <item-id-or-alias> --from 2024-01-01 --to 2024-01-31 --output-format json
jq -r '.[] | select(.name | test("grocery"; "i")) | [.date, .name, .amount] | @tsv'
可使用 accounts 输出中的 --account-id 缩小结果范围。
输出格式：json 或 csv。
监控交易
通过轮询滚动窗口并比较交易 ID 来检测新活动：
state=/tmp/plaid.txids
next=/tmp/plaid.txids.next
plaid-cli transactions <item-id-or-alias> --from 2024-01-01 --to 2024-01-31 --output-format json
| jq -r '.[].transaction_id' | sort > "$next"
if [ -f "$state" ]; then comm -13 "$state" "$next"; fi
mv "$next" "$state"
可使用 cron 进行定时调度。
注意事项
除非明确要求，避免使用 plaid-cli tokens，因为它会打印访问令牌。
在遇到 ITEM_LOGIN_REQUIRED 错误时会自动触发重新链接。
可识别的请求示例：
"Search transactions for Starbucks last month"
"Show balances for my Chase accounts"