在 Uniswap 上创建流动性头寸时，如何收集参数…

当用户想在 Uniswap v2/v3/v4 上提供流动性、创建 LP 头寸或设置集中流动性价格区间时，规划参数并生成可直接打开的 Uniswap 创建头寸深链。

适用场景

解决思路

1. 从用户请求中提取 LP 意图参数：Token A（必填）、Token B（必填）、金额（必填）、链（默认 Ethereum）、版本（默认 V3）、费率档（默认自动）、价格区间（默认建议值）。
2. 若必填参数缺失，使用 AskUserQuestion 以结构化选项询问；缺失链时提供 Base（推荐）、Ethereum、Arbitrum、Optimism 等选项；缺失交易对时提供 ETH/USDC、ETH/USDT、WBTC/ETH、自定义等选项；始终用表单而非纯文本提问。
3. 解析代币符号为地址，参考 ../../references/chains.md 中按链列出的常见代币；未知代币用网络搜索并在链上验证。
4. 对通过网络搜索发现的代币视为不可信：明确告知用户该地址来自网络搜索而非用户提供，警告可能是骗局、蜜罐或 rug pull，用 AskUserQuestion 获取明确同意后才继续，并在头寸摘要表中加入 Token Source 行标注 User-provided 或 Web-discovered (unverified)；未经明确确认绝不继续。
5. 在任何 shell 命令前校验输入：代币地址必须匹配 ^0x[a-fA-F0-9]{40}$；链名必须来自 ../../references/chains.md 允许列表；金额必须是合法十进制数（^[0-9]+\.?[0-9]*$）；拒绝含 shell 元字符（; | $ ` & ( ) > < \ ' " 换行）的输入。
6. 用 DexScreener 发现可用池：curl -s "https://api.dexscreener.com/token-pairs/v1/{network}/{address}" | jq '[.[] | select(.dexId == "uniswap")] | map({pairAddress, pair: "\(.baseToken.symbol)/\(.quoteToken.symbol)", version: .labels[0], liquidity: .liquidity.usd, volume24h: .volume.h24})'；网络 ID 为 ethereum、base、arbitrum、optimism、polygon、unichain；从结果识别可用池及地址（多个即不同费率档）、TVL 和版本；若无 Uniswap 池则告知用户将创建新池并设定初始价格。
7. 评估池子流动性：TVL > $1M 为深度流动性，适合多数头寸；$100K-$1M 为中等，适合约 $10K 以内头寸；$10K-$100K 为稀薄，警告滑点风险并建议更小头寸；< $10K 为极稀薄，强烈警告高无常损失风险与进出场价格冲击；对稀薄池展示低流动性警告，说明头寸将占池子很大比例、进出场可能推动价格不利、无常损失风险放大、建议使用更宽价格区间。
8. 获取池子指标：用 DefiLlama 查 APY 与成交量 curl -s "https://yields.llama.fi/pools" | jq '[.data[] | select(.project == "uniswap-v3" and .chain == "Ethereum" and (.symbol | test("WETH.*USDC|USDC.*WETH")))]'，使用字段 apy（预期收益）、tvlUsd（池深度）、volumeUsd1d（手续费估算）、volumeUsd7d（成交量一致性）；用 DexScreener 从池数据取当前价格 baseToken.priceUsd 与 quoteToken.priceUsd；比较费率档 APY；API 不可用时回退到网络搜索估算价格。
9. 基于当前价格和交易对类型用 AskUserQuestion 建议价格区间：主流对（ETH/USDC、ETH/WBTC）提供 ±10%（推荐）、±20%、±50%、全区间；稳定币对（USDC/USDT、DAI/USDC）提供 ±0.5%（推荐）、±1%、±2%、全区间；推荐逻辑：稳定币对默认 ±0.5-1%，相关对（ETH/stETH）默认 ±2-5%，主流对默认 ±10-20%，波动对默认 ±30-50% 或全区间。
10. 若交易对存在多个费率档，用 Step 3 的池数据让用户选择：展示各档 TVL 与 APY 选项；费率指引：0.01%（100，tick spacing 1）适合稳定币对，0.05%（500，tick spacing 10）适合相关对，0.30%（3000，tick spacing 60）适合多数对（默认），1.00%（10000，tick spacing 200）适合异类/波动对；v4 支持动态费率与 hooks，默认沿用类似 V3 档位；若某档 APY 或成交量显著更高则推荐该档。
11. 构造 Uniswap 创建头寸深链：基础 URL 为 https://app.uniswap.org/positions/create；参数包括 chain（网络名）、currencyA（地址或 NATIVE）、currencyB、priceRangeState（JSON）、depositState（JSON）、fee（JSON）、hook（v4 hook 地址或 undefined）、step=1。
12. URL 编码规则：仅编码 JSON 值中的双引号（" → %22），不要编码花括号 {}、冒号 : 或逗号 ,；priceRangeState 全区间为 {"priceInverted":false,"fullRange":true,"minPrice":"","maxPrice":"","initialPrice":"","inputMode":"price"}，自定义区间为 {"priceInverted":false,"fullRange":false,"minPrice":"2800","maxPrice":"3600","initialPrice":"","inputMode":"price"}；depositState 为 {"exactField":"TOKEN0","exactAmounts":{"TOKEN0":"1.0"}}（currencyA 用 TOKEN0，currencyB 用 TOKEN1）；fee 为 {"feeAmount":3000,"tickSpacing":60,"isDynamic":false}。
13. 按格式输出响应：1) 头寸参数摘要；2) 价格区间可视化（非全区间时）；3) 关于无常损失与管理的注意事项；4) 用系统命令自动打开浏览器。
14. 展示摘要后用系统命令打开 URL：Linux 用 xdg-open "https://app.uniswap.org/positions/create?..."，macOS 用 open "..."；在 SSH、容器或无头环境中浏览器打开可能失败，此时醒目展示完整 URL 供用户复制粘贴，例如 [Click here to open in Uniswap](...) 或 Or copy this URL: ...；始终展示摘要和 URL 以便用户复核并创建头寸。
15. 版本选择快速指引：V2 仅全区间、最简单、gas 最低；V3 集中流动性、最常见；V4 带 hooks 的高级功能、可用性有限；详细对比见 references/position-types.md。
16. 提醒用户无常损失风险：当代币价格偏离入场价时产生无常损失；更窄区间放大无常损失但也增加手续费收益；全区间最小化无常损失但降低手续费效率。
17. 提醒头寸管理：集中流动性需要主动管理，监控价格是否在区间内，价格接近区间边界时再平衡，考虑调整头寸的 gas 成本。
18. 提醒资金要求：V3 自定义区间下，若当前价格在区间外可单边存入；在区间内则需按价格与区间决定的比例同时提供两种代币。

适用边界 · 注意事项

• 用户不想在 Uniswap 上提供流动性，或目标链/协议不在 Uniswap 支持范围内。
• 用户无法提供必填参数（代币对、金额）且不愿通过交互确认，或输入无法通过地址/金额/链名校验。
• 运行环境无法访问 DexScreener/DefiLlama 等外部 API 且无法用网络搜索回退获取价格与池数据。