在Web3 DApp开发过程中，不少开发者使用Truffle框架完成合约开发、本地调试与联调测试，当需要对接欧逸Web3 APP做功能适配测试时，默认配置下Truffle会自动拉取最新版本的欧逸Web3 APP调试包，但很多开发场景中，我们需要测试适配特定旧版本、或是定制化版本的APP，这就需要手动修改Truffle中欧逸Web3 APP的下载版本，本文分享具体操作流程与注意事项。
前置准备
开始修改前,需要提前准备两项基础信息：一是确认你需要下载的目标欧逸Web3 APP的具体版本号；二是从官方渠道获取目标版本的合法下载地址，避免使用第三方来源的安装包带来安全风险，同时确保本地Truffle开发环境已经正常初始化。
分场景修改操作
根据修改需求是单项目生效还是全局环境生效,操作流程分为两种：
单项目指定版本修改（大多数开发场景适用）
如果只是当前开发项目需要指定特定版本的欧逸Web3 APP，修改步骤非常简单：
第一步，在项目根目录找到欧逸Web3的配置文件，如果使用了官方适配Truffle的开发插件，一般会生成ouyi-dev-config.json配置文件，打开后可以找到appVersion和downloadUrl两个核心字段；
第二步，将appVersion的数值修改为你需要的目标版本号，再将downloadUrl替换为对应版本的官方下载地址；如果是SDK依赖版本修改，只需要在项目根目录执行命令npm uninstall oy-web3卸载旧版本，再执行npm install oy-web3@[你的目标版本号] --save，即可自动更新package.json中的版本配置。
第三步，清除Truffle本地缓存：如果之前已经下载过旧版本安装包，需要手动删除Truffle缓存目录中旧的安装包，Mac系统缓存路径一般为~/.truffle/ouyi/，Windows系统路径一般为C:\Users\你的用户名\.truffle\ouyi\，删除旧包后重新启动Truffle开发服务，就会自动下载你指定版本的欧逸Web3 APP了。
全局Truffle环境默认版本修改
如果需要所有本地Truffle项目默认都使用指定版本,只需要修改全局Truffle插件的默认配置：找到全局node_modules目录下的欧逸Truffle插件目录，一般路径为{全局node路径}/node_modules/@ouyi/truffle-web3-provider/，打开目录中的default-config.js文件，修改默认的defaultAppVersion和默认下载地址，保存后重启终端即可全局生效。
注意事项
第一,修改完成后一定要做兼容性测试：不同版本的欧逸Web3 APP的开放API、交互逻辑存在差异，改完后需要测试签名授权、DApp跳转、链上交互等核心流程是否正常； 第二，避免缓存问题：如果修改完成后仍然下载旧版本，绝大多数情况是本地缓存没有清理，按照上文路径删除旧安装包即可解决； 第三，安全优先：所有版本安装包都要从欧逸官方渠道获取，不要使用第三方修改包，避免带来私钥泄露、合约被篡改等安全风险。
整体来看,修改Truffle中欧逸Web3 APP的下载版本操作并不复杂，只要找准对应配置项、清理缓存，就能快速切换到目标版本满足开发测试需求。