From 9ca5ee8ae70df29b9e158c3d288298062fe21773 Mon Sep 17 00:00:00 2001
From: AskaEth <i@yeij.top>
Date: Tue, 10 Nov 2026 14:00:16 +0800
Subject: [PATCH] =?UTF-8?q?docs(core):=20adopt=20=E7=9A=84=E4=B8=A4?=
 =?UTF-8?q?=E6=9D=A1=E6=96=87=E6=A1=A3=E5=B0=8F=E7=96=B5=EF=BC=88r4=20?=
 =?UTF-8?q?=E5=A4=8D=E5=AE=A1=E7=95=99=E7=9A=84=EF=BC=8CM223=20=E9=A1=BA?=
 =?UTF-8?q?=E6=89=8B=E4=BF=AE=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- plan.rs 第 11-12 行：一个悬空半句（「…必须落在」后面断掉）补完，并把 fspaths 的引用接上；
- run_dir.rs 第 16 行：删掉「配置写面看 <.ULL>、并额外排除游戏根」这条**已移交**
  fspaths::ensure_surfaces_clear_of_game_tree 的职责描述，明说本模块只负责数据写面这一条。

纯文档，零行为变化。
---
 crates/core/src/game/adopt/plan.rs    | 4 ++--
 crates/core/src/game/adopt/run_dir.rs | 6 ++++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/crates/core/src/game/adopt/plan.rs b/crates/core/src/game/adopt/plan.rs
index d0e85d2..cf3ffa2 100644
--- a/crates/core/src/game/adopt/plan.rs
+++ b/crates/core/src/game/adopt/plan.rs
@@ -8,8 +8,8 @@
 //!    路径上的已有祖先若解析到**数据根之外**（符号链接/目录联接）⇒ 拒绝，不沿它写盘；
 //!    已被**别的实例**占着 ⇒ 顺延 `-2`/`-3` 后缀，绝不让两个实例共用同一个运行目录）。
 //!
-//! 写配置**之前**还要核一遍真实写面（`config/`、`config/instances/`、`profiles.json` 必须在
-//! 写盘面判据见 [`fspaths`]（配置必须在 `<.ULL>` 内、默认写盘面不得与游戏树重叠）。
+//! 写配置**之前**还要核一遍真实写面（`config/`、`config/instances/`、`profiles.json` 必须落在
+//! `<.ULL>` 内、且默认写盘面不得与游戏树重叠），判据见 [`fspaths`]。
 //!
 //! `versions/` `libraries/` `assets/` **一个字节都不写**：登记只填 `version_id`，内容靠 D20 的
 //! 「恒共享层」被启动/下载链路复用（[`crate::game::isolation::SHARED_LAYERS`]）。
diff --git a/crates/core/src/game/adopt/run_dir.rs b/crates/core/src/game/adopt/run_dir.rs
index 1e93fff..c12e559 100644
--- a/crates/core/src/game/adopt/run_dir.rs
+++ b/crates/core/src/game/adopt/run_dir.rs
@@ -13,8 +13,10 @@
 //! # 判据的基准（为什么不拿 `<data>/instances` 或 `<.ULL>/config` 当基准）
 //!
 //! 被保护的**边界自己是链接**时，拿它当基准等于把越界当正常。所以基准一律是**解析后的父级**：
-//! 数据写面看 `<data>`，配置写面看 `<.ULL>`、并额外排除游戏根。用户把整棵树迁到别的盘
-//! （`<.ULL>` 或 `<data>` 本身是联接/符号链接）仍然允许——判据是落点，不是路径长得像不像。
+//! 数据写面看 `<data>`（本模块只负责这一条）；配置写面（`<.ULL>` 内、并额外排除游戏根）已移交
+//! [`super::fspaths`] 的 `ensure_config_write_surface` / `ensure_surfaces_clear_of_game_tree`，
+//! 不在本模块的判据里。用户把整棵树迁到别的盘（`<.ULL>` 或 `<data>` 本身是联接/符号链接）
+//! 仍然允许——判据是落点，不是路径长得像不像。
 //!
 //! # 已知边界
 //!