Merge pull request #120 from DogeLakeDev/release/daemon-0.2.3

release: SFMC 0.2.3 daemon supervisor

Author: Tanya7z

docs/zh/guide/config.md

@@ -98,9 +98,10 @@ SFMC 采用**约定优于配置（Convention over Configuration）**的设计理
 
 ---
 
-### `bds_updater.json`：BDS 核心与进程守护
+### `bds_updater.json`：BDS 核心更新
 
-管理 Bedrock Dedicated Server 的自动版本检测、热补丁下载、升级前安全备份与进程崩溃自启。
+管理 Bedrock Dedicated Server 的自动版本检测、热补丁下载与升级前安全备份。
+进程崩溃拉起由 `sfmc` 后台守护进程负责，不再在此配置开关。
 
 ```json title="configs/bds_updater.json"
 {
@@ -109,23 +110,19 @@ SFMC 采用**约定优于配置（Convention over Configuration）**的设计理
   "backup_dir": "./backups",
   "channel": "release",
   "auto_check": true,
-  "crash_restart": true,
-  "crash_restart_delay": 5,
   "preserve": ["server.properties", "whitelist.json", "permissions.json", "worlds"],
   "qq_notify": true
 }
 ```
 
-| 字段                  | 类型       | 说明                                                                                |
-| :-------------------- | :--------- | :---------------------------------------------------------------------------------- |
-| `bds_path`            | `string`   | BDS 核心可执行程序所在目录。                                                        |
-| `backup_dir`          | `string`   | 升级或回滚时的全量备份落盘路径（必须位于 `bds_path` 目录之外）。                    |
-| `channel`             | `string`   | 更新通道：`"release"`（正式稳定版）或 `"preview"`（预览测试版）。                   |
-| `auto_check`          | `boolean`  | 服务启动时是否静默请求 Mojang 官方源检测最新版本。                                  |
-| `crash_restart`       | `boolean`  | 当 `bedrock_server` 异常崩溃退出时，是否自动尝试拉起恢复。                          |
-| `crash_restart_delay` | `number`   | 崩溃重启前的缓冲等待时间（秒），避免因端口未释放引发频繁颠簸。                      |
-| `preserve`            | `string[]` | 覆盖更新时**绝对予以保留并自动复原**的文件/目录白名单（避免存档或基础配置被冲洗）。 |
-| `qq_notify`           | `boolean`  | 更新启动、完成或崩溃告警时，是否通过 QQ 群同步广播进度。                            |
+| 字段         | 类型       | 说明                                                                                |
+| :----------- | :--------- | :---------------------------------------------------------------------------------- |
+| `bds_path`   | `string`   | BDS 核心可执行程序所在目录。                                                        |
+| `backup_dir` | `string`   | 升级或回滚时的全量备份落盘路径（必须位于 `bds_path` 目录之外）。                    |
+| `channel`    | `string`   | 更新通道：`"release"`（正式稳定版）或 `"preview"`（预览测试版）。                   |
+| `auto_check` | `boolean`  | 服务启动时是否静默请求 Mojang 官方源检测最新版本。                                  |
+| `preserve`   | `string[]` | 覆盖更新时**绝对予以保留并自动复原**的文件/目录白名单（避免存档或基础配置被冲洗）。 |
+| `qq_notify`  | `boolean`  | 更新启动、完成或崩溃告警时，是否通过 QQ 群同步广播进度。                            |
 
 ---
 

modules/sdk/@sfmc-sdk/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sfmc-bds/sdk
 
+## 0.2.1
+
+### Patch Changes
+
+- 5a25300: 新增 CLI 守护进程监管：退出 CLI 不停服，经命名管道 RPC 连接；移除 bds_updater 崩溃自启配置项，改由 daemon 固定拉起。正式版补丁 0.2.3。
+
 ## 0.2.0
 
 ### Minor Changes

modules/sdk/@sfmc-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfmc-bds/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "ScriptsForMinecraftServer unified SDK — SAPI/Node umbrella covering contracts, runtime, module-loader, and db/config/service capabilities.",
   "author": "Shiroha7z",
   "license": "ISC",

modules/sdk/@sfmc-sdk/schemas/bds_updater.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/DogeLakeDev/ScriptsForMinecraftServer/schemas/bds_updater.schema.json",
   "title": "SFMC bds_updater",
-  "description": "BDS 自动更新与进程管理配置。由 bds-tools（check-update / bds-manager）读取；路径请用双反斜杠或正斜杠。",
+  "description": "BDS 自动更新配置。由 bds-tools（check-update）读取；崩溃拉起由 sfmc daemon 负责。路径请用双反斜杠或正斜杠。",
   "type": "object",
   "additionalProperties": false,
   "properties": {
@@ -39,18 +39,6 @@
       "type": "boolean",
       "description": "启动时是否自动检查 BDS 更新"
     },
-    "crash_restart": {
-      "type": "boolean",
-      "description": "BDS 异常退出时是否自动拉起"
-    },
-    "crash_restart_delay": {
-      "type": "number",
-      "description": "崩溃重启前等待秒数（可选）"
-    },
-    "auto_restart": {
-      "type": "boolean",
-      "description": "旧字段：兼容保留，用于推断是否启用 QQ 等相关自动行为"
-    },
     "version_mode": {
       "type": "string",
       "enum": ["bedrock-oss", "endstone"],

modules/sdk/@sfmc-sdk/src/node/config/index.ts

@@ -6,10 +6,7 @@ export interface BdsUpdaterConfig {
   bds_path?: string;
   backup_dir?: string;
   channel?: "release" | "preview" | string;
-  auto_restart?: boolean;
   auto_check?: boolean;
-  crash_restart?: boolean;
-  crash_restart_delay?: number;
   qq_notify?: boolean;
   qq_config?: string;
   preserve?: string[];
@@ -239,8 +236,6 @@ export const DEFAULT_BDS_UPDATER_CONFIG: BdsUpdaterConfig = {
   qq_notify: false,
   qq_config: "../configs/qq_config.json",
   auto_check: true,
-  crash_restart: true,
-  auto_restart: true,
 };
 
 /** permissions.json 根为数组；默认空表 */

packages/bds-tools/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @sfmc-bds/bds-tools
 
+## 0.2.1
+
+### Patch Changes
+
+- 5a25300: 新增 CLI 守护进程监管：退出 CLI 不停服，经命名管道 RPC 连接；移除 bds_updater 崩溃自启配置项，改由 daemon 固定拉起。正式版补丁 0.2.3。
+- Updated dependencies [5a25300]
+  - @sfmc-bds/sdk@0.2.1
+
 ## 0.2.0
 
 ### Minor Changes

packages/bds-tools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfmc-bds/bds-tools",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "SFMC BDS auto-updater, lifecycle manager, and behavior-pack assembler",
   "author": "Shiroha7z",
   "license": "AGPL-3.0-only",

packages/bds-tools/src/bds-manager.ts

@@ -57,14 +57,17 @@ export interface BdsManagerOptions {
 interface CachedProc {
   process: ReturnType<typeof spawn> | null;
   isManualStop: boolean;
-  crashRestart: boolean;
+  /** 独立运行 bds-manager 时的崩溃拉起延迟（秒）；守护由 sfmc daemon 负责时不读配置 */
   crashDelayMs: number;
   exePath: string;
   bdsPath: string;
 }
 
 let cached: CachedProc | null = null;
 
+/** 独立入口崩溃拉起默认等待（毫秒）；配置项已移除，固定值避免与 daemon 监管重复暴露开关 */
+const STANDALONE_CRASH_DELAY_MS = 5_000;
+
 function ensureProc(): CachedProc {
   if (cached) return cached;
   const cfg = loadConfig();
@@ -74,8 +77,7 @@ function ensureProc(): CachedProc {
   cached = {
     process: null,
     isManualStop: false,
-    crashRestart: cfg.crash_restart !== false,
-    crashDelayMs: (cfg.crash_restart_delay ?? 5) * 1000,
+    crashDelayMs: STANDALONE_CRASH_DELAY_MS,
     exePath,
     bdsPath: bds_path,
   };
@@ -224,7 +226,7 @@ export function createBdsManager(options: BdsManagerOptions = {}): BdsManager {
       } else {
         void postBdsLifecycleEvent("stop");
       }
-      if (!wasManual && p.crashRestart && isMain()) {
+      if (!wasManual && isMain()) {
         log.info(`BDS 意外退出，${p.crashDelayMs / 1000}s 后自动重启...`);
         setTimeout(() => {
           start().catch((e) => log.error(`自动重启失败: ${e.message}`));

packages/bds-tools/src/check-update.ts

@@ -80,7 +80,7 @@ function buildContext(): UpdateContext {
     bdsPath: bds_path,
     backupDir: backup_dir,
     preserve,
-    autoRestart: !args["no-start"] && cfg.auto_restart !== false,
+    autoRestart: !args["no-start"],
     qqNotify: !!cfg.qq_notify,
   };
 }

packages/bds-tools/src/types.ts

@@ -6,10 +6,7 @@ export interface BdsUpdaterConfig {
   bds_path?: string;
   backup_dir?: string;
   channel?: "release" | "preview" | string;
-  auto_restart?: boolean;
   auto_check?: boolean;
-  crash_restart?: boolean;
-  crash_restart_delay?: number;
   qq_notify?: boolean;
   qq_config?: string;
   preserve?: string[];