完成 DirectProject 扩展导入阶段零

补充阶段零输入分类、拆分和命名契约。新增 Skill、MCP、Plugin、混合来源和未知文件样例。记录阶段零的验证基线。
2026-08-31 09:59:52 +00:00
parent 8bae66108a
commit bd812093f0
13 changed files with 162 additions and 0 deletions
@@ -0,0 +1,26 @@
+# DirectProject 扩展导入阶段 0 样例
+
+本目录只保存导入分类和命名契约使用的最小样例，不作为运行时扩展安装目录。阶段 0 不启动其中的 MCP，也不执行 Skill 中的脚本。
+
+## 样例与预期
+
+| 样例 | 预期拆分 | 备注 |
+| --- | --- | --- |
+| `single-skill/` | 1 个 Skill：`single-skill` | 根目录 `SKILL.md` |
+| `multi-skill/` | 2 个 Skill：`art-skill`、`code-skill` | 一个 Skill root，分别导入 |
+| `mcp-config/` | 2 个 MCP：`search`、`filesystem` | 原生 `config.toml` |
+| `mcp-json/` | 2 个 MCP：`search`、`filesystem` | 兼容 `.mcp.json` |
+| `plugin/` | 1 个 Skill：`plugin-skill` | Plugin 只作为导入来源 |
+| `mixed-source/` | 1 个 Skill：`mixed-skill`、2 个 MCP：`search`、`filesystem` | 一个来源拆成多个独立项 |
+| `unknown/` | 1 个未知项：`unknown.bin` | 不执行、不作为 MCP 入口 |
+
+`mixed-source/` 表示目录或 zip 解压后的标准内容。实际 zip 测试可以在测试运行时将该目录压缩为临时归档，不把生成的二进制 zip 提交到仓库。
+
+## 阶段 0 固定规则
+
+- 一个来源里的每个 Skill 和每个 MCP Server 都是独立扩展项。
+- 导入后已识别项默认启用；未知项保留但不可启动。
+- 同名或重复内容再次导入时保留新项，名称使用原生标识追加 `-2`、`-3`。
+- 前端列表名称和 Codex 运行时名称相同，不维护两套名称。
+- 单个可执行文件或脚本不提供手动指定为 MCP 入口的功能。
+- Plugin 只提取支持的 Skill/MCP，不开启 hooks、apps 或完整 Plugin Runtime。
@@ -0,0 +1,67 @@
+{
+  "schemaVersion": "direct-project-extension-fixture.v1",
+  "cases": [
+    {
+      "id": "single-skill",
+      "source": "single-skill",
+      "items": [
+        { "type": "skill", "name": "single-skill" }
+      ]
+    },
+    {
+      "id": "multi-skill",
+      "source": "multi-skill",
+      "items": [
+        { "type": "skill", "name": "art-skill" },
+        { "type": "skill", "name": "code-skill" }
+      ]
+    },
+    {
+      "id": "mcp-config",
+      "source": "mcp-config/config.toml",
+      "items": [
+        { "type": "mcp", "name": "search" },
+        { "type": "mcp", "name": "filesystem" }
+      ]
+    },
+    {
+      "id": "mcp-json",
+      "source": "mcp-json/.mcp.json",
+      "items": [
+        { "type": "mcp", "name": "search" },
+        { "type": "mcp", "name": "filesystem" }
+      ]
+    },
+    {
+      "id": "plugin",
+      "source": "plugin",
+      "items": [
+        { "type": "skill", "name": "plugin-skill" }
+      ],
+      "ignoredCapabilities": ["hooks", "apps", "remote_plugin"]
+    },
+    {
+      "id": "mixed-source",
+      "source": "mixed-source",
+      "items": [
+        { "type": "skill", "name": "mixed-skill" },
+        { "type": "mcp", "name": "search" },
+        { "type": "mcp", "name": "filesystem" }
+      ]
+    },
+    {
+      "id": "unknown",
+      "source": "unknown/unknown.bin",
+      "items": [
+        { "type": "unknown", "name": "unknown.bin", "launchable": false }
+      ]
+    }
+  ],
+  "duplicateImport": {
+    "source": "single-skill",
+    "items": [
+      { "type": "skill", "name": "single-skill-2" }
+    ],
+    "preserveOriginal": true
+  }
+}
@@ -0,0 +1,5 @@
+[mcp_servers.search]
+command = "fixture-search"
+
+[mcp_servers.filesystem]
+command = "fixture-filesystem"
@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "search": {
+      "command": "fixture-search"
+    },
+    "filesystem": {
+      "command": "fixture-filesystem"
+    }
+  }
+}
@@ -0,0 +1,5 @@
+[mcp_servers.search]
+command = "fixture-search"
+
+[mcp_servers.filesystem]
+command = "fixture-filesystem"
@@ -0,0 +1,8 @@
+---
+name: mixed-skill
+description: Stage 0 fixture for a source containing independent Skill and MCP entries.
+---
+
+# Mixed Source Skill Fixture
+
+This fixture is used only to verify independent import items.
@@ -0,0 +1,8 @@
+---
+name: art-skill
+description: Stage 0 fixture for an imported art Skill.
+---
+
+# Art Skill Fixture
+
+This fixture is used only to verify that one Skill root becomes independent items.
@@ -0,0 +1,8 @@
+---
+name: code-skill
+description: Stage 0 fixture for an imported code Skill.
+---
+
+# Code Skill Fixture
+
+This fixture is used only to verify that one Skill root becomes independent items.
@@ -0,0 +1,6 @@
+{
+  "name": "stage-0-fixture-plugin",
+  "version": "0.1.0",
+  "description": "Fixture for extracting standard Skill content from a Plugin source.",
+  "skills": "./skills/"
+}
@@ -0,0 +1,8 @@
+---
+name: plugin-skill
+description: Stage 0 fixture for a Skill contained in a Plugin.
+---
+
+# Plugin Skill Fixture
+
+This fixture is used only to verify Plugin source extraction.
@@ -0,0 +1,8 @@
+---
+name: single-skill
+description: Stage 0 fixture for a single imported Skill.
+---
+
+# Single Skill Fixture
+
+This fixture is used only to verify discovery and naming.
@@ -0,0 +1 @@
+This is an inert unknown-file fixture. It must never be executed as an MCP server.
@@ -384,6 +384,8 @@ remove_client_extension(id)

 准备最小样例并确认每个样例的预期拆分结果。

+阶段 0 样例位于 `apps/ai-game-creator-shell/src-tauri/tests/fixtures/direct_extensions/`，其 `README.md` 和 `expected-imports.json` 是本阶段输入分类、拆分和命名预期的机器可读/人工可读基线。zip 场景使用 `mixed-source/` 在测试运行时生成临时归档，不提交生成的二进制 zip。
+
 ### 阶段 1：客户端导入和列表

 完成：
				`@@ -0,0 +1 @@`
				`This is an inert unknown-file fixture. It must never be executed as an MCP server.`