1lck · Oct 25, 2026 · Oct 22, 2026 · Oct 22, 2026 · Oct 22, 2026 · Oct 22, 2026
@@ -253,6 +253,12 @@ JDT 通道曾触发其 15 秒测试期限，同一提交在 SharedRust 通道用
 所有测试的时限来隐藏这类问题。计时工具用可控时钟验证普通、集成和总截止
 时间，并验证 HTML 与 JUnit 不会把合法的集成耗时误判为失败。
 
+checkout/clone 完整流程用例 `git_write_executes_checkout_preflight_clone_and_validation`
+在 Windows CI 39935852248 中全部断言通过，Rust 内部计时 15.22 秒、测试进程计时
+18.529 秒，超过默认十五秒后触发清缓存重编，继而耗尽原套件期限。该用例创建分叉
+分支，覆盖干净、脏和未跟踪文件预检、智能/强制切换以及本地 clone，因此只为它在
+SharedRust 和真实 JDT 两个入口设置三十秒预算；不延长请求或整套期限，不重试失败断言。
+
 取消模块的确定性回归核对 mutation 后正常读取保留原截止时间和取消能力，
 已取消或超时请求的独立读取仍受清理期限约束，错误和异常退出后恢复原状态。
 真实仓库 rebase 回归核对 edit、conflict、continue、skip、abort 和过期 amendment；

@@ -89,6 +89,13 @@ MacServiceContainer
 错误，不能把残留资源伪装成成功禁用。上述任务仍在主执行器上使用异步等待，
 不阻塞线程、不新增插件代码加载能力。
 
+使用真实 AppModel 的测试也必须遵守项目打开的清理顺序。`openProjectDirectly` 会启动
+模块图关闭；项目文件快照已经发布不代表关闭完成。Safe Mode 测试要手动注入能力时，
+先通过有截止的 `WorkbenchTestScope.run` 等待 `awaitModuleRuntimeShutdown()`，再放入
+测试能力。否则迟到的 shutdown 事件可能移除刚注入的能力，让前几次搜索通过、随后
+查询全部为空。不要用睡眠或反复重新注入能力掩盖这个顺序；搜索排除回归与插件页面
+生命周期测试都使用同一个明确的完成边界。
+
 ### 数据库视图在模块释放后的刷新
 
 退出应用或休眠数据库模块时，SwiftUI（macOS 的声明式界面框架）可能先刷新

@@ -33,13 +33,12 @@ Swift 源码，也不得依赖 macOS 类型。
 | `macos/Sources/Lithe/Core/` | 平台无关端口和类型化 Rust 操作 |
 | `macos/Sources/Lithe/Platform/MacOS/` | macOS 适配器和组合根 |
 | `rust/lithe-core/` | 确定性的共享命令、模型、校验和 C ABI |
-| `rust/lithe-git-host/` | 原生 Git 子进程、管道、临时输入和有界清理 |
+| `rust/lithe-git-host/` | 原生 Git 子进程、管道、临时输入和有界清理；以及长期子进程的进程树归属（`ProcessTree`，Windows Job Object / Unix 进程组） |
 | `windows/` | React/Tauri Windows 产品和 Windows Rust 适配器 |
 | `Plugins/mac/` | macOS 所有的插件包 |
 | `Plugins/win/` | Windows 所有的插件包 |
 | `frontend/editor/` | 两端共同依赖的 Monaco 表现层、分词与编辑器模型；不调用平台 API |
 | `shared/` | 跨平台契约和夹具，不放编译实现 |
-| `infra/` | 仓库级开发和验证基础设施 |
 | `third_party/` | 固定版本的上游清单和必要的局部源码补丁 |
 
 应用层依赖方向如下：
@@ -128,6 +127,9 @@ Swift 源码。新文件以主要类型
 
 原生 Git 适配器 `rust/lithe-git-host/` 负责子进程、管道、临时输入文件，
 以及进程组或 Windows 作业对象的限时清理，不负责 Git 参数策略或界面模型。
+运行会话、调试适配器和 Windows 语言服务器这类宿主自己读写输出的长期进程，
+也通过它的 `ProcessTree` 把整棵进程树交给 Job Object 或进程组，不在各自模块里
+重复实现 Windows 作业对象。
 现有 Core Git 输出捕获入口调用此适配器，以保留 JSON 和 C ABI（C 语言
 调用边界）的兼容性；共享事件解码和凭据脱敏留在 `rust/lithe-core/src/git/`。
 认证界面和凭据存储仍由各平台负责。新增 Git 操作应复用此执行边界，
@@ -269,5 +271,4 @@ Core 操作会随协议演进持续增加，逐个新增 Tauri command 会在
 - `shared/`
 - `frontend/editor/`
 - `scripts/`
-- `infra/`
 - `third_party/`
@@ -96,6 +96,31 @@ Diff 的纵向同步依据 Community `SyncScrollSupport.ScrollHelper` 和
 有效范围。记录的组件布局与截图耗时只是本地诊断数据，不能替代整机连续拖动的
 帧延迟，也不能把 `split.drag` 手势持续时间当成帧性能。
 
+### 设置窗口只观察设置相关的变化
+
+设置窗口不能整体订阅 `AppModel`。`AppModel` 会把文档、语言服务、Git、搜索、
+运行等十几个功能模块的变化合并转发出去；整体订阅时，主窗口里编辑代码、索引或
+刷新 Git 状态，都会让整个设置页（包括插件列表和详情）重新计算，设置窗口还会
+重新配置一次标题栏。工程越忙，设置页越卡。IDEA 的设置对话框也不随工程事件重绘。
+
+正确做法是：设置页根视图通过 `SettingsModelContext` 读取同一个 `AppModel`，只订阅
+`AppModel.settingsChanges`。这条通道包含模型自身的发布属性、插件和模块的直接通知、
+模块激活与释放，以及当前工作区变化；功能模块的高频转发调用
+`scheduleObjectWillChangeRelay(affectsSettings: false)`，不进入设置窗口。新增的转发
+如果会改变设置页显示的内容，保持默认的 `affectsSettings: true`。
+
+需要实时状态的页面自己订阅对应功能模型，或者在一个小的叶子视图里订阅 `AppModel`，
+例如语言服务状态和项目运行时页面。模块按需激活的页面要把激活结果存进本地状态，
+不能指望后续的整体刷新把新功能显示出来；但本地状态只能作为能力缓存填好前的过渡，统一用 `ModuleFeatureSelection`：激活任务以当前能力身份为 key，模块休眠后立即丢弃旧实例并重新激活，页面不能继续读写已释放的功能实例。窗口外观（标题栏、样式掩码）只在标题、
+主题、关闭按钮状态或外观真的变化时才重新应用。插件列表在一次渲染里只排序、
+过滤一次，行的悬停状态留在行内部。
+
+设置窗口是项目窗口的子窗口，用来跟随项目窗口移动。但 AppKit 拖动子窗口时由应用
+主线程逐个鼠标事件移动，工程忙时拖动会一格一格地跳，不跟手。因此
+`SettingsWindowChrome` 在标题栏按下鼠标时临时解除父子关系，交给窗口服务器拖动，
+松手（或移动结束且鼠标已松开）后再挂回原项目窗口。不要为了跟随而在拖动期间保持
+子窗口关系，也不要用定时器手动同步位置。
+
 ### 正确做法
 
 ```text
@@ -164,6 +189,13 @@ IDEA 的 [BranchesTreeComponent](https://github.com/JetBrains/intellij-community
   `cd windows/tauri && bun test src/features/tabs/hooks/use-tab-wheel-scroll.test.tsx`
   Windows CI 显式运行整个 `src/features/tabs` 测试目录，并生成逐项计时报告。
 - 代码审查时确认拖动不会导致高频整页重绘
+- `AppModelSettingsChangesTests` 验证只影响工作台的转发不会进入
+  `settingsChanges`，直接通知和设置相关的转发仍然会进入，并且合并后的一次转发
+  只要包含设置相关变化就会通知设置窗口。
+- `ModuleFeatureSelectionTests` 验证设置页保持打开时，模块休眠后会丢弃已释放的
+  实例，重新激活后显示新实例。`SettingsAppearanceContainerTests` 用原生鼠标事件
+  验证：按下标题栏会解除子窗口关系，拖动中重新配置不会提前挂回，松手后挂回，
+  关闭后重新打开也会挂回。
 - `GitGraphInteractionTests.splitPaneBounds` 在两种方向、两种位置及折叠状态
   验证原生子视图身份、可见尺寸和传入的确定尺寸，防止恢复为堆栈尺寸探测。
 - `LitheSplitPaneCollapseTests.outerDragSuspendsRowChrome` 使用原生分隔条