[xiaoyumuxi]

背景

shared/contracts/plugins/v1/fixtures/ 原来有 70 多个平铺文件，proposals/toolchains/ 又单独放了一套示例，插件开发者在 lithe-plugin-docs 的 contract/v1/ 里找不到某个功能对应的清单和用例。契约 README 的能力版本表也有遗漏和重复。本 PR 只调整目录和路径、修正版本表，不改任何契约语义；fixture 内容除路径引用外逐字节不变。

改动

1. fixtures 按功能分目录

子目录	内容
manifest/	hello-lithe.plugin.json、invalid-manifests.json（跨领域的清单拒绝用例）
languages/（含 grammars/）	语言、语法、打包/系统命令语言服务器、Node 运行时、command-plans.json、runtime-versions.json
backend/	后端、命令后端、终端后端、后端工作区、function-protocol.json、plugin-logging.json
editor/	editor-actions.plugin.json
ui/	原生控件/表单/面板、网页面板
settings/	settings-v2.plugin.json
build-systems/	声明式构建（buildSystems）清单与 build-plans.json
build-providers/	构建提供者（buildProviders）清单与执行/测试/配置/调试准备协议用例
debug-adapters/	调试适配器清单与拒绝用例
vcs/	vcs-provider.plugin.json
keymap-import/	keymap-import-provider.plugin.json
project-generators/（含 templates/）	项目生成器清单、project-plans.json，模板从 project-generator-templates/ 移入 templates/
toolchains/（含 proposal/）	工具定义、工具链提供者清单；原 proposals/toolchains/fixtures/ 移入 proposal/
package-trust/	发布者签名向量、随包发布者清单
marketplace/	市场索引用例（原已是子目录，未改动）

• 项目生成器模板里的 Java 示例（dev.lithe.fixture.java-support、main/Main.java、java-tool-definition.json）按要求原样保留，只移动位置并修正引用路径。
• 用例文件只按文件名引用基础清单，所以各子目录之间文件名必须唯一。

2. toolchains 文档合并

• toolchains.md → toolchains/README.md
• proposals/toolchains/（README、manifest.md、protocol.md、4 个 schema）→ toolchains/proposal/
• 文档内的相对链接全部随之更新。

3. 顶层 schema 不动

plugin-manifest.schema.json、plugin-index.schema.json、native-ui.schema.json 的路径和 $id 都没变，已发布插件里写的 $schema URL 继续有效。

4. 契约 README 与 schema 的版本表修正

• serverProcess：补版本 2（新增 runSelectedRuntime，供调试适配器使用，属于 API 级别 4），并注明 v2 目前只有 Rust Core 支持，macOS 和 Windows 宿主都只声明 1。
• 构建提供者协议协商：宿主发送的 litheBuild 版本列表从 [8..1] 改为 Core 实际提供的 [11, 10, …, 1]，并补上版本 9（不透明语义测试选择器）、10（类型化运行选项与服务/任务运行准备）、11（注册表连接调试）的说明，与 build_provider.rs 一致。
• executableResolution：原来有两行重复，现合并为一行（v1 候选排序与严格选择；v2 增加工具定义候选，以及项目/子项目工具链注册表绑定）。
• 补上缺失的 keymapImportProviders 行（1，仅 macOS；Windows 尚未声明）。
• pluginAPIVersion 说明补上级别 4。
• plugin-manifest.schema.json 中 requires.buildSystems 的枚举补 4，描述写明 v2/v3/v4 各自新增的内容（与 capabilities.rs 的 SUPPORTED_CAPABILITIES 一致）；executionProviders 行修正缩进。

5. 校验脚本新增检查（scripts/architecture/verify-shared-contracts.sh）

• fixtures/ 根目录不得有散落文件，新 fixture 必须放进某个功能子目录。
• fixture 文件名在所有子目录间必须唯一。
• 原有校验的路径全部改到新目录。

6. 引用方同步

• Rust Core 测试（rust/lithe-core）里的 fixture 路径。
• macOS 测试（macos/Tests/LitheTests 下 38 个测试文件）的 fixture 路径。
• Windows：plugin_host/tests.rs 的 fixture_path 改为在 fixtures 下按文件名递归查找，web.rs 和 declarative-plugin-ui.test.ts 改为新路径。
• macos/Experiments/Monaco/workbench.integration.ts 的语法路径。
• .agents/notes、shared/contracts/rust-core-api.md、shared/contracts/vcs-provider-v1.md 中的路径链接。
• shared/platform-feature-matrix/features/*.json 中 25 个功能文件的证据路径。
• scripts/architecture/language-specifics-baseline.json 中键名改为新路径（计数不变）。

验证

• zsh scripts/architecture/verify-shared-contracts.sh：通过
• cargo test -p lithe-core：通过（1850 + 25 + 5 + 2 + 1，0 失败）
• node --test 'scripts/architecture/*.test.mjs'：17/17 通过
• 宿主语言特定内容闸门本地 ratchet：与基线一致
• node scripts/i18n/verify-app-language-localization.mjs、node scripts/i18n/generate-i18n.mjs --check：通过
• 平台功能矩阵校验：通过（240 项）
• 全仓库扫描旧的 fixtures/<文件名> 引用：无残留
• Windows：macOS 上无法编译 lithe-windows（project_window_registry.rs 使用 std::os::windows，与本 PR 无关），改用静态检查确认 tests.rs 用到的每个 fixture 名在子目录中恰好命中一次，web.rs 的相对路径存在；需要 Windows CI 跑实际测试。
• macOS Swift 测试（scripts/macos/test/test-macos.sh --filter，覆盖改了 fixture 路径的 38 个测试类）：
  • 首轮 38 个类一起跑（476 个测试）：4 个套件出现等待超时（DeadlineExceeded("session shutdown")、waitUntilOpen），没有任何 fixture 读取失败；
  • 只重跑这 4 个套件（102 个测试）：剩 1 个超时；
  • 单独跑剩下的 WorkbenchContributionHostTests：32/32 通过；
  • 失败测试引用的 fixture 路径都已逐一确认存在。超时数量随并发负载变化，与本 PR 的路径改动无关。

合并说明

• 语言特定内容闸门的 --base 对比会把改名后的 fixture 看成新增文件，所以会失败。这是预期行为，已确认直接合并，闸门不做改名识别。
• 未合并 PR 的变基：feat(plugins): 编辑器 Provider 与多车道编辑器动作（API-25、API-27） #1730、feat: 项目生成器增加通用工具字段（projectGenerators 2，API-33） #1740、feat(core): 插件函数跨插件中转（API-35 第一阶段） #1742、feat(plugin): 插件自有语言服务器会话与后端决定启动方式（API-25，含 API-12/20/22） #1745、feat(plugin-api): 插件后端发起原生运行与调试，声明调试适配器行为与输出链接（API-22/23/30） #1746 都在 fixtures 根目录新增了文件，或修改了 function-protocol.json / invalid-manifests.json。变基到本 PR 后：
  • 修改的文件跟到新位置：backend/function-protocol.json、manifest/invalid-manifests.json、project-generators/project-plans.json；feat(plugin-api): 插件后端发起原生运行与调试，声明调试适配器行为与输出链接（API-22/23/30） #1746 中的 toolchains.md 对应 toolchains/README.md。
  • 新增的文件放进对应子目录。例如 feat(plugin-api): 插件后端发起原生运行与调试，声明调试适配器行为与输出链接（API-22/23/30） #1746 的 run-start.json、debug-start.json、debug-adapter-features.plugin.json、output-link-matchers.json、tool-reference-launch.plugin.json 放进 debug-adapters/ 或 backend/；feat(plugin): 插件自有语言服务器会话与后端决定启动方式（API-25，含 API-12/20/22） #1745 的语言服务器用例放进 languages/；feat(core): 插件函数跨插件中转（API-35 第一阶段） #1742 的插件函数清单放进 backend/；feat: 项目生成器增加通用工具字段（projectGenerators 2，API-33） #1740 的项目生成器清单放进 project-generators/、模板放进 project-generators/templates/；feat(plugins): 编辑器 Provider 与多车道编辑器动作（API-25、API-27） #1730 的编辑器用例放进 editor/。
  • 新增的散落文件会被校验脚本直接拒绝，漏放会在 CI 失败。
• 合并后：在 lithe-plugin-docs 运行 node scripts/contract.mjs sync --revision <合并后的 preview commit>，并更新 SDK 测试、README 和 guides 中的 fixture 路径（会单独提 PR）。