PCH System v0.10.1 - 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 后端（必需） + 前端（可选）：见上「首次部署」

更新内容

部署脚本修复：MCDR 跑在容器里（宿主机无 mcdreforged CLI）时，依赖插件也能自动补装。

Fixed

部署脚本（运维）：MCDR 容器化部署时依赖插件补装必败（#73）。现 pim 不可用时自动回退老方案——直连各插件 GitHub Releases（下载失败自动试镜像链）原子落盘 .mcdr 到 plugins/（zip 内插件 id 校验）；Python 依赖不自动装，按部署形态给出容器 / venv 手动指引；失败时输出对应 Releases 链接。

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

backend-v0.10.1（2026-08-22）

托管管理账号可用性修复与安全加固。

托管账号绑定管理玩家：ADMIN_* 托管账号现同步绑定同名管理玩家——登录 JWT 带 active_uuid，admin 可直接执行建项目、编辑等全部玩家级写操作，不再报 missing active_uuid；同名玩家已被其他账号绑定时不再抢占（告警并回退只读形态）。
OpenAPI 文档增强：鉴权头声明为 security schemes（/docs 出现 Authorize 按钮），全部端点补中文摘要。
修复：无绑定玩家的托管账号登录后访问「个人信息」「施工管理」被 401 missing active_uuid 踢回登录页（#74）——admin 端点鉴权升 account 级（admin 不再要求绑定玩家）；GET /me 对无玩家账号返回 active_uuid=null；续签放行无玩家账号；材料表 / 施工进度对无玩家账号开放只读浏览（写操作仍需玩家身份）。
修复：施工 mod 源审批复验：active_uuid 须仍属当前 admin 账号才记为审批人（玩家迁移到其他账号后，旧 token 不再冒名）。
安全：阻断托管账号同名提权：ADMIN_* 同名管理玩家改为不可登录锚点——任何人以管理员用户名同名进离线服后，经 !!PCH login 无密码换 owner JWT 的提权链被切断；历史挂靠产物同步收回并告警。

frontend-v0.11.1（2026-08-22）

注册入口：登录页新增「注册」，引导到游戏内 !!PCH login 完成账号注册与绑定。
修复：无绑定玩家的托管管理账号登录后浏览「个人信息 / 施工管理」不再被 401 踢回登录页（#74，与 backend-v0.10.1 配套）。
修复：web 入口 index.html 加 Cache-Control: no-cache——发版后浏览器不再继续跑旧 bundle 引用旧 chunk（/assets/ 仍一年强缓存）。

pch_system-v0.10.1.mcdr