PCH System v0.10.0 - Plugin Catalogue

Plugin ID	Requirement
mcdreforged	>=2.14.0
uuid_api_remake	*
minecraft_data_api	*
chest_scanner_lib	>=1.0.1

Python Package	Requirement
requests	>=2.31

⚠️ 本插件需配合 PCHSystem 后端使用，单独安装 .mcdr 无法工作。

这是什么

PCH System 是 PCHSystem 的游戏内客户端（MCDReforged 插件）：材料协作收集、项目三阶段进度管理、积分 / 称号、通知投递等全在游戏内 !!PCH 命令完成。所有功能经 HTTP 调用后端，必须先部署后端。

首次部署（全栈 · 推荐）

git clone https://github.com/YuShenLiu06/PCHSystem.git
cd PCHSystem
bash Scripts/install.sh

脚本一键完成：docker / 镜像自适应 → 生成 .env → 起 postgres+backend+web → 数据库迁移 → 前端构建 → 拷贝插件 + 生成 config.json。完成后游戏内 !!MCDR plugin reload pch_system → !!PCH status（自检）→ !!PCH login。

升级（已部署）

bash Scripts/update.sh

详情参考 部署流程

依赖

MCDReforged ≥ 2.14.0
插件依赖：chest_scanner_lib（v0.10.0 新增，硬依赖）、uuid_api_remake、minecraft_data_api——install.sh / update.sh 经 MCDR pim 自动检测补装，无需手动下载
PCHSystem 后端（必需） + 前端（可选）：见上「首次部署」

破坏性变更

v0.10.0 起箱子扫描剥离为独立插件 chest_scanner_lib（硬依赖）。旧部署（<0.10.0）升级后，!!MCDR plugin reload pch_system 会因依赖缺失被 MCDR 卸载（重启也无效）。

恢复：在仓库内再执行一次 bash Scripts/update.sh（v0.10.0 脚本会自动检测并补装缺失依赖），随后游戏内 reload 即可；或参照下文「更新内容」手动 pim 安装。

更新内容

⚠️ 破坏性变更：箱子扫描剥离为独立插件，本版起 pch_system 硬依赖 chest_scanner_lib。旧部署（<0.10.0）升级后，!!MCDR plugin reload pch_system 会因依赖缺失被卸载（重启也无效）。恢复方法（任选其一）：

仓库内再执行一次 bash Scripts/update.sh（新版会自动检测并补装缺失依赖），随后 reload；
手动安装：mcdreforged pim download chest_scanner_lib -o <plugins 目录> → mcdreforged pim pipi <下载的 .mcdr 文件> → !!MCDR plugin reload pch_system。

Changed

箱子扫描独立成库：!!submitc / !!PCH sheet submitchest 的扫描实现（RCON 读箱、准星检测、SNBT 解析、双联合并）剥离为官方插件目录收录的外部插件 chest_scanner_lib（>=1.0.1），随依赖自动安装；游戏内命令用法不变。内嵌 chest_scanner.py 移除，插件自身不再需要 hjson Python 依赖。

Added

部署脚本（运维）：依赖插件安装改走 MCDR 原生 pim CLI——install.sh 缺失自动安装（交互确认）；update.sh 每次执行自动补装缺失依赖（置于版本比对之前，「已是最新」也生效——旧部署升级断裂后再跑一次 update 即恢复），另新增 --upgrade-plugins 主动升级已装依赖到 latest（换文件防同 id 双载）；依赖 id 清单从 mcdreforged.plugin.json 运行时解析，杜绝清单漂移；TestServer 构建同链路。

配套前后端变化（pch_system-v0.9.3 → v0.10.0 期间）

建议随本版一并升级（bash Scripts/update.sh 全栈更新；backend 含数据库迁移 0024，部署脚本自动执行）：

backend-v0.10.0（2026-08-19）· 积分层上线

积分记账 API：积分批量入账 / 出账与多角色流水分页；每笔变动单独记账、不可篡改、附记账后余额，可完整审计回溯；支持防重复提交、透支开关、记账站内通知。
管理员调分 API：管理员/拥有者调增调减玩家积分（原因必填、可附备注），玩家收可读通知、操作入审计日志；配套玩家名联想接口。
余额排名与按账号流水：玩家积分余额排名接口（余额由流水累加重建）；流水查询支持按账号过滤，供后台下钻。
托管管理账号：.env 配置用户名/密码后，启动自动创建/更新不绑定任何玩家的管理员账号，专用于纯后台管理。
修复：负余额账号入账不再被透支守卫静默跳过；托管账号撞名接管不再静默（打警示日志）；调分通知附备注时文案完整。

frontend-v0.11.0（2026-08-19）· 积分管理页

积分管理页：管理员/拥有者新增「积分管理」——「积分流水」按玩家/时间筛选（服务端分页），「玩家积分」展示余额排名（负余额红标），点击行下钻该账号流水抽屉（自带分页）。
调分弹窗：入账/出账方向预览，透支开关仅出账可用，原因与备注有中文提示；调分后余额即时刷新。
托管账号登录：登录支持无绑定玩家的托管管理账号，「我的身份」入口按是否绑定显隐。
修复：下拉框/输入框聚焦描边错位（双框）；积分页「N 条/页」切换档位不生效。

frontend-v0.10.0（2026-08-15 · 与 pch_system-v0.9.3 同批发布）

若前端仍停留在 v0.9.x：此版为界面全面换新——与 wiki 统一的深板岩 + 草方块绿视觉；亮/暗主题（自动跟随系统 + 顶栏三态切换）；顶部导航栏 + 品牌 logo + 用户区（窄屏折叠抽屉）；材料表「换算」列按盒/组/个分段、交付进度组刻度条；404 页与动态标签页标题。

pch_system-v0.10.0.mcdr