sganggs/Stronghold-Protocol

《明日方舟》季节性自走棋塔防玩法「卫戍协议：盟约」的非官方同人复刻：浏览器即开即玩，单人或 1–4 人联机合作。

English summary: below.

同盟房间	策略轮选	休整期（商店 / 盟约）
部署方向轮盘	作战	最终攻势

• 声明 · 简介 · 功能一览
• 快速开始：整合包 · 从源码运行 · 系统要求 · 端口与配置 · 局域网联机
• 插件 · 联机方式 · 操作 · 文档 · 开发与测试 · 项目结构
• 许可证 · 致谢与数据来源 · 贡献

「卫戍协议：盟约」是自走棋 + 塔防：休整期在调度中心招募干员、摆阵、配装备，作战期干员自动部署，迎击从红门涌来的敌人，漏过去的敌人扣目标生命值。本项目在浏览器里复刻了这一玩法，规则和数值尽量对照官方数据表与 PRTS 核对。

• 独立模拟（单人）与同盟模拟（1–4 人合作，没有 PvP；空位可以加 AI 队友）。
• 服务器是一个 Node.js 程序，战斗在各玩家的浏览器里模拟（和官方一样），服务器只管经济与回合，一台低功耗小主机就能开服。
• 当前版本 0.3.1：Forge 工坊包导入大幅补齐（主题变量、公告、行为开关、新的盟约 / 装备 / 召唤物 / 驻守与池外官方干员、面板兼容层、特效、皮肤），插件工作台为这些新功能加了图形化模板；设置新增「素材存储」（申请持久保存、清理旧版本素材）；修复余、野鬃、缪尔赛思、瑕光等干员的官方特效和动作，琳琅诗怀雅三技能改为官方的不自动关闭，详见 CHANGELOG.md。仍有少数规则按推断实现，与官方不一致的地方欢迎在 Issue 里反馈。

• 完整的一局：确认本局信息 → 策略轮选（40 名策略）→ 14 回合 → 结算称号；险境及以上满足条件时进入第 15 回合「隐秘核心」。
• 4 种难度：标准 / 险境 / 绝境 / 终极，独立与同盟各一套参数，均取自官方数据。
• 休整期：招募、刷新、冻结、升级调度中心；整备区与临时整备区；从整备区拖到棋盘部署，用方向轮盘选择朝向。同盟模拟的卡池共用。
• 晋升精锐：3 名同名干员自动合成精锐，并获得一次高一阶的免费招募。
• 干员与调配：112 名可招募干员（+ 精锐）及其技能、天赋和特质；开局前可以为每名干员选择携带的技能（283 个技能全部手工实现）和精锐的模组。
• 盟约与层数：23 个盟约（8 个势力核心盟约 + 附加盟约），层数整局保留，每个盟约最多 999 层。
• 装备与机变：装备与法术，同名装备合成、特定组合赋予盟约效果；已配发的装备锁定在干员身上。部分回合开始前有机变选卡（装备、资金、干员、层数、悬赏等）。
• 自动作战：技能按官方「技能策略」自动释放；按接触半径阻挡，阻挡者倒下时由接触的干员接替；元素损伤与元素爆发；召唤物由玩家手动摆放；推开 / 拉拽按力度与重量计算；被击倒的干员留在原地显示再部署倒计时。
• 地形与敌人：阻隔工事、射击台、源石流吹风机、沼泽、排气格栅、涨潮等地形装置；空中与近地悬浮敌人、悬赏敌人。
• 联防：有人漏怪、又有人完美作战时，完美作战的队友带着阵容帮忙拦截漏掉的敌人。
• 最终攻势与隐秘核心：两人共享一个战场，全队共同削减同一条领袖血条；10 个敌方领袖，巨型领袖约 5×3 格的受击范围，以及官方的限伤规则。
• 结算：官方样式的个人战报和同盟结算页，卫戍认证等级（官方 60 级、每日防卫目标，按本机记录计算）；卫戍之星、不朽盟约、坚若磐石等 6 个结算称号。
• 断线重连：同盟模拟断线后 10 分钟内重新打开页面即可回到原座位，掉线期间按原阵容自动作战，也可以「暂离」交给 AI 托管；独立模拟 24 小时内可以回来继续（同一个浏览器）。
• 交互细节：漏怪时顶栏用红字 + 「−N」标记待扣的目标生命值（结算时才扣除）；点选、拖放和配发装备都按地上的方格；购买、升级和机变选卡都需要点两次确认；只有一名玩家时除作战外不计时。
• 画面与声音：真实 Spine 小人、官方 BGM 与音效、表情（6 套 × 6 个）、作战特效；可选的官方 3D 棋盘（需要从本机客户端提取贴图）。
• 手机与电脑：触摸拖拽、长按查看详情，推荐横屏；设置里可以调低画质；界面被挖孔、刘海或曲面边缘挡住时可以用「异形屏适配」调整四边。

Releases 里有两种整合包，代码和运行依赖完全相同，二选一；已经装好 0.2.x 的，升级时只下载更新包即可：

• 完整包 Stronghold-Protocol-v<版本>.zip（约 800 MB，解压后约 1.16 GB）：附带全部美术 / 音频（含中文、日文、英文、韩文和本土语言的干员语音、官方 3D 棋盘贴图、各战场的官方场景和官方战斗特效），解压就能玩，不需要再下载任何东西。推荐。
• 精简包 Stronghold-Protocol-v<版本>-lite.zip（约 25 MB）：不带素材，第一次启动时自动从公开镜像下载美术、Spine 模型、音频、字体、表情和「玩法说明」教程图（约 720 MB，可中断，再次启动会续传）；官方 3D 棋盘等本地客户端素材不在其中（见下面的「本地客户端素材」；各战场的官方场景可以用 node tools/setup.mjs --scenes 在本机下载并提取）。适合下载大文件不方便的情况。
• 更新包 Stronghold-Protocol-v<版本>-update.zip（0.2.1 起提供，大小看改动多少，通常只有几 MB）：只含比之前的 0.2.x 版本改动过的文件，用来把已经装好的 0.2.x（完整包或精简包装的都行）升级到新版本，不用重新下载整个包。用法：先停止服务器（关掉窗口；装了开机自启的运行 scripts\install-service-windows.ps1 -Stop），把 zip 里 Stronghold-Protocol 文件夹的全部内容合并到安装文件夹、覆盖同名文件（Windows 资源管理器里复制粘贴即可；macOS 不要用访达拖放，它会整个替换文件夹，请用 unzip -o，见 docs/DEPLOY.md 第 1.5 节），再照常启动。启动时会先核对全部程序文件、删除新版本不再用的旧文件，然后正常运行；如果这个文件夹不是更新包对应的版本（例如 0.1.x，或者程序文件被改过），会提示下载完整包，服务器不启动。全新安装请用完整包或精简包。

两种包都包含运行和部署文件，以及插件作者需要的工具、模板、Schemas、插件文档和战斗测试助手。完整开发测试与设计文档仍在源码仓库里。

1. 安装 Node.js 22 或 24（LTS）
   • Windows：在 PowerShell 里运行 winget install OpenJS.NodeJS.LTS，或到 https://nodejs.org/zh-cn/download 下载安装包。
   • macOS：brew install node@22，或到官网下载安装包。
   • Linux：发行版的包管理器、nvm 或 fnm。
2. 下载：在 Releases 页面下载最新版本的完整包（或精简包），解压到一个路径较短的文件夹（Windows 上建议不要放在 OneDrive 同步的目录里）。
3. 启动
   • Windows：双击 scripts\start-windows.bat。如果弹出「安全警告」，点「运行」；Windows 防火墙弹窗请勾选「专用网络」并允许。
   • macOS / Linux：在解压出的文件夹里运行 ./scripts/start.sh（或 bash scripts/start.sh）。
4. 浏览器会自动打开 http://localhost:3000。窗口里列出的局域网地址可以直接发给同一网络的朋友。关闭窗口（或按 Ctrl+C）即停止服务器。

git clone https://github.com/sganggs/Stronghold-Protocol.git
cd Stronghold-Protocol
npm install        # 安装依赖（postinstall 会把 pixi / preact / three 复制到 public/vendor）
npm run setup      # 检查环境，并从公开镜像下载约 720 MB 美术 / 音频（可中断，再次运行会续传）
npm start          # 启动服务器：http://localhost:3000

也可以直接运行启动脚本（Windows scripts\start-windows.bat，macOS / Linux scripts/start.sh）：首次会自动安装依赖、下载素材，然后启动服务器并打开浏览器。

• 本地客户端素材（可选）：官方 3D 棋盘、官方战斗特效（0.3.0「官方特效」）、部分官方界面图标（交流按钮与表情面板的边框、模组类型图标等）、灼热 / 炽焰源石虫和 39 个召唤物（多数自选召唤物）的官方模型需要从本机的《明日方舟》PC 客户端提取（Windows 原生客户端、macOS 的 CrossOver 或 PlayCover）。npm run setup 检测到客户端时会询问是否提取（需要 Python 3.8+，依赖装在项目内的 .venv-extract，不影响系统）；之后可以用 node tools/setup.mjs --local 重新提取，或用 --game "<…/StreamingAssets/AB/Windows>" 指定路径。没有客户端时游戏照常运行，这几样换成替代样式：2D 棋盘、样式相近的图标、染色的普通源石虫、召唤物头像。表情和「玩法说明」的教程图随上面的素材一起从公开镜像下载，不需要客户端。没有客户端的服务器（例如 Linux VPS）也可以从同一版本的整合包（完整包；精简包没有）里复制 public/assets/local/ 和 data/local-assets.json，见 docs/DEPLOY.md 的「本地客户端素材」。
• 素材下载优先使用 GitHub，失败时自动改用 jsDelivr 镜像。
• npm run doctor（即 node tools/doctor.mjs）可以随时诊断：Node 版本、素材是否完整、端口占用、局域网地址和防火墙。

显卡较弱时可以在「设置」里调低画质，或在网址后加 ?board=2d（强制 2D 棋盘）/ ?render=fallback（不用 WebGL 的简化画面）。

默认监听 TCP 3000。换端口：启动脚本加 --port 3001，或设置环境变量 PORT。

设置方式：macOS / Linux PORT=8080 npm start；PowerShell $env:PORT=8080; npm start；cmd set "PORT=8080" && npm start。健康检查：GET /healthz。

1. 打开页面 → 输入昵称 → 同盟模拟 → 创建房间。房主选择难度，可以添加 / 移除 AI 队友；开始前也可以把其他博士移出房间（对方可凭密钥重新加入）。
2. 把 4 位字母的同盟密钥，或「复制链接」得到的 http://<地址>:3000/?room=密钥 发给朋友。
3. 所有人点「准备就绪」后房主开始。
4. 同一 Wi-Fi / 路由器下的朋友打开启动窗口里列出的地址（形如 http://192.168.x.x:3000）即可。打不开时多半是防火墙：Windows 首次启动时在弹窗中允许「专用网络」，或运行 npm run doctor 查看具体命令；访客 Wi-Fi 常开启「AP 隔离」，也会导致连不上。

刷新页面或断线后，同盟模拟 10 分钟内、独立模拟 24 小时内重新打开即可回到原座位。服务器把房间和对局都保存在内存里，重启服务器会结束所有对局。

0.3.0 起支持插件；不开插件时按原版游玩。

• 服主安装：将插件文件夹放进服务器的 plugins/，或用 node tools/plugin.mjs install <zip路径或HTTPS地址> 安装；远程地址需带 --sha256。工作台也支持从社区目录安装和导入 Forge 工坊包。服主可在 plugins/config.json 限定可用插件。
• 房主开启：在房间顶部的「原版 / 插件 ×N」面板里选外观或玩法插件、修改插件设置、选择插件模式。玩法插件的内容会由所有玩家下载并校验，房间标为「非官方」，统计总览默认不计入。
• 玩家个人设置：「设置 → 外观插件 / 界面插件」只影响自己的浏览器；个人不能另装玩法插件改变房间规则。外观插件只换画面与声音，界面插件只读允许的对局信息。
• 自己制作：打开启动窗口 Studio: 行的地址，使用 /studio/ 插件工作台选模板、按官方名称选目标、拖放素材、实时预览、试一场并回放，最后打包分享。工作台限本机和局域网，修改需要钥匙。

脚本执行默认关闭。服主可以用 SP_PLUGIN_SCRIPTS=sandbox 开启沙箱脚本（或启动时加 --scripts sandbox；Windows 双击 scripts\start-windows-sandbox.bat）；原生受信任模式还需审查、固定锁文件哈希和玩家同意，公网部署需 trusted-force。开服设置见 部署指南，作者从插件新手指南开始，格式与限制见插件参考，接口列表见插件 API 表。

朋友不在同一个局域网时，下面是几类常见做法，按自己的情况选一种即可。这里只做简单介绍，提到的工具和服务只是举例，本项目与它们没有任何关系，也不做推荐；具体的安装、费用和使用规则请以各自的官方说明为准。部署细节（防火墙、开机自启、反向代理与 HTTPS、Docker）见 docs/DEPLOY.md。

通用注意事项：

• 游戏是单个常驻 Node.js 进程 + WebSocket（路径 /ws），只能跑一个实例，必须部署在域名根路径；Vercel 之类的 Serverless 平台和 GitHub Pages 之类的静态托管都不适用。反向代理要转发 WebSocket 升级。
• 游戏没有账号系统，知道地址的人都能进来。请只把地址发给朋友，不要公开发布，也不要搭建公开大厅；这同时能降低素材版权方面的风险。
• 有公网 IPv4 时也可以在路由器上做端口转发，但这会把家里的电脑直接暴露在公网上，优先考虑上面的方式。

完整的规则、数值和小技巧见 docs/PLAYING.md（游戏内左下角也有「玩法说明」）。

npm run dev                 # node --watch：改动服务器代码后自动重启
npm test                    # 单元 + 集成测试（约 3170 项；缺少素材 / 浏览器的用例会自动跳过；不带文件的 node --test 会把 test/ 下的辅助模块和夹具也当测试跑）
SP_E2E=1 node --test test/ui/mock.e2e.test.js        # 浏览器端到端测试，需要本机 Chrome（CHROME_PATH 可指定路径）
SP_REAL_E2E=1 node --test test/ui/real.e2e.test.js   # 需要 Chrome + 已下载的素材
RENDER_E2E=1 node --test 'test/render/*.browser.test.js'   # 渲染测试，部分需要本地提取的棋盘贴图
GOLDEN_FULL=1 node --test test/golden.test.js           # 黄金结果：固定种子的整套战斗与人机对局摘要（默认只跑快速子集）
node tools/perfbench.mjs --cpu 1,4,6 --profile             # 真实战斗的帧耗时基准（Chrome 降速 CPU 近似中低端手机），需要 Chrome + 已下载的素材

• 游戏数据由 npm run build-data（tools/build-data.mjs）从官方数据表生成，不要手工修改 data/*.json。
• 性能测试：/dev/battle-perf.html 在浏览器里跑一场真实战斗（对局用的战斗运行器、模拟和渲染），实时显示帧率与逐帧耗时；在手机上打开后点击「开始测量（10 秒）」，生成的报告可以复制后附在反馈中。用到的战斗来自 node tools/capture-specs.mjs 从固定种子的机器人对局里截取的数据（public/dev/perf/）。
• 只重构、不改玩法的提交不能改变 test/golden/*.json；有意改变玩法时运行 npm run golden:update，检查差异后随改动一起提交（见 test/golden/README.md）。
• GitHub Actions（.github/workflows/ci.yml）在 Ubuntu 与 Windows、Node 22 / 24 上运行 npm ci、npm test 和服务器冒烟测试。
• 代码怎么分层、改某个规则该从哪个文件入手，见 docs/ARCHITECTURE.md。

• 代码：本项目自己编写的代码以 GPL-3.0-or-later 发布，全文见 LICENSE；另附一条 GPL 第 7 条的附加许可，允许与 pixi-spine 中的 Spine Runtimes 组合分发（见 NOTICE.md）。
• 游戏素材不在许可范围内：《明日方舟》相关的美术、音乐、音效、文本与数据等版权归原权利人所有，不适用 GPL，使用限制见上方的声明和 NOTICE.md。
• 第三方组件各自遵循其许可证：通过 npm 安装的库（整合包的 node_modules 中附带各自的许可证文件）、tools/local-extract/aklz4.py 的算法（BSD-3-Clause），以及字体等，清单与许可证全文见 THIRD-PARTY-NOTICES.md。

• 游戏数据：Kengxxiao/ArknightsGameData。
• 素材来源：yuanyan3060/ArknightsGameResource、fexli/ArknightsResource、isHarryh/Ark-Models、ArknightsAssets/ArknightsAssets2；字体来自 TimWangZi/The-font-of-Arknights 与 Google Fonts（Noto Sans SC）。详见 docs/ASSETS.md。
• 规则核对参考：PRTS 明日方舟中文 Wiki。
• LZ4AK 解包：tools/local-extract/aklz4.py 的算法来自 isHarryh/Ark-Unpacker（BSD-3-Clause，经 MooncellWiki/UnityPy）；解析 Unity 资源使用 UnityPy（MIT）。
• 库：PixiJS（MIT）、pixi-spine（MIT；其中包含的 Spine Runtime 另受 Spine Runtimes License 约束）、three.js（MIT）、Preact + htm（MIT）、ws（MIT）。

感谢以上项目的作者与维护者，以及鹰角网络带来的这款游戏。

欢迎提 Issue 反馈 bug、与官方规则不一致的地方或改进建议，也欢迎提交 Pull Request：

• 准备环境、运行测试、忠实原则和提交约定见 CONTRIBUTING.md。
• 提交前请运行 npm test，并同步更新相关文档；文档使用简体中文，代码与注释使用英文。
• 提交的代码将以 GPL-3.0-or-later 发布。
• 请不要提交任何游戏素材文件（public/assets/ 等目录已被 .gitignore 排除）。
• 本项目坚持非商业：请不要提交广告、付费、打赏等任何形式的变现功能。

An unofficial, non-commercial fan remake of Arknights' seasonal auto-chess tower-defense mode Stronghold Protocol: Alliance, played in the browser: solo, or 1–4 player co-op (AI teammates can fill seats). Combat is simulated in each player's browser, so a low-power PC can host.

• Run: download the full bundle Stronghold-Protocol-v<version>.zip (~800 MB, all the art inside, the Chinese, Japanese, English, Korean and own-language operator voices, the official battlefield scenes and the official battle effects included) from Releases — or the lite one, …-lite.zip (~25 MB), which downloads the art (~720 MB) on its first start; from 0.2.1 on, …-update.zip holds only the files changed since the earlier 0.2.x releases: stop the server, extract it over an existing 0.2.x folder and start again (the first start deletes the files the new version dropped and verifies the install) — install Node.js 22 or 24, then double-click scripts\start-windows.bat (Windows) or run ./scripts/start.sh (macOS / Linux) and open http://localhost:3000. From source: npm install && npm run setup && npm start (setup downloads ~720 MB of art from public mirrors, the emotes and the how-to-play pages included; the official 3D board, some official HUD icons, two enemy models and 39 summon models are extracted from a local Arknights client — without one the game uses the 2D board and look-alike stand-ins (the summons show their avatars), and a server can copy public/assets/local/ and data/local-assets.json from the full bundle of the same version).
• Languages: Chinese (the default), English, 日本語, 한국어 and 繁體中文 — switch on the title screen or in Settings. Game texts come from the official clients; the Japanese, Korean and Traditional Chinese interface strings are machine translations (corrections welcome: docs/I18N.md).
• Play with friends: create a co-op room and share the 4-letter key or the ?room=KEY link. On a LAN, use the address printed at start; otherwise use a virtual-LAN tool, a tunnel or a VPS — see docs/DEPLOY.md.
• Disclaimer: not affiliated with or endorsed by Hypergryph or Yostar. All Arknights names, art, audio, text and data are © their respective owners and are not covered by this project's GPL licence. For study and personal non-commercial use only — no selling, paid distribution, paid servers or monetisation of any kind. Content will be removed on request of the rights holders. Provided "as is", without warranty.
• License: code GPL-3.0-or-later (LICENSE); game assets excluded.
• Contributing: CONTRIBUTING.md (an English summary at its end); the code map is docs/ARCHITECTURE.md.