文件树模块职责与依赖

返回文档导航 · 技术架构 · 模块提取记录

范围与阅读约定

• 按当前源码梳理，包含文件树视图与差异表单收拢，以及打包按钮处理迁入 tree-controls.mts 后的结构。
• 下文 runtime/、sidebar/ 等路径相对于 src/renderer/。
• 依赖方向 A → B 表示 A 导入并使用 B。
• 图只展示主要业务依赖，省略共享状态、类型和通用辅助模块；这些依赖另列于表中。
• 静态导入、动态加载和注入回调分别说明，命名再导出不视为原文件仍拥有实现。

文件职责

树运行时

UI、算法与相邻业务

状态、装配与外部入口

主要文件依赖

视图、控件和差异

以下箭头均为静态运行时导入，双向箭头表示双方直接导入对方。

flowchart LR
  C["runtime/tree-controls.mts"] <--> V["runtime/tree-view.mts"]
  C <--> F["runtime/tree-difference-form.mts"]
  C <--> B["runtime/editor/difference-baseline.mts"]
  F --> B
  B --> E["runtime/editor/differences.mts"]
  V <--> S["runtime/tree-selection.mts"]
  V <--> M["runtime/context-menus.mts"]
  C --> M
  C <--> W["runtime/workspace.mts"]
  V <--> W
  W --> F
  C <--> D["runtime/sync/file-tree-diff.mts"]
  D --> V

文件转移与操作历史

flowchart LR
  V["tree-view.mts"] <--> S["tree-selection.mts"]
  S <--> T["tree-drag-drop.mts"]
  S <--> H["tree-history.mts"]
  T <--> H
  T --> V
  S --> W["workspace.mts"]
  T --> W
  H --> W
  S --> A["library-actions.mts"]
  T --> A
  H --> A

• tree-selection 使用转移模块记录剪贴板意图，删除后记录历史。
• tree-drag-drop 完成转移后恢复选择与焦点、刷新树并记录历史。
• tree-history 使用转移模块的父路径辅助函数，复用选择模块的计时、选择和焦点恢复接口。
• 三者都通过现有工作区和文件操作模块协调快照、路径重定位及脏文档保护。
• 图省略各模块对通用对话框、编辑器文件操作和 dependencies.mts 的 ESM 导入。

UI 组装、公共算法与按需打包

flowchart TD
  DEP["dependencies.mts"] --> SURFACE["sidebar/file-filter-diff.mts"]
  SURFACE --> UI["sidebar/file-filter-ui.mts"]
  UI --> FILTER["sidebar/file-filter.mts"]
  FILTER --> TIME["sidebar/file-time-filter.mts"]
  DEP --> FILTER
  DEP --> TIME
  DEP --> NAV["sidebar/file-tree-navigation.mts"]
  C["runtime/tree-controls.mts"] --> DEP
  V["runtime/tree-view.mts"] --> DEP
  F["runtime/tree-difference-form.mts"] --> DEP
  C -. "动态 import" .-> PACK["sidebar/file-pack.mts"]
  PACK --> UI
  PACK --> FILTER

• dependencies.mts 创建 treeFileFilters，tree-controls 随后通过 connect() 注入仓库状态、预设保存、筛选应用和通知回调。
• file-pack.mts 只在打包按钮触发时加载。
  • tree-controls 传入文件树快照、可见性函数、当前筛选、共享预设及仓库读写回调。
  • 打包模块调用这些回调完成操作，不直接导入 runtime 模块。
• 公共算法和公共筛选 UI 未直接导入树运行时，继续支持文件树与打包界面复用。

初始化和主要执行路径

初始化顺序

1. initializeDependencies() 创建完整筛选 UI；initializeCore() 获取 DOM 引用并准备基础状态。
2. 编辑器差异模块初始化差异状态与缓存；基线模块注册 Git HEAD 刷新。
3. initializeTreeView() 初始化可见性缓存，绑定全部展开和折叠。
4. initializeTreeDifferenceForm() 初始化差异表单字段、草稿和控件事件。
5. initializeTreeControls() 连接筛选业务回调，绑定标题控件、筛选弹层、设置和打包入口。
6. 随后注册拖放、工作区、操作历史、全局事件和命令服务等模块。
7. 最后 initializeShell() 启动异步 initialize()，读取初始工作区，再通过工作区模块恢复仓库状态、激活文档并渲染。

• 上述顺序只列与本主题有关的步骤，其他 runtime 初始化仍穿插其间。
• 事件回调在用户操作或异步事件触发时读取共享状态，注册阶段不主动执行树渲染或基线切换。

应用筛选与差异

1. 公共筛选 UI 读取筛选草稿，差异表单读取并校验基线选择。
2. tree-controls 编译文件规则、刷新工作区快照、应用文件规则和修改时间筛选。
3. tree-view 根据匹配结果重绘树、协调选择并恢复焦点。
4. 基线模块应用差异选择，清理旧高亮并刷新编辑器差异。
5. tree-controls 保存筛选和差异选项，关闭弹层并按原行为恢复焦点。

定位文件与打包

• 定位由 tree-view 查询目标、展开父目录、选择条目并最小滚动树容器。
  • 编辑器激活、同步版本和整树差异结果均复用此入口。
• 打包由 tree-controls 动态加载界面，并注入仓库操作。
  • 异步读写保留仓库路径校验，避免切库后操作落到另一个仓库。

当前边界与仍保留的耦合

• 本次优化收拢的是职责归属；runtime 仍通过共享状态及相互调用协作，并非单向分层。
• 树视图与标题控件、差异表单与筛选持久化、基线切换与标题刷新、视图与选择均存在直接双向依赖。
• 选择、拖放与历史之间也保留双向依赖，工作区恢复与树模块形成更大的调用环。
• 原 tree-controls.mts、context-menus.mts、dialogs.mts 和编辑器差异模块保留迁移接口的命名再导出。
  • 再导出会继续产生 ESM 模块依赖，但实现和内部调用已迁到所属模块。
  • 上图没有单独展开这些再导出边。
• 后续若要进一步解除循环，可集中评估标题状态刷新、表单持久化和操作协调边界。
  • 应先确认具体维护成本，再决定是否提取职责或调整回调方向。
  • 当前记录不增加新抽象，也不改变代码和初始化行为。