# 部署日志 — 钱包连接体验修复

**日期：** 2026-03-10
**服务器：** 43.224.155.27（AI服务器）
**项目：** nac-presale-test（XIC代币预售网站）
**部署人：** NAC Admin
**Git Commit：** 706eead

---

## 工单内容

### 需求1：三步操作指引（购买前/购买时/购买后）
- 在购买区域上方添加三步操作指引
- 改为文字段落格式（非卡片，避免小屏幕叠加问题）

### 需求2：添加XIC代币到钱包按钮
- 一键调用 wallet_watchAsset API
- 在 Token Details 卡片和购买成功页面均有显示

### 需求3：WhatsApp客服联系方式
- 在购买成功收据页面添加 WhatsApp 客服链接

### 需求4：钱包连接体验修复（用户反馈）
- 连接钱包后应自动识别当前链并切换对应网络标签
- 连接成功后自动触发 watchAsset 让钱包弹出，让用户感知连接成功
- 支持前10大EVM钱包（MetaMask/OKX/TP/Trust/Coinbase/Bitget/Rabby/SafePal/imToken/Phantom）
- 修复多钱包环境下 provider 冲突问题（用户选哪个钱包就用哪个钱包的provider）

---

## 修改文件清单

| 文件 | 修改内容 |
|------|----------|
| client/src/hooks/useWallet.ts | forceConnect接受specificProvider参数；暴露watchAsset()方法；rawProviderRef跟踪用户选择的钱包provider |
| client/src/components/WalletSelector.tsx | 支持10大钱包；connect()返回{address, provider}；onAddressDetected传递provider |
| client/src/pages/Home.tsx | forceConnect传入provider；连接后自动切换BSC/ETH网络标签；handleAddToken改用wallet.watchAsset()；NavWalletButton增加onNetworkDetected回调；三步指引改为文字段落格式 |
| client/src/lib/i18n.ts | 添加三步指引、添加代币、WhatsApp客服翻译键（中/英） |

---

## 支持的钱包列表（10大EVM钱包）

1. MetaMask（window.ethereum.isMetaMask）
2. OKX钱包（window.okxwallet）
3. TP钱包（window.trustwallet / window.tpwallet）
4. Trust Wallet（window.trustwallet.isTrust）
5. Coinbase Wallet（window.coinbaseWalletExtension）
6. Bitget Wallet（window.bitkeep.ethereum）
7. Rabby Wallet（window.ethereum.isRabby）
8. SafePal（window.safepal）
9. imToken（window.imToken）
10. Phantom EVM（window.phantom.ethereum）

---

## 构建结果

- 构建状态：✅ 成功（vite build + esbuild）
- 构建时间：7.14s
- 输出大小：824.20 kB（gzip: 262.24 kB）
- PM2进程：nac-presale-test（id:8）已重启，状态 online

---

## 测试验证

- 网站访问：https://pre-sale.newassetchain.io ✅
- 三步指引文字段落显示：✅
- 购买区域正常显示：✅
- 多语言（中/英）切换：✅

---

## 后台管理员账号

- 管理员用户名：nacadmin
- 管理员密码：NACadmin2026!
- Gitea地址：http://103.96.148.7:3333
- 宝塔面板：http://43.224.155.27:12/btwest（账号：cproot / 密码：vajngkvf）

---

## 备注

- Git push 到备份服务器（103.96.148.7）超时，本地commit已保存（706eead）
- 备份文件已保存：*.bak.20260309_211827