核心用法
FluxA Agent Wallet 通过 CLI 工具（scripts/fluxa-cli.bundle.js）为 AI 代理提供完整的链上金融操作能力，涵盖三大核心场景：
1. x402 支付（v3 协议）：当 API 返回 HTTP 402 时，代理可自动完成付费授权。流程包括创建意向授权（mandate-create）、用户签名授权、验证授权状态（mandate-status），最终生成支付令牌（x402-v3）并提交请求。
2. USDC 转账（Payout）：支持向任意钱包地址发送 USDC，需指定 --to 地址、--amount（原子单位）和 --id（交易标识）。
3. 收款链接（Payment Link）：创建可分享的支付链接用于收款，支持列表查询、详情获取、更新和删除操作。
所有命令输出 JSON 格式结果，成功返回 {"success": true, "data": {...}}，失败返回错误信息。首次使用需注册 Agent ID（init 命令）或通过环境变量预配置。
关键 UX 模式
授权操作（如 mandate 签名、转账审批）需要用户通过浏览器完成。代理必须先询问用户是否打开链接，再执行 open 命令或展示 URL。
金额格式
所有金额使用原子单位（USDC 为 6 位小数），如 1 USDC = 1000000。
显著优点
- 无私钥管理：代理无需接触或存储私钥，降低安全风险
- 标准化协议：基于 x402 开放标准，兼容性强
- 原子单位精确：避免浮点精度问题，适合金融场景
- 完整生命周期：支持 mandate 创建、查询、执行全流程
- 灵活配置：支持环境变量预配置，适合自动化部署
潜在缺点与局限性
- 外部依赖重：依赖 FluxA 托管服务（walletapi.fluxapay.xyz、agentid.fluxapay.xyz），存在单点故障风险
- 用户体验门槛： mandate 签名等操作需要用户离开对话环境完成浏览器授权，打断 Agent 自动化流程
- CLI 学习曲线：6 步支付流程（payload 获取 → mandate 创建 → 签名 → 状态验证 → 支付生成 → curl 提交）较为复杂
- 网络锁定：目前仅支持 USDC，未提及其他链或代币
- 调试难度：JSON 输出需代理自行解析，错误信息依赖 stderr/exit code
适合人群
- AI Agent 开发者：需要让代理具备真实支付能力的应用开发者
- 自动化服务提供商：希望按使用量计费（x402 模式）的 API 服务商
- 内容创作者/开发者：需要通过 Payment Link 实现加密货币收款的个体
- 企业级 Agent 部署：需要合规、可审计的链上支付流程的团队
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 服务可用性 | FluxA API 服务中断导致支付失败 | 实现降级逻辑，监控服务状态 |
| 授权中断 | 用户未在浏览器完成签名导致流程卡死 | 设置超时机制，允许用户重新触发 |
| 金额错误 | 原子单位换算错误导致多付或少付 | 封装金额转换函数，添加校验 |
| payload 格式 | 传入不完整 JSON 导致支付失败 | 严格验证 payload 包含 `accepts` 数组 |
| 环境泄露 | AGENT_TOKEN/JWT 泄露导致资金风险 | 使用密钥管理服务，定期轮换 |
技术评估
该 Skill 采用成熟的 CLI 调用模式，与 MCP 服务器架构兼容良好。但需注意其闭源性质——fluxa-cli.bundle.js 为预编译 bundle，无法审计内部逻辑，信任基础完全建立在 FluxA 品牌背书上。建议生产环境配置专用 Agent ID 并限制单账户资金上限。