LSE BlockLog - 为基岩版服务器打造的方块操作记录与回档系统 1.0.2

[MD] ## 1.0.2 Release 更新日志 **发布日期：** 2026-06-24 **版本号：** v1.0.2 ### 新增特性 - **方块/物品类型映射表** 新增 `block_items` 表，用数字 `uid` 代替 `operations` 表中存储的长字符串（如 `minecraft:stone`），显著压缩数据库体积。 - **本地离线迁移工具** 当数据库过大、服务器内存不足以完成自动迁移时，可下载 `migrate_db.exe` 到本地 PC 进行离线转换，迁移完成后将数据库上传回服务器即可。 ### 优化 - 大幅减少重复类型字符串造成的空间浪费，实测可压缩 30%~60% 的数据库大小。 - 服务器启动时自动检测并迁移旧数据，迁移过程分批进行，避免内存溢出。 - 所有事件回调增加异常保护，防止因单个方块数据异常导致引擎崩溃。 ### 修复 - 修复了 `onBlockChanged` 事件中因方块 `type` 为 `undefined` 引发的 `TypeError`。 - 修复了旧版本数据库迁移时一次性加载全部记录导致 `bad_alloc` 的问题。 - 修复 Web 面板端口被占用误报 ### 注意事项 - **自动迁移需要一定内存**：默认每批处理 5000 条记录，若数据库极大（>10万条）且服务器内存较小，建议使用**本地迁移工具**在个人电脑上处理。（存放于插件压缩包/BlockLog/migrate_db.exe） - 迁移完成后将在控制台输出创建的映射项数及预估节省空间。 - 本次更新完全兼容旧数据库，无需手动干预。 ## 本地离线迁移工具 (migrate_db.exe) 当服务器内存不足以完成自动迁移时，可使用此工具在本地 PC 上完成数据库的 UID 转换。 **使用方法：** 1. 将服务器上的 `plugins/BlockLog/blocklog.db` 下载到本地。 2. 打开命令行，执行： ``` migrate_db.exe blocklog.db ``` 3. 等待程序运行完毕，会输出迁移进度和节省空间信息。 4. 将转换后的 `blocklog.db` 上传回服务器原位置，重启服务器即可。 [/MD]

[MD] **这是 BlockLog 的首个正式稳定版，基于 v1.0.0 预发布版的反馈进行了全面修复和增强。** 已在 Levilamina 1.9.5 环境下完成多轮测试，建议所有用户升级到此版本。 --- ## 新特性 - **监察模式右键查看** 开启监察模式 (`/bl inspect`) 后，右键任意方块即可直接查看该位置的最近 5 条操作记录，输出格式与查询命令一致。 - **数据库大小显示** `/bl status` 现在会显示数据库文件的实际占用空间（自动转换为 B/KB/MB）。 - **容器名称优化** 容器相关操作（如箱子、木桶）的记录中，现在会显示方块的本地化名称（例如“箱子”），而不是原始的英文 ID。 - **回档能力增强** - 回档破坏的方块时，会更完整地恢复方块的 NBT 数据（如朝向、开关状态等）。 - 回档容器物品时，如果目标方块已不存在，插件会自动根据记录重建容器方块，再进行物品恢复。 --- ## 修复 - 修复了数据库查询时频繁出现的 `SQLiteStmt::step` 错误，所有参数化查询已改用预准备语句，大幅提升稳定性。 - 修复了回档容器操作时 `getContainerSnapshot is not defined` 的致命错误，现在容器物品可以正确回退。 - 修复了回档后容器类方块朝向错误的问题（方块 NBT 写入流程已优化）。 - 修复了监察模式下右键方块时重复触发十几次的问题，加入了可靠的防抖机制。 --- ## 安装与升级 1. **全新安装** - 下载 `BlockLog-v1.0.1.zip` 并解压至 `plugins/` - 进入 `plugins/BlockLog/` 目录，安装依赖： ``` lip install express express-session bcryptjs ``` - 启动服务器，首次运行会自动生成配置文件及数据库。 - 查看 `plugins/BlockLog/initial_token.txt` 获取超级管理员 Token，登录 Web 面板（默认 `http://<服务器IP>:3000`）完成初始设置。 2. **从 v1.0.0 升级** - 备份 `plugins/BlockLog/` 文件夹（包括数据库和配置文件）。 - 删除旧的 `plugins/BlockLog/` 目录。 - 解压新版本压缩包，并重新安装依赖（同上）。 - 将备份的 `blocklog.db` 和 `config.json` 复制回 `plugins/BlockLog/`。 - 启动服务器，升级完成。 --- ## 注意事项 - 本版本为正式版，但仍建议在生产环境部署前先在测试服验证回档功能。 - 普通玩家查询半径限制默认为 200 格，管理员无限制。 - 使用 `/bl consumer off` 可暂停事件记录，`/bl consumer on` 恢复。 - 清理历史数据：`/bl purge t:30d`（支持 `#vacuum` 压缩数据库）。 --- ## 问题反馈 如遇到 Bug 或有功能建议，请前往 [GitHub Issues](https://github.com/wuqinlanjian/BlockLog/issues) 提交，附上错误日志和复现步骤。 感谢你对 BlockLog 的支持！ [/MD]