CyberPup

一款免费、开源的网络安全应用，专为普通大众设计。

CyberPup 通过引导式清单、简短课程和泄露检查等工具，帮助非技术用户保障数字生活安全。所有指导均基于 ACSC、CISA 和 NIST 的知名框架，并将其转化为任何人都能实际遵循的通俗语言。

多数个人网络安全工具要么过于技术化，要么只解决单一方面的问题，要么就是彻头彻尾的骗局。CyberPup 试图引导用户全面了解密码、电子邮件安全、设备卫生、社交媒体和泄露检查。

该应用已在 iOS App Store 上线，约有 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 无需 App Store 安装即可被任何人使用，从而大幅扩大面向非技术用户的目标受众。

这是贡献者可以参与的最有影响力的工作之一。

路线图

以下是一些想法和待办清单中未完成的内容。它们旨在让你了解项目的可能发展方向——并非规范，只是起点。

打磨与修复

• 使隐私政策可在应用内直接阅读，而非打开链接
• 设备更新部分：修复蓝牙/无线重试设置
• 应用加载/引导界面（首次启动体验）
• 浅色模式支持

用户参与

• 完成安全等级时分享进度
• 成就徽章弹窗
• 每月安全提醒推送通知
• 扩展“洞察”标签页内容

新工具

• 带实时反馈的密码强度检查器
• 钓鱼链接检查器 – 分析可疑 URL
• 短信和邮件诈骗信息检测
• HIBP 付费 API 集成以获取更丰富的泄露数据（需评估定价可行性）
• 基于移动操作系统的诈骗电话/短信检测指导

更大创意

• Web 应用（见上文）
• CyberPup 作为更突出的角色/向导融入应用（微妙动画、个性）
• 隐私设置扫描器

快速开始

前置条件

• Node.js 18 或更高版本
• npm 或 yarn
• 手机上的 Expo Go 用于快速测试，或模拟器

本地运行

git clone https://github.com/brodsbytes/cyberpup.git
cd cyberpup
npm install
npm start

然后用 Expo Go 扫描二维码，或按 i 启动 iOS 模拟器 / a 启动 Android 模拟器 / w 启动 Web。

环境变量

在项目根目录创建 .env.local 文件：

EXPO_PUBLIC_POSTHOG_API_KEY=your_key_here

如果缺少密钥，分析功能将静默禁用，因此在本地开发中是可选的。

项目结构

CyberPup/
├── App.js                    # 根组件，导航设置
├── screens/
│   ├── WelcomeScreen.js      # 主仪表盘
│   ├── CategoryScreen.js     # 基于等级的清单组织
│   ├── ModuleListScreen.js   # 基于领域的清单列表
│   ├── ProfileScreen.js      # 用户资料和成就
│   ├── StreakDetailsScreen.js
│   ├── BadgesScreen.js
│   └── lessons/              # 所有单个检查屏幕
│       ├── level-1/
│       ├── level-2/
│       └── level-3/
├── components/               # 可复用 UI 组件
├── data/                     # 内容和应用结构数据
├── utils/                    # 存储、分析、徽章逻辑
├── theme.js                  # 设计系统（颜色、字体、间距）
├── docs/                     # 架构和开发指南
└── assets/                   # 图片和动画

参见 docs/ 了解架构参考、开发指南和实现说明。

贡献

欢迎任何形式的贡献——错误修复、新的检查项、UI 改进、Web 版本构建，或上述路线图中的任何内容。

请参阅 CONTRIBUTING.md 了解如何设置和提交更改。

如果你有意担任更重要的角色（维护者、引领项目新方向），请随时提交 issue 或直接联系。

网站

cyberpupsecurity.com

许可证

MIT