Skip to content

tatan0000/ClipboardGuard

Repository files navigation

剪贴板护卫 (ClipboardGuard)

一个基于 LSPosed/Xposed 框架的 Android 模块,用于应用在剪贴板写入时进行筛选,防止应用在未经允许下在剪贴板里拉屎。

前言

去年在浏览器打开123云盘的链接后,总是会复制莫名其妙的快手指令到我的剪贴板里,流体云显示了,我很不爽。😡😡但是也没什么办法,禁用写入剪贴板权限吧,那其他正常复制操作就受阻了,写了一个浏览器脚本但是没有效果,于是就放任不管了。
今年,我在学校的外卖小程序点餐付完款后,总是有弹窗广告就算了,甚至直接在剪贴板里写入闲鱼的链接,流体云也显示了,我很不爽,😡😡这种感觉就跟被强奸了一样,无法反抗。实在忍受不了这种流氓行为,又因为最近AI很火,我又有root设备,我就想尝试写一下,即将毕业,也为自己积累一点项目经验。
于是有了这个模块。希望能借此项目,推动国内应用市场及各厂商进一步收紧权限管控,后续也需要手机厂商、开发者和普通用户共同监督、一起整治。
hook系统服务并不那么容易,需要深入了解 Binder 机制、系统广播、内存泄漏规避等底层知识。如果我没有及时更新,请原谅我时间和能力有限,但我会尽力维护,坚持把项目做下去、不停摆。同时也欢迎各位大佬提出建议想法、提交 Issue 和 PR,一起完善这个项目。

📋 功能特点

  • 权限弹窗提示:当应用尝试写入剪贴板时,弹出权限请求对话框
  • 用户自主选择:用户可以选择允许或拒绝写入操作
  • 内容预览:对话框显示应用想要写入的内容预览
  • 超时处理:如果用户4秒内未做选择,默认拒绝写入
  • 防抖机制:同一应用在进行选择(自动或手动选择)后1.5s内不会重复弹窗,按上一次选择结果执行
  • 系统应用过滤:系统应用自动跳过,不影响系统正常运行

📱 使用方法

���装要求

  • Android 11 (API 30) 及以上
  • 已安装 LSPosed 或其他兼容的 Xposed 框架(基于Xposed API 82开发)

安装步骤

  1. 安装 APK 到设备
  2. 在 LSPosed 管理器中启用本模块,勾选推荐作用域(系统框架)
  3. 首次安装需要授予应用 显示在其他应用上层 (悬浮窗) ,关联启动 等权限, thanox里开启了后台启动的,也要打开本模块的后台启动
  4. 打开APP选择要监控的应用(推荐选择需要的应用)
  5. 重启设备

📝 配置信息

配置项
包名 com.android.clipboardguard
minSdk 30
targetSdk 36
Xposed API 82

📌 关于模块

  • 本模块由 腾讯WorkBuddy 辅助生成,参考许多开源项目
  • 经过清明假期3天大量调试,在WSA(Android 13)以及AVD(Android 11)测试较为完好,在本人手机上也测试通过
  • 可能会有部分bug,若遇到可提 Issue
  • 如果模块对你有帮助,欢迎给我点个 star ⭐

🐛 问题反馈

遇到 Bug ,按以下格式提交 Issue :

1. 环境截图:模块主页面 + Xposed 版本 + Android 系统版本

2. 问题描述:清晰说明 Bug 表现、复现场景

3. 复现录屏:直观展示 Bug 触发过程

4. 日志信息:提供 logcat 日志(模块内部日志页面待开发中)

温馨提示:由于开发时间有限,问题处理可能存在延迟,若追求极致稳定可等待正式版发布~

TODO

有时间就更新 2026-04-19_211950

🔧 技术原理

(此处待补充核心技术逻辑)

🏗️ 项目结构

(此处待补充项目模块划分)

About

一个基于 LSPosed/Xposed 框架的 Android 模块,用于应用在剪贴板写入时进行筛选,防止应用在未经允许下在剪贴板里拉屎。

Resources

Stars

Watchers

Forks

Packages