## 📖 关于
**Web3 Antivirus Desktop** 是一款原生桌面应用，将整个 W3A 安全技术栈集中于一处。浏览器扩展守护您的标签页，Snap 保护 MetaMask，而桌面端 agent 则监控您的整个系统：已连接的钱包、剪贴板、发往 dApp 的网络流量以及本地密钥库。
## ✨ 功能
| | 模块 | 功能描述 |
|---|---|---|
| 🛡️ | **Web3 防火墙** | 在您签署交易前，拦截钓鱼 dApp、蜜罐和恶意合约 |
| 🧪 | **交易模拟** | 在本地模拟交易结果并揭示实际的余额变化 |
| 🧬 | **钱包毒性评分** | 针对任何地址进行 AI 驱动的风险评估，并为受制裁或可疑钱包提供 AML 标签 |
| 🎯 | **地址投毒监控** | 实时捕获混淆地址攻击——在您点击“发送”之前 |
| 🔍 | **深度合约分析** | ABI 和 bytecode 审查，配备 20 多种威胁检测器并提供通俗易懂的解释 |
| 🗝️ | **授权管理器** | 检测危险的 `approve` / `setApprovalForAll` 调用，并支持一键撤销 |
| 📋 | **剪贴板防护** | 检测会篡改钱包地址的剪贴板劫持恶意软件 |
| 🌐 | **DNS 与域名防护** | 本地 DNS 过滤，拦截伪装成主流 dApp 的相似域名 |
| 🔔 | **实时警报** | 针对 rug-pull、蜜罐和资产抽干企图发送原生 OS 通知 |
| 🧩 | **多钱包支持** | MetaMask、Rabby、Trust、Ledger Live、Phantom、Keplr 等 |
## 📥 下载
| Windows | macOS | Linux |
|:---:|:---:|:---:|
| [⬇️ `.msi`](https://github.com/web3-antivirus/desktop/releases/latest) | [⬇️ `.dmg` (Intel + Apple Silicon)](https://github.com/web3-antivirus/desktop/releases/latest) | [⬇️ `.AppImage` / `.deb` / `.rpm`](https://github.com/web3-antivirus/desktop/releases/latest) |
| Windows 10/11 (x64, ARM64) | macOS 12+ | Ubuntu 20.04+, Fedora 36+, Arch |
包管理器：
```
# Windows (winget)
winget install Web3Antivirus.Desktop
# macOS (Homebrew)
brew install --cask web3-antivirus
# Linux (Flatpak)
flatpak install flathub io.web3antivirus.Desktop
```
## 🚀 快速开始
1. 为您的 OS **下载并安装**对应的构建版本。
2. 启动应用——🛡️ 图标将出现在您的系统托盘中。
3. 点击 **“连接钱包”** 并选择一个提供商（或输入公开地址以进入只读模式）。
4. 打开 **仪表板** 标签页——您将看到毒性评分、活跃授权以及最近的交易。
5. 大功告成。应用会在后台默默保护您。
## 🖼 截图
## 🧱 技术栈
- **运行时：** [Tauri 2](https://tauri.app/) + Rust —— 二进制文件体积小，内存占用低
- **UI：** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui
- **状态：** Zustand + TanStack Query
- **Web3：** viem · wagmi · ethers.js · @solana/web3.js
- **安全引擎：** 内部 Rust 模块 + [W3A Security API](https://web3antivirus.io/)
- **存储：** 通过 `sqlx` 实现的加密 SQLite · 密钥存储在 OS 钥匙串中
- **CI/CD：** GitHub Actions · 通过 Tauri Updater 实现自动更新（Ed25519 签名）
## 🛠 从源码构建
要求：**Node.js 20+**、**pnpm**、**Rust 1.77+**。
```
# 1. Clone 仓库
git clone https://github.com/web3-antivirus/desktop.git
cd desktop
# 2. 安装依赖
pnpm install
# 3. 带 hot-reload 的 Dev 模式
pnpm tauri dev
# 4. Production build
pnpm tauri build
```
编译后的二进制文件位于 `src-tauri/target/release/bundle/`。
开发前置条件
- **Windows：** Microsoft C++ Build Tools, WebView2
- **macOS：** Xcode Command Line Tools
- **Linux：** `webkit2gtk`, `libayatana-appindicator3-dev`, `librsvg2-dev`
详情请参阅 [`docs/BUILDING.md`](./docs/BUILDING.md)。
## 🗂 项目结构
```
desktop/
├── src/ # React frontend
│ ├── components/ # UI components
│ ├── features/ # Modules: firewall, dashboard, approvals…
│ ├── hooks/ # Custom hooks
│ └── lib/ # API clients, utilities
├── src-tauri/ # Rust backend (security core)
│ ├── src/
│ │ ├── engine/ # Contract analysis engine
│ │ ├── monitors/ # Clipboard, DNS, network guards
│ │ └── ipc/ # IPC commands for the frontend
│ └── tauri.conf.json
├── docs/ # Documentation and screenshots
└── .github/workflows/ # CI/CD
```
## 🗺 路线图
- [x] MVP：防火墙 + 仪表板 + 授权管理器
- [x] 多链：Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base
- [x] 签名的自动更新
- [ ] **2026 年第三季度** — 原生 Ledger / Trezor 集成
- [ ] **2026 年第三季度** — 支持 Solana 和 TON
- [ ] **2026 年第四季度** — 本地 ML rug-pull 检测模型（离线模式）
- [ ] **2026 年第四季度** — 与 Telegram Mini App 进行移动端同步
- [ ] **2027 年第一季度** — 面向第三方钱包的开源 SDK
完整的待办事项位于[项目](https://github.com/web3-antivirus/desktop/projects)中。
## 🔒 安全与隐私
- 私钥**绝不**离开您的设备，也绝不会发送至 W3A 服务器。
- 所有 Security API 调用均通过 HTTPS 进行，敏感查询在客户端进行哈希处理。
- 自动更新使用 Ed25519 签名——无法被篡改。
- 代码库会定期接受审计（参见 [`docs/audits/`](./docs/audits)）。
## 📄 许可证
基于 **MIT License** 分发——参见 [`LICENSE`](./LICENSE)。
.jpg)
.jpg)
.jpg)
.jpg)