# CodeClip

**Repository Path**: wh86_admin/CodeClip

## Basic Information

- **Project Name**: CodeClip
- **Description**: 复制礼包码，游戏中一键粘贴
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeClip — 复制礼包码，游戏中一键粘贴

![Platform](https://img.shields.io/badge/platform-Android-3DDC84)
![Min SDK](https://img.shields.io/badge/min%20SDK-26-3DDC84)
![License](https://img.shields.io/badge/license-MIT-blue)
![Version](https://img.shields.io/badge/version-1.0.0-blue)

## 这是什么

复制礼包码后，CodeClip 自动识别并入队；游戏中点一下悬浮球，下一个码自动填入输入框，省去来回切换 App 的麻烦。

## 核心特性

- 🎯 **复制即入队**：在任何 App 复制含礼包码的文字，CodeClip 自动识别并追加到队列。
- 🔍 **智能识别**：基于关键词 + 正则识别 4-20 位字母数字组合的礼包码，自动去重。
- 🎮 **悬浮球一键粘贴**：游戏中点一下悬浮球，自动把下一个码填到当前输入框。
- 🔄 **自动换码模式**：开启后，复制任意内容都会被替换为下一个码，再粘贴即可。
- 🎭 **角色动画反馈**：悬浮球自带 7 帧角色精灵图（待机 / 长按蓄力 / 点击释放），操作有视觉反馈。

## 使用方法

### 第 1 步：开启权限

1. 安装后打开 App
2. 授予 **无障碍服务** 权限（系统设置 → 无障碍 → CodeClip → 启用）
3. 授予 **悬浮窗** 权限（系统设置 → 应用 → CodeClip → 悬浮窗 → 允许）

### 第 2 步：复制礼包码

在任何 App（浏览器、聊天工具、公众号文章、记事本等）长按一段含礼包码的文字 → 点「复制」。CodeClip 会自动识别并入队，状态栏通知显示当前队列数量。

### 第 3 步：在游戏中粘贴

切换到游戏，聚焦输入框，点一下悬浮球，下一个码自动填入。再点填入下一个。

### 自动换码模式（可选）

开启后：复制任意内容 → 自动被替换为下一个礼包码 → 在任何输入框粘贴即可。

### 兜底：长按悬浮球手动入队

少数 App 不会向无障碍服务投递复制事件。这时只需 **长按 CodeClip 悬浮球约 0.5 秒**，角色会做蓄力动作，自动读一次剪贴板入队。

## 兼容性

- 开发/测试设备：Android 16
- 最低支持：Android 8.0（API 26）
- 理论上可在更新版本的 Android 上运行

## 已知限制

部分设备的复制菜单不会向无障碍服务投递点击事件，导致「复制即入队」失效。

**解决方案**：复制完成后，**长按 CodeClip 悬浮球约 0.5 秒**，手动触发一次剪贴板读取，无需切回主界面。

## 权限说明

| 权限 | 用途 |
|------|------|
| 无障碍服务 | 检测复制动作、自动填入输入框 |
| 悬浮窗 | 在其他 App 上显示悬浮球 |
| 前台服务 | 保持剪贴板监听在后台运行 |
| 通知 | 显示队列数量等常驻通知 |

## 下载

在 [GitHub Releases](https://github.com/wangheng0316/CodeClip/releases) 或 [Gitee Releases](https://gitee.com/wh86_admin/CodeClip/releases) 下载最新版本。

v1.0.0 提供两种构建：
- `app-debug.apk`：开发版，含详细日志
- `app-release.apk`：发布版，推荐普通用户使用

## 许可

本项目基于 [MIT License](LICENSE) 开源。