koishi-plugin-qqapk-renamer

一个专为 Koishi 设计的 QQ APK 文件重命名插件，通过引用消息自动处理 .apk.1 文件，去除后缀并封装为 ZIP 压缩包，绕过 QQ 的 APK 文件限制。

✨ 特性

• 🔄 自动重命名：将 .apk.1 文件重命名为 .apk
• 📦 ZIP 封装：自动封装为 ZIP 压缩包，绕过 QQ 限制
• 💬 群聊 & 私聊支持：适配群聊和私聊环境
• 🗑️ 自动清理：处理完成后自动清理临时文件
• ⚡ 智能响应：5秒后自动撤回确认消息，保持界面整洁

📦 安装

使用 Koishi 控制台：

1. 在插件市场搜索 qqapk-renamer
2. 点击安装并启用插件

🚀 使用方法

1. 上传文件：将 .apk.1 文件上传到群聊或私聊
2. 引用消息：回复包含 .apk.1 文件的消息
3. 发送指令：输入 apk转换 或 apkfix
4. 获取文件：下载生成的 ZIP 文件并解压获得正确的 .apk 文件

示例

用户A: [发送文件: app-release.apk.1]
用户B: [引用上面的消息] apk转换
机器人: 收到，开始处理文件...
机器人: ✅ 文件处理完成并上传到群文件！
       原文件名: app-release.apk.1
       目标文件名: app-release.apk
       封装格式: ZIP压缩包

⚙️ 配置选项

| 选项 | 类型 | 默认值 | 描述 | |------|------|--------|------| | commandName | string | apk转换 | 触发重命名功能的指令名称 | | feedbackMessage | string | 收到，开始处理文件... | 收到有效指令后的反馈信息 | | tempDir | string | (空) | 临时文件存储目录，留空使用默认目录 | | debug | boolean | false | 是否启用详细调试日志 |

🔧 工作原理

1. 文件检测：扫描引用消息中的文件元素
2. 类型识别：支持 .apk.1（原始）和 .apk（已处理）文件
3. 下载处理：优先使用本地路径，备用 HTTP 下载
4. 重命名操作：去除 .1 后缀（仅原始文件）
5. ZIP 封装：始终封装为 ZIP 压缩包
6. 智能发送：根据环境选择群文件或私聊发送
7. 自动清理：清理所有临时文件

📄 免责声明

重要提示：本插件仅供技术学习和个人使用。

• ⚠️ 用户责任：使用者需确保处理的 APK 文件来源合法，并承担相应的法律责任
• ⚠️ 安全风险：请勿处理来源不明的 APK 文件，避免安全风险
• ⚠️ 合规使用：请遵守当地法律法规和平台使用条款
• ⚠️ 版权声明：尊重软件版权，请勿用于商业盗版等违法行为

作者不对因使用本插件产生的任何直接或间接损失承担责任。

📜 许可证

本项目基于 MIT 许可证 开源。