核心用法
sui-decompile 是一款专注于 Sui 区块链生态的智能合约源码获取技能。该技能本身为纯文档型 Markdown 技能，不包含可执行代码，其核心功能是通过浏览器自动化工具（如 Playwright 或 MCP browser）访问 Sui 区块链浏览器（Suivision 或 Suiscan），获取链上 Move 智能合约的源代码或反编译代码。
使用时，用户需提供目标合约的 package ID，技能会引导浏览器打开对应的区块链浏览器页面（如 https://suivision.xyz/package/{package_id}?tab=Code），然后通过 DOM 选择器提取代码表格中的内容。对于包含多个模块的复杂合约（如 DeepBook），技能支持逐个模块切换并分别提取代码。
该技能特别适用于以下场景：研究 DeFi 协议实现原理、学习优秀的 Move 合约设计模式、审计合约安全性、以及为开发新合约寻找参考实现。
显著优点
生态系统整合度高：与 Sui 开发技能套件深度协同，可与 sui-move（编写部署合约）、sui-coverage（测试覆盖率分析）、sui-agent-wallet（DApp 前端开发）形成完整开发闭环。
零依赖轻量级：作为纯文档技能，无第三方代码依赖，不引入额外的安全风险面，部署和使用极为轻量。
双源冗余设计：同时支持 Suivision（优先，可能提供官方验证源码）和 Suiscan（备选，提供 Revela 反编译代码）两个主流浏览器，确保数据可用性。
实战指导详尽：提供完整的服务器/无头环境配置方案，包括 xvfb 虚拟显示框架的使用，解决 headless 浏览器检测问题。
潜在缺点与局限性
反编译代码质量限制：Suiscan 提供的 Revela 反编译代码可能无法直接编译，仅适合作为分析参考，不能替代官方验证源码用于生产开发。
浏览器自动化依赖：功能实现依赖于外部浏览器自动化工具，需要正确配置 Playwright/Puppeteer 环境，对服务器环境有一定要求。
数据源可控性：数据来源于第三方区块链浏览器，而非直接查询 Sui 全节点，存在单点可用性风险，且浏览器界面变更可能导致提取逻辑失效。
个人开发者维护：由个人开发者（EasonC13）维护，非企业级团队，长期维护和更新保障相对有限。
适合的目标群体
- Sui/Move 合约开发者：需要研究现有协议实现、学习设计模式的开发者
- DeFi 安全研究人员：需要审计或分析链上合约安全性的专业人士
- 区块链教育从业者：需要获取真实合约案例用于教学讲解
- 智能合约入门学习者：希望通过阅读优质代码快速掌握 Move 语言实践
使用风险
性能与稳定性风险：浏览器自动化操作相比直接 API 调用性能较低，且受目标网站响应速度和可用性影响；大规模批量获取可能触发浏览器或网站的反爬机制。
依赖项配置风险：服务器环境需要正确安装和配置 xvfb、Puppeteer/Playwright 等依赖，配置不当可能导致功能失效或资源泄漏（如浏览器进程未关闭）。
数据准确性风险：反编译代码可能与原始源码存在差异，用于安全关键决策时需与官方验证源码交叉核对；浏览器渲染差异也可能导致代码提取不完整。
权限操作风险：文档中包含 sudo apt-get install xvfb 等系统权限操作示例，用户执行前需理解命令用途，避免在不信任的环境中盲目执行提权命令。