GitHub Dashboard：打造个性化代码监控中心

核心功能：让 GitHub 活动尽在掌控

GitHub Dashboard 是一款浏览器扩展工具，专为开发者打造个性化的代码活动监控中心。它能帮你过滤 GitHub 活动流中的噪音，只显示你真正关心的内容。无论是关注特定类型的代码提交，还是追踪重要项目的动态，这款工具都能让你的开发效率事半功倍。

核心功能亮点：

• 📊 智能过滤：按事件类型（代码提交、Issue 讨论、版本发布等）筛选活动
• 👥 关系识别：自动区分关注用户与其他开发者的活动
• 💾 偏好记忆：保存你的筛选设置，下次访问自动应用
• 🌐 双浏览器支持：完美适配 Chrome 和 Firefox 两大主流浏览器

快速上手：三步开启个性化监控

1. 安装扩展

📌 首先克隆项目代码库到本地：

git clone https://gitcode.com/gh_mirrors/gi/github-dashboard

2. 加载到浏览器

• Chrome 浏览器：

  1. 打开 chrome://extensions/
  2. 启用"开发者模式"
  3. 点击"加载已解压的扩展程序"，选择项目中的 chrome/ 目录

• Firefox 浏览器：

  1. 打开 about:debugging#/runtime/this-firefox
  2. 点击"临时加载附加组件"
  3. 选择项目中 firefox/manifest.json 文件

3. 开始使用

打开 GitHub 个人仪表盘，你会看到顶部新增了"Filter"按钮。点击它就能看到筛选选项面板，勾选你关注的事件类型即可实时过滤活动流。

⚠️ 注意：首次使用时所有事件类型默认都是勾选状态，你需要根据自己的需求取消不需要的选项。

深度解析：扩展如何工作

运行机制：事件驱动的实时过滤

GitHub Dashboard 通过三层架构实现功能：

1. 内容脚本层 (content.js)：注入到 GitHub 页面，负责 DOM 操作和事件监听
2. 逻辑处理层 (dashboard.js)：核心过滤引擎，包含：
   • 事件类型识别系统（第 26-43 行定义了各类事件的 CSS 选择器）
   • 用户偏好管理（通过 localStorage 存储选择状态）
   • 关注用户识别（自动获取并缓存你关注的用户列表）
3. UI 交互层：动态创建的筛选面板（第 74-122 行的 init 函数）

当你勾选筛选选项时，系统会给仪表盘容器添加对应的 CSS 类（如 show_code、show_releases），通过 CSS 规则控制不同类型事件的显示与隐藏。

配置指南：定制你的专属仪表盘

扩展的核心配置文件是 manifest.json（浏览器扩展的"身份证文件"），Chrome 和 Firefox 版本略有差异：

配置项	Chrome 版本	Firefox 版本	作用
manifest_version	2	2	配置文件格式版本
permissions	["https://github.com/*"]	["https://github.com/*"]	扩展需要访问的网站权限
background.scripts	["background.js"]	["background.js"]	后台运行的脚本
browser_action	定义扩展图标和弹出窗口	同 Chrome	浏览器工具栏中的扩展入口

📌 高级自定义：如需添加新的事件过滤类型，可以修改 dashboard.js 中的 eventClasses 数组（第 26-43 行），添加对应的 CSS 选择器。

常见问题解决

问题1：筛选按钮不显示

• 可能原因：GitHub 页面结构更新导致位置标记无法识别
• 解决方法：
  1. 刷新页面尝试重新加载扩展
  2. 检查控制台是否有错误信息（F12 打开开发者工具）
  3. 确认扩展已正确加载，尝试重新安装

问题2：筛选功能突然失效

• 可能原因：GitHub 更改了页面 CSS 类名
• 解决方法：
  1. 清除浏览器缓存（Ctrl+Shift+R 强制刷新）
  2. 更新扩展到最新版本
  3. 手动修改 dashboard.js 中的 eventClasses 定义，适配新的 CSS 类名

问题3：关注用户识别不准确

• 可能原因：关注列表缓存过期
• 解决方法：
  1. 清除 localStorage 中以 dashboard: 开头的键值对
  2. 刷新页面，扩展会自动重新获取关注列表
  3. 检查网络连接，确保能正常访问 GitHub API

💡 提示：扩展使用 localStorage 存储设置和关注列表，清除浏览器数据可能会导致设置丢失。

项目参与指南

GitHub Dashboard 欢迎所有开发者参与贡献！无论你是发现了 Bug、有新功能建议，还是想改进文档，都可以通过以下方式参与：

1. 报告问题：在项目中创建 Issue，详细描述你遇到的问题或建议
2. 提交代码：
   • Fork 项目仓库
   • 创建特性分支 (git checkout -b feature/amazing-feature)
   • 提交更改 (git commit -m 'Add some amazing feature')
   • 推送到分支 (git push origin feature/amazing-feature)
   • 打开 Pull Request
3. 改进文档：帮助完善使用教程或 API 说明
4. 测试反馈：在不同浏览器和环境中测试，提供兼容性反馈

所有贡献者都将出现在项目贡献者列表中，让我们一起打造更好用的 GitHub 活动过滤工具！

📝 注意：提交代码前请确保通过基本功能测试，并遵循项目的代码风格规范。