Plan Leaves IP Intelligence 5.9 build 3666 — 最终验收构建

2026-10-13 最终定版

发布标签：v5.9-build.3666-leaves-ip.1

插件显示版本：5.9 build 3666。这是基于 Plan 5.9 开发版本的社区自定义构建，不是官方正式发行包；GitHub 保留预发布标识，不将其伪装成上游稳定版。本标签固定本次验收的源码和 JAR，不代表今后停止维护。

下载与校验

发布附件：Plan-Leaves-IP-Intelligence-5.9-build-3666.jar

SHA-256：8675314B67010512534078D873DECC0ED4FB4DE009B0D738817B37D3D20FFFCB

此次直接发布通过本地测试的同一份 JAR，不重新生成或修改其内容。

上游构建号由 Git 历史的 commit 数自动计算。此次 JAR 是提交发布记录前构建的工作区验收产物，标签保存对应源码；新增发布提交后自行重编译，显示的 build 号可能递增，二进制也不保证逐字节相同。请以此附件及以上 SHA-256 识别已验收的最终产物，不通过修改上游构建脚本强行伪造 build 号。

与上一次公开版本相比

• 完整保留玩家 IP 历史、按游戏名查询关联账号、中国省份热力图及省市玩家排行。
• 增加登录后按精确 IP 整组预览、填写理由、人工确认账号与 IP 原生封禁。预览不允许单账号排除，不自动扩展到其它 IP 或网段。
• 增加独立审计和撤销快照，只撤销本次新增且未被其它操作修改的处罚；保留原有封禁、报告冲突。
• 增加观察名单、新 IP 与共享精确 IP 人工核查提示。低可信网段线索默认关闭，不自动封禁。
• 处置面板改为三页签、分层卡片、折叠详情和空状态；兼容手机与 Plan 默认夜间模式，长备注自动换行。
• 增加单独 Plan 网页管理权限、会话绑定的 CSRF 校验、跨站请求拒绝和当前服务器身份校验。不会自动给已有组增加管理权限。
• 修复导入数据库或变更世界后 Minecraft 统计项缺失导致的空值异常：保留缺失项之前收集的值，不将缺失误记为零。
• HTTP 登录仅通过 Allow_HTTP_authentication: true 显式开启；默认仍为 false，HTTPS 原有能力保留。修正 HTTP 登录/登出的 Cookie 兼容性和请求头大小写处理。

安装与数据保留

先停服，备份 plugins/Plan/、原插件 JAR、banned-players.json 和 banned-ips.json，再替换单个 Plan JAR。不要保留两个 Plan JAR，也不要删除数据库来升级。

保留现有 config.yml、database.db（或 MySQL）、ServerInfoFile.yml、IP 离线库、网页账号及个性化配置。新功能配置与授权步骤见 处置与登录说明。LuckPerms 游戏权限不能替代 Plan 网页用户组权限。

旧 public_html 中的 React bundle 可能覆盖新界面，应先备份并逐项确认旧覆盖；不要用旧版 public_html 重新覆盖新版前端，也不要删除整个 Plan 数据目录。

ip-moderation.json 保存独立审计、撤销和观察数据，必须随同实例备份；它不会由 /plan db move 迁移。原生封禁名单也应一起保留。

本次选择继续使用现有 HTTP 配置，没有启用 HTTPS、申请证书或新增 HTTPS 强制/禁止降级逻辑。HTTP 上密码、会话和 IP 数据仍为明文；登录、权限与 CSRF 不能替代传输加密。不要把明文面板暴露在不可信网络，建议使用 VPN、SSH 隧道或可信管理网络。公版默认配置不包含正式服地址、密码或玩家数据。

实际验证

• 官方 Gradle Wrapper：build :plugin:bukkitShadowJar --console=plain 成功；最终仅修改展示导航与 CSS 后，再次执行 :plugin:bukkitShadowJar 成功。
• 现有 XML 测试结果：4093 个测试，3857 通过、236 跳过、0 失败、0 错误。未删除或禁用测试。没有配置真实 MySQL 环境，不能据此宣称完成 MySQL 端到端验证。
• 最终附件在隔离 Leaves 1.21.11 环境正常加载，SQLite 连接、数据库补丁、HTTP Webserver 和登录正常。
• 用虚构账号及文档保留 IP 检查管理 API、整组预览、匿名登录重定向和无效 CSRF 拒绝；未操作真实玩家。
• 浏览器检查 1440×960 和 390×844 布局、日间/夜间配色、页签、长备注、详情展开、忽略提示和空状态；手机无横向溢出。
• 检查封禁说明为空时禁止继续、最终确认可取消及撤销弹窗可取消。界面美化测试未重新执行真实玩家处罚。
• 最终服务启动及交互未出现 Plan 异常；HTTP 明文警告保留。主动停服期间旧浏览器的连接中断不计为恢复后错误。

未验证正式 VPS、真实 MySQL、老旧浏览器、第三方封禁插件联动和多日压力运行。地区准确性仍取决于所用离线 IP 库，共享 IP 不构成同一人的证明。

Plan Leaves IP Intelligence 5.9 build 3664

基于 Plan 5.9 开发分支的社区自定义构建，非 Plan 官方发布。

• 玩家地理与分析：省市热力图和排行、游戏名查历史 IP、同 IP 关联账号。
• IP 收集默认关闭，API 与页面需要专门的 Web 权限。
• 包含服务器导航选择修复。

安装前请备份 plugins/Plan/，替换 Plan.jar 时保留 database.db、ServerInfoFile.yml、config.yml；ip2region .xdb 数据文件需自行配置。配置和隐私说明见仓库 docs/CONFIGURATION.zh-CN.md。

构建：JDK 25，Plan/gradlew.bat build 成功；SQLite 等自动测试通过，MySQL 端到端迁移未实测。

SHA-256: 14A21F65F87B4CDAC6529D14FD975502D063689C8C67F3C106B42D00F95D20F6