PalOps Web

截图说明： README 中的全部界面图均来自 V1.3.2 当前前端页面，使用专用伪数据、虚构玩家/公会、保留地址和项目内置离线地图瓦片生成。截图不包含真实服务器 IP、世界 ID、账号、Token、Webhook、Cookie、存档路径或生产数据。

• 统一更新与扩展入口：将原“更新中心”和“插件与模组”合并为“更新与扩展中心”，统一提供核心组件、插件与模组、更新任务、备份与历史四个标签；旧 /system/plugins 链接自动跳转到扩展标签。
• 稳定组件身份与去重：PalOps Web、PalDefender、PalServer、UE4SS 使用稳定组件 ID；PalDefender 本地插件信息合并到核心组件记录，不再重复显示 Plugin: PalDefender。
• PalDefender 在线更新：仅从配置的官方 GitHub Release 下载受控 ZIP，执行 SHA-256、容量、ZIP 路径和重解析点校验，并按“备份 → 停服 → 原子替换 → 启动 → 验证”流程更新，失败自动回滚。
• PalOps Web 外部自更新器：新增独立 PalOps.Updater 项目，主进程完成下载、校验和备份后安全退出，由外部更新器替换程序与 wwwroot、重启并执行版本健康检查，失败时恢复旧版本。
• 统一任务、审计与历史：核心更新接入任务中心的优先级、互斥资源、进度、取消和持久化历史；下载、执行与回滚接口继续执行角色权限、CSRF 和结构化审计。
• 受限更新配置：系统设置新增官方仓库、Release 资产规则、下载/解压上限、本机回环健康检查地址和 PalServer 自动重启开关，不接受任意下载 URL。
• 版本与发布产物统一：后端、更新器、Vue 包、双语文档和 wwwroot/palops-build.json 统一为 1.3.2，前端生产产物直接集成到 src/PalOps.Web/wwwroot。

PalOps Web 不是通用云面板。它面向与 PalServer 同机部署的 Windows 专用服务器，用于解决社区服长期运营中进程控制、玩家数据、存档、地图、PalDefender、防护配置、通知和审计彼此割裂的问题。

• 一个工作台：运行监控、玩家、公会、地图、物资、配置、维护、存档、安全和治理统一管理。
• 本地优先：存档只读解析、离线地图瓦片/POI、本地 JSON/JSONL 数据和审计链路均可在局域网环境运行。
• 安全写入：身份认证、角色权限、CSRF、SHA-256 并发检查、修改前备份、原子替换和结构化审计。
• PalDefender 深度集成：REST、扩展 RCON、版本、白名单、封禁与完整配置文件管理。
• 首次部署友好：未配置时页面安全降级并明确告诉管理员“还缺什么、去哪里配置”。

PalDefender 与 PalOps Web 是独立项目。未安装 PalDefender 时，基础进程控制、存档解析、离线地图、备份及部分原生 REST/RCON 能力仍可按配置使用；依赖 PalDefender 的防护、扩展命令和特色实时数据会明确标记为未配置或不可用。

玩家管理	公会据点
在线/离线玩家、角色信息、背包与帕鲁档案。	成员、会长、归属证据、据点和地图定位。

Palworld 配置	服务器统计
结构化参数、启动参数、诊断、差异和安全保存。	玩家、FPS、资源和运营事件趋势。

按在线状态、公会、角色信息选择一个或多个目标，避免把资源误发给错误玩家。

支持物品和帕鲁分类、中文名、英文名、内部 ID 及空格分隔的多元素搜索，并批量加入发放清单。

再次核对玩家、资源、数量、经验/科技点和执行范围；实际写操作仍经过权限、确认与审计。

消息发送	RCON 控制台
公告、警告、定向消息和受控玩家操作。	命令模板、能力探测、高风险确认和响应历史。

自动任务	维护中心与崩溃守护
周期任务、风险等级、下次运行和执行结果。	安全维护编排、健康验证、自动恢复与熔断。

存档备份	存档差异
备份、校验、下载、恢复预检和保留策略。	快照变化、异常提示和重要资源变化。

玩家纪律	插件与模组
白名单、封禁、身份、违规、踢出和审计。	版本、依赖、兼容性、更新、备份和回滚。

诊断中心	事件与故障中心
进程、网络、文件、配置、资源和支持包。	告警规则、聚合、确认、分派、恢复和时间线。

玩家洞察	世界分析与据点治理
玩家时间线、活跃度、流失信号和运营备注。	据点归属、治理候选、复核状态与人工说明。

灾备中心	更新中心
灾备目标、RPO/RTO、验证和恢复演练。	组件版本、更新预检、审批和健康验证。

配置版本库	运维剧本
快照、差异、当前匹配与受控回滚。	白名单动作、顺序步骤、执行历史和高风险确认。

安全中心	对外集成
安全策略、API Token、作用域、过期与吊销。	HTTPS 事件订阅、签名引用、重试和投递历史。

消息通知	推送记录
多渠道 Webhook、事件订阅、模板和重试策略。	投递状态、HTTP 结果、耗时和失败原因。

系统设置	PalDefender 防护组件
首次使用教程、配置清单、连接、存档和备份设置。	连接、版本、配置文件、字段说明和原子保存。

存档解析	物品与帕鲁目录
快照状态、自动解析、格式检测和手动任务。	离线目录、图标、分类、别名、收藏与导入。

审计日志	系统日志
关键操作、结果、来源地址和结构化详情。	业务日志、级别筛选、搜索和异常定位。

权限管理	关于系统
多角色账户、启停状态和最近登录。	版本、数据来源、开源依赖和许可证说明。

flowchart LR
    Admin[管理员] --> PalOps[PalOps Web]
    PalOps -->|REST Bearer Token| PDREST[PalDefender REST]
    PalOps -->|扩展命令| RCON[PalDefender RCON]
    PalOps -->|白名单校验 / 备份 / 原子替换| Config[PalDefender JSON 配置]
    PDREST --> Runtime[玩家 / 指标 / 版本 / 防护数据]
    RCON --> Operations[封禁 / 解封 / 广播 / reloadcfg]
    Config --> Protection[反作弊 / 日志 / 管理员 / 游戏规则]

PalOps Web 提供 PalDefender 当前版本检查、REST 地址与 Token 连通性、完整配置文件中文说明、严格 JSON/type 校验、路径保护、SHA-256 冲突检查、修改前备份、临时文件写入、原子替换以及 reloadcfg / 重启提示。

安装与 Token 配置见 PalDefender 部署说明 和 PalDefender 配置管理。

flowchart LR
    Browser[浏览器\nVue 3 + Element Plus + MapLibre] -->|Cookie + CSRF| Web[PalOps.Web\nASP.NET Core / .NET 10]
    Web -->|SignalR| Browser
    Web --> Runtime[PalServer / Shipping\nWindows 进程控制]
    Web --> Save[Level.sav / Players\n只读快照解析]
    Web --> PalREST[Palworld REST]
    Web --> RCON[Palworld / PalDefender RCON]
    Web --> Defender[PalDefender REST 与配置目录]
    Web --> Notify[Webhook 渠道与事件订阅]
    Web --> Data[(本地 JSON / JSONL\n设置、审计、任务与状态)]
    Browser --> Map[前端离线地图瓦片\nPOI 与坐标转换]

关键安全边界：

• 浏览器不直接读取 PalDefender Token，也不直接操作 PalServer 或 RCON。
• 所有写操作经过身份、角色权限、CSRF、确认词和结构化审计。
• 停服与强停前重新验证 PID、可执行文件路径和服务器安装目录。
• 存档解析只读取私有快照；解析失败时保留最后一份成功索引。
• PalDefender 配置只允许白名单文件和受控相对路径。
• 地图瓦片、固定 POI 和坐标转换作为前端静态资源发布。

• Windows 10/11 或 Windows Server；
• .NET 10 SDK；
• Node.js 22；
• 本机 Palworld Dedicated Server；
• 推荐安装 PalDefender，以启用防护、扩展 RCON 与特色实时数据能力。

git clone https://github.com/CoderYiXin/PalOpsWeb.git
cd PalOpsWeb
.\scripts\build.ps1

生成 Windows x64 发布包：

.\scripts\fetch-map-tiles.ps1 -Layer all
.\scripts\publish-win-x64.ps1 -Version 1.3.2

也可以分别构建：

cd frontend-vue
npm ci
npm run build

cd ..
dotnet build PalOpsWeb.slnx -c Release
dotnet build PalOpsWeb.Tests.slnx -c Release
.\scripts\run-verifiers.ps1 -Configuration Release -NoBuild

PalOpsWeb.slnx 只包含主程序、外部更新器和仓库工具；全部 .Verifier 项目位于独立的 PalOpsWeb.Tests.slnx，不会再挤占日常开发解决方案。

前端生产产物写入 src/PalOps.Web/wwwroot，ASP.NET Core 发布包不需要单独部署前端服务。

主解决方案 PalOpsWeb.slnx 包含主程序 PalOps.Web、仅供自更新流程调用的辅助程序 PalOps.Updater 和仓库工具；验证项目已移入 PalOpsWeb.Tests.slnx。调试运行时应选择解决方案启动配置 PalOps Web，或在解决方案资源管理器中右键 src/PalOps.Web 并选择“设为启动项目”。PalOps.Updater 不能单独启动；它只接受主程序生成的 --request <update-request.json>。

1. 解压到独立目录并使用有权读取 Palworld 存档、检查 PalServer 进程的 Windows 账户启动。
2. 完成 Owner 初始化，然后优先进入 系统设置 查看首次使用配置清单。
3. 初始化本地数据目录，配置 Palworld 世界存档路径并生成第一份存档索引。
4. 配置并测试 Palworld REST；需要防护与扩展能力时配置 PalDefender REST。
5. 配置 RCON，并确认管理员密码、端口和命令能力探测结果。
6. 配置备份目录，执行第一份备份并验证 SHA-256。
7. 根据需要启用自动任务、维护计划、通知渠道和灾备目标。
8. 仅通过受信任 LAN、VPN 或 HTTPS 反向代理开放管理入口。

依赖检查默认在后台静默执行并复用短期缓存；只有确认缺少必要配置时，相关页面才显示内嵌说明并阻止不安全操作。配置完成后缓存会被刷新，页面切换不再反复出现检查遮罩。

完整说明见 构建文档、部署文档 和 发布检查清单。

默认文档为中文，每份主要技术文档提供 English 对应页。

.github/workflows/build.yml 在 push、Pull Request 和手动触发时执行：

1. Node.js 22 依赖安装、前端契约、TypeScript 与 Vite 构建；
2. npm 高危依赖审计；
3. .NET 10 restore 与 Release build；
4. 目录、地图、README、双语截图、文档和源码仓库校验；
5. 运行数据、密钥、编译缓存和不允许发布的内部文件残留检查。

• 不要把 PalOps、Palworld REST、PalDefender REST 或 RCON 端口直接暴露到公网。
• 不要提交 data、存档、数据库、日志、Data Protection 密钥、密码、Token、Cookie 或真实截图。
• 生命周期控制只支持 Windows 本机 PalServer；Web UI 以桌面浏览器为主要目标。
• 地图图像再分发前请核对 THIRD-PARTY-NOTICES.md。

漏洞报告见 SECURITY.md，贡献流程见 CONTRIBUTING.md。

PalOps Web 以 GNU GPL v3 或更高版本发布。Palworld 及相关名称、商标和游戏资产归各自权利人所有；本项目与 Pocketpair 无隶属或背书关系。