akshithnallaginnela/shield-insight-labs

# ScamShield AI 🛡️ **停止钓鱼。验证后再信任。** 基于 AI 的诈骗检测工具，专门用于识别虚假招聘、钓鱼攻击、可疑消息和在线欺诈——专为即时通讯一代打造。    ## 概述 ScamShield AI 是一个专门针对**技术与职业诈骗**的威胁检测平台。它实时分析可疑消息，检测实习骗局、钓鱼攻击、技术支持诈骗、AI 机器人消息及其他职场相关威胁。通过心理学、行为学和语言学分析，帮助用户在受骗前识别并避免在线欺诈。 - **95%+ 准确率**，覆盖所有技术诈骗类型 - **实时**威胁检测 - **AI 驱动**的心理分析引擎 - **重点领域：** 实习、钓鱼、技术支持、AI 机器人、投资诈骗、身份盗窃 ## 🚀 功能 ### 👔 实习/招聘骗局检测 在您投递简历前识别虚假职位、预付款要求和可疑招聘模式。 ### 🔐 钓鱼与凭证盗窃检测 高精度检测虚假验证请求、凭证钓鱼和账户劫持企图。 ### 🖥️ 技术支持诈骗检测 识别恶意软件警报、远程访问请求和虚假杀毒/支持电话。 ### 🤖 AI 机器人与模板消息检测 通过语言异常分析和通用问候模式检测 AI 生成或模板化的诈骗消息。 ### 💰 投资/加密货币诈骗检测 识别不切实际的投资回报、拉盘砸盘计划和加密货币骗局。 ### 🏦 身份盗窃与 KYC 诈骗检测 标记针对敏感信息（Aadhar、PAN、OTP、银行账户）的可疑请求。 ### 🧠 心理学+行为检测 识别诈骗者用来规避理性思维的紧迫感、恐惧、权威和行为异常。 ### 📝 语言异常检测 标记诈骗消息中常见的语言模式、语气转变、语法问题和模板标记。 ### ✅ 实时安全步骤 根据您面临的具体威胁提供可操作的检查清单。 ## 🛠️ 技术栈 - **前端框架**：React 19 + TypeScript - **路由**：TanStack Router - **元框架**：TanStack Start - **样式**：Tailwind CSS v4 + Class Variance Authority - **UI 组件**：Radix UI + 自定义组件 - **状态管理**：Zustand - **数据获取**：TanStack React Query - **表单处理**：React Hook Form + Zod - **图表**：Recharts - **构建工具**：Vite 7 - **代码检查**：ESLint + Prettier - **部署**：Cloudflare ## 📋 前置条件 - **Node.js**：v18+（推荐 v20+） - **npm**：v9+ 或 **pnpm** - **Git**：用于版本控制 ## 🔧 安装说明 1. **克隆仓库** ```bash git clone https://github.com/yourusername/shield-insight-labs.git cd shield-insight-labs ``` 2. **安装依赖** ```bash npm install ``` 3. **环境配置**（如有需要） ```bash cp .env.example .env.local # 编辑 .env.local 文件以配置您的设置 ``` ## 🚀 入门指南 ### 开发服务器 ``` npm run dev ``` 在浏览器中打开 [http://localhost:5173](http://localhost:5173)。 ### 构建生产版本 ``` npm run build ``` ### 预览生产构建 ``` npm run preview ``` ### 运行代码检查 ``` npm run lint ``` ### 格式化代码 ``` npm run format ``` ## 📁 项目结构 ``` shield-insight-labs/ ├── src/ │ ├── components/ │ │ ├── analyzer/ # Analysis UI components │ │ │ ├── MessageInput.tsx │ │ │ ├── ProbabilityGauge.tsx │ │ │ ├── RedFlagsList.tsx │ │ │ ├── SafeStepsChecklist.tsx │ │ │ ├── ScanningOverlay.tsx │ │ │ └── ThreatBreakdown.tsx │ │ ├── layout/ # Layout components │ │ ├── ui/ # Reusable UI primitives │ │ └── ... │ ├── routes/ # Page components & routing │ │ ├── index.tsx # Landing page │ │ ├── analyze.tsx # Analysis dashboard │ │ ├── feed.tsx # Threat feed │ │ ├── recruiter.tsx # Recruiter verification │ │ └── ... │ ├── stores/ # Zustand state management │ ├── lib/ # Utilities & helpers │ ├── router.tsx # Router configuration │ └── start.ts # App entry point ├── vite.config.ts # Vite configuration ├── tailwind.config.ts # Tailwind CSS config ├── tsconfig.json # TypeScript config └── package.json # Dependencies & scripts ``` ## 📍 页面与路由 | 路由 | 用途 | | ------------------ | ---------------------------- | | `/` | 带功能概览的着陆页 | | `/analyze` | 主要威胁分析面板 | | `/feed` | 社区威胁动态 | | `/link-scanner` | 专门的链接/域名分析 | | `/recruiter` | 招聘者验证工具 | | `/quiz` | 安全意识测验 | | `/report` | 举报可疑内容 | ## 🎨 设计系统 本项目采用现代深色主题 UI： - **配色方案**：赛博朋克主题，霓虹色点缀 - **排版**：系统字体，层级一致 - **组件**：基于 Radix UI 原始组件，自定义样式 - **动画**：平滑过渡与入场动画 - **响应式**：移动端优先，完全响应式设计 ## 🔄 状态管理 **Zustand 存储**（`src/stores/analysisStore.ts`）： - `pendingMessage` - 待分析的消息 - `result` - 分析结果与威胁详情 - `setResult()` - 更新分析结果 - `setPending()` - 将消息加入分析队列 ## 🧪 测试 应用包含面向开发的模拟分析功能： - `src/lib/mockAnalyzer.ts` - 模拟威胁检测引擎 - 项目文档中提供了测试用例 ## 🚀 部署 项目已配置为**Cloudflare 部署**： ``` # 构建并部署到 Cloudflare npm run build wrangler deploy ``` ## 🔐 安全与隐私 - **无需登录**：即时扫描 - **不存储数据**：分析结果不会持久化 - **客户端处理**：分析在设备本地运行 - **无 Cookie**：以用户隐私为核心 ## 📊 性能 - **分析速度**：<3 秒 - **轻量级**：优化后的包体积 - **移动优化**：在所有设备上响应流畅 ## 📝 脚本参考 ``` npm run dev # Start development server npm run build # Build for production npm run build:dev # Build in development mode npm run preview # Preview production build npm run lint # Run ESLint npm run format # Format code with Prettier ``` ## 🐛 故障排除 ### 端口已被占用 ``` npm run dev -- --port 3000 ``` ### 构建问题 ``` rm -rf node_modules package-lock.json npm install npm run build ``` ### 类型错误 ``` npm run build # Verify TypeScript compilation npx tsc --noEmit # Check for type issues ``` ## 📚 资源 - [TanStack Router 文档](https://tanstack.com/router) - [TanStack Start 文档](https://tanstack.com/start) - [Tailwind CSS 文档](https://tailwindcss.com) - [Radix UI 组件](https://www.radix-ui.com) - [React 19 文档](https://react.dev) - [Zod 文档](https://zod.dev) ## 📄 许可证 MIT 许可证 - 详见 LICENSE 文件 ## 👥 支持 如有问题、疑问或功能请求： - 在 GitHub 上[提交 issue](https://github.com/yourusername/shield-insight-labs/issues) - 查阅现有文档 - 查看项目 Wiki ## 🎯 路线图 - [ ] 基于高级 ML 的模式检测 - [ ] 浏览器扩展集成 - [ ] 面向第三方集成的 API - [ ] 增强移动端体验 - [ ] 多语言支持 - [ ] 离线模式 **ScamShield AI** — 以智能为驱动，为保护而生。 _别再猜测。验证。放心信任。_

标签：AI安全, AI诈骗, Apex, Chat Copilot, Object Callbacks, 人工智能, 加密货币欺诈, 反诈骗, 在线欺诈, 威胁情报, 实时分析, 开发者工具, 心理学分析, 情绪操纵检测, 截图分析, 技术支持诈骗, 投资欺诈, 招聘者验证, 招聘诈骗, 无需登录, 机器学习, 用户模式Hook绕过, 网络安全, 网络钓鱼, 自动化攻击, 虚假招聘, 诈骗检测, 身份盗窃, 钓鱼检测, 隐私保护