[xiaoyumuxi]

关联 Issue / Linked issue

• Closes [Feature] 归档已迁出插件仓库的 Java/Maven/JDT/Spring Agent Note #1787
• Closes [Cleanup] 处理 windows/tauri/src/features/ai 历史遗留 AI 前端（无后端、默认不可用） #957
• Refs [Feature] 清理 Viva 资源复用清单与构建文档中的旧 Java 内置打包规则 #1905（worktree-resources.json 的旧客户端条目已在 Issue 评论里补充，不在本 PR 处理）
• Refs [Feature] 清理 Viva 重构后 Windows 计时执行器的失效 scope #1940（write-stable-tests 的旧计时执行器和静态扫描器已在 Issue 评论里补充，不在本 PR 处理）

PR 类型 / Type

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

改动说明 / What changes

背景 / Why

仓库现在只剩 Viva 桌面端（desktop/，Go）这一个客户端，Core 在 Lithe-core-rust。Java、Maven、Gradle、JDT 和 Spring 已迁到各自的插件仓库（#1495）。但 .agents/notes/、docs/ 和 Skill 参考页里，还有大量内容把已删除的 Swift macOS 客户端（macos/）、Tauri Windows 客户端（windows/tauri/）、仓内 rust/ 和内置 Java 支持写成当前实现：

• 文中的路径、测试命令和验收步骤已经不存在。
• 一部分笔记写着“待迁移”“以后再改”，却说不清 Viva 现在到底做了什么。
• Agent 按这些笔记工作时，会去找不存在的文件，或者把旧客户端的验收当成 Viva 已通过。

本 PR 把这些内容分三类处理：

1. 只描述旧实现、Viva 不沿用的笔记：归档。
2. 决策仍然有效、只是路径和验证过时的笔记：改写到 Viva 和 Core 的当前实现。
3. 对现状仍然准确的内容：保留。

改动 / Changes

Agent Note：归档 70 篇（移到 .agents/notes/archived/，状态改为“已实现”，加 归档日期：2026-11-15，开头写明归档原因和现在的归属）

• 旧 Swift macOS 客户端和 Tauri Windows 客户端独有的实现：例如 Windows Git Log 滚轮动画和日期格式、Windows 终端直链、Windows 设置控件和分组、macOS 设置窗口恢复、macOS 共享滚动条、Agent 对话（ACP）及其生命周期提示、Windows 声明式插件宿主。
• 已迁到插件仓库的 Java、Maven、Gradle、JDT 和 Spring 笔记（[Feature] 归档已迁出插件仓库的 Java/Maven/JDT/Spring Agent Note #1787）：例如 maven-java-domain-plugin-migration、java-support-independent-distribution、jdtls 堆上限、Gradle 导入设置、Spring 索引、Maven 运行诊断、JVM 性能监控、Java New 菜单模板。
• 远程 SSH 连接等 Viva 尚未接入、旧实现也不再沿用的笔记。
• Tauri AI 前端相关的笔记（[Cleanup] 处理 windows/tauri/src/features/ai 历史遗留 AI 前端（无后端、默认不可用） #957）。代码本身已经由 Epic(0.7.0): 基于 Viva 框架的跨平台方案的迁移（#1794） #1799 删除，本 PR 只归档笔记。

Agent Note：改写 118 篇（104 篇已实现，14 篇提议中）

• “适用范围”“验证”和正文路径，从 macos/Sources/...、windows/tauri/... 和仓内 rust/... 改成 desktop/internal/... 的实际文件，以及 Lithe-core-rust 的 crate 链接。swift test、bun run 这类命令改成 scripts/desktop/desktop-go.sh test ./internal/<包>，每个包路径都核对过存在。
• 指向 Core main 的 9 处链接，从已拆分的旧单体 rust/lithe-core/src/... 改成 crate 布局，例如 rust/crates/git/src/metadata_watch.rs、rust/crates/text/src/edits.rs、rust/crates/plugin-manifest/src、rust/crates/ai。钉在固定修订（例如 0ffd327、5a54c41）上的永久链接保持不变。
• “Viva 迁移状态”横幅去掉日期流水账。“待迁移的目标边界”这类说法改成写清 Viva 现在做了什么、还缺什么。
• 提议中的调试五篇（统一调试引擎、可选调试扩展、插件依赖与导出、调试网络路径、SSH 远端适配器）改写为桌面端现状：desktop/internal/workbench/debug_*.go 和 Core rust/crates/debug。删除了 Xcode、SwiftUI 的实施细节。
• 提议中的 plugin-injected-toolchains、java-extraction-generic-apis-and-gate、single-repository-git-status-observation 改写到 desktop/internal/toolchain、desktop/internal/workbench/git_observation.go 和 Core 的当前状态。仍缺的能力写成明确的缺口，而不是“待迁移”。
• go-php-community-plugins：第 5 节改写为当前残留，即空的官方索引只供 desktop/internal/marketplace 测试使用；删除已不存在的 scripts/plugins/... 适用范围。
• 活跃笔记不再链接 archived/。原来指向已归档笔记的地方改成一句文字说明，或者删除。

docs/

• 删除只服务旧客户端的文档：docs/development/windows-plugin-parity-plan.md、docs/architecture/macos-updates.md、docs/releases/windows-updater.md、docs/performance/macos-interaction-baseline.md、docs/agent-classic-layout-visual-check.md、docs/plugin-executable-layout-visual-check.md，以及没有引用的截图目录 docs/assets/agent-classic-layout/、docs/assets/plugin-executable-layout/。
• docs/ci-builds.md（676 → 232 行）：
  • 工作流表按 desktop-ci.yml、desktop-release.yml 和 desktop-autobuild.yml 的实际触发条件和 job 重写。例如 Desktop CI 的 push 只触发 preview；Draft PR 只跑 Linux。
  • AutoBuild 一节改写为 prepare、build、publish 三步，删除 Sparkle、appcast 和 release-preview-macos.yml。
  • “独立工作树的本地编译”只保留 Viva 的条目，删除 Swift、SwiftPM、Bun、ConPTY、PHP 和 Agent Hook。日志检查改为 desktop/internal/logwindow/visual_capture_test.go。
  • [Feature] 清理 Viva 资源复用清单与构建文档中的旧 Java 内置打包规则 #1905 要处理的“可下载的官方插件包”段落原样保留。
• docs/development/desktop-getting-started.md、document-encoding.md、windows-ai-commit.md、issue-1495-...、macos-plugin-api-plan.md：删除旧客户端命令和路径，链接改到归档位置或当前实现。

Skill 参考页

• develop-lithe/references/scripts.md：scripts/ci/common/ 实际不存在。改为说明“被两个及以上工作流共用的脚本才放这里，目前没有”，删除旧的“变更分类、车道复用”描述。
• develop-lithe/references/macos-ui.md：改为“原版视觉与交互基线”。
  • 14 个 macos/... 路径都用 git cat-file -e 在 5a54c41 下核对存在，然后改成固定修订的永久链接。
  • 统一入口表新增“Viva 对应实现”列：ui.Menu、ui.ContextMenu、ui.Combobox、ui.Select，每项附本仓库的调用处。共享行尺寸和 8pt 菜单外层圆角目前没有共享实现，表中如实写明。
  • SwiftUI、AppKit、Monaco 的类名和测试名改成平台无关的规则；删除 Agent 任务输入的条目。
  • 滚动条几何指向 desktop/internal/uistyle/uistyle.go 的 Bars；验证范围改为在 desktop/ 下运行受影响包的 Go 测试。
  • develop-lithe/SKILL.md 中指向这一页的两处链接文字同步改名。
• develop-lithe/references/scrolling-content.md、lithe-code-review 的 finding-severity.md、submit-lithe-issue 的 environment-checklist.md、write-stable-tests 的 test-reporting.md：删除旧客户端路径和命令。

不在本 PR 范围内 / Out of scope

• scripts/resources/worktree-resources.json 里的旧客户端条目：swiftpm、bun、conpty、agent-、remote-、sparkle-baseline-staging 等。清理它们要同步改复用脚本的校验路由和测试，已补充到 [Feature] 清理 Viva 资源复用清单与构建文档中的旧 Java 内置打包规则 #1905。
• write-stable-tests 的 run-swift-tests-with-timing.mjs、run-bun-tests-with-timing.mjs，以及 verify-test-stability.mjs 的旧目录分类，已补充到 [Feature] 清理 Viva 重构后 Windows 计时执行器的失效 scope #1940。补充内容包括一个缺口：这个扫描器不覆盖 Go，对当前客户端没有任何检查。
• i18n 脚本里扫描 macos/Sources 的死代码，已记录在 [Feature] 统一 Viva 桌面文案的共享 i18n 来源与校验 #1807。
• docs/development/macos-plugin-api-plan.md 状态列的重新核对，以及 issue-1495 剩余台账的重新定基线：这两项需要逐项核对 Viva 实现，本 PR 只修了失效链接。
• docs/development/windows-ai-commit.md 的文件名：保留原名，避免已有外部链接失效。
• 功能矩阵 legacy 段里指向旧路径和已归档笔记的证据：它们钉在旧客户端修订 5a54c41，在该修订下是正确的，所以不改。
• docs/viva-migration.md 的历史段落。

---

类型专属：docs

• 只改文档、Agent Note、Skill、入口文件等，没有产品代码的行为变化（有则改选 feat 或 fix）
• 长期决策、取舍和约束写在 .agents/notes/（中文），docs/ 只保留操作说明、正式 schema、发布说明和验收材料；改了 Note 已运行 ./scripts/agent-notes/verify-agent-notes.sh
• 规则只在真源（Skill、Note）里写一份，入口文件只留指针，没有复制出会漂移的第二份
• 文中的路径、命令、链接已核对真实存在（反引号里的仓库路径、desktop-go.sh test 包路径和 Core main 链接，都已用脚本对照本工作树和固定 Core 检出核对；剩余未命中的都是 Core 仓库路径、示例或生成文件）
• [N/A] 涉及插件契约或宿主方法的，已完成下方“插件契约”一组（不涉及契约）

---

范围检查 / Scope checks

功能矩阵 / Feature matrix

N/A：没有改宿主能力。legacy 段的证据路径钉在 5a54c41，不改；已运行 ./scripts/platform-feature-matrix/verify-platform-feature-matrix.sh。

插件归属 / Plugin ownership

• 已在仓库根目录运行 develop-lithe 第三节“插件归属与宿主零依赖”的自查命令，结果为空
• [N/A] 新增或修改的测试只使用测试内联的合成插件、Core 契约 fixture 或插件市场索引快照（没有改测试）
• [N/A] 没有为具体插件提供的能力新建或更新宿主功能矩阵条目（没有改功能矩阵）
• 插件文案没有写进 shared/i18n/；插件的构建步骤、资源路径和补丁没有写进 scripts/resources/、docs/ci-builds.md、Agent Note 或 Skill（本 PR 反而删除了笔记里的 Java 和 Maven 构建细节，改成指向插件仓库）
• [N/A] 修改了通用扩展点、可能影响已发布插件的（没有改扩展点）

UI 验证 / UI evidence

N/A：只改文档。

统一日志系统 / Structured logging

N/A：只改文档。

界面文案 / i18n

N/A：没有改界面文案。已运行两个 i18n 检查，确认没有受影响。

逻辑归属 / Logic placement

N/A：没有改业务逻辑。

性能与内存 / Performance and memory

N/A：只改文档。

设置 / Settings

N/A：只改文档。

插件契约 / Plugin contract

N/A：不涉及契约。

发行包与资源 / Bundle and resources

N/A：没有改运行时资源和构建步骤。docs/ci-builds.md 的资源说明只删除了已不存在的旧客户端条目；worktree-resources.json 未改，其旧条目由 #1905 处理。

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

• 本次改动导致变成无用的代码已在本 PR 删除（删除了不再被引用的截图目录）
• 本次之前就存在的无用代码或可重构之处，已登记到已有 Issue，没有在本 PR 顺手处理：[Feature] 清理 Viva 资源复用清单与构建文档中的旧 Java 内置打包规则 #1905、[Feature] 清理 Viva 重构后 Windows 计时执行器的失效 scope #1940、[Feature] 统一 Viva 桌面文案的共享 i18n 来源与校验 #1807（按“少开 Issue”原则补充到同类单子，没有另开新单）

---

验证 / Verification

命令或操作	平台	结果
./scripts/agent-notes/verify-agent-notes.sh	macOS	通过（155 篇活跃 Note）
node scripts/i18n/verify-app-language-localization.mjs	macOS	通过
node scripts/i18n/generate-i18n.mjs --check	macOS	通过（中英各 11217 条，完整）
./scripts/platform-feature-matrix/verify-platform-feature-matrix.sh	macOS	通过（191 项能力）
node scripts/resources/test-reuse-worktree-resources.mjs	macOS	32/32 通过
插件归属自查 rg（develop-lithe 第三节）	macOS	结果为空
反引号仓库路径和 desktop-go.sh test 包路径核对（临时脚本，对照本工作树）	macOS	除 Core 仓库路径、示例 docs/a.png 和生成文件 lithe-mcp.bin 外全部存在
Core main 链接核对（对照 PINNED_CORE_REVISION 的 Core 检出）	macOS	92 个链接全部存在
已删除或移动文件的引用扫描	macOS	只剩功能矩阵 legacy 段（钉在 5a54c41）和 docs/viva-migration.md 历史段落

未能执行的检查和原因：

• ./scripts/desktop/verify/verify-runtime-bundle-immutability.sh：本 PR 不改运行时资源、构建脚本和产品代码，没有运行。
• 没有编译或运行 Viva，也没有在 Windows 虚拟机上验证：只改了文档。

提交前确认 / Final checks

• 分支从最新的 preview 创建；目标分支：feat、fix、docs 为 preview，release 以发布流程要求为准
• 以 Draft 提交，本地验证通过后才标记 ready
• 没有无关改动，没有提交 .build/、target/、dist/、.artifacts/ 等产物，没有凭据、个人路径和未脱敏的日志或截图
• 本次构建、测试或预览启动的 Lithe 应用和子进程已全部关闭，没有进程残留（本次没有启动 Lithe）