适用源码：
9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为，默认配置不等于实服配置。
设计状态：按现状编写，具体业务批准记录未逐项核定；开发状态：下述能力有实现证据，限制单列；验证状态：完成定向源码核对，未执行自动测试或实服验收。
范围
本文是可公开的发布流程解释，不是对生产操作的授权。本阶段只读过脚本，没有执行构建、同步、停服或重启。具体参数由同提交 Git 脚本维护，不复制完整部署工具。
构建与产物
在独立工作副本确认源码、依赖和配置差异。构建入口为 mvn -f folia_plugin/pom.xml package -DskipTests，产物为 folia_plugin/target/folia_plugin-1.0-SNAPSHOT.jar。skipTests 不代表测试通过，显式回归另行执行。客户端资源变化还需构建 ZIP 与 manifest。
先预览再应用
| 入口 | 当前实际行为 |
|---|---|
| scripts/sync-plugins.ps1 | 不加 -Apply 为预览，需要已存在 JAR（ArtOnly另有范围） |
| scripts/sync-plugins.sh | 默认预览，--apply 才应用 |
| scripts/package-and-sync.sh | 构建后默认预览，--apply 才应用 |
| scripts/package-and-sync.ps1 | 当前只接收 Target，要求已有 JAR，构建资源后直接调用同步 -Apply |
不要把 PowerShell 一键入口当作安全预览。 scripts/README.md 对它“先编译且默认预览”的描述与源码不同。Windows 预览使用单独同步脚本，不通过一键入口探测。
路径均由操作者填入专用插件目录，不能指向仓库 Plugins。脚本拒绝部分链接/重解析路径。目标文件列表包括版本控制及未忽略文件，预览须检查是否误纳入新文件。
推荐检查顺序
- 在隔离目录准备产物与对应资源，记录提交与哈希。
- 确认运行数据备份和恢复方案，不用开发数据库覆盖服务器。
- 运行同步预览，核对目标、保护项、ZIP 与配置清单。
- 计划停服保存后，才由有权限维护者执行应用。
- 更新 JAR 后正常重启，核对启动日志和核心功能；CE 重载不能替代 JAR 重启。
同步不负责自动完成整个维护窗口，也不意味着客户端已加载资源。
失败与回滚
任一步失败停止后续发布。回滚必须匹配配置、数据结构、JAR 与资源，不只复制旧 JAR。同步会保留大量目标文件，但资源退役链有特定清理行为，不宣称绝不移动任何文件。
来源
README.md、docs/部署与资源维护.md、scripts/README.md；直接核对 scripts/package-and-sync.ps1、package-and-sync.sh、sync-plugins.ps1（同 scripts）。README 与执行代码冲突按代码描述，不擅自更改脚本。
相关：架构依赖。