拦截100开源项目指南

拦截100开源项目指南

block100项目地址:https://gitcode.com/gh_mirrors/bl/block100

欢迎来到拦截100（Block 100）的使用和安装教程。本指南将详细解读此开源项目的主要结构、关键文件及其功能，以便您能够更好地理解和使用这个专为提升Safari浏览器用户体验设计的工具。

1. 项目目录结构及介绍

拦截100项目基于Git管理，其主要目录结构如下：

• 根目录:

  • README.md: 项目的核心说明文档，提供了项目简介、安装步骤和基本用法。
  • LICENSE: 指定了该项目遵循的GPL-2.0开源许可协议。
  • .gitignore: 列出了Git应忽略的文件或目录类型。
  • Resources: 这是项目的核心资源目录，其中包含两个子目录——jumpapp 和 domain，对拦截逻辑至关重要。

• Resources目录:

  • jumpapp: 子目录用于存放阻止特定应用跳转的脚本，每一个可能的App跳转行为可以通过独立的文件夹进行管理和配置，通过JavaScript实现。
  • domain: 匹配不同网站并提供相应处理策略的目录，分为两部分操作：全文展开(read.js)和广告去除(call.js)，每个文件夹以其目标网站的域名命名。

2. 项目的启动文件介绍

对于开发者来说，实际的启动并非直接从项目内部某单一“启动文件”进行，而是需要通过Xcode环境来编译和部署Safari Extension。具体步骤包括：

1. 在Xcode中新建一个Safari Extension App项目。
2. 替换项目中的SafariWebExtension扩展文件夹下的Resources文件夹为本项目提供的Resources目录。
3. 编译并运行项目，在Safari浏览器中启用并管理该扩展来启动拦截功能。

3. 项目的配置文件介绍

拦截100的配置分散在Resources目录中：

• 跳转拦截配置位于jumpapp目录，通过对不同网站的针对性JavaScript脚本管理来实现。
• 网站特化配置在于domain目录，每一个子目录对应一种网站，通过call.js和read.js文件定义了具体的广告移除和全文展开逻辑，这些构成了项目的动态配置核心。

综上所述，拦截100项目通过其精细的资源组织和自定义逻辑，实现了高效的网页内容优化和用户隐私保护功能。开发者可以根据需要调整和增补配置，以适应不同的浏览器环境和网站特性。记得在进行任何改动前仔细阅读项目文档，并遵守GPL-2.0许可协议。

block100项目地址:https://gitcode.com/gh_mirrors/bl/block100