@zat-design/sisyphus-scene 4.6.1 → 4.6.2

package/README.md

@@ -6,14 +6,16 @@
 
 ## 安装
 
-需要 Node.js 18+、Sisyphus 4.x 和 Ant Design `>=6 <7`。默认安装 npm `latest` 稳定版：
+需要 Node.js 18+、Sisyphus 4.x 和 Ant Design `>=6 <7`。Node.js 20 可直接使用。选择 Codex 平台时，终端中的 Codex CLI 还需支持 `mcp list --json` 和 `mcp add`。默认安装 npm `latest` 稳定版：
 
 ```bash
 npx -y @zat-design/sisyphus-scene install --check
 npx -y @zat-design/sisyphus-scene install
 ```
 
-常用参数：`--global`、`--platform claude,cursor,codex`、`--skip-mcp`、`--skill sisyphus-scene-legacy`。
+常用参数：`--global`、`--platform claude,cursor,codex`、`--skip-mcp`、`--skill sisyphus-scene-legacy`。`--skip-mcp` 只安装 Skill，不提供组件 API/demo 查询能力；不需要 Codex 时可显式使用 `--platform claude,cursor`。
+
+Codex MCP 安装失败时，先在同一终端运行 `codex --version` 和 `codex mcp list --json`。若 Codex 命令非零退出且 stdout/stderr 为空，请检查当前终端实际命中的 Codex CLI 来源和兼容性；可临时使用 `--skip-mcp` 绕过 MCP，但这不代表 MCP 已安装。
 
 安装器会将 MCP 锁定到 Scene 自身精确版本。锁版或 beta 项目使用 `@<完整版本>`，并保持组件库、MCP 和 Scene 三包完全同版。
 

package/bin/sisyphus-scene.mjs

@@ -80,8 +80,7 @@ if (options.check) {
   process.exit(0);
 }
 
-const result = {
-  skill: JSON.parse(run('sync-platforms.mjs', [...skillArgs, '--write'])),
-};
+const result = {};
 if (configureMcp) result.mcp = JSON.parse(run('install-mcp.mjs', [...mcpArgs, '--write']));
+result.skill = JSON.parse(run('sync-platforms.mjs', [...skillArgs, '--write']));
 process.stdout.write(`${JSON.stringify({ mode: 'write', ...result }, null, 2)}\n`);

package/mcp/sisyphus-react.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@zat-design/sisyphus-react-mcp@4.6.1"
+        "@zat-design/sisyphus-react-mcp@4.6.2"
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zat-design/sisyphus-scene",
-  "version": "4.6.1",
+  "version": "4.6.2",
   "description": "Sisyphus 业务场景 Agent 技能，跨 Claude Code、Codex、Cursor 分发 Sisyphus 4 + Ant Design 6 场景与 MCP 配置",
   "type": "module",
   "license": "MIT",

package/scripts/install-mcp.mjs

@@ -74,24 +74,62 @@ const runCodex = (commandArgs) =>
     env: codexEnv,
   });
 
+const formatCodexFailure = (commandArgs, result) => {
+  const stdout = String(result.stdout || '').trim() || '(empty)';
+  const stderr = String(result.stderr || '').trim() || '(empty)';
+  return [
+    `command: codex ${commandArgs.join(' ')}`,
+    `status: ${result.status ?? '(empty)'}`,
+    `signal: ${result.signal || '(empty)'}`,
+    `stdout: ${stdout}`,
+    `stderr: ${stderr}`,
+    '请运行 codex --version 和 codex mcp list --json 确认当前 Codex CLI 兼容性；仅安装 Skill 可临时使用 --skip-mcp。',
+  ].join('\n');
+};
+
 const inspectCodex = () => {
   if (!fs.existsSync(codexHome)) {
-    const version = runCodex(['--version']);
-    if (version.error?.code === 'ENOENT') throw new Error('未找到 Codex CLI，无法配置 Codex MCP。');
-    if (version.status !== 0)
-      throw new Error(`Codex CLI 不可用：${version.stderr || version.stdout}`);
+    const commandArgs = ['--version'];
+    const result = runCodex(commandArgs);
+    if (result.error?.code === 'ENOENT') throw new Error('未找到 Codex CLI，无法配置 Codex MCP。');
+    if (result.status !== 0) {
+      throw new Error(`Codex CLI 不可用：\n${formatCodexFailure(commandArgs, result)}`);
+    }
     return { status: 'missing' };
   }
 
-  const result = runCodex(['mcp', 'get', 'sisyphus-react', '--json']);
+  const commandArgs = ['mcp', 'list', '--json'];
+  const result = runCodex(commandArgs);
   if (result.error?.code === 'ENOENT') throw new Error('未找到 Codex CLI，无法配置 Codex MCP。');
   if (result.status !== 0) {
-    const message = `${result.stderr || ''}${result.stdout || ''}`;
-    if (/not found|no mcp server/i.test(message)) return { status: 'missing' };
-    throw new Error(`读取 Codex MCP 配置失败：${message.trim()}`);
+    throw new Error(`读取 Codex MCP 配置失败：\n${formatCodexFailure(commandArgs, result)}`);
+  }
+
+  const output = String(result.stdout || '').trim();
+  if (!output) {
+    throw new Error(`Codex MCP 列表 JSON 为空：\n${formatCodexFailure(commandArgs, result)}`);
+  }
+
+  let values;
+  try {
+    values = JSON.parse(output);
+  } catch (error) {
+    throw new Error(
+      `Codex MCP 列表 JSON 解析失败：${error.message}\n${formatCodexFailure(commandArgs, result)}`,
+    );
+  }
+  if (!Array.isArray(values)) {
+    throw new Error(`Codex MCP 列表 JSON 必须是数组。\n${formatCodexFailure(commandArgs, result)}`);
+  }
+
+  const value = values.find((item) => item?.name === 'sisyphus-react');
+  if (!value) return { status: 'missing' };
+  if (value.enabled === false) {
+    throw new Error(
+      `${path.join(codexHome, 'config.toml')} 中的 sisyphus-react MCP 已禁用；请人工启用后重试。`,
+    );
   }
 
-  const value = JSON.parse(result.stdout);
   const transport = value.transport || value;
   const expectedArgs = server.args || [];
   if (transport.command !== server.command || !sameJson(transport.args || [], expectedArgs)) {
@@ -141,16 +179,19 @@ for (const platform of platforms) {
     const inspected = inspectCodex();
     if (inspected.status === 'missing' && write) {
       fs.mkdirSync(codexHome, { recursive: true });
-      const result = runCodex([
+      const commandArgs = [
         'mcp',
         'add',
         'sisyphus-react',
         '--',
         server.command,
         ...(server.args || []),
-      ]);
-      if (result.status !== 0)
-        throw new Error(`写入 Codex MCP 配置失败：${result.stderr || result.stdout}`);
+      ];
+      const result = runCodex(commandArgs);
+      if (result.error?.code === 'ENOENT') throw new Error('未找到 Codex CLI，无法配置 Codex MCP。');
+      if (result.status !== 0) {
+        throw new Error(`写入 Codex MCP 配置失败：\n${formatCodexFailure(commandArgs, result)}`);
+      }
     }
     results.push({
       platform,

package/skills/sisyphus-scene/assets/ai-contract.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.6.1",
+  "version": "4.6.2",
   "schemaVersion": 2,
   "tools": [
     "sisyphus-get-meta-status",

package/skills/sisyphus-scene/evals/fixtures/valid-decisions.json

@@ -8,13 +8,13 @@
     "apiEvidence": {
       "tool": "sisyphus-get-component-api",
       "target": "ProForm",
-      "libraryVersion": "4.6.1",
+      "libraryVersion": "4.6.2",
       "schemaVersion": 2
     },
     "demoEvidence": {
       "tool": "sisyphus-get-example",
       "target": "ProForm/demos/base.tsx",
-      "libraryVersion": "4.6.1",
+      "libraryVersion": "4.6.2",
       "schemaVersion": 2,
       "exampleId": "ProForm/demos/base.tsx"
     }
@@ -28,13 +28,13 @@
     "apiEvidence": {
       "tool": "sisyphus-get-component-api",
       "target": "ProTable",
-      "libraryVersion": "4.6.1",
+      "libraryVersion": "4.6.2",
       "schemaVersion": 2
     },
     "demoEvidence": {
       "tool": "sisyphus-get-example",
       "target": "ProTable/demos/base.tsx",
-      "libraryVersion": "4.6.1",
+      "libraryVersion": "4.6.2",
       "schemaVersion": 2,
       "exampleId": "ProTable/demos/base.tsx"
     }

package/skills/sisyphus-scene/references/approved-examples.yaml

@@ -7,7 +7,7 @@ examples: []
 #   status: approved
 #   application: xk-wjs-claim-web
 #   capabilities: [search-form, data-table, table-tabs, drawer-form]
-#   sisyphus_version: "4.6.1"
+#   sisyphus_version: "4.6.2"
 #   antd_range: ">=6 <7"
 #   paths:
 #     - src/pages/litigationManagement/index.tsx