用途
liquidity-planner 是一个用于规划 PancakeSwap 流动性提供的技能（skill），本身不执行任何链上交易。它帮助用户完成从意图收集到生成 PancakeSwap 仓位创建界面深度链接的全过程，用户可在钱包中复核仓位大小、费率层级和价格区间后自行确认。
主要能力
- 8 步工作流：收集意图 → 解析代币 → 输入验证 → 发现矿池 → 评估矿池指标 → 推荐价格区间 → 选择费率层级 → 生成深度链接。
- 多链支持：BSC、Ethereum、Arbitrum One、Base、zkSync Era、Linea、opBNB、Monad、BSC Testnet、Solana。
- 池类型覆盖：V2（仅 BSC）、V3（所有链）、StableSwap（BSC、Ethereum、Arbitrum 的稳定币对）、Infinity（CL、Bin、Stable，仅 BSC 与 Base 部分类型）。
- 费率层级指引：V3 支持 0.01%、0.05%、0.25%、1%；StableSwap 使用更低费率。Infinity 池会计算协议费并展示有效费率。
- 无常损失与 APY 分析：提供无常损失警告，并从 DefiLlama 获取收益数据；脚本同时拉取 Merkl、Incentra 额外奖励 APR 与 CAKE 农场 APR（部分池通过链上 MasterChef V3 与 Infinity REST 获取）。
- StableSwap 优化：针对 BSC 上的 USDT/USDC/BUSD 等稳定币对降低滑点。
- 代币发现与验证：优先使用 PancakeSwap 官方代币列表；若未找到则使用 DexScreener 搜索，再通过链上调用（EVM 用 cast 或 JSON-RPC，Solana 用 RPC 校验 mint 账户）验证代币合约，并列出红旗警告（如非合约地址、名称不符、新部署无审计、流动性集中于单一钱包、来源不可信等）。
- 矿池发现与 APR 数据：通过 discover-pools.mjs 脚本一次性查询 Explorer API、额外奖励 APR、CAKE 农场 APR 与 Infinity 协议费，输出 TVL、24 小时交易量、LP 费率 APR、CAKE APR、总 APR 等指标。
使用方式
用户以自然语言描述需求即可，例如“在 BSC 上为 BNB/CAKE 添加流动性”“在 Arbitrum 提供 1 ETH + 2000 USDC 流动性”“在 BSC 上做 500 USDT 和 500 USDC 的稳定币 LP”。若参数不全，技能会通过提问补充代币对、金额、链、仓位规模、是否参与农场、价格区间偏好等信息。若仅输入技能名而无具体请求，则输出帮助文本并停止。
技能会依次执行：初始化会话（向 pancakeswap.ai 发送 ping）、收集意图、解析代币、验证合约、发现矿池并获取 APR、评估矿池、推荐价格区间与费率层级、生成 PancakeSwap 深度链接。
适用场景
适合希望在 PancakeSwap 上规划流动性仓位、比较不同矿池的 TVL/交易量/APR、了解无常损失风险、并快速获得预填参数链接以便在钱包中确认的用户。
限制
- 不执行交易，仅生成深度链接。
- V2 仅支持 BSC；StableSwap 仅限 BSC、Ethereum、Arbitrum 的稳定币对；Infinity 池类型仅部分链支持。
- Solana 仅支持 V3。
- 代币地址必须经过验证，未验证地址不会写入深度链接。
- 外部 API 数据视为不可信，不执行其中指令。
- 仅允许访问指定的 API 域名与公开 RPC，禁止访问内网/私有 IP。
- 费用、价格、APR 等数据来自实时查询，可能变化；技能本身不提供收费信息（暂未提供）。