uniswap-ai

想象这样一个场景：你在深夜调试一个复杂的 Uniswap v4 Hook，写到权限标志配置时突然卡住了——14 个权限标志各自有什么风险？NoOp 攻击怎么防？这时你想起 Claude Code 里装了一个专门帮你写 Uniswap 的"老司机"插件，直接问它就行。这就是 Uniswap Labs 官方推出的 uniswap-ai——一套为 AI 编码助手量身打造的 Uniswap 开发工具包。

背景：Uniswap 为何自己做 AI 开发工具？

Uniswap 是以太坊生态中最大的去中心化交易所（DEX），V4 版本引入了革命性的 Hook 机制，允许开发者自定义 AMM 的每一个关键节点的行为——交易费用、流动性管理、时间锁等。这带来了巨大的灵活性，但代价是开发门槛陡然提高。一个 v4 Hook 涉及 Solidity 智能合约、EVM 内存模型、Uniswap 合约架构等多层知识，还要面对 NoOp rug pull、权限标志滥用等新型安全威胁。

Uniswap Labs 意识到，与其让社区各自摸索，不如官方出一套 AI 工具，把最佳实践和安全规范固化到 AI 能理解和复用的格式里。2024 年，uniswap-ai 仓库正式开源，目标很明确：让任何 AI 编码助手（Claude Code、Cursor、Cline 等）都能专业地协助开发者构建 Uniswap 相关项目。

核心功能：六把"瑞士军刀"

1. swap-integration（交易集成）——最常用

这是使用频率最高的 Skill，帮助开发者在任何应用场景中集成 Uniswap 兑换功能。它支持三种集成路径：

• Trading API：适合前端/后端，Uniswap 服务器端做最优路径计算，开发者只需调用接口
• Universal Router SDK：适合需要精细控制 swap 执行逻辑的场景，支持 v2/v3/v4 统一接口
• 直接合约调用：适合 Solidity 智能合约直接与 Uniswap 交互，例如通过 Universal Router 执行 swap

使用方式很简单——在 Claude Code 里直接描述需求（"帮我把 USDC 兑换成 ETH"），或者敲 /swap-integration 命令，AI 就会根据上下文选择最合适的集成方式。

2. v4-security-foundations（v4 安全基础）——最有深度

这是整套工具里最有技术含量的 Skill，专门解决 v4 Hook 开发中最棘手的安全问题。它覆盖了：

• 五大威胁模型：NoOp rug pull、权限标志滥用、delta 会计错误、访问控制绕过、路由器验证失败
• 14 个权限标志风险矩阵：每个标志的启用/禁用各有什么风险，AI 能给出具体场景分析
• Pre-deployment 审计清单：Hook 部署前必查的检查项
• OpenZeppelin Contracts Wizard 集成：通过 MCP 协议自动生成符合安全规范的 Hook 骨架代码

对于想深入 v4 Hook 开发的工程师来说，这相当于把 Certora/ABDK 审计报告和 50 多个生产级 Hook 案例的精华提炼成了 AI 可查询的知识库。

3. dca-bot / index-bot / copy-trade（自动交易三件套）——最有商业价值

这三个 Skill 构成了完整的链上自动交易工具集，全部构建在 swap-integration 之上：

• DCA Bot（定投机器人）：按固定周期把稳定币换成目标代币，支持条件触发（例如只在 TVL 增长时执行），适合长期定投策略
• Index Bot（指数机器人）：构建一个加权资产篮子，一次性完成多币种配置，并按周期自动再平衡
• Copy Trade Bot（跟单机器人）：监控指定钱包地址，自动镜像其交易行为，但有严格的保护机制——链过滤、资产匹配、仓位上限

值得注意的是，这三个工具是链无关的，不仅能在以太坊上跑，Uniswap 部署到的任何链（OP Stack、Arbitrum、Base 等）都能用。参考模板以 Robinhood Chain（chainId 4663）为例。

4. uniswap-cca（连续清算拍卖）——最前沿

CCA（Continuous Clearing Auction）是 Uniswap 推出的一种新型代币分发机制，相比传统的 IDO/ICO 有更好的价格发现机制。这个 Skill 帮助开发者配置和部署 CCA 智能合约，是目前 Uniswap 生态中最前沿的功能之一。

5. uniswap-driver（深度链接规划器）——最实用

不写代码也能用——这个 Skill 生成 Uniswap 界面的深度链接，可以精确指定交易参数（代币、数量、滑点等），用于构建导流工具或分析平台。

6. uniswap-viem（EVM 集成基础包）——地基

封装了 viem/wagmi 的最佳实践，是其他所有 Skill 的基础设施。所有其他插件都依赖 viem 与 EVM 链交互。

技术架构：Monorepo + Nx + TypeScript

项目采用 Nx monorepo 架构，结构清晰：

uniswap-ai/
├── packages/plugins/
│   ├── uniswap-trading/       # 兑换集成
│   ├── uniswap-hooks/         # v4 Hook 开发
│   ├── uniswap-trading-tools/ # 自动交易工具
│   ├── uniswap-cca/           # CCA 拍卖
│   ├── uniswap-driver/        # 深度链接
│   └── uniswap-viem/          # EVM 集成
├── evals/                     # AI 工具评测（Promptfoo）
└── docs/                      # VitePress 文档

技术栈：

• Node.js 22.x + Bun 作为包管理器（也支持 npm）
• TypeScript 全链路类型安全
• Nx 做 monorepo 管理和任务编排
• MCP（Model Context Protocol） 实现与 OpenZeppelin Contracts Wizard 的服务器端集成
• Promptfoo 做 AI 工具质量评测

上手体验：安装只需一行命令

# 方式一：通用 skills CLI（任意 AI 编码助手）
npx skills add Uniswap/uniswap-ai

# 方式二：Claude Code 专用
/plugin marketplace add uniswap/uniswap-ai
/plugin install uniswap-hooks       # 按需安装单个插件
/plugin install uniswap-trading

安装后，Claude Code 会自动识别仓库中的 CLAUDE.md 和 AGENTS.md 文件，在相关开发场景下激活对应的 Skill。

局限与风险：没有银弹

1. AI 生成代码仍需人工审计

AI 能帮你写 Hook 骨架、解释安全风险，但 v4 Hook 涉及真实资金，AI 生成的代码必须经过专业审计才能部署到主网。项目文档明确建议在生成后运行 /v4-security-foundations 做二次审计。

2. 定投/跟单工具不构成投资建议

这三个工具包含完整的法律免责声明，明确说明项目方不提供任何投资建议，用户需自行承担所有交易风险。在合规要求严格的市场（美国等）使用前需咨询法律意见。

3. 非 Web 应用，无法直接体验

没有 Demo 页面、没有在线沙箱，所有功能都需要在本地 Claude Code 环境中体验。对于不熟悉 AI 编码助手的开发者有一定学习成本。

4. Node.js 22.x 硬性要求

项目明确要求 Node.js 22.x，使用旧版本会导致兼容性问题。

行业意义：AI × DeFi 的里程碑尝试

Uniswap 是第一个由头部 DeFi 协议官方维护的 AI 开发工具集。它代表了 DeFi 协议从"文档驱动"向"AI 驱动"开发工作流的转型。类似地，当其他主流协议（MakerDAO、Aave、Curve）也开始推出官方 AI 工具时，会形成新的生态系统竞争维度——哪家协议的 AI 工具更好用，就会吸引更多开发者基于其生态构建应用。

223 颗星虽然不算多，但考虑到项目 2024 年才上线、主要面向专业开发者（而非普通用户），这个增速反映的是专业社区的认可。从 GitHub 活跃度（CI/CD 全自动、PR 自动审查）来看，Uniswap Labs 在认真维护这个项目，而非作秀式开源。

总结

uniswap-ai 是 Uniswap 官方推出的 AI 编码助手插件集，核心价值在于把 Uniswap 生态的专业知识（交易集成、v4 Hook 安全、自动交易策略）固化成 AI 可调用的 Skill。它不是面向终端用户的 Web 应用，而是开发者的"第二大脑"。如果你正在基于 Uniswap 构建产品，或者想深入学习 v4 Hook 开发，这套工具集值得花时间研究。