PCH System v0.10.2 - 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（硬依赖）、uuid_api_remake、minecraft_data_api——install.sh / update.sh 自动检测补装，无需手动下载
PCHSystem 后端（必需） + 前端（可选）：见上「首次部署」

更新内容

子材料协作大修：可单独认领交付，父项备齐后整单锁定。

Fixed

子材料行（子物品）无法认领/更改状态/交付（#80）——现可像普通材料一样单独认领、解除、交付；认领父项时自动连带认领其未认领的锁定子材料；认领后再新建的子材料自动归认领人。
父项备齐后子材料整单锁定：父项交齐（标备齐）后，其子材料的认领/交付/改动/删除会被拒绝并提示「父行已备齐，子行已锁定」；打回父项即恢复。
!!PCH sheet view 锁定行（含子行）显示交付进度 delivered/need。
批量提交（!!submitc / !!PCH sheet submit）回执：未认领行的「需先认领」不再被折叠成「与您无关」；操作被拒时显示具体原因，不再是笼统的「状态非法」。

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

backend-v0.10.2（2026-08-31）

sheets 子物品生命周期闭环。

修复：子物品生命周期（#80）：子行与普通行共用状态机、可独立协作；父行备齐后子行全部写操作拒绝（409 附中文原因），父行打回或需求上调自动解冻，存量数据无需迁移；解除父行只连带解除同认领者的锁定子行（他人认领的保留）；父行改模式不再连带改子行模式；修复 0.07×100 类级联重算进位多算 1。
修复：并发加入施工撞唯一约束时不再报 500（补缺失 import，恢复兜底重试）。

frontend-v0.11.2（2026-08-31）

修复：子物品行放开操作：可认领/解除、切换模式，锁定子行显示交付进度列。
修复：父项备齐后子行显示锁定状态：状态列显示「已锁定」、操作列显示原因，操作与删除入口同步隐藏。

pch_system-v0.10.2.mcdr