ClawHub

Force Unwrap Scanner

Security

扫描并报告 Swift 项目中的强制解包（!）和 try! 使用情况，识别潜在崩溃风险

Install

openclaw skills install force-unwrap-scanner

Force Unwrap Scanner

扫描并报告项目中的强制解包使用情况，帮助识别潜在的运行时崩溃风险。

功能

  • 扫描项目中所有的 try! 和 ! 强制解包使用
  • 按风险等级分类（高/中/低）
  • 生成详细报告
  • 提供修复建议

使用方法

cd .agent/skills/force-unwrap-scanner
./RunSkill.sh [scan|report|fix]

参数说明

  • scan - 扫描项目并输出结果
  • report - 生成详细的 HTML 报告
  • fix - 交互式修复（高风险项需要手动确认）

风险分级

风险等级说明示例
🔴 高EKEventStore、SwiftData、FileIO 等系统级操作try! EKEventStore()
🟡 中数据库查询、网络请求try! fetchTasks()
🟢 低本地数据、已知安全值let x = dict["key"]!

输出示例

🔍 Force Unwrap Scanner Report
===================================

Total: 3 findings
  🔴 High: 1
  🟡 Medium: 1
  🟢 Low: 1

Files with issues:
  TimeFlow/Services/EventKitService.swift:35
  TimeFlow/ViewModels/AppState.swift:12
  TimeFlow/Helpers/ParseHelper.swift:45
More in Security