[xiaoyumuxi]

关联 Issue / Linked issue

• Refs [Feature] Windows/macOS 统一 Viva 工作台与原生编辑器，保留 Rust Core 和插件体系（分阶段重构） #1794（Viva 统一工作台：Build 工具窗口）
• Build 窗口改进的第 ② 步桌面端收尾：Core 改动是 Lithe-IDEA/Lithe-core-rust#33（已合入）。第 ① 步是 feat(desktop): Build 窗口可运行的行常驻绿色运行按钮，依赖标题加 ⓘ #1896（已合入）。

PR 类型 / Type

• feat：新功能或用户可见的改进
• fix：缺陷修复
• docs：文档、Agent Note、Skill 等规则文件
• release：稳定版发布准备

改动说明 / What changes

背景 / Why

Build 窗口会把同一个模块列两遍。原因是 build.detect 把被 Git 忽略的目录也当成了构建根目录，例如 .claude/worktrees/* 下的代理工作树、生成目录和本地副本。Core #33 让检测跳过这些目录，桌面端要把固定的 Core 版本升上去才能用到。

改动 / Changes

• scripts/desktop/build-desktop-core.sh：
  • PINNED_CORE_REVISION 从 62b8a08（[Windows][W3] 多会话终端系统 #31）升到 29b35bf（[Feature] 希望能支持 vim 模式 #33 的 squash 合并提交）。
  • 固定版本注释补上 [Feature] 希望能支持 vim 模式 #33 和中间的 feat(macos): add macOS 13 compatibility #32。
• 随新版本带来的行为变化：
  • [Feature] 希望能支持 vim 模式 #33：build.detect 和自动运行项发现共用一个最多 6 层的启发式扫描，现在它会剪掉被 Git 忽略的目录。规则来自工作区内的 .gitignore，以及根目录在工作区内的每个仓库的 info/exclude；链接工作树经 commondir 读主仓库共享的 info/exclude。不读工作区根以上的目录、core.excludesFile 和索引。指纹扫描和 Node 清单发现不变。
  • feat(macos): add macOS 13 compatibility #32：Markdown 里的内联 SVG 保留白名单内的绘图元素。
• 功能矩阵：build-system-plugins 的说明补一句检测跳过 Git 忽略的目录，并写上 Core 的测试名。状态保持 partial/pending。

不在本 PR 范围内 / Out of scope

• 构建树投影下沉到 Core，以及树结构调整：[Feature] 将 Viva 构建窗口与结构窗口的树投影、筛选和展开规则下沉到 Rust Core #1866。
• BuildTarget 的 displayName 契约和 Go 插件的映射：feat(desktop): Build 窗口的目标行只显示路径，悬停显示完整名称 #1895 已经只显示路径，这两项是否还要做，待确认。

---

类型专属：feat

多平台对齐

• 两端都具备：Viva 桌面端在 macOS 和 Windows 上共用同一份 Go 代码和 Rust Core。Windows 没有实机验证，功能矩阵里 Windows 的验证状态保持 pending。
• 只实现了 macOS：已为 Windows 提交跟进 Issue：#
• 只实现了 Windows：已为 macOS 提交跟进 Issue：#
• 刻意只属于某个平台（功能矩阵中另一端记为 platform-specific），理由：

---

范围检查 / Scope checks

功能矩阵 / Feature matrix

• 已更新 shared/platform-feature-matrix/features/build-system-plugins.json 的说明；状态和验证保持 partial/pending
• 已运行 ./scripts/platform-feature-matrix/verify-platform-feature-matrix.sh（222 项通过）和 ./scripts/platform-feature-matrix/verify-platform-feature-matrix-change.sh origin/preview HEAD（通过）
• 没有提交 .artifacts/ 下生成的矩阵视图
• [N/A] 已更新矩阵，不需要豁免理由

统一日志系统 / Structured logging

N/A：桌面端代码没有改动。

界面文案 / i18n

N/A：没有新增或修改界面文案。

逻辑归属 / Logic placement

• 忽略规则的解析和剪枝都在 Rust Core（[Feature] 希望能支持 vim 模式 #33）；桌面端只升级固定版本
• [N/A] 没有修改平台层逻辑
• 没有按工具名加分支

性能与内存 / Performance and memory

• 没有新增后台任务、进程或缓存。检测时被忽略的子树不再读取，扫描只会更少
• [N/A] 主线程没有改动
• [N/A] 不涉及启动、输入、滚动、大文件或搜索路径

设置 / Settings

N/A：没有改设置。

插件契约 / Plugin contract

• 契约文档的改动（README 的 detection 一行、构建系统参考页）已在 Core [Feature] 希望能支持 vim 模式 #33 里随代码一起提交，同一个 PR 登记了协议更新记录（2026-11-14，API 编号 —，pluginAPIVersion 0 内的补充）：Lithe-IDEA/Lithe-core-rust#33
• PINNED_CORE_REVISION 已升到 29b35bf，桌面端测试经 scripts/desktop/desktop-go.sh 读到的是这份契约
• [N/A] 没有改插件后端协议
• [N/A] 没有新增或修改宿主方法、宿主通知

发行包与资源 / Bundle and resources

• 没有新增运行时资源；运行了 ./scripts/desktop/verify/verify-runtime-bundle-immutability.sh，通过
• [N/A] 没有新增下载、解压、生成或缓存资源

无用代码与重构 / Dead code and refactoring

• [N/A] 没有代码改动导致的无用代码
• [N/A] 没有发现新的既有债务

---

验证 / Verification

命令或操作	平台	结果
./scripts/desktop/desktop-go.sh test ./... -count=1（在 desktop/，链接 Core 29b35bf）	macOS	54 个包全部通过
Core #33 的 CI，以及本地 cargo test -p lithe-core、clippy、fmt、注释和文档校验	macOS / CI	通过
功能矩阵两个校验脚本	macOS	通过
./scripts/desktop/verify/verify-runtime-bundle-immutability.sh	macOS	通过

未能执行的检查和原因： 没有在 Windows 实机上运行。没有在打包后的应用里打开带代理工作树的仓库手动核对 Build 窗口，检测结果由 Core 的分发器测试 tests::build_systems::detection_skips_directories_git_ignores 覆盖。

提交前确认 / Final checks

• 分支从最新的 preview（a7eee36，feat(desktop): Build 窗口可运行的行常驻绿色运行按钮，依赖标题加 ⓘ #1896 之后）创建，目标分支 preview
• 以 Draft 提交
• 没有无关改动和构建产物
• 测试全部无头运行，没有启动 Lithe 应用，没有进程残留

[lithe-code-review]

Lithe Review

结论： ❓ 审查未完成

已由服务器取消。可以重新评论 @lithe review 召唤。