能力概览
UKey Wallet Agent 不只是登录或托管流程。它会把真实的钱包、兑换、行情和安全能力暴露给 AI Agent，同时把关键控制权保留在 UKey Wallet。
Wallet Operations
当用户想查询余额、收款地址、交易历史、BTC 地址类型，或发起转账时，通常会使用这一类能力。
| 用户意图 | 自然语言 | Skill 路由 |
|---|---|---|
| 查看当前钱包 | What wallet am I using? | UKey Wallet 会话 读取当前活动会话 |
| 展示收款地址 | Show my ETH receiving address. | UKey Wallet 会话 返回当前收款地址 |
| 查询余额 | Show my wallet balance on Ethereum. | UKey Wallet 会话 查询当前钱包余额 |
| 查询历史 | Show my last 5 BTC transactions. | UKey Wallet 会话 获取近期交易记录 |
| 指定 BTC 地址类型 | Show my BTC taproot address. | UKey Wallet 会话 返回指定 BTC 地址类型 |
| 发起转账 | Send 50 USDC to this address. | UKey Wallet 会话 完成校验、预览并请求确认 |
转账前应先向用户展示确认信息，包括资产、金额、接收方、目标链、费用信息，以及后续可能涉及的安全检查。
Swap and Bridge
当用户想交易、买入、卖出、兑换、跨链，或执行 BTC sign-only 流程时，会使用这一类能力。
| 用户意图 | 自然语言 | Skill 路由 |
|---|---|---|
| 获取报价 | Quote 1 ETH to USDC. | UKey Wallet Swap 只返回报价，不直接执行 |
| 构建交易 | Prepare the swap, but do not submit. | UKey Wallet Swap 在审核后准备订单 |
| 确认后执行 | Yes, execute the swap. | UKey Wallet Swap 只执行已经确认过的订单 |
| 查询状态 | What happened to this swap? | UKey Wallet Swap 跟踪已有订单 |
| 发现跨链支持 | Can I bridge USDC from Ethereum to Base? | UKey Wallet Swap 在报价前检查 bridge 支持情况 |
| BTC sign-only | Swap BTC to USDC using taproot and sign only. | UKey Wallet Swap 保留 taproot，并返回 signed 或 preview PSBT |
推荐流程是先报价、再做安全检查、再确认、再构建、最后执行。报价和执行不应放在同一个 assistant turn 中完成。
Market and Research
当用户想查询价格、趋势代币、Token 信息、K 线、流动性、持仓或市场研究内容时，会使用这一类能力。
| 用户意图 | 自然语言 | Skill 路由 |
|---|---|---|
| 单币价格 | What is the SOL price? | UKey Wallet Market 返回价格和 24 小时市场上下文 |
| Trending Tokens | What tokens are trending on Solana? | UKey Wallet Market 返回趋势代币列表 |
| Token 搜索 | Search BONK on Solana. | UKey Wallet Market 保留对应链上下文进行搜索 |
| Token 详情 | Show token info for USDC on Ethereum. | UKey Wallet Market 返回 Token 详情信息 |
| K 线数据 | Show ETH 1H candles. | UKey Wallet Market 返回图表数据 |
| 流动性 / 持仓 | Show liquidity for PEPE. | UKey Wallet Market 汇总流动性或持仓信息 |
Market 默认属于只读能力。如果用户随后要求买入或兑换，Agent 应先完成研究，再进入独立的交易确认流程。
Security Checks
当用户准备进行资金操作、合约交互，或询问某个 Token / 交易是否安全时，会使用这一类能力。
| 用户意图 | 自然语言 | Skill 路由 |
|---|---|---|
| Token 审查 | Is this token safe? | UKey Wallet Security 报告风险等级和原因 |
| 交易模拟 | What happens if I sign this? | UKey Wallet Security 在签名前模拟结果 |
| 授权风险检查 | Review this unlimited USDC approval. | UKey Wallet Security 明确提示无限授权风险 |
| 链不匹配拦截 | Send SOL to 0x... | 停止并报告 Solana / EVM 地址不匹配 |
| 假合约风险 | Swap 500 USDC to WETH at 0x... | 因 Token / Contract mismatch 停止继续执行 |
在高风险或信息不完整的情况下，应先阻断后续资金操作，直到用户明确接受风险为止。
Hardware Control
当用户想使用设备签名、验证设备真伪、修改 PIN / Passphrase，或让敏感操作走 clear signing 时，会使用这一类能力。
用户可见的交互路径仍然保持自然语言形式，例如连接设备、验证真伪、切换到硬件会话、按需选择 Passphrase 行为，并在设备上审核敏感操作。
完成硬件登录后，当前活动会话会切换到设备侧。之后的钱包查询、转账、兑换和签名命令，都会自动沿用当前硬件会话。