核心用法
ATXSwap 是一款面向 BSC（币安智能链）生态的 DeFi 自动化技能，专注于 ATX 代币的全生命周期管理。其核心功能模块包括：
1. 钱包管理
- 单实例单钱包设计，不支持私钥导入，仅支持新建钱包
- 采用 MetaMask 兼容的加密 Keystore 格式存储于
~/.config/atxswap/keystore - 密码加密存储于系统级安全存储（Keychain/Secret Service）
- 提供
wallet.js export导出加密备份，严禁暴露原始私钥
2. 市场查询
- 实时价格查询：
query.js price - 余额与持仓：
query.js balance、query.js positions - 交易报价：
query.js quote <buy|sell> <amount> - LP 位置详情：包含本金估值、价格区间、手续费收益等关键指标
3. 交易执行
- 现货兑换：
swap.js buy/sell，支持自定义滑点（BPS） - 流动性操作：
liquidity.js add/remove/collect/burn，支持全范围、价格区间、百分比范围等多种模式 - 资产转账：
transfer.js支持 BNB、ATX、USDT 及任意 ERC20
4. 安全预览流程
所有写入操作（swap/transfer/liquidity）强制要求：先查询→展示预览→用户确认→执行，杜绝盲操作。
显著优点
- BSC 原生优化：内置 6 个公共 RPC 节点自动容错，支持自定义 RPC 集群
- PancakeSwap V3 深度集成：完整支持 V3 的集中流动性、NFT 仓位管理、手续费自动计算
- 安全设计严谨：密码/私钥零暴露、强制预览确认、删除钱包需双重确认+备份流程
- 人机可读输出：LP 持仓以 USDT/ATX 计价，避免原始 tick 数值
- 自动化就绪：JSON 结构化输出，适合 Agent 程序化调用
潜在缺点与局限性
- 单钱包限制：每个技能实例仅支持一个钱包，无法多账户管理
- 不支持私钥导入：必须从本技能新建钱包，迁移现有资产需外部转账
- Node.js 依赖：要求 Node.js 18+ 及 npm 环境，增加部署复杂度
- 无硬件钱包支持：仅软件 Keystore，无 Ledger/Trezor 等冷钱包集成
- BSC 单链锁定：不支持以太坊、Arbitrum 等其他链的 ATX 交易
- LP 本金估算浮动：基于当前价格的理论估值，与链上精确记账存在 wei 级误差
适合人群
- DeFi 自动化需求者：需要程序化执行定投、调仓、收益复投的用户
- LP 流动性提供者：希望自动监控仓位、收取手续费、调整价格区间的投资者
- Agent 开发者：构建交易机器人、资管助手的开发者
- 安全意识较强的用户：重视密钥保护、不接受私钥明文存储的用户
常规风险
| 风险类型 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 智能合约风险 | PancakeSwap V3 合约漏洞或升级问题 | 使用官方 SDK，关注审计报告 |
| 价格滑点损失 | 大额交易或低流动性时段导致预期外价格 | 强制预览报价，设置合理滑点上限 |
| 无常损失 | 集中流动性策略在价格波动中损失本金 | 教育用户理解 V3 LP 机制，提供范围选择建议 |
| 密钥管理风险 | 软件钱包被恶意程序窃取 | Keystore 加密+系统安全存储，建议配合系统级防护 |
| 操作确认绕过 | Agent 误触发或用户误确认 | 严格执行"预览→确认→执行"流程，大额交易需显式"yes" |
| RPC 单点故障 | 节点延迟或返回错误数据 | 内置多节点轮询，支持自定义备用 RPC |
总体评估：ATXSwap 是一款功能完整、安全设计到位的 BSC DeFi 自动化工具，适合对 ATX 生态有深度参与需求的用户，但需注意其单链、单钱包的技术约束。