Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📚 书签清理助手 (Bookmark Cleaning Assistant)

一个智能的Chrome扩展,帮助用户清理无效书签,保护私有链接,提供专业的书签管理体验。

✨ 功能特性

🔍 智能检测

  • 无效链接检测:自动检测无法访问的书签链接
  • 私有链接保护:智能识别并保护私有IP地址链接
  • 批量处理:支持批量检测和清理操作

🗂️ 文件夹管理

  • 树形控件:专业的层级文件夹选择器
  • 多选支持:支持同时选择多个文件夹进行检测
  • 智能过滤:只显示包含书签的文件夹
  • 层级导航:支持逐层级展开和折叠

🛠️ 清理选项

  • 移动模式:将无效书签移动到"失效书签"文件夹(默认)
  • 删除模式:直接删除无效书签
  • 批量操作:支持批量移动或删除
  • 自定义超时:用户可设置5-60秒的网络检测超时时间

🎨 用户界面

  • 侧边栏设计:现代化的右侧边栏界面
  • 专业图标:自定义设计的插件图标
  • 响应式布局:适配不同屏幕尺寸
  • 平滑动画:流畅的交互体验

🚀 安装使用

开发模式安装

  1. 下载或克隆项目到本地
  2. 打开Chrome浏览器,进入 chrome://extensions/
  3. 开启"开发者模式"
  4. 点击"加载已解压的扩展程序"
  5. 选择项目文件夹
  6. 插件安装完成,点击工具栏图标即可使用

使用步骤

  1. 打开插件:点击浏览器工具栏中的插件图标
  2. 选择文件夹:在树形控件中选择要检测的书签文件夹
  3. 开始检测:点击"🔍 开始检测"按钮
  4. 查看结果:查看检测结果,包括无效书签、私有链接等
  5. 清理操作:选择清理方式(移动或删除),点击"🗑️ 清理无效书签"

📁 项目结构

plugin_bookmarks_clean/
├── manifest.json              # 扩展配置文件
├── background.js              # 后台服务脚本
├── content.js                 # 内容脚本(侧边栏)
├── icons/                     # 图标文件
│   ├── icon16.png            # 16x16 图标
│   ├── icon32.png            # 32x32 图标
│   ├── icon48.png            # 48x48 图标
│   ├── icon128.png           # 128x128 图标
│   ├── icon.svg              # SVG 源文件
│   └── generate_icons.html   # 图标生成工具
├── README.md                 # 项目说明文档
├── 安装测试.md               # 安装测试指南
├── 调试指南.md               # 调试指南
├── 测试说明.md               # 功能测试说明
└── 更新说明.md               # 版本更新说明

🔧 技术特性

核心技术

  • Chrome Extension API:使用最新的Manifest V3规范
  • Service Worker:后台服务脚本
  • Content Script:页面内容脚本注入
  • Message Passing:脚本间通信机制

智能算法

  • 网络检测:HEAD请求检测链接有效性
  • IP识别:智能识别私有IP地址范围
  • 协议过滤:过滤特殊协议链接
  • 树形构建:递归构建文件夹树结构

用户体验

  • 防重复注入:避免脚本重复加载
  • 错误处理:完善的错误处理机制
  • 性能优化:延迟加载和缓存机制
  • 响应式设计:适配不同设备

🎯 支持的链接类型

私有链接保护

  • 本地网络:192.168.x.x, 10.x.x.x, 172.16-31.x.x
  • 回环地址:127.0.0.1
  • 链路本地:169.254.x.x
  • 特殊协议:chrome://, file://, data://, about://

检测范围

  • HTTP/HTTPS:标准网页链接
  • 网络可达性:通过HEAD请求检测
  • 超时处理:用户可自定义5-60秒超时时间(默认15秒)

📋 系统要求

  • 浏览器:Chrome 88+ 或基于Chromium的浏览器
  • 权限:书签访问、网络访问、脚本注入
  • 存储:本地存储,无需云端服务

🔒 隐私安全

  • 本地处理:所有数据在本地处理,不上传服务器
  • 权限最小化:只请求必要的权限
  • 透明操作:所有操作都有明确的用户确认
  • 数据保护:不收集或存储用户个人信息

🐛 问题反馈

如果遇到问题或有改进建议,请:

  1. 检查Console日志获取详细错误信息
  2. 参考项目中的调试指南
  3. 在GitHub Issues中提交问题报告

📄 许可证

本项目采用 MIT 许可证,详见 LICENSE 文件。

🤝 贡献指南

欢迎提交Issue和Pull Request来改进这个项目!

开发环境

  1. Fork 项目
  2. 创建功能分支
  3. 提交更改
  4. 推送到分支
  5. 创建 Pull Request

📈 版本历史

v2.0.0 (当前版本)

  • ✨ 新增树形文件夹选择器
  • ✨ 新增多选文件夹功能
  • ✨ 新增移动模式清理选项
  • ✨ 新增自定义图标支持
  • ✨ 新增自定义超时时间设置
  • 🔧 修复重复注入问题
  • 🔧 优化性能和用户体验

v1.0.0

  • 🎉 初始版本发布
  • ✨ 基础书签检测功能
  • ✨ 侧边栏界面
  • ✨ 私有链接保护

感谢使用书签清理助手! 🎉

About

智能清理无效书签的Chrome扩展,支持树形文件夹选择、多选操作、私有链接保护等功能。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages