面向以太坊等链的交互工具（React + JS + Ethers），已整合 Tauri v2，可直接开发与打包桌面应用。
当前状态
- 仅保留主分支
main，历史快照以 tag 方式保留：pre-merge-master、pre-merge-tauri-version、发布点v0.2.7。 - 已迁移到 Vite（保留 CRA 以便回退），Tauri 联动端口为
9754。
功能概览（持续完善）
- 钱包基础：创建、助记词恢复、转账、基础数据
- 参考：
src/components/ethers/wallet_basic_functions/
- 参考：
- 钱包增强：事件监听、交易历史、聚合器
- 参考：
src/components/ethers/wallet_upgrate_functions/
- 参考：
- 余额/代币：ETH 余额、ERC20/721/1155 查询、通用合约交互
- 参考：
src/components/ethers/GetBalance/,src/components/ethers/GetTokenBalance/
- 参考：
- 批量任务工作台：批量钱包生成、批量余额查询、批量转账、多链 Gas 面板
- 参考：
src/components/batch/,src/container/BatchContain/
- 参考：
- 全局配置与日志：跨页面复用链/RPC/API Key，统一查看任务执行日志
- 参考：
src/state/,src/components/shared/GlobalSettingsDrawer.jsx,src/components/shared/TaskLogDrawer.jsx
- 参考：
- Solana：工具区规划中（逐步补齐基础查询与批量交互）
目录结构（节选）
src-tauri/：Tauri 配置与 Rust 端src/：React 前端代码（CRA）public/：静态资源（CRA）package.json：脚本与依赖（含@tauri-apps/cli）.env：本地环境变量（含PORT=9754）
- Node.js ≥ 20.18（推荐 20.18.0）与 npm（或 pnpm/yarn 自行替代）
- Rust 稳定版工具链：
rustup,cargo - Windows（开发/打包）：需安装 Visual Studio C++ 构建工具（Desktop development with C++）
- 安装依赖：
npm install
- 开发（Vite 浏览器预览，推荐）：
npm run dev:vite→http://localhost:9754
- 开发（Tauri 桌面版调试，走 Vite）：
npm run tauri:dev
- 构建（Web 静态站点 via Vite）：
npm run build:vite→ 输出到dist/
- 构建（Tauri 桌面应用）：
npm run tauri:build→ 输出到src-tauri/target/release/bundle/
- 兼容保留（可选）：
- CRA 开发：
npm start（端口仍取.env中PORT=9754） - CRA 构建：
npm run build→build/
- CRA 开发：
- 版本统一以
package.json:1为准，执行npm version自动同步到：src-tauri/tauri.conf.json:1的versionsrc-tauri/Cargo.toml:1的[package] version
- 命令示例：
- 补丁升级：
npm version patch（如 0.2.7 → 0.2.8） - 次版本：
npm version minor - 主版本：
npm version major
- 补丁升级：
- 同步逻辑位于：
scripts/sync-version.js:1，通过package.json的scripts.version钩子自动执行。
- 本地执行：
npm version patch|minor|major- 自动：同步 Tauri 与 Cargo 版本，并创建 commit + tag（含同步的文件）
- 自动：执行
postversion推送到远端（含 tag）
- GitHub Actions（见
.github/workflows/tauri-release.yml:1）会在v*tag 触发，三平台打包并发布 Release。 - 如需夜构产物（不发 Release），参见
.github/workflows/tauri-nightly.yml:1。
- 端口（开发）：
.env:1设置PORT=9754src-tauri/tauri.conf.json:6→build.devUrl = "http://localhost:9754"
- 构建路径（生产）：
- Vite 输出
dist/（src-tauri/tauri.conf.json:6→build.frontendDist = "../dist"） - CRA 输出
build/（兼容保留）
- Vite 输出
- 常用脚本（
package.json:33起）：- Vite：
dev:vite、build:vite、preview:vite - CRA：
start、build - Tauri：
tauri:dev、tauri:build
- Vite：
.env:1示例：PORT=9754（开发端口）- 已兼容两种风格：
- CRA：
REACT_APP_ganacheAddress、REACT_APP_ganacheRpc、REACT_APP_BASE_URL - Vite：
VITE_ganacheAddress、VITE_ganacheRpc、VITE_BASE_URL
- CRA：
- 代码中已提供兼容读取（见
src/env.js:1），可逐步迁移为VITE_*。
- 如使用 Etherscan API（查询），请自行配置 API Key（可放入
.env以REACT_APP_...形式）。 - 访问主网/测试网请配置可靠的 RPC（Infura/Alchemy/自建节点等）。
- 端口占用：如 9754 被占用，修改
.env的PORT，同时更新src-tauri/tauri.conf.json的devUrl。 - Tauri 打包失败：确认 Rust 工具链与平台构建依赖安装完整；Windows 需 MSVC。
- 依赖安装失败：切换国内源或使用 pnpm/yarn；Node 版本需满足 18+。
- 仅保留
main分支，旧分支已清理：master、tauri-version（合并并入）。 - 历史快照与发布点：
pre-merge-master、pre-merge-tauri-version、v0.2.7。
欢迎提交问题与建议，后续会继续补充功能与文档（尤其是批量任务、事件监听与交易历史的使用说明）。