brodsbytes/CyberPup

# CyberPup **一款面向普通人的免费开源网络安全应用。** CyberPup 通过引导式清单、简洁课程以及漏洞检查等工具，帮助非技术用户锁定其数字生活。所有指导均基于 ACSC、CISA 和 NIST 的知名框架，并转化为任何人都能实际遵循的通俗语言。 大多数个人网络安全工具要么过于技术化、只解决部分问题，要么就是彻头彻尾的骗局。CyberPup 尝试引导用户看清全局：密码、邮件安全、设备卫生、社交媒体以及账户漏洞检查。 该应用已在 [iOS App Store](https://apps.apple.com/au/app/cyberpup-secure/id6752377981) 上线，目前安装量约 500 次。它可以运行，但并未被积极维护。此仓库是一个开放的邀请——面向贡献者、维护者，或任何希望将其继续发展的人。 ## 功能 - **渐进式安全等级** - 从基础到进阶的 Scout、Watchdog 和 Guardian 等级，引导用户逐步提升 - **交互式清单** - 带持久化进度跟踪的逐步安全操作 - **平台特定指导** - 针对 iOS、Android、macOS 和 Windows 的定制说明 - **漏洞检查** - 集成类似 HaveIBeenPwned 的 API，检查账户是否已被泄露 - **游戏化机制** - 连续登录、徽章和成就里程碑，提升用户参与度 - **简洁课程** - 可选“了解更多”内容，不干扰主要操作 ## 技术栈 - **React Native** + **Expo** - 跨平台移动应用（iOS & Android） - **React Navigation** - 页面导航 - **AsyncStorage** - 本地进度持久化 - **PostHog** - 注重隐私的分析（需用户同意，支持退出） ## Web 应用机会 由于此应用基于 React Native 和 Expo 构建，**运行为 Web 应用是完全可行的**；`npm run web` 在开发环境中已可用。正式的 Web 构建版本将使 CyberPup 无需安装即可被任何用户使用，这将显著扩大面向非技术人群的工具覆盖面。 这是贡献者可以承担的最具影响力的事项之一。 ## 路线图 以下是一些尚未实现的想法和待办事项，用于展示项目可能的发展方向，而非详细规范，仅作起点参考。 **打磨与修复** - 使隐私政策可内联阅读，而非跳转链接 - 设备更新部分：修复蓝牙/Wi-Fi 重试配置 - 应用加载/引导页（首次启动体验） - 深色模式支持 **用户参与** - 完成安全等级时分享进度 - 完成时弹出徽章成就提示 - 每月安全提醒推送通知 - 扩展“洞察”标签页内容 **新工具** - 实时反馈的密码强度检查器 - 钓鱼链接检查器 - 分析可疑 URL - 短信/邮件诈骗信息检测 - 待验证的 HIBP 付费 API 集成（获取更丰富的泄露数据） - 基于移动操作系统的诈骗电话/SMS 检测指导 **更大胆的构想** - Web 应用（见上文） - 将 CyberPup 设计为应用内更突出的角色/向导（微妙动画与个性） - 隐私设置扫描器 ## 快速开始 ### 前置条件 - Node.js 18+ - npm 或 yarn - 手机安装 [Expo Go](https://expo.dev/go) 用于快速测试，或使用模拟器/仿真器 ### 本地运行 ``` git clone https://github.com/brodsbytes/cyberpup.git cd cyberpup npm install npm start ``` 然后使用 Expo Go 扫描二维码，或在 iOS 模拟器中按 `i`、Android 模拟器中按 `a`、Web 环境中按 `w`。 ### 环境变量 在项目根目录创建 `.env.local` 文件： ``` EXPO_PUBLIC_POSTHOG_API_KEY=your_key_here ``` 若未设置该密钥，分析功能将静默无操作，因此本地开发时可选择性配置。 ## 项目结构 ``` CyberPup/ ├── App.js # Root component, navigation setup ├── screens/ │ ├── WelcomeScreen.js # Main dashboard │ ├── CategoryScreen.js # Level-based check organisation │ ├── ModuleListScreen.js # Area-based check lists │ ├── ProfileScreen.js # User profile and achievements │ ├── StreakDetailsScreen.js │ ├── BadgesScreen.js │ └── lessons/ # All individual check screens │ ├── level-1/ │ ├── level-2/ │ └── level-3/ ├── components/ # Reusable UI components ├── data/ # Content and app structure data ├── utils/ # Storage, analytics, badge logic ├── theme.js # Design system (colours, typography, spacing) ├── docs/ # Architecture and development guides └── assets/ # Images and animations ``` 请参考 [`docs/`](docs/) 获取架构说明、开发指南与实现备注。 ## 官方网站 [cyberpupsecurity.com](https://cyberpupsecurity.com) ## 许可证 [MIT](LICENSE)

标签：Android, AsyncStorage, Atomic Red Team, DSL, Expo, Have I Been Pwned, iOS, PostHog, React Native, React Navigation, SEO, 个人安全, 免费工具, 关键词, 安全教育, 安全防护, 平台指导, 数据泄露检测, 清单管理, 游戏化, 用户参与, 用户引导, 目录枚举, 移动安全, 网络安全, 自定义脚本, 进度追踪, 隐私保护, 隐私分析