SafeW如何开启文件上传时的病毒自动扫描？
功能定位：为什么钱包也要扫毒
SafeW 的核心关键词「文件上传病毒自动扫描」并不是传统杀毒概念，而是为「合约导入、NFT 源文件、固件升级包」三类场景提供的可审计前置检查。任何文件先被送到本地沙箱，调用链上风险引擎的 18 家审计库做哈希比对，再决定是否放行上链或写入安全飞地。这样一来，即使攻击者把恶意固件伪装成「硬件升级包」，也能在点击确认前被拦截，并自动生成符合 ISO 27001 要求的「拒绝日志」。
与系统级杀毒不同，SafeW 的扫描结果会同步到「合规看板」，方便企业用户直接把报告递交给四大会计师事务所。个人用户则可把日志导出成 PDF，作为被盗申诉的辅助材料。该功能在 v6.3.0 桌面端默认关闭，移动端因沙箱权限限制仅提供「只读告警」，需要手动开启「本地扫描代理」。
版本差异：桌面端与移动端能力对照
| 平台 | 最低版本 | 扫描引擎 | 日志留存 |
|---|---|---|---|
| Windows | v6.3.0 | 本地沙箱 + 云哈希 | 30 天本地 + 永久链上索引 |
| macOS | v6.3.0 | 同上 | 同上 |
| Android | v4.1 | 仅云哈希 | 7 天本地缓存 |
| iOS | v4.1 | 仅云哈希 | 3 天本地缓存 |
经验性观察：桌面端启用本地沙箱后，4 GB 固件包扫描耗时约数十秒；移动端因仅做云哈希，同样文件可在亚秒级返回结果，但遇到新型木马可能出现「零日漏报」。若业务对合规要求高于实时性，优先使用桌面端。
桌面端开启路径（Windows & macOS）
最短路径
- 打开 SafeW → 右上角「设置」⚙️ → 「安全实验室」→「文件防护」。
- 将「上传前病毒扫描」开关拨到「开启」，此时系统会弹出 UAC/Keychain 授权，请允许 SafeW 写入临时沙箱目录。
- 在「扫描模式」中选择：
- 标准模式（哈希+特征库，推荐）
- 深度模式（完整静态分析，耗时翻倍，适合固件包）
- 点击「保存并重启服务」，界面底部出现绿色提示「FileGuard 已就绪」即表示成功。
失败分支与回退
若重启后提示「沙箱目录不可写」，请检查是否被第三方杀毒锁定。可临时把 SafeW 安装目录下的 sandbox/ 文件夹加入白名单，然后再次「重载服务」。仍失败时，可在同一页面右上角点击「回退到云哈希」，功能会退化为移动端同等能力，日志依旧保留。
移动端开启路径（Android & iOS）
由于系统沙箱限制，移动端无法本地解包，只能把文件哈希上传到 SafeW 中继节点做比对。开启步骤如下：
- SafeW App →「我」→「安全中心」→「文件上传保护」→ 开启「云哈希检查」。
- iOS 18 用户需额外在「系统设置-隐私-本地网络」允许 SafeW 访问，否则会出现「OSError: 104」。
- Android 15 若开启「自适应连接」privacy tool，需手动在 SafeW-设置-网络里打开「允许按量网络」，否则后台续传会中断。
注意：移动端不做本地隔离，若文件含零日木马，可能出现「云哈希未命中」的漏报。经验性观察，漏报概率低于 1%，但对金库级别操作仍建议回到桌面端完成。
例外策略：什么时候跳过扫描
SafeW 允许对「可信白名单」跳过扫描，但需满足两条底线：1. 文件哈希曾在 30 天内通过深度模式；2. 写入人地址在链上多签列表内。配置入口在「文件防护」→「高级」→「可信哈希库」。企业用户可批量导入 CSV（格式：hash,blockHeight,multiSigAddress），导入前请把文件编码调成 UTF-8，否则法语、德语特殊字符会乱码。
不建议把「社区空投 NFT」直接加入白名单。经验性观察，部分攻击者会先广播干净哈希，等用户加入白名单后再替换恶意元数据，形成「哈希白名单+内容投毒」组合攻击。若必须放行，请改用「限时 24h 临时白名单」，并在操作结束后手动清除。
与第三方 Bot 协同：权限最小化原则
SafeW 并未提供官方 Bot，但允许通过「只读 API Key」把扫描结果推送到第三方归档机器人。生成路径：「设置」→「开发者」→「新建只读 Key」，权限仅勾选 file_scan_result:read，有效期建议设为 7 天。这样即使 Bot 被攻破，攻击者也只能拿到历史哈希，无法上传或删除日志。
示例：某 DAO 使用 Telegram 归档机器人，把每日扫描摘要推送至 #audit-log 频道。频道仅允许审计角色查看，且机器人未授予任何钱包操作权限。一旦 Key 泄露，只需在 SafeW 控制台「一键吊销」即可，无需更换钱包地址。
故障排查：现象→原因→验证→处置
现象 1：桌面端提示「FileGuard 服务未就绪」
可能原因：沙箱目录被占用或杀软拦截。验证：打开系统事件查看器，搜索 SafeW.FileGuard，若出现「Access Denied」即确认。处置：把 sandbox/ 加入杀软白名单，再点「重载服务」。
现象 2：macOS 15 循环弹「想访问系统隐私-文件」
原因：SafeW 未获得「完全磁盘访问」权限。验证：系统设置里搜索 SafeW，若右侧开关为灰色即确认。处置：手动把 /Applications/SafeW.app 拖入列表，退出重登。
现象 3：合规看板导出 CSV 乱码
原因：控制台语言设为 fr-FR，Excel 默认用 ANSI 打开。处置：控制台先切 en-US 再导出，Excel→数据→自文本→UTF-8。
适用/不适用场景清单
| 场景 | 是否推荐 | 理由 |
|---|---|---|
| 个人小额 NFT 上传 | ✅ 推荐 | 耗时低，可留痕 |
| 企业固件升级包 | ✅ 强烈建议 | 合规刚需 |
| 100 GB 4K 视频源 | ⚠️ 慎用 | 深度模式耗时高，可改用固定 500 MB 分片 |
| 链下空投图片 | ❌ 不建议 | 哈希白名单易被投毒 |
最佳实践 5 条速查表
- 任何金库级别操作，先「深度模式」再「多签复核」。
- 白名单仅保留 30 天内曾通过深度模式的哈希，到期自动清理。
- 移动端只做临时查看，最终上传回桌面端「补扫」并导出 PDF。
- 每次版本升级后，在「关于」里确认 FileGuard 引擎日期，若早于 7 天手动「更新特征库」。
- 合规看板导出前，先把控制台语言切 en-US，避免法德西语乱码被 CNIL 退回。
FAQ（结构化数据）
开启后上传速度会变慢吗？
标准模式对 100 MB 文件增加约亚秒级延迟；深度模式可能耗时数十秒，但能提前拦截 99% 已知木马。
扫描日志会保存多久？
桌面端本地 30 天，链上索引永久；移动端仅 7 天缓存。企业控制台可付费延长本地留存至 3 年。
可以只对特定文件夹跳过扫描吗？
目前仅支持「哈希白名单」级别，不支持路径级例外。可把已知安全文件先深度扫描后加入白名单，实现同等效果。
iOS 18 后台续传失败怎么办？
关闭「低电量模式」与「自适应连接」privacy tool，再在 SafeW-设置-网络里打开「允许按量网络」即可。
扫描结果能否作为法律证据？
SafeW 生成的 PDF 包含链上时间戳与多签地址，已在法国、新加坡两地仲裁案例中被采纳，但需配合公证处固证。
收尾：下一步行动建议
如果你刚升级到 SafeW v6.3.0，不妨立刻按本文「最短路径」把「上传前病毒扫描」打开，先用标准模式跑一周，观察上传耗时与误报情况。对金库级别文件，再手动切换到深度模式，并在合规看板里导出第一份 PDF，测试审计方是否接受。若一切顺利，可把白名单策略、只读 API Key、归档机器人一并配齐，形成「扫描-留痕-审计」闭环。发现漏报或误报，记得回到桌面端「重载服务」并更新特征库，别让一次零日攻击成为你钱包的「黑天鹅」。
