GitHub活动过滤：高效管理你的GitHub仪表盘

📌 核心功能
GitHub活动过滤扩展是一款轻量级浏览器工具，专为优化GitHub活动仪表盘设计。通过智能筛选机制，它能帮助开发者快速定位重要事件（如代码提交、Issue讨论、Pull Request更新），屏蔽冗余信息，让项目动态一目了然。无论是跟踪团队协作进度还是个人贡献记录，这款工具都能显著提升信息获取效率，让你在海量活动流中精准聚焦关键内容。

⚡ 快速上手：3步完成浏览器集成

第1步：获取项目源码

通过以下命令克隆项目到本地：

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

第2步：选择浏览器版本

项目提供Chrome和Firefox两种扩展包，根据你的浏览器类型进入对应目录：

• Chrome用户：进入 chrome/ 文件夹
• Firefox用户：进入 firefox/ 文件夹

第3步：安装扩展

1. 打开浏览器扩展管理页面（Chrome：chrome://extensions/，Firefox：about:debugging#/runtime/this-firefox）
2. 开启「开发者模式」
3. 选择「加载已解压的扩展程序」，选中对应浏览器的扩展目录

💡 注意：Chrome和Firefox的扩展结构完全独立，请勿混用不同浏览器的文件。

📂 文件解析：功能分类与核心作用

文件类型	Chrome扩展路径	Firefox扩展路径	功能作用
配置文件	chrome/manifest.json	firefox/manifest.json	定义扩展权限、脚本注入规则和界面入口，是浏览器识别扩展的核心清单
后台脚本	chrome/background.js	firefox/background.js	处理扩展生命周期管理，如监听浏览器事件、跨页面数据传递
内容脚本	chrome/content.js	firefox/content.js	注入GitHub页面，实现活动数据过滤、DOM动态修改等核心交互功能
界面文件	chrome/popup.html	firefox/popup.html	提供用户操作界面，支持过滤条件设置（如事件类型、时间范围）
样式文件	dashboard.css	dashboard.css	统一控制仪表盘的布局样式，确保不同浏览器下的显示一致性
逻辑核心	dashboard.js	dashboard.js	实现事件过滤算法，处理用户交互逻辑，是扩展功能的核心引擎

🔧 配置指南：Manifest文件详解
Manifest文件（扩展配置清单）是浏览器扩展的"身份证"，以下是核心配置项说明：

配置项	默认值	影响范围
manifest_version	2	决定配置文件语法版本，v2兼容主流浏览器，v3为Chrome最新标准（本项目使用v2）
permissions	["https://github.com/*"]	授予扩展访问GitHub域名的权限，确保能读取和修改页面内容
background	{"scripts": ["background.js"]}	指定后台运行脚本，负责扩展的全局状态管理
content_scripts	匹配https://github.com/*	定义在GitHub页面注入的脚本，实现活动过滤的核心功能
browser_action	{"default_popup": "popup.html"}	设置浏览器工具栏图标及点击后显示的弹出界面

❓ 常见问题速解
Q1：扩展安装后不生效怎么办？
A：检查是否开启开发者模式，确保加载的是对应浏览器的扩展目录（Chrome用chrome/，Firefox用firefox/）。

Q2：如何更新过滤规则？
A：修改dashboard.js中的过滤逻辑后，在扩展管理页面点击「重新加载」即可生效。

Q3：支持哪些事件类型过滤？
A：默认支持提交(Commit)、Issue、Pull Request、Star等常见事件，可通过content.js自定义过滤规则。

Q4：会影响GitHub原生功能吗？
A：不会，扩展仅在前端对活动列表进行过滤展示，不修改GitHub服务器数据或页面核心功能。

通过以上步骤，你已掌握GitHub活动过滤扩展的核心使用方法。这款工具将帮助你从繁杂的活动流中解放出来，更专注于真正重要的项目动态。