OpenFactorioServerManager · BAYUNZIYUE · Jun 19, 2026 · Jun 21, 2026 · Jun 21, 2026 · Jun 21, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,56 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.12.0] - TBD
+
+### Added
+- Server version manager: download, update, and downgrade Factorio server from UI - Thanks to @BAYUNZIYUE
+  - Full version list from updater.factorio.com (stable/experimental)
+  - Async install with WebSocket real-time progress
+- Mod sync from save: read mod list from level.dat0 with exact versions - Thanks to @joey00797-cell
+  - Selective sync with checkboxes
+  - WebSocket download progress for each mod
+- DLC mods (elevated-rails, quality, space-age) detected from mod-list.json
+  - Grouped in UI with single toggle - Thanks to @joey00797-cell
+- i18n internationalization via i18next framework with zh-CN translations - Thanks to @joey00797-cell, @BAYUNZIYUE
+- Language switcher dialog (EN / RU / 中文)
+- 5-thread concurrent mod downloading with per-worker progress bars
+- Upload mod multi-file support with progress
+- Mod list auto-refresh every 2s with background-tab skip
+- TabControl onActivate support for lazy portal list loading
+- Server settings Chinese descriptions toggle (27 items based on Factorio Wiki)
+- File size display in mod list
+- IP/port memory in Controls page (localStorage)
+- Cache mod portal list for 1 hour (~60x speedup)
+- Token-based Factorio authentication support
+
+### Changed
+- Factorio version display uniformly prefixed with `>=`
+- Mod portal releases compatibility now uses Factorio-aware GEC (same major.minor required)
+- DepOp no longer hardcoded to `>=` — reflects actual dependency operator
+- Portal "Mod not found" returns 404 JSON instead of 500 error
+- File lock timeout increased to 30s to prevent deadlocks
+- Docker build cache for go mod download and npm install
+
+### Fixed
+- Factorio 2.1 compatibility: mods with different minor version correctly marked incompatible
+- save.go: Factorio 2.0 save header parsing (readFromV2, 192-line complete rewrite)
+- mod_modInfo.go: base dependency version override (old `base >= 0.18` no longer overwrites info.json factorio_version: 2.0)
+- mod_modInfo.go: dependency parsing bounds check (prevents crash on malformed deps)
+- Corrupted mod zip files gracefully skipped instead of crashing FSM
+- 401 auto-redirect to login page (replace instead of push state)
+- React #31 crash: axios interceptor no longer passes Object to Flash component
+- Mod page black screen: portal API calls limited to initial mount (was 153 calls every 2s)
+- Auth gate prevents login form flash (authChecked before tab render)
+- Shared Factorio auth state restored across all mod tabs (AddMod + LoadMods) —
+  parent component checks portal login once, children receive via props;
+  merged Joey's LoadMods rewrite regressed this with local state — fixed via prop drilling
+- Updater API stable tag compatibility for 2.1.7 detection
+- save.go: fmt.Errorf escaped percent signs fixed (20+ instances)
+
+### Removed
+- removeAll on Docker volume replaced with proper mod directory clear - Thanks to @joey00797-cell
+
 ## [0.11.0] - TBD
 ### Changed
 - Configuration environment variables are now uppercase and prefixed with FSM

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -0,0 +1,80 @@
+# FSM Roadmap
+
+## ✅ Done
+
+- [x] Fix mod folder cleanup on Docker volume
+- [x] Fix save file parsing for Factorio 2.0
+- [x] Read all mods with exact versions directly from save file
+- [x] New endpoint to read mods from save without downloading
+- [x] Selective mod sync with checkboxes (select/deselect all)
+- [x] Real-time download progress via WebSocket
+- [x] DLC mods auto-detected and grouped in UI with single toggle
+- [x] DLC mods visible in installed mods list with enable/disable
+- [x] Server start blocked while mod sync is in progress
+- [x] i18n support (EN/RU/zh-CN)
+- [x] Token-based authentication on factorio.com
+- [x] Server version manager (download/update/downgrade Factorio from UI)
+- [x] 5-thread concurrent mod downloading with progress bars
+- [x] Upload mod multi-file support
+- [x] Mod portal list caching (1 hour)
+- [x] Factorio 2.1 compatibility (GEC version checking)
+- [x] Factorio 2.0 save header parser (readFromV2)
+- [x] Server settings Chinese descriptions (Factorio Wiki based)
+- [x] Auth gate preventing login form flash
+- [x] 401 auto-redirect to login page
+
+## 📂 Worktree 隔离开发
+
+```
+主目录:    /workspace/projects/factorio-server-manager-joey       (当前功能)
+参考目录:  /workspace/projects/factorio-server-manager-develop    (joey/develop)
+
+新功能:
+  git worktree add ../factorio-server-manager-<slug> -b feat/<slug>
+  cd ../factorio-server-manager-<slug>
+  # 开发、构建、测试...
+  # 完成后: git push && git worktree remove ../factorio-server-manager-<slug>
+```
+
+## 🧪 测试流程（每次改动必做）
+
+修改代码后，必须闭环验证以下步骤：
+
+1. **构建**: `npm run build && go build`
+2. **部署**: `cp -r app/* /home/game/fsm/app/ && cp factorio-server-manager /home/game/fsm/`
+3. **重启**: `kill $(pgrep factorio-server); cd /home/game/fsm && setsid ./factorio-server-manager ...`
+4. **登录**: Playwright 打开 `/login` → 输入凭据 → 确认跳转到主页
+5. **功能页**: 导航到改动的页面，等待 15 秒
+6. **检查**: 控制台 0 个 JS Error，页面正常渲染
+7. **交互**: 点击/拖拽核心功能，确认不崩溃
+
+> 每次提交前跑一遍，不允许「改完就提交」。
+
+## 🚧 Planned
+
+### Mods
+- [ ] Auto-resolve mod dependencies when creating a new save
+- [ ] Portal link icon next to each mod in the list
+- [ ] Row highlight on hover in mod list
+- [ ] Batch update all compatible mods for current server version
+
+### Authentication
+- [ ] Show logged-in username on mod portal tab
+- [ ] Refresh button for saved credentials
+- [ ] Proper FSM login (registration form on first launch)
+
+### Server
+- [ ] Controls page info panel — merge Game Settings into Controls dashboard:
+  - Remove standalone `/game-settings` page (mostly empty config.ini view)
+  - Add read-only info section below start/stop controls:
+    - Factorio version + base mod version
+    - Data paths (read-data / write-data)
+    - Installed / compatible / incompatible mod counts
+    - Save file count + last modified
+    - (future) uptime, player count
+- [ ] Server Status tab refactor:
+  - Autostart checkbox
+  - Factorio version dropdown with auto-download
+  - Server name field
+- [ ] Multi-server support
+- [ ] Dual logs — Factorio server logs + FSM manager logs
diff --git a/decompiled_script.lua b/decompiled_script.lua
diff --git a/docker/Dockerfile-build b/docker/Dockerfile-build
@@ -1,23 +1,29 @@
 FROM alpine:latest as build
-
 RUN apk add --no-cache git make musl-dev go nodejs npm zip mingw-w64-gcc
-
 ENV GOROOT /usr/lib/go
 ENV GOPATH /go
 ENV PATH /go/bin:$PATH
 ENV FACTORIO_ROOT /go/src/factorio-server-manager
 
-COPY docker/build-release.sh /usr/local/bin/build-release.sh
-COPY ./ $FACTORIO_ROOT
-
 RUN mkdir -p ${GOPATH}/bin
-RUN chmod u+x /usr/local/bin/build-release.sh
-
 WORKDIR $FACTORIO_ROOT
 
+# Кешируем Go зависимости отдельно
+COPY src/go.mod src/go.sum ./src/
+RUN cd src && go mod download
+
+# Кешируем npm зависимости отдельно
+COPY package.json package-lock.json ./
+RUN npm install
+
+# Копируем остальное
+COPY ./ ./
+
+COPY docker/build-release.sh /usr/local/bin/build-release.sh
+RUN chmod u+x /usr/local/bin/build-release.sh
+
 VOLUME /build
 VOLUME $FACTORIO_ROOT
-
 RUN ["/usr/local/bin/build-release.sh"]
 
 FROM scratch as output

diff --git a/docker/build-release.sh b/docker/build-release.sh
diff --git a/docker/build.sh b/docker/build.sh
diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh
diff --git a/docs/add-language-guide.md b/docs/add-language-guide.md
@@ -0,0 +1,143 @@
+# 添加新语言指南
+
+FSM 前端基于 `react-i18next`，添加新语言只需创建翻译文件并注册即可。
+
+## 快速上手（以日语 ja 为例）
+
+### 第 1 步：创建翻译文件
+
+```bash
+mkdir -p ui/locales/ja
+```
+
+复制英文文件作为模板：
+
+```bash
+cp ui/locales/en/*.json ui/locales/ja/
+```
+
+### 第 2 步：翻译
+
+逐个编辑 `ui/locales/ja/` 下的 9 个 JSON 文件，**只改 value，不改 key**。
+
+| 文件 | 示例 key | 英文 | 日文翻译 |
+|---|---|---|---|
+| `common.json` | `save` | Save | 保存 |
+| `common.json` | `cancel` | Cancel | キャンセル |
+| `common.json` | `confirm` | Confirm | 確認 |
+| `controls.json` | `startServer` | Start Server | サーバー起動 |
+| `controls.json` | `RUNNING` | Running | 実行中 |
+| `layout.json` | `appTitle` | Factorio Server Manager | Factorio サーバーマネージャー |
+
+### 第 3 步：注册语言
+
+编辑 `ui/i18n.js`，在两个地方添加 ja：
+
+**位置 1 — import 翻译文件：**
+
+```js
+// 在 zh-CN imports 后面添加
+import jaCommon from './locales/ja/common.json';
+import jaLayout from './locales/ja/layout.json';
+import jaControls from './locales/ja/controls.json';
+import jaMods from './locales/ja/mods.json';
+import jaSaves from './locales/ja/saves.json';
+import jaServerSettings from './locales/ja/serverSettings.json';
+import jaLogs from './locales/ja/logs.json';
+import jaConsole from './locales/ja/console.json';
+import jaUserManagement from './locales/ja/userManagement.json';
+```
+
+**位置 2 — 添加到 resources 对象：**
+
+```js
+const resources = {
+  en: { /* 已有 */ },
+  'zh-CN': { /* 已有 */ },
+  ja: {
+    common: jaCommon,
+    layout: jaLayout,
+    controls: jaControls,
+    mods: jaMods,
+    saves: jaSaves,
+    serverSettings: jaServerSettings,
+    logs: jaLogs,
+    console: jaConsole,
+    userManagement: jaUserManagement,
+  },
+};
+```
+
+### 第 4 步：添加到语言切换器
+
+编辑 `ui/App/components/Layout.jsx`，在 `<select>` 中添加：
+
+```jsx
+<option value="ja">日本語</option>
+```
+
+### 第 5 步：验证
+
+```bash
+npm run build
+```
+
+构建通过即完成。浏览器语言设为日语时自动显示日文，也可通过侧边栏切换器手动选择。
+
+---
+
+## 翻译文件结构
+
+```
+ui/locales/
+├── en/               ← 英文（fallback，必须保持完整）
+│   ├── common.json   ← 通用词汇（保存/取消/确认/删除...）
+│   ├── layout.json   ← 导航栏/侧边栏/页面标题
+│   ├── controls.json ← 服务器启停控制面板
+│   ├── mods.json     ← Mod 管理全部子页面
+│   ├── saves.json    ← 存档管理全部子页面
+│   ├── serverSettings.json ← 服务器+游戏设置
+│   ├── logs.json     ← 日志页面
+│   ├── console.json  ← RCON 控制台
+│   └── userManagement.json ← 用户管理/登录
+├── zh-CN/            ← 简体中文（已完成）
+└── ja/               ← 日语（按本指南添加）
+```
+
+## 翻译规则
+
+1. **只改 value，不改 key。** key 是代码引用的标识，改了会导致显示空白。
+2. **保持扁平结构。** 所有 key 在 JSON 顶层，不要嵌套。
+3. **不要修改 HTML。** 翻译值里不要放 `<div>`、`<span>` 等标签。
+4. **大写 key 是状态值**（如 `RUNNING`、`STOPPED`、`UNKNOWN`），翻译时用对应的状态词。
+5. **en/ 是权威源。** 如果某个 key 在目标语言中缺失，i18next 会自动回退到英文，不会报错。
+
+## 自动语言检测
+
+`i18next-browser-languagedetector` 按以下优先级检测：
+
+1. `localStorage` 中 `fsm_lang` 的值（用户手动切换后记住）
+2. 浏览器 `navigator.language`
+
+例如浏览器语言是 `ja` → 自动加载日语；无匹配 → 回退英文。
+
+## 常见 BCP 47 语言标签
+
+| 语言 | 标签 | 写入 `i18n.js` |
+|---|---|---|
+| 日语 | `ja` | `ja` |
+| 韩语 | `ko` | `ko` |
+| 繁体中文 | `zh-TW` | `zh-TW` |
+| 德语 | `de` | `de` |
+| 法语 | `fr` | `fr` |
+| 俄语 | `ru` | `ru` |
+| 西班牙语 | `es` | `es` |
+| 葡萄牙语 | `pt` | `pt` |
+| 波兰语 | `pl` | `pl` |
+
+## 注意事项
+
+- **不要删除或修改 `en/` 下的文件。** 英文是 fallback 语言，必须保持完整。
+- **新语言的 JSON 文件名必须与 `en/` 完全一致。**
+- 如果不想翻译所有 key，可以先复制英文再逐条翻译，未翻译的 key 会自动回退英文。
+- Factorio 社区有大量活跃的非英语玩家，欢迎贡献翻译 PR。