PermPacks

新增

• 英文介绍文档 README-en.md 与两种尺寸的项目 Logo。
• 在 Iterable<Pack>#toRequest() 中对资源包去重，避免重复发送同一包。
• S3 文件上传服务（amazon_s3），支持可配置的 endpoint、region、bucket、目录等。
• 上传服务启动清理逻辑，支持自托管/ S3 中清理未被引用的对象。
• 多个函数的必要注释与文档化内容。
• .gitignore 中对 run/ 目录的忽略。

优化

• UploadService#upload() 支持传入预先计算的哈希以避免重复计算。
• paper-plugin.yml 的版本变量替换与 build.gradle.kts 的任务结构。
• PackItem 系列结构，将 hash 上移到父类统一管理；toResourcePackInfo() 的异常抛出与结构更清晰。
• 资源包清理流程、若干函数命名与注释本地化；Options 字段命名与冗余接口移除。
• BinaryCache#set() 支持传入 null 即删除；整体代码结构与日志工具函数。
• 与 CommandAPI 的对接与 PermPacks 中部分函数顺序。

修复

• FilePackItem 在初始化后未触发上传的问题。
• URI 序列化问题与 S3 endpoint 缺失 schema 的问题。
• 部分字符串格式化中误用原始 toString() 的问题。
• cleanup() 同步修改遗漏导致的逻辑问题。
• BinaryCache#get() 潜在未处理异常；移除未使用的 BinaryCache#remove()。
• 移除未使用的 Logger#error() 扩展方法。

文档

• README.md 调整表格与内容；补充项目概览与多语言说明。

修复

• 修复插件启用顺序导致本地文件资源包未能加载的问题：现在会先初始化文件元数据存储，并在上传服务完成初始化后再构建资源包栈，file 条目不再被误判为不可用。
• 修复自托管 HTTP 服务在处理带前导斜杠的哈希路径时返回 404 的问题，确保客户端始终可以拉取到缓存的资源包文件。

改进

• 重载资源包时会同步清理上传缓存，并允许上传服务验证缓存 URL 是否仍然有效，自托管实现会检查文件是否仍存在，避免客户端命中已失效的下载链接。
• BinaryCache 现已提供泛型读写接口，序列化过程中自动携带类型信息，降低了使用时的类型转换错误风险。

文档

• README 大幅扩写，新增功能概览、环境要求、配置示例、命令列表与构建指南，为 Modrinth 页面提供完整的项目介绍与使用说明。

First alpha version