[xiaoyumuxi]

最新进度与接手入口（2026-11-09，真实 Debug 与 Windows 原生边界节点）

持续开发，保持 Draft，不 ready、不自动合并。本节取代旧接手快照；下方历史说明仍保留。

当前提交与明确依赖

• 客户端：7354cb7c4，现有分支 feature/1794-viva-workbench-shell。已保留并集成远端 e92acfa84、d12cca7c9、7aea0ff17 的编辑器/终端标签、Shell 设置、Git Log 等改动，没有覆盖其他工作。
• Core 增量依赖：Lithe-IDEA/Lithe-core-rust#3，同为 Draft、未合并；客户端精确固定 b22c2ef80421a555a08d0a87eb9f39693c08a2b1。继续复用原 Rust Core；工具链 pin 编辑与 DAP 状态转换仍在 Core，不重写内核。
• 前节点 60aadcaf3 已接回工具链发现、Core candidates/resolve、Build 设置草稿及显式批量保存，Build/Run/命令型 Tests 同时使用工具链程序与导出环境。toolchains.editPins 与共享 fixture 取代 Go 的 pin schema 合并；取消、外部修改冲突和原子文件发布仍由原生层负责。

本节点的具体行为

• Debug 增加显式适配器选择；后台用原始插件 manifest 调 Core 进程计划、debug.adapters.executablePlan 和 startArguments，传真实 program/cwd、插件默认参数及目标绑定，修复空 launch arguments。自动查找跳过目录/非程序候选；明确配置失效时拒绝，不静默回退。
• 工具运行时入口先验证包路径，工具链解析后调用 Core 模板生成 argv；macOS PATH 缺失时由通用 xcrun --find 查询选中开发工具，不硬编码工具或 Xcode 路径。serverProcess 4 仅有内部路径回归，未扩大宿主能力声明。
• 原生进程创建移出 UI 线程；会话的 Core 调用、发送帧、发布更新串行完成，进程句柄原子发布。停止等待启动收尾，只销毁真正创建的 Core 会话，再回收进程/观察器与原生分配的独占状态目录。运行时写入插件可写 .state，安装包只读。
• 真实 LLDB 可先暂停/结束再确认 launch；Core 只把仍处于 launching 的状态改为 running，避免覆盖暂停或复活结束的会话，新增共享时序 fixture。
• Windows 插件可执行文件改由 GetBinaryTypeW 判断 Win32/64 程序，拒绝伪 .exe；不再用 Unix 执行位误拒真实程序。退出测试证明实际创建过进程，防止启动失败冒充清理成功。
• Windows 工具链保存先给未发布临时文件复制原所有者/组/DACL及继承保护状态，再核对取消和字节基线、原子改名；权限准备失败保留源文件。新增真实受保护 ACL 回归。
• 修正 Linux Expand All 测试的观察时机：直接断言该动作的上限提示，避免异步 watcher 的独立上限提示覆盖单一横幅。扩展512目录断言与另一个按钮派发回归保留，没有放宽限额。
• 补齐共享中英文文案、矩阵、Notes、独占状态目录的资源复用排除规则及构建文档。

验证与限制

• macOS：集成远端后的全量 Go 测试通过；普通/dev vet、桌面构建通过。Debug/工具链定向 race 有此前通过证据；工作台全包竞态二进制在恢复正常启动后于正确包目录复验，301项通过、8项条件跳过（54.57秒）。此复验用同一编译结果，临时移除Go DWARF并重新ad hoc签名，未改断言和期限；标准启动仍有下条限制。真实官方 LLDB manifest + clang -g + lldb-dap 验证 program/cwd/defaults、源码断点、main 栈帧、继续/输出/退出与清理，重复三轮通过；14条计时记录13项通过、1项仅子进程夹具跳过。
• Windows Lithe-dev：与集成源码的520个 Go 文件逐一哈希一致；相关41条计时记录38项通过、3项条件跳过，build/vet 通过。原生程序误拒与 DACL 丢失均有先失败再通过的回归。没有启动持续运行的 Lithe 窗口；完整原生 GUI、真实 Windows LLDB 与发行流程不在这些证据内。
• Core 工具链100项、pin14项计时、Debug引擎59项计时通过；Go/Rust共用 fixture。i18n三项检查（10,716中英词条）、225篇Notes、254项矩阵与变更门禁、36项资源复用测试、bundle只读静态检查、测试稳定性和diff检查通过。
• macOS扩大验证时三个 Tests Provider 初始化超时；普通与 race 的单独复跑通过，集成后普通全量通过，但集成后全包 race 仍失败。随后新 race 可执行文件在 _dyld_start 停留超过100秒、尚未进入测试，签名验证有效；去掉Go DWARF、重新临时签名都未解决，不能把标准冷启动记作通过或断言就是同一根因。后续复用已正常启动的同一竞态二进制、在正确包目录运行，工作台全包301通过/8条件跳过；首次直接运行因cwd错误导致的fixture缺失也保留为失败证据。诊断源码已恢复；失败日志、原生采样与有界终止证据保留，未放宽期限、未跳过断言。旧 Core unused/dead-code 与最低 macOS 链接警告保留。日志等价门禁仍由 #1802 跟踪；缺失的 Core 注释自动门禁和旧共享契约全量脚本不记作通过，新改动已有定向检查与真实消费者测试。
• 真实 LLDB 测试把组织原始 manifest 放入隔离夹具，不能当作市场安装/准入验收。settings 2、完整用户配置编辑、Java/TCP/attach/步进/变量、工具链 provider 查询及其他迁移能力仍未完成，不提升为 verified，不结束完整目标。

本节点 GitHub Draft Linux CI、格式与脚本、Notes 和矩阵检查已全部通过：Desktop CI run 42655477550。macOS/Windows runner 按 Draft 策略跳过，不能当作通过。

继续工作与恢复

1. 先解决/隔离本机 _dyld_start 启动停滞并补齐最新全包 race 的验收；继续真实插件设置来源与确认写回、正式插件准入、完整 Run/Debug 配置与工具链 provider，核对设置快照切换/关闭项目的作用域保护。
2. 复核完整迁移清单及真实用户流程。previous-batches/delivery-audit/ 是旧盘点；146 must-replace、48 pending-owner-decision 不是删功能许可。LS3、SDK、编辑器/Git/生成器等剩余能力与跨平台原生/打包/升级还须逐项验收。
3. 保留 Viva 上游 [Bug] Windows preview 0.3.0 编辑器持续卡顿：每键全文同步、Git blame 与 LSP 轮询 #187/[Mac] 使用 Release 静态更新清单替代匿名 GitHub API 检查更新 #188 升级待办，未合并前不静默换 pin。
4. 工作树：~/.codex/worktrees/viva-1799-takeover/Lithe-IDEA，本地分支 codex/1799-viva-completion；按大节点继续提交、同步本 PR，保持 Draft。
5. 仓库根 .artifacts/1799-handoff/ 的旧恢复包保留；本次资料在 takeover-2026-11-09/，含最新源码、客户端增量 bundle（基于旧 final-snapshots.bundle 的 f105d32c）、独立 Core bundle、失败/通过日志及计时 HTML/JUnit。当前工作树继续使用，未归档；Windows 专属验证目录已在证据收集后删除，清理报告确认目录不存在、所属进程0；未动其他服务器工作区。本机诊断进程也已终止。

本批已验收集成（2026-11-09）

保留远端 db2024230 及此前编辑器性能优化，集成以下子任务；工具链和测试/Debug 工作树仍独立，未混入本次提交。

• 官方插件包：同时接受根目录 plugin.json 与唯一 <plugin-id>/plugin.json 布局；内容根名称必须匹配 Core 校验后的插件 ID。拒绝歧义 manifest、根外条目、路径穿越、符号链接及配额违规。归档摘要和内容摘要的审批边界保持不变，无签名磁盘包仍需要明确审批。官方 Cargo 0.1.0 原始 ZIP 已通过安装、启用、模型加载与真实构建，flat 包兼容回归保留；不代表发布者签名验证已实现。
• 语言操作：F12 / Cmd或Ctrl点击定义跳转、多目标选择，F1 / 指针停留 Hover，Ctrl+Space 显式补全及接受。消费 Core 规范化结果，支持取消与过期版本隔离，列表有界；snippet 转纯文本由 Core 完成。移除 lsp.request 不接受的 documentVersion/Extra，接现有 completionContext，并等待真实 ready。自动补全、只读/jar目标、重命名/格式化仍未实现。
• 编辑器集成：适配最新 rope/string 编辑接口；接受补全时只在 UI 线程取得不可变快照，后台计算变更区间，回到 UI 后核对版本并应用局部编辑。回归证明旧整篇替换会发送 120009 字节，新路径只发送新增的 3 字节，撤销/重做保持正确。Core lsp.applyTextEdits 仍是后台全量文本接口，未宣称它已增量化。
• Agent：会话历史读取、选择恢复、新建会话，以及 adapter 声明的模型/思考程度/模式选项；配置收到确认才生效。恢复回放使用独立有界缓存，恢复失败保留原会话文本和已确认配置，新建失败亦保留配置。历史缓存容量受限，补充认证要求/等待登录/连接丢失状态；不读取真实账户、不发起付费请求。归档历史、完整订阅认证与 boolean 配置仍未接入。
• CI 架构：沿用远端已有 core.PluginArchitecture，不加入第二套换算；补充真实 Core 对 arm64/x86_64 接受及 amd64/x64/sparc 拒绝的契约回归。

本批验证：全量 Go 测试、workbench/plugininstall/pluginpkg/editorview 全包竞态、普通/dev vet、桌面构建、i18n 三项检查、Notes、功能矩阵、资源只读与测试稳定性门禁。真实 clangd 的定义/Hover/补全及官方 Cargo 原包 E2E 单独执行。所有证据为本机 macOS；Windows/Linux 原生端到端仍待验证。

编辑器性能：同机 Apple M4，100 KiB/10 MiB，相关 Paint/Type/UndoRedo/CaretMove/Scroll 基准各 6 次；28/28 在预算内，绘制/滚动 0 B/op、0 allocs/op。对比文件 .artifacts/editor-perf/batch2-before.txt、batch2-after.txt、batch2-after.md，不提交产物；本批没有新超预算项。

关联 Issue / Linked issue

• Refs [Feature] Windows/macOS 统一 Viva 工作台与原生编辑器，保留 Rust Core 和插件体系（分阶段重构） #1794：Viva 跨平台桌面客户端迁移，当前仍在进行中。
• Refs feat(core): #1794 新增工作台外框布局规则 workbench.chromeLayout.reduce Lithe-IDEA/Lithe-core-rust#1：工作台布局 Core 能力。
• Refs feat(core): #1794 插件语言语法改为 TextMate（languages 3），撤回 Monarch（languages 2） Lithe-IDEA/Lithe-core-rust#2：TextMate 语言语法契约与 Core 实现。

PR 类型 / Type

• feat：新功能或用户可见的改进
• fix：缺陷修复（含审查发现的替换窗口、并发丢更新与 CI 失败项）
• docs：文档、Agent Note、Skill 等规则文件
• release：稳定版发布准备

改动说明 / What changes

背景 / Why

将原 macOS SwiftUI 和 Windows Tauri 客户端迁移到共用的 Viva（Go）桌面界面；共享规则继续由独立的 Lithe-core-rust 实现，语言、构建和其他工具能力由插件提供。这个 Draft 已删除旧客户端与仓库内旧 Core，但新客户端尚未实现或验收旧产品的全部功能，不能作为可发布版本。

改动 / Changes

界面与工作台（此前已完成）

• 增加 Viva 欢迎页、工作台、可拖放工具窗口、终端、设置和日志窗口；项目文件树、编辑器标签、文件打开和保存、TextMate 高亮、文件图标与自动换行已有接入。
• 欢迎页支持最近项目、搜索、Core 解析 Git 分支、打开项目与通过 Core 克隆仓库；新建项目窗口支持空项目、名称校验、选择位置、可选 Git 初始化、取消和失败后保留已创建目录。侧栏搜索通过 Core 匹配，插件入口打开插件市场页面。
• 接入工作区文件和文本搜索、Search Everywhere、编辑器行列跳转、外部文件变更与保存冲突保护；Git 状态、分支、日志、暂存与提交使用已有 Core 命令。
• 同步 Core 已合入的 languages: 3 TextMate 契约，撤回原 languages: 2 Monarch 语法；更新共享 fixture、i18n、功能矩阵、资源与测试脚本，并记录旧客户端相关决策的迁移状态。
• 修复 macOS 上 Go 与 Rust Core 使用子进程时的 SIGCHLD 信号栈问题；增加有界 Go 测试计时、Windows Git Bash 路径识别及资源只读检查。
• 修复 Windows 与 Linux 自定义标题栏的最小化、最大化/还原、关闭按钮在浅色外观下看不见：工作台、设置窗口和日志窗口通过 desktop/internal/windowcontrols 按各自标题栏的文字色着色，按钮名称使用共享 i18n 的 window.* 词条。三个窗口各有 TestWindowControlsFollowTheTitleBar 回归测试。

插件安装链路（此前已接入）

• pluginpkg：ZIP 安全解压。拒绝契约禁止的绝对路径、.. 段、反斜杠、NUL 与符号链接，并补上跨平台安装所需的 Windows 设备名、尾随点/空格、大小写重复、文件与目录冲突；宿主自定 20000 条目 / 512 MiB 单文件 / 2 GiB 解压总量 / 200 倍膨胀上限（契约未给数值）。解压与摘要校验共用同一已打开句柄，关闭「校验完再按路径打开」的替换窗口；失败清理暂存目录；启动时清扫 .staging / .trash 残留。
• plugintrust：批准记录。只保存来源、归档摘要、包内容摘要、权限与已批准程序；市场来源在摘要与程序集都没变时复用批准，磁盘来源每次都问。记录加互斥，避免并发读改写丢更新。
• plugininstall：两阶段安装。Prepare 解压、校验清单、算内容摘要、取 Core 的安装审查并判定能否复用批准；Commit 才真正写入。解压与校验都响应取消。
• pluginstate / pluginmanager：启用状态与生命周期。卸载删除该插件的全部已安装版本并清掉对应批准，最后才清启用选择。
• pluginhost：能力声明、清单校验、包路径逐段解析（拒绝任一级符号链接）、宿主服务注册与派发（机器请求 30 秒期限，用户选择类请求豁免）、启动计划路径校验。
• pluginbackend：Core 绑定的后端启动、停止与事件泵。宿主请求交给 pluginhost.Services 应答，其余事件（诊断等）交给调用方；systemCommand 启动用宿主工具发现解析裸命令。
• pluginservice：装配上述各层，并把 Core 的安装审查、语法解码、文档同步适配成内部类型。

语言服务与诊断

• 语言贡献：读取已启用插件包内的 plugin.json，语法文件经 pluginhost.ResolvePackagePath 逐段校验后交 Core 解码；行注释、块注释、括号与自动闭合都映射进编辑器语言表。单个语法被拒只让该语言降级为纯文本，不丢整个插件的语言。
• 文档同步（pluginlsp）：文档在版本 1 打开，之后只发增量变更；未打开的文档拒绝变更/保存；Core 解析出的 URI 作为唯一键。
• 语言服务器生命周期：打开文件时按语言惰性启动（一个 Go 工作区不该为一个 Java 服务器付费），同一语言并发打开只起一个；关闭项目、禁用、卸载都会停止并销毁会话。
• 诊断：Core 侧新增诊断事件解码（同时接受「事件带 uri/version + 裸数组」与「载荷自带身份」两种形状），有界存入 plugindiag，在编辑器里按单元格网格画 2px 下划线（滚动与换行时仍贴着字符），状态栏显示问题总数（单数另有措辞）。
• 能力声明：Declared() 从空集改为 languages: [1,3]、languageServers: [1]、serverProcess: [1]。市场索引请求改为传真实能力集，条目可用性按实际支持过滤。

本轮集成：Problems / Build & Run / Agent（三个工作树压缩为一个提交）

• Problems：接入 Core lsp.problems.query，虚拟化显示诊断并按 UTF-16 位置打开文件；诊断按插件隔离，关闭、禁用、崩溃、重启和项目切换时清理。
• 文档同步：编辑器 open/change/save/close 接到现有 Core 会话，覆盖服务器延迟启动、增量编辑和迟到结果隔离。修正语言服务器启动计划、language_server 角色、Core root URI 和 utf16Column 字段；释放插件时使进行中的 Open 失效。
• Build/Run：声明 buildSystems: [1]、buildProviders: [1,2]；Core 检测实例、生成模型/任务/运行计划，插件提供工具知识，宿主执行原生进程并显示有界输出。支持 command/provider 任务、真实 ready、进度、取消及项目关闭清理；没有在 Go 内重写 Maven/Gradle/Cargo 规则。
• 共享语言服务器：构建与编辑器复用会话，注册表统一同步并保留项目归属；构建先启动时同步已打开文档，关闭或停用后拒绝迟到注册。修复重复 ready/终态关闭、进度发送到已关闭通道、后台子进程持有输出管道造成退出卡死等生命周期问题。
• Agent：通过 Core 发现和解析实际 provider 配置、显示来源及可用状态；显式安装适配器，支持进度、取消、重试；接入文本会话、流式输出、停止、权限回答、断开与项目关闭清理。对话显示有上限，截断保持 UTF-8 完整。凭据只在内存中传递，不写日志。
• 同步中英文案、功能矩阵与决策笔记。集成检查修复 Unix 进程适配器的互斥锁值复制（go vet 失败项）。

本轮验收边界

• 真实 clangd 通过隔离测试插件启动，验证编辑→Core→服务器→Problems、关闭/项目切换，以及构建先启动共享会话的路径；这不等于从市场安装正式语言插件已验收。
• 官方 Cargo 0.1.0 的同一份内容重排为根目录布局后，安装、启用、模型加载和真实 cargo build 通过；此前原始 Release ZIP 布局曾被拒绝；本批已修复并以原包 E2E 替换拒绝回归。Maven 0.1.1 的 languageImport 与固定 Core 不兼容，未宣称 Maven 全流程通过。
• Agent 使用受控适配器安装及 Core fixture 会话验证，未发起真实付费 provider 对话；Windows Job Object 仅交叉编译，尚无 Windows 原生运行证据。

编辑器性能基线与优化（本轮新增，11 个提交：5b24494b4..3031c2ff5）

• 基线分三层：
  • rope、语法、视图三层 Go 基准，场景包括打开、输入、回车、撤销重做、粘贴、光标和翻页移动、视口染色、整篇染色、绘制、滚动、小地图、超长行。
  • 每个场景跑 100 KiB 和大文档两种规模。大文档默认 10 MiB，可用 LITHE_EDITOR_PERF_LARGE_BYTES 或 --large-bytes 修改。
  • 预算写在 desktop/benchmarks/editor-budgets.json，限定每次耗时、内存、分配次数、吞吐，以及大文档相对 100 KiB 的倍数。
  • scripts/desktop/perf/editor-bench.sh 负责运行、生成报告和 record。record 在机器不空闲时拒绝记录。超预算只报告，不阻塞，也不是 CI 必跑项。
• 规则：AGENTS.md / CLAUDE.md 新增“编辑器性能”入口；develop-lithe 新增参考页 references/editor-performance.md；决策原因写进 Agent Note testing/2026-11-09-viva-editor-performance-baseline.md。
  • 改动前后在同一台机器上对比，写进 PR。
  • 不得上调预算、删除场景或缩小文档。
  • 绘制路径零分配。
  • 视图基准必须按窗口的方式配置视图。
• 编辑器优化：
  • 编辑、撤销和打开不再随文档大小变慢。
  • 绘制一帧不再分配内存。
  • 超长行只读要画的那一段。
  • 撤销和重做只处理改动的那一段。
• 染色引擎优化：正则引擎少试无望的起点，整篇染色快 7%–21%。
• 变基到上游语言服务器同步（79bce218c）后发现一处回退：撤销、重做和重新加载把整篇文档当作一次替换报告给 OnEdit，每次复制整篇文本；超长行上每次按键还要从行首数 UTF-16 列。
  • 已修复：只报告 rope.Diff 找到的那一段，列号从较近的已知位置开始数。
  • 基准当初没有设置 OnEdit，所以没有测出这处回退；现在已补上。
• 两处基准测错了对象，已修正（预算、场景、文档规模和生成方式都没改）：
  • 绘制和滚动的计时循环改用预热过的画布。原来首帧画布扩容的成本被平摊进每一帧，显示为每帧 1–40 B；修正后 22 项结果都是 0 B/op、0 allocs/op。
  • TypeInLine 在两种规模下改为编辑同一行。原来比较的是两行不同的内容，修正后规模比为 1.02x–1.03x。

同一台 M4 MacBook Pro，大文档 10 MiB：

场景	改前	改后
按键输入（Type/go）	678 µs	46 µs
撤销/重做（UndoRedo/go）	225 ms	46 µs（1.4 KiB）
窗口线程上打开 Go 文件	224 ms	1.04 ms
粘贴 1 MiB	250 ms	3.5 ms（1.18 MiB）
稳定帧的分配	113–152 次	0

修复 OnEdit 回退前后，两份二进制交替各跑 6 轮，取中位数（两边都设置了 OnEdit）：

基准	改前	改后	改前内存	改后内存
UndoRedo/go/100KiB	56.0 µs	48.9 µs	208.1 KiB	55 B
UndoRedo/go/10MiB	784 µs	46.4 µs	20.02 MiB	1.4 KiB
Paste/go/100KiB	3.49 ms	3.44 ms	3.39 MiB	1.17 MiB
Paste/go/10MiB	4.41 ms	3.49 ms	23.21 MiB	1.18 MiB
Type/go/10MiB	46.1 µs	46.1 µs	4.5 KiB	4.5 KiB
Enter/go/10MiB	34.6 µs	34.7 µs	3.1 KiB	3.1 KiB

超预算项：优化前 110 项中 52 项超出，优化后剩 20 项；两处基准修正去掉了其中 17 项不是编辑器造成的结果，剩下 3 项，都不是本 PR 新引入的：

结果	实测	预算	说明
SyntaxFullPass/go/100KiB	约 1.9 MB/s（54 ms）	20 MB/s（5.12 ms）	从头染整篇文档。TextMate 正则逐个起点回溯执行，每个起点都要试一遍 Go 语法的全部规则，开销集中在正则引擎；已快 14%。窗口里只染视口，视口冷启动约 1 ms，在预算内。
SyntaxFullPass/java/100KiB	约 2.5 MB/s（40 ms）	20 MB/s	原因同上；已快 7%。
SyntaxFullPass/markdown/100KiB	约 6.9 MB/s（15 ms）	20 MB/s	原因同上，另有 `(?:\n

desktop/benchmarks/history/m4-mbp.jsonl 里只有优化前的第一次 record（a7e52e32e，记录时工作区有未提交改动）。优化后的那次 record 按维护者要求停掉了，没有写入历史。

发现的既有性能债务。按维护者决定合并在一个 Issue 里跟踪：#1816，每项可以单独修复、单独提 PR：

1. textmate/tokenizer.go:162：StateStack.push 每次压栈都在堆上新分配一个节点。
2. editorview/view.go：widestLine 每次编辑都要重新找最宽的行。
3. replaceFromDisk 在窗口线程上做 O(n) 的工作。
4. workbench/document_observation.go:187：每次观察文档都用 bytes.Equal 比较整篇内容。
5. syntax/semantic.go 逐行复制文本。
6. 正则引擎是回溯执行，整篇染色吞吐受它限制。
7. (?:\n|$) 一类模式算不出首字符，无法剪枝。
8. 自动换行时，超长行每次编辑都整行重新换行。
9. 小地图每次重新换行。
10. 没有在超长行上输入的基准。

Git Log 提交详情作者行不截断（7aea0ff17）

• 提交详情标题下的「哈希 / 作者 / 邮箱 / 日期」原来是一行，放不下时以省略号截断（如 Yao…、<23722032@bjt…）。现在四段逐段量宽、用 wrapTabs 分行，每段完整显示；某一段单独就比一行宽（如很长的邮箱）时独占一行，用 ui.Wrap 在段内折行。
• 测试：TestLogCommitDetailsShowWholeAuthorLine 在最窄的详情面板中检查四段都完整画在面板内、没有省略号，超长邮箱独占一行且各行拼起来是完整邮箱；把 Wrap 换回 Ellipsis 时该测试失败。
• 功能矩阵：git-history 补充证据与验证步骤。

终端标签栏横向滚动、按 Shell 新建终端、细滚动条可拖动（d12cca7c9）

项	之前	现在
终端工具窗口标签栏	放不下时裁掉右侧，无法左右移动	与编辑器组共用 drawGroupStrip：单行横向滚动、顶部细滚动条、滚轮/触控板左右滚动、⋯ 列出看不见的标签；加号和下拉箭头始终可见
新建终端	只能用登录 Shell	加号旁 ⌄ 菜单列出已安装的 Shell，选一项即以它新建终端；分隔线下「设置」打开 设置 > 工具 > 终端
新终端默认 Shell	不可设置	设置 > 工具 > 终端 选择；自动时显示实际生效的登录 Shell，已保存但不存在的路径显示「未找到」
横向细滚动条	只显示位置，拖不动	可拖动：编辑器标签栏、终端标签栏、项目树、Git Log 改动文件
底部区域默认高度	固定 260	主列高度的 42%，未拖动前随窗口变化；拖动后记住拖动值
Git Log 提交详情的分支/标签引用	单行，放不下时裁掉	换行显示

• 终端 ⌄ 菜单在 workbench/terminal_shells.go：每次打开时在后台线程查找 Shell，查找期间显示上次的结果（第一次打开时显示查找中的提示）；Esc、点击外部、打开隐藏标签列表或按钮不再绘制（工具窗口隐藏、项目关闭）时关闭。
• Shell 查找的取舍（localshell）：
  • macOS/Linux 新增 InstalledShells，列出 /etc/shells、常用前缀（/bin、/usr/bin、/usr/local/bin、/opt/homebrew/bin、/opt/local/bin）和 PATH 中每个不同的可执行文件。同一文件经符号链接或硬链接到达（如合并后的 /usr）只保留第一个位置；csh/tcsh 仍合并。
  • Windows 维持每个家族一项：PowerShell 7、Windows PowerShell、CMD、Git Bash（--login -i 启动）、Cygwin、Nushell。
  • 菜单标签用 Labels：名称唯一时只显示名称，同名多份时显示 名称 (路径)，例如 bash (/bin/bash)、bash (/opt/homebrew/bin/bash)。
  • WSL 发行版（InstalledWSL）暂不列入菜单。
• 设置窗口新增 pageTerminal（父级「工具」）与 settingswindow/terminal_view.go；Controller.OpenTerminal 打开该页并展开「工具」分组，已打开的窗口通过 requestPage 切页，插件页原来的单独切页逻辑并入其中。新建终端时未指定 Shell 就用 terminalShell 设置。
• 细滚动条拖动：hscroll 新增 Grab / DragTo，workbench/sideways.go 统一登记滑块并处理指针。
• 底部默认高度：固定 440 会在较矮窗口里挤掉左右工具窗口的内容（7 项 Agent 历史与 Commit 测试失败），因此改为按主列高度的比例（layoutState.bottomFor）；停靠拖拽预览同用 bottomFor。
• 测试：hscroll 拖动、TestEditorTabStripThumbDrags、gitlog_details_test、localshell 多安装与合并、Labels、settingswindow 终端页与切页。按维护者要求，终端 ⌄ 菜单本次没有新增 workbench 测试。
• 功能矩阵：terminal-sessions 改为 Viva 证据、partial / pending，补充验证步骤与 Shell 查找取舍。

编辑器标签栏横向滚动与标签页位置设置（e92acfa84）

• 编辑器组的标签放不下时，标签栏原来直接裁掉右侧、无法左右移动；现在横向滚动，参照旧版 macOS 标签栏：
  • 顶部细滚动条显示当前位置；滚轮和触控板在标签栏上左右滚动，纵向滚轮也转为横向。
  • 所选标签自动滚入视野（新打开、切换、从列表选择时）。
  • 右端 ⌄ 按钮列出部分或完全看不见的标签，每项带文件图标、名称、未保存标记和关闭按钮；选择后切换并滚入视野，关闭后列表保持打开；Esc 或点击外部关闭。
  • 实现在新增的 workbench/tabstrip.go：布局后读取每个标签的位置，算出滚动范围和看不见的标签，变化时再画一帧。
• 设置 > 编辑器新增「标签页」，参照 IDEA「在以下位置显示标签页」：
  • 一行，标签页放不下时：滚动标签页面板（默认）/ 挤压标签页（标签最窄 72，名称截断）。
  • 多行：按宽度换行，软换行开关等按钮在第一行右端。
  • 写入设置文件的 editorTabRows / editorTabOverflow，修改立即生效；未知值回到默认，「恢复默认」同样复位。
• 终端标签拖到编辑器组时，插入位置和插入竖线按行计算，多行标签栏可以放到任意一行（insertionIndex / insertionMark 增加纵坐标）。
• 新增 desktop/internal/hscroll：横向滚动状态（范围修正、滚入视野、滑块、滚轮换算），项目树、Git Log 改动文件和编辑器标签栏共用；workbench/sideways.go 统一绘制细滚动条。项目树原来的手写横向滚动改用它，行为不变。
• Git Log 提交详情的改动文件列表可以横向滚动，长路径不再被截断，底部显示细滚动条。
• 删除的文件改用红色（新增调色板 Deleted，亮色 #DB3B4B、暗色 #DB5C5C），原来用次要文字色，暗色主题下显得发灰；Commit 工具窗口同样适用。
• 测试：tabstrip_test.go 3 项（滚动与隐藏标签列表的选择、关闭、Esc、外部点击；挤压、多行与恢复默认；换行算法），editorgroups_test.go 新增跨行插入位置并扩展插入竖线，settingswindow/editor_view_test.go 覆盖设置页，hscroll_test.go 7 项，gitlog_files_test.go 新增横向滚动。
• 功能矩阵：editor-multiline-tabs 改为 Viva 证据、partial / pending；git-history、file-explorer 补充证据与说明。

插件后端架构名修复（db2024230）

• 插件契约和 Core 只接受 arm64 / x86_64，宿主却把 Go 的 amd64 换成插件市场用的 x64。Core 因此在 x64 的 Windows 和 Linux 上拒绝规划任何插件后端，语言服务器和构建提供者都启动不了。从 79bce218c 起 Linux CI 的 TestProviderModelTaskAndCancellation 一直因此失败。
• 换算收成一处 core.PluginArchitecture（原来宿主和测试各写一份，其中两份是错的）；新增 TestPluginArchitectureUsesContractNames，在任何架构的机器上都核对换算。插件市场的平台名（windows-x64 等）是另一套约定，保持不变。

项目树标题栏按钮与公共折叠树列表（18748cc8f）

• 新增 desktop/internal/treelist：公共折叠树列表，负责行几何、缩进、展开箭头、悬停、有键盘焦点和失焦两种选择色、方向键/Home/End/翻页导航、双击展开和 Enter 激活，只声明可见行。行的无障碍属性报告 Selected、Expandable、Expanded、Level。项目树改用它绘制。
• Git Log 提交详情的改动文件原来是平铺列表，现在按文件夹分组并可折叠，复用 treelist：文件夹先于文件，文件保持 Git 返回的顺序；单击箭头、双击文件夹或方向键展开收起，Enter 打开文件差异；切换提交后文件夹重新展开。
  • 分组暂在 Go（gitlog.go 的 groupLogFiles，按字节排序，与项目树的 Core 自然排序不同），下沉 Core 跟踪 [Feature] 将 Viva Git Log 提交改动文件的文件夹分组下沉到 Core #1814。
  • 左侧分支面板仍是独立的手写树（行标识按可见序号、无键盘导航、无展开状态的无障碍属性），迁移到 treelist 跟踪 [Feature] Viva Git Log 分支面板改用公共树列表 desktop/internal/treelist #1815。
• Project 标题栏在隐藏按钮前新增四个按钮，使用 Lucide 图标：
  • 定位当前文件：逐级列出并展开祖先目录，选中并居中目标行，下一帧把键盘焦点交给该行（同一帧的焦点请求会被按钮点击的焦点覆盖）；当前文件不在项目内时按钮禁用；途中某级目录或文件已不存在时放弃，并记录 operation_rejected。
  • 刷新：重读已展开的目录；根目录读取失败时重新监听并读取。
  • 全部展开：广度优先，最多打开 512 个目录，超出时提示（新词条 desktop.project.expandAllIncomplete）。
  • 全部折叠：保留根目录，被隐藏的选择移到它所在的顶层目录，焦点留在按钮上。
• 抽出 toolIconButton：禁用状态同时写入命中与无障碍树（ui.Box.Disabled 只调暗绘制）。项目搜索的刷新按钮改用它；Search Everywhere 改用与定位按钮共用的 projectRelativePath 计算相对路径。
• 文件树监听未改动，说明如下：macOS 和 Windows 用 Viva 的 app.WatchTree 对项目根递归监听（FSEvents / ReadDirectoryChangesW），与项目搜索共用一条流；Linux 按已展开目录用 app.WatchDirectory（inotify），上限 128 个。事件经 Core FilterWorkspaceChanges 过滤，再由 Core ListDirectories 分批重读受影响的已展开目录。
• 测试：treelist_test.go 8 项（几何、索引、最小滚动、居中、首行往返、键盘移动与展开、键盘滚动、双击），filetree_actions_test.go 6 项（定位、定位放弃、全部展开与折叠、512 上限、刷新、根目录恢复），gitlog_files_test.go 2 项（折叠、分组顺序）。
• 功能矩阵更新 file-explorer、project-sidebar-header-icons、git-history、macos-shared-tree-list-control：后三项改为 Viva 证据，状态 partial / pending；尚未实现 IDEA SVG 图标、悬停渐显、标题下拉箭头、范围多选、拖放、行内编辑和插件树。

此前的审查与 CI 修复

• 按只读代码审查报告修复 17 项缺陷，另有 2 项只做到部分：Unicode 规范化折叠（未引入 golang.org/x/text，改为把文件系统折叠导致的 EEXIST 翻译成重复路径错误）、Serve 返回后的会话自动处置（改为文档化调用方责任，避免与 Stop 双重销毁）。
• 修复项目树同一段连续列目录失败记两条重复错误通知（Linux CI 稳定失败的真实产品缺陷）。
• 修复 Verify Agent Notes：155 篇笔记里约 735 条指向已删除路径的引用，改成删除线加注「已随 [Feature] Windows/macOS 统一 Viva 工作台与原生编辑器，保留 Rust Core 和插件体系（分阶段重构） #1794 移除」并保留原文，校验器不再把它们当作当前入口。
• 修复两个脚本测试：移除随旧客户端退役的 PlantUML 资源与远程构建脚本断言及对应注册表条目；测试稳定性脚本测试不再读已删除的 ci-windows.yml。

不在本次进度中 / Remaining work

• 语言智能剩余接线：Problems、文档同步、定义跳转、Hover、显式补全已接入；自动补全、引用、只读目标、重命名及格式化仍待实现。
• languageServers: 3 未声明。requestMethods、commands、serializedCommands、forwardNotifications、state、remote 还没有转发实现，插件后端无法驱动自己的服务器。
• 工具发现只查 PATH。项目工具链与用户覆盖未实现，依赖它们的启动计划会被拒绝而不是凑合启动。
• 新建项目目前只有空项目；插件提供的 Java、Maven Archetype、Spring Boot 等生成器、工具发现和完整生成事务未完成。
• Agent 最小会话及基础 Build/Run 已接入；完整认证、历史、工具链、测试、调试和更多插件协议仍待迁移。功能矩阵区分实现状态与原生验证状态，未验收平台保持 pending。
• macOS 原版与 Viva 的截图对照已开始，但整个界面尚未达到像素级一致；Windows 和 Linux 的原生窗口、打包与完整产品流程尚未完成验收。
• 编辑器性能基线已建立（见上文）；启动、打开项目、文件树和内存的跨平台基线，以及与 VS Code / Zed 和真实窗口的对照，尚未完成。
• 数据迁移、签名与升级回退演练、插件 SDK 端到端均未开始。
• PR 保持 Draft，不应合并或标记 ready。

Viva 升级

上游修复 vivaui/viva#187（Issue vivaui/viva#186）。它让 Mono 文本的布局、换行和截断都按等宽格子计算，中文等宽字符占 2 格，并新增 gfx.Canvas.WrapLinesStyle。

另一个上游修复 vivaui/viva#188：Windows 上等宽文字走 GDI，GDI 为没有 semibold 字面的 Consolas 合成 600 字重，字比格子宽，日志窗口“级别”列和工具栏的 INFO 显示成 INFC；修复后中等和半粗的等宽文字交给 Direct2D。Lithe 侧不加绕过代码。

本 PR 仍固定在 v0.5.2-0.20261109020342-0c11a3d0950d，等上游合并后再完成以下改动：

• 升级 Viva：desktop/go.mod，以及 scripts/desktop/ 下 package-desktop.sh、generate-desktop-icons.sh、generate-desktop-file-icons.sh 里的 VIVA_VERSION，三个脚本与 go.mod 用同一版本。
• 删除 desktop/internal/monogrid 及其测试。Git 日志详情里的提交标题（internal/workbench/gitlog_view.go 的 subjectLines 和 logView.subject* 缓存字段）改为 f.Wrap(subject).Mono().Bold().FontSize(logFontSize)，并用 LineHeight 设为等宽格子高度，保持现在的行距。
• internal/logwindow/window.go 的 mono()：去掉非 ASCII 文本手动补宽度的分支，删除 printableASCII。
• internal/logwindow/details.go 操作区下方的脱敏说明改用 f.Wrap(...).Mono()，删除 wrapDetailWords 及其两个测试，并核对行距与现在一致。
• 保留 wrapDetailRows（按字符折行带颜色的 JSON 片段）和工具栏的 monoWidth（计算按钮宽度）。它们是正常功能，不是绕路代码。
• 升级后运行 make -C desktop check，再用无头截图确认三处中文等宽文字不再超出边界：提交面板的分支名（不改代码，升级后自动修复）、Git 日志的提交标题、日志窗口。
• 升级版本包含 windows: leave medium and semibold fixed-pitch runs to Direct2D vivaui/viva#188 时，在 Windows 确认日志窗口“级别”列和工具栏的 INFO 显示完整。

类型专属：feat

多平台对齐

• 两端完整具备并验收：同一 Viva 界面面向 macOS 和 Windows；本次仅完成部分能力及针对性测试，完整对齐尚未验证。
• [N/A] 只实现 macOS / 只实现 Windows：此 PR 目标为共用客户端，平台专属适配仍分别验证。

范围检查 / Scope checks

功能矩阵 / Feature matrix

• 更新受影响的功能矩阵，未完成或未验证的能力保留相应状态。
• 运行 ./scripts/platform-feature-matrix/verify-platform-feature-matrix.sh；生成视图未提交。
• e92acfa84：更新 editor-multiline-tabs、git-history、file-explorer；结构检查与 60aadcaf3..HEAD 变更门禁通过（254 项能力）。
• d12cca7c9：更新 terminal-sessions；结构检查与 e92acfa84..HEAD 变更门禁通过（254 项能力）。
• 7aea0ff17：更新 git-history；结构检查通过（254 项能力）。
• 完整变更范围核验和所有能力逐项验收仍待完成。新增的 10 个插件包与语言服务能力尚未写入矩阵。

统一日志系统 / Structured logging

• 已接入 Core 日志目录及部分工作台失败事件；插件安装、语言服务器起停与诊断的失败事件也已接线，但全量日志门禁和所有用户流程的接线仍需验证。

界面文案 / i18n

• 用户界面使用共享 i18n；更新中英文词条和生成结果（新增 17 条 desktop 词条，含插件安装、审查面板与问题计数）。
• verify-app-language-localization.mjs、generate-i18n.mjs --check 和 i18n 测试通过。
• 18748cc8f：files.collapseAll、outline.expandAll、native.revealActiveFileInProjectTree 加入 desktop 平台，新增 desktop.project.expandAllIncomplete；变基后中英词条 10,647 条完整。
• e92acfa84：新增 desktop.editor.hiddenTabs 及 desktop.settings.editorTabs 等 7 条设置页词条；变基后中英词条 10,711 条完整。
• d12cca7c9：新增终端 Shell 菜单与终端设置页词条，desktop 平台复用 native.newTerminalWithShell 等已有词条；中英词条 10,714 条完整。
• 新增词条的两个语言包都已接上访问器；只接英文会让中文界面在调用时 panic，已由测试覆盖。

逻辑归属 / Logic placement

• 插件链路遵守「Core 算规则、Go 搬字节」：安装审查、清单校验、语法解码、启动计划、文档同步、语义请求全部走 Core 命令，Go 侧只做文件系统、路径校验与呈现。
• 整个客户端的共享逻辑归属仍需完整审计；编辑器引擎当前在 Go，已有本地性能基线（只报告，不阻塞），相关架构审计未完成。
• 工具专属行为及所有插件边界仍需逐项核实。
• Git Log 改动文件的文件夹分组暂在 Go 完成（固定 Core 没有分组接口，本 PR 不改内核），跟踪 [Feature] 将 Viva Git Log 提交改动文件的文件夹分组下沉到 Core #1814；项目树可见行与导航下沉见 [Feature] 将 Viva 项目树可见行和导航规则下沉到 Rust Core #1800。

性能与内存 / Performance and memory

• 编辑器的输入、撤销、粘贴、打开、染色、绘制、滚动和超长行已有 100 KiB / 10 MiB 两种规模的本地基线，改前改后对比见上文；剩下 3 项超预算结果已逐项说明。
• 部分搜索、文件树、子进程生命周期与插件解压有有界和取消测试；启动、打开项目和内存的跨平台前后基线尚未完成。

设置 / Settings

• 终端默认 Shell 只写 Lithe 自己的设置文件 terminalShell（不对应外部工具配置），回显当前值；自动时显示实际生效的登录 Shell，已保存但不存在的路径显示「未找到」。
• 编辑器「标签页」设置只写 Lithe 自己的设置文件（不对应外部工具配置），回显当前值，「恢复默认」复位；未知值回到默认。
• 插件页可显示安装状态、安装、启用/禁用与卸载。
• 设置界面的真实工具配置来源、分类、说明和全功能对齐仍需逐项验收。

插件与共享契约 / Plugin and shared contracts

• languages: 3 与 languageServers: 1、serverProcess: 1 已声明；声明依据写在 pluginhost.Declared 的注释里，未实现的能力不声明。
• 合并前在本地补齐了 lsp.syncDocument / saveDocument / closeDocument / request 的 Go 入口（契约已有，客户端此前未包）。
• 真实插件消费者（io.github.lithe-idea.java-support）仍未装上并跑通；languageServers: 3 的插件驱动能力未实现。
• 合并前的 lithe-plugin-docs 三个 SDK 端到端测试尚未执行。
• 合并后需按仓库规则在 lithe-plugin-docs 同步合并后的契约并登记协议变更。
• [N/A] 本次未新增或修改插件宿主方法、通知；不新增 API 编号。

发行包与资源 / Bundle and resources

• 运行静态 bundle 只读检查；新增计时报告的 worktree 复用规则和文档已更新。
• 资源复用测试 36/36 通过；已移除随旧客户端退役的 Markdown/PlantUML 资源与远程构建脚本条目。
• 插件运行时状态写入平台数据目录（插件根下的 .state/<id>/<version>），不写 bundle 或安装目录。
• 完整生产打包、签名、更新与资源生命周期待验收。

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

• 修复项目树重复错误日志、卸载只删最新版本、暂存目录泄漏等缺陷。
• 旧代码债务与跟踪 Issue 尚需完整核对。
• 本次发现的两项重构债务已建单：[Feature] 将 Viva Git Log 提交改动文件的文件夹分组下沉到 Core #1814（改动文件分组下沉 Core）、[Feature] Viva Git Log 分支面板改用公共树列表 desktop/internal/treelist #1815（Git Log 分支面板改用 treelist）。

验证 / Verification

本批集成在 macOS 上验证，旧分支的结果不冒充本批结果：

命令或操作	结果
make -C desktop fmt-check；普通及 -tags dev 的 vet ./...	通过
desktop-go.sh test ./... -count=1 -timeout=600s	37 个有测试的包通过
pluginbackend / pluginservice / buildprovider / buildprocess 全包竞态；workbench 全包及最终 core / pluginlsp / workbench 受影响测试竞态	通过
test -tags dev ./internal/buildinfo；build ... ./cmd/lithe	通过
真实 clangd、官方 Cargo 内容及关键回归的逐项计时	12 条结果全部通过；报告 .artifacts/test-stability/integration.json / index.html（本地，不提交产物）
i18n 生成检查、用法检查及 40 项脚本测试	通过；10,617 条中英词条完整
功能矩阵结构及精确 PR base/head 变更门禁	通过；253 项能力
Agent Notes 校验	221 篇 active 笔记通过
runtime bundle immutability	macOS/Windows 资源路径静态检查通过，不等于发行包运行时验收
测试稳定性静态门禁、git diff --check	通过；静态扫描不覆盖 Go，Go 另跑竞态与计时
scripts/desktop/perf/editor-bench.sh（110 项，macOS M4）	改前 52 项超预算，改后 3 项（均为 FullPass，已说明）；只报告不阻塞
go -C desktop test ./internal/editor/... ./internal/editorview/...；desktop-go.sh vet ./...	通过
node --test scripts/desktop/perf/editor-perf-report.test.mjs	通过
架构名修复后 core / buildprovider / workbench / pluginbackend / pluginservice 测试与 vet	通过（本机 arm64；x64 路径由 Linux CI 验证）
工作树资源复用测试、Agent Notes 校验（含新增性能基线笔记）	通过
18748cc8f 变基到 72c2a92da 后：desktop-go.sh test ./... -count=1、vet ./...、gofmt -l；treelist、项目树按钮、Git Log 改动文件共 16 项新测试	通过
18748cc8f：i18n 生成与用法检查；功能矩阵结构及 72c2a92da..HEAD 变更门禁	通过；10,647 条词条，253 项能力
e92acfa84 变基到 60aadcaf3 后：desktop-go.sh test ./... -count=1（41 个包）、vet ./...、gofmt -l；标签栏、设置页、hscroll、跨行插入、Git Log 横向滚动共 14 项新增或扩展测试	通过
e92acfa84：i18n 生成与用法检查、测试稳定性门禁、功能矩阵结构及 60aadcaf3..HEAD 变更门禁	通过；10,711 条词条，254 项能力
d12cca7c9：desktop-go.sh test ./... -count=1（41 个包）、vet ./...、gofmt -l；localshell、termview 的 GOOS=windows 与 GOOS=linux 交叉 vet	通过
d12cca7c9：i18n 生成与用法检查、测试稳定性门禁、功能矩阵结构及 e92acfa84..HEAD 变更门禁	通过；10,714 条词条，254 项能力
7aea0ff17：desktop-go.sh test ./... -count=1（41 个包）、vet ./...、gofmt -l、测试稳定性门禁；新增测试的变异检查（换回 Ellipsis 时失败）	通过

未执行或仍有缺口：终端 ⌄ 菜单、终端标签栏横向滚动、细滚动条拖动、底部 42% 默认高度、Git Log 引用与作者行换行尚未在真实窗口验收；Windows 的 Shell 查找（Git Bash、PowerShell 7 等）与 Linux 的 Shell 列表只做了交叉 vet，未在真机运行，workbench 依赖 cgo 的 Core，无法交叉 vet；编辑器标签栏的滚动、隐藏标签列表、挤压与多行，以及 Git Log 改动文件横向滚动只有无头测试，尚未在真实窗口中用触控板验收；项目树按钮与 Git Log 改动文件折叠只有单元测试，尚未在真实窗口中点按验收；Windows/Linux 原生窗口与完整工作流、真实商业 Agent provider、市场正式语言插件端到端、完整打包发布与升级、插件 SDK 端到端；编辑器基线以外的跨平台性能基线、与 VS Code / Zed 的对照、真实窗口中的帧时间测量，以及优化后的 record。迁移分支中已移除的旧日志/Core 契约检查未当作通过；原生平台矩阵保持 pending。固定 Core 构建仍有既有 unused/dead-code 警告及本机 Rust 静态库 macOS 最低版本链接警告，本次未更改 Core 修订或发布兼容性声明。

最新 CI 以本 PR 推送后的运行结果为准，PR 保持 Draft。

提交前确认 / Final checks

• 目标分支为 preview，PR 保持 Draft。
• 全部本地门禁通过后再考虑 ready；本次按维护者要求先同步进行中的进度。
• 本次新增提交未包含 .artifacts/、编译产物、日志、截图或经定向扫描发现的凭据及机器专属用户目录。
• 本轮启动的本地 Lithe 对照实例和测试进程已关闭。