STFCS · 项目笔记

《远行星号》风格的桌面战术舰队战斗推演系统，服务端权威架构。在线 stfcs.205716.xyz · 仓库 fire-disposal/STFCS · 状态 ACTIVE SYSTEM。

定位

• 规则边界放服务端：客户端提交行动意图，服务端验证并广播结果。
• 核心战斗模型：六象限独立装甲、软 / 硬辐能、过载与排散、三阶段机动、供主持人实时调控的 DM 控制台。
• README 仍以稳定舰队战斗系统为主，开发命令、Docker 部署与 GitHub Actions → GHCR → SSH 部署链路已明确。

架构与数据流

客户端(React 19 + PixiJS) → 行动意图 → 服务端(Node + Socket.IO, 权威裁决)
                                      → 结果广播(Zustand 客户端状态)

技术栈

• 前端：React 19 + PixiJS（桌面战场）+ Zustand（客户端状态）。
• 后端 / 实时：Node.js + Socket.IO（实时房间与同步）。
• 部署：GitHub Actions → GHCR → SSH + Docker。

核心设计要点

• 服务端权威：客户端只提交意图，结果由服务端广播；越权操作被拒绝。
• 共享数据 schema + sync:full / state:patch / RPC 响应 + 断线重连验收纳入集成测试。
• 舰船专用规则与通用房间 / 资产 / 存档基础设施分层，降低维护耦合。

近期重点与路线图

• 近期：稳定舰队战斗垂直切片——双客户端回归、服务端裁决一致、无人自定义派系清理不打断回合、CI/CD 一条可复现链路。
• 中期：强化主持人与战斗记录——DM 观察、战斗日志筛选 / 回放 / 快照、schema + 同步协议集成测试、分层解耦。
• 长期：谨慎评估新战术域——须先冻结共享 schema 与边界、服务端权威协议、最小 vertical slice、双客户端同步验收，再决定复用基础设施或另立仓库。

边界与不做

• 不把 STFCS 变成自动替主持人裁决的完整规则引擎。
• 不在舰队系统稳定回归前横向扩张多个游戏域。
• 不以视觉特效替代服务端同步、状态一致性与可恢复存档。

部署与门禁

• GitHub Actions → GHCR → SSH（stfcs.205716.xyz）部署链路；Docker 健康检查、构建、镜像推送、SSH 部署与生产状态检查保持可复现。

情报来源

• GitHub README 与截至 2026-08-07 主分支提交；docs/design/flux-balance.md 与现有架构 / 部署约定。

更新动向

• 2026-08-07：近一轮提交聚焦战斗面板稳定性与回合信息可读性——d062c0e 稳定战斗/游戏面板、b9f4ffd 回合条派系名提示、24d38c3 重整 TurnBar/TopBar 准备状态/头像/旗帜布局等。