@sokeai/cli 1.0.76 → 1.0.78

package/skills/ai-coach-director/references/env-check.md

@@ -1,167 +0,0 @@
-# soke-cli 环境检测
-
-独立于页面/创作管线，仅在需要调用平台接口时执行。
-
----
-
-> ⚠️ **沙箱绕过（全局规则）**：soke-cli 是 Go 编译的二进制文件，在 WorkBuddy Bash 工具沙箱中执行会受限（表现为 `permission denied`、`operation not permitted`、静默无输出）。**以下所有命令在 WorkBuddy 平台调用 Bash 工具时必须设置 `dangerouslyDisableSandbox: true`**。悟空/QClaw/Zework 等平台的沙箱机制不同，按各平台适配器（`platform/adapters/`）的规则执行，一般无需此参数。
-
-> 📱 **跨平台检测策略（v2.4）**：Step 0 检测按当前运行平台自动选择策略——WorkBuddy 用 `dangerouslyDisableSandbox: true` + soke-cli CLI 命令；悟空/QClaw/Zework 直接执行 CLI（无 WorkBuddy 沙箱限制）；纯聊天平台可跳过 Node.js/soke-cli 安装检测，直接引导用户获取 Token 并通过 REST API（`platform/api-fallback.md`）验证连通性。
-
----
-
-## 检测流程
-
-按顺序执行，任一步不通过则先按本文件修复流程处理；只有确认 CLI 与登录态可用后才继续平台同步。
-
-> ⚠️ **soke-cli 多版本与配置修复优先级**：如果默认 `soke-cli` 路径异常，不要反复重试同一个命令。按本文件「多版本故障降级」寻找可用二进制。
-
-### 1. Node.js 版本
-
-```bash
-node --version
-```
-
-- ✅ >= 14.0.0 → 通过
-- ❌ 未安装或版本过低 → 提示：`需要 Node.js >= 14.0.0，请先安装或升级`
-- ❌ `command not found` → 提示安装 Node.js
-
----
-
-### 2. soke-cli 安装
-
-```bash
-which soke-cli && soke-cli --version
-```
-
-- ✅ 输出版本号 → 继续执行 `soke-cli config show` 验证该路径是否真的可用
-- ⚠️ 输出版本号但后续命令报 `spawn Unknown system error -88` / Exit 137 / panic → 不视为通过，立即进入「多版本故障降级」
-- ❌ `command not found` → 执行安装：
-
-```bash
-mkdir -p ~/.npm-global
-npm config set prefix ~/.npm-global
-echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
-source ~/.zshrc
-npm install -g @sokeai/cli@latest
-```
-
-安装后重新执行 `which soke-cli && soke-cli --version` 验证。
-
-> Windows：将 `~/.zshrc` 替换为 PowerShell profile 路径，PATH 追加方式不同（见安装指南 Q2）。
-
-#### 2.1 多版本故障降级
-
-当默认 `soke-cli` 出现以下任一现象时，必须切换可用路径，而不是继续重试：
-
-- Node wrapper 报 `spawn Unknown system error -88`
-- 直接执行 Go 二进制无输出并 Exit 137
-- `config show` panic：`slice bounds out of range [-4:]`
-- `config show` 因短 token、空 token、`test_token_12345` 等占位值触发崩溃
-
-按以下顺序探测候选路径，选择第一个同时满足 `--version`、`config show`、`auth login` 可执行的路径：
-
-```bash
-which -a soke-cli
-/Users/edy/soke-cli/soke-cli/soke-cli --version
-/Users/edy/Library/Application\ Support/QClaw/npm-global/bin/soke-cli --version
-/Users/edy/.nvm/versions/node/v22.22.1/bin/soke-cli --version
-```
-
-已知可用经验：在 edy 的 macOS 环境中，`/Users/edy/soke-cli/soke-cli/soke-cli`（v1.0.30）可正常执行 `config show` 和 `auth login`，可作为新版 v1.0.66 panic 时的优先 fallback。
-
-若 fallback 路径可用，后续本轮所有 `soke-cli` 命令都必须使用该绝对路径，不再调用默认 PATH 中的 `soke-cli`。
-
----
-
-### 3. 登录状态
-
-```bash
-soke-cli config show
-```
-
-- ✅ 输出含 `user_token` / `UserToken` 且长度充足、非占位值 → 通过，进入下一步企业绑定检查
-- ❌ 无 `user_token` / `UserToken`、值为空、值为 `test_token_12345`、或长度不足 4 → 执行登录：
-- ⚠️ `config show` panic 但存在 `~/.soke-cli/config.json` → 可用 Read 工具读取配置文件判断字段是否存在，但**不得在对话中展示 Token 原文**；若 token 为空/占位/长度不足，按未登录处理
-
-```bash
-soke-cli auth login
-```
-
-自动打开浏览器完成 OAuth 授权。如果浏览器未自动打开，复制终端显示的链接手动打开。
-
-登录完成后重新执行 `soke-cli config show`，确认 `user_token` 已存在。
-
-- ❌ 返回 `401 Unauthorized` → Token 过期，重新登录：
-
-```bash
-soke-cli auth logout
-soke-cli auth login
-```
-
-登录成功后重新执行 `soke-cli config show`，确认 `user_token` 已恢复。
-
----
-
-### 4. 企业绑定（corp binding）
-
-```bash
-soke-cli config show
-```
-
-依次检查以下字段是否存在且非空：
-- `implementation_corp_id`
-- `corpid`
-- `CorpID`（旧版配置文件字段）
-
-判定规则：
-- ✅ `implementation_corp_id` 非空 → 通过，后续优先使用该字段
-- ✅ `implementation_corp_id` 为空，但 `corpid` / `CorpID` 非空 → 通过，后续可使用该字段
-- ❌ 全部为空 → 提示用户：
-  > 已登录，但当前账号未绑定企业。请先在授客AI平台完成企业绑定，再重新执行 `soke-cli auth login --force`
-
-如需强制刷新企业绑定信息，执行：
-
-```bash
-soke-cli auth login --force
-```
-
-完成后重新执行 `soke-cli config show`，确认 `implementation_corp_id` 或 `corpid` 至少一个非空。
-
-如果仍为空，说明当前账号未加入任何企业，需联系管理员添加。
-
----
-
-## 常见故障速查
-
-| 现象 | 原因 | 修复 |
-|------|------|------|
-| `which soke-cli` 无输出但已安装 | PATH 未生效 | `source ~/.zshrc` 或新开终端 |
-| `config show` panic: `slice bounds out of range [-4:]` | 新版 CLI 对短 token / 空 token 脱敏时切片越界 | 进入 2.1 多版本故障降级；优先用 `/Users/edy/soke-cli/soke-cli/soke-cli config show`；必要时读取 `~/.soke-cli/config.json` 判断登录态 |
-| Node wrapper `spawn Unknown system error -88` | npm wrapper 无法 spawn Go 二进制 | 避免默认 wrapper，改用可运行的本地二进制绝对路径 |
-| Go 二进制无输出 Exit 137 | 当前二进制在环境中被系统杀死或不兼容 | 切换多版本候选路径；不要重复调用同一路径 |
-| 配置中 `UserToken` 为 `test_token_12345` | 测试占位 token，非有效登录 | 按未登录处理，执行 `auth login` |
-| `401 Unauthorized` | Token 过期 | `soke-cli auth logout && soke-cli auth login` |
-| 登录时浏览器未打开 | 系统无默认浏览器 | 手动复制终端链接到浏览器 |
-| `npm: command not found` | Node.js 未安装 | 安装 Node.js >= 14 |
-| `EACCES` 权限错误 | npm 全局安装需要 sudo | 使用 `~/.npm-global` 方案（见步骤2） |
-| `implementation_corp_id` / `corpid` 为空 | 未绑定企业 | `soke-cli auth login --force` 重新授权，或联系管理员 |
-| `permission denied` / 静默无输出 | soke-cli 在 WorkBuddy 沙箱中受限（Go 二进制） | Bash 工具设置 `dangerouslyDisableSandbox: true` 重试 |
-| 悟空/QClaw 中 soke-cli 不可用 | 平台安全策略或未安装 | 跳过 CLI 检测，按 `platform/api-fallback.md` 用 Token 验证 API 连通性 |
-
----
-
-## 使用方式
-
-```
-# 在 ai-coach-director 中
-read references/env-check.md
-按顺序执行 4 步检测：
-  1. node --version
-  2. which soke-cli && soke-cli --version；若默认路径异常，按 2.1 多版本故障降级选择可用绝对路径
-  3. <可用soke-cli路径> config show → 确认 user_token/UserToken 非空、非 test_token_12345、长度充足
-  4. <可用soke-cli路径> config show 或 ~/.soke-cli/config.json → 确认 implementation_corp_id / corpid / CorpID 至少一个非空
-全部通过 → 记录企业 ID，继续调度
-补充约定：后续场景更新命令默认优先使用 `--request-file <partX-update.json>`；仅在排障时才改用 `--operations-file`。
-任一步失败 → 按修复流程引导用户，不进入内容生成/同步
-```

package/skills/ai-coach-director/references/platform-api-pitfalls.md

@@ -1,232 +0,0 @@
-# 平台 API 踩坑清单
-
-> 记录 AI 陪练场景在真实 MentorAI 平台同步过程中的已验证差异。优先级高于历史示例；当文档、经验和平台返回冲突时，以本文件 + 最新 CLI 实证为准。
-
-> 需要复制标准命令时，统一参考 `verified-cli-cheatsheet.md`，避免误写成顶层 `soke-cli +...`。
-
-> 同步请求结构额外对齐附件《比得_AI陪练CLI创建与更新场景使用指南 2.0》：默认优先 `--request-file <partX-update.json>` 传完整更新请求；仅在排障或拆解问题时退回 `--operations-file` + `--base-updated-at` 模式。
-
-## 1. Step2 / Part3 对话流程不能整包替换
-
-- 历史误区：使用 `replace_conversation_steps`
-- 真实结果：422 校验失败
-- 已验证做法：改用 `add_conversation_step` / `patch_conversation_step` / `remove_conversation_step` / `reorder_conversation_steps`
-- 备注：字段名必须是 `step_name`，不是 `name`
-
-## 2. Step3 / Part4 评分配置必须包在 `data.config`
-
-- 历史误区：把 `criteria_data` 直接平铺在 `data` 下，或在 `config` 与 `criteria_data` 之间缺失层级
-- 真实结果：`replace_scoring_criteria_config 必须提供 config` 或平台 UI 不显示评分配置
-- 已验证做法：使用 `data.config.criteria_data`（完整的三层嵌套），不可省略 `config` 或 `criteria_data` 任一层级
-
-## 2.1 Part4 `replace_scoring_criteria_config` 缺少外壳字段导致 UI 不渲染
-
-- 历史误区：`data.config` 下只传了 `criteria_data`，缺少外壳字段
-- 真实结果：API apply 成功，但平台 UI 不显示评分配置
-- 已验证做法：`data.config` 必须同时包含：
-  - `scenario_criteria_id`：场景内评分标准唯一标识（格式 `criteria_{场景短码}`）
-  - `customization_level`：固定 `"full"`
-  - `is_custom_criteria`：固定 `true`
-  - `customized_fields`：固定 `["criteria_data"]`
-  - `criteria_data`：评分标准正文（直接在 config 下，完整三层嵌套：`data.config.criteria_data`）
-- 备注：缺少任一外壳字段或层级缺失，平台 UI 无法识别和渲染评分配置模块
-
-## 2.2 Part4 `criteria_data` 和维度缺少内部元数据字段
-
-- 历史误区：`criteria_data` 只传了 `name`、`description`、`dimensions`，缺少内部元数据；维度缺少 `id` 和 `sort_order`
-- 真实结果：数据存储但 UI 展示不完整或维度顺序不可控
-- 已验证做法：
-  - `criteria_data` 必须包含：`source_type`（固定 `"enterprise"`）、`total_weight`（固定 `100`）、`tags`（取 Part1 标签前 4 个）
-  - 每个维度必须包含：`id`（格式 `dim_{code}`）、`sort_order`（从 1 递增）
-- 参考：`比得_AI陪练CLI创建与更新场景使用指南.md` 第 6.4 节
-
-> 生成 `part4-operations.json` 后，preview 前**必须逐项核对** `platform/sync-engine.md` 中的「Part4 replace_scoring_criteria_config 自查清单」（13 项），任一项不通过禁止 preview。
-
-## 3. Step1 创建场景必须先准备封面
-
-- 历史误区：只传 name / description / tags 就能建场景
-- 真实结果：`soke-cli ai-training +create-scenario` 报缺少 `scenario_cover`
-- 已验证做法：先上传封面，再把 `scenario_cover` URL 写入 `step1-create.json`
-
-## 3.1 Step1 创建场景必须传 `key_points` 和 `scene_lang`
-
-- 历史误区：`step1-create.json` 只写 name / description / tags，没写 key_points / scene_lang
-- 真实结果：创建成功但场景不完整，或者平台校验报缺少必填字段
-- 已验证做法：`step1-create.json` 必须包含六个字段：`name`, `description`, `tags`（数组）, `key_points`（字符串，不能用数组）, `scene_lang`（固定 `简体中文`）, `scenario_cover`
-- `key_points` 来源：将 Part1 的考核关键点拼接为单个字符串（分号或编号分隔），不能直接传数组
-
-## 3.5 opening_dialogue_type 是整数，不是字符串
-
-- 历史误区：传入 `"opening_dialogue_type": "2"` 或 `"opening_dialogue_type": "customer_first"`
-- 真实结果：`VALIDATION_ERROR: opening_dialogue_type 必须是 1 或 2`
-- 已验证做法：`"opening_dialogue_type": 1`（AI 先开口）或 `"opening_dialogue_type": 2`（学员/客户先开口），传数字不传字符串
-- 影响文件：`sync-engine.md` Part2 字段映射表、`step2-operations.json` 示例
-
-## 3.6 --operations-file 直接放数组，不要 {"operations": [...]} 包装
-
-- 历史误区：operations JSON 套一层 `{"operations": [...], "step_name": "..."}`
-- 真实结果：`解析 JSON 失败 .../operations.json: json: cannot unmarshal object into Go value of type []interface {}`
-- 已验证做法：文件内容为裸数组 `[{type: "...", data: {...}}, ...]`，不套外层对象
-- 影响：所有 `part2/3/4/5-operations.json` 的生成逻辑
-
-## 3.7 apply 必须传 --idempotency-key，preview 不需要
-
-- 历史误区：preview 和 apply 参数完全对称
-- 真实结果：apply 缺少 `--idempotency-key` 时报 `apply 需要 idempotency_key`
-- 已验证做法：
-  - `preview`：不传 `--idempotency-key`
-  - `apply`：传 `--idempotency-key "nature-part2-apply-1752395205"`（建议格式 `{场景短码}-{part}-apply-{timestamp}`）
-  - 若使用 `--request-file <partX-update.json>`，则 `idempotency_key` 写在 JSON 请求体中，而不是命令行参数
-
-## 3.8 reason 是 preview 和 apply 的必填参数
-
-- 历史误区：`--reason` 是可选参数，只在多人协作时有用
-- 真实结果：不传 `--reason` 时直接报 `reason 不能为空`
-- 已验证做法：preview 和 apply 都传 `--reason "PartX: 描述"`，如 `--reason "Part2: AI角色设定同步"`
-- 备注：reason 字符串会出现在快照列表中，建议含 Part 编号便于追踪
-
-## 3.9 含中文引号的 JSON 必须通过 Python json.dump 写入，禁止 heredoc / echo
-
-- 历史误区：用 shell heredoc 或 `echo` 生成含中文标点（如 `""` 中文双引号）的 JSON
-- 真实结果：`invalid character '0' after object key:value pair` —— shell 会将中文引号误解析为语法结构
-- 已验证做法：一律用 `python3 -c "import json; json.dump(data, f, ensure_ascii=False, indent=2)"` 写入 JSON 文件
-- 备注：`「」`（直角引号）不触发此问题，只有 `""`（全角双引号，Unicode U+201C/U+201D）会
-
-## 3.2 场景命令必须走 `ai-training` 子命令
-
-- 历史误区：把命令写成 `soke-cli +create-scenario`、`soke-cli +get-scenario` 这类顶层调用
-- 真实结果：命令入口错误，无法稳定复现平台行为，也容易把排查方向带偏
-- 已验证做法：统一使用 `soke-cli ai-training +create-scenario`、`soke-cli ai-training +get-scenario`、`soke-cli ai-training +preview-scenario-update`、`soke-cli ai-training +apply-scenario-update`
-- 备注：场景创建、读取、预览、应用、封面上传等 MentorAI 场景能力，均按 `soke-cli ai-training +...` 口径执行，不要省略 `ai-training`
-
-## 3.3 soke-cli 在 WorkBuddy 沙箱中受限
-
-- 历史误区：直接在 Bash 工具中执行 soke-cli 命令（默认沙箱模式）
-- 真实结果：`permission denied`、`operation not permitted`、或静默无输出，命令未实际执行
-- 根因：soke-cli 是 Go 编译的二进制文件，沙箱限制了其所需的系统调用
-- 已验证做法：调用 Bash 工具执行任何 soke-cli 命令时，**必须设置 `dangerouslyDisableSandbox: true`**
-- 备注：此规则适用于全部 soke-cli 子命令（`config show`、`auth login`、`ai-training +...` 等），不限于创建型流程。若 soke-cli 命令返回权限错误，第一反应应检查是否遗漏了 `dangerouslyDisableSandbox: true`
-
-## 4. Part2 角色写入的真实最小稳定结构
-
-### 关键结论
-
-- `replace_ai_roles` 可用，数据键为 `data.roles`（非 `data.ai_roles`），不能只传裸 `role_data`
-- 必须使用完整 custom role 外壳，且提供稳定的 `scenario_role_id`
-- `avatar` 输入必须是头像资源 URL（来自 `+list-role-avatars` 的 `url` 字段），**严禁**使用资源 `id`
-- `voice_id` 输入必须是声音资源 ID（来自 `+list-role-voices` 的 `id` 字段）
-- `knowledge_level` 必须是数组，不是字符串
-- 建议同时携带 `tags`、`source_type`、`customized_fields`、`created_at`、`updated_at`
-
-> 生成 `part2-operations.json` 后，preview 前**必须逐项核对** `platform/sync-engine.md` 中的「Part2 replace_ai_roles 自查清单」（14 项），任一项不通过禁止 preview。
-
-### 已验证可回读的角色结构特征
-
-- `customization_level = "full"`
-- `is_custom_role = true`
-- `template_id / template_name / template_version = null`
-- `source_type = "custom"`
-- `customized_fields` 与 `role_data` 实际写入字段逐项对应
-
-## 4.1 Part2 外壳字段层级放错 → "角色数据异常"
-
-- 历史误区：把 `customization_level`、`is_custom_role`、`customized_fields`、`source_type`、`created_at`、`updated_at` 塞进 `role_data` 内部
-- 真实结果：角色回读显示 `name: "角色数据异常"`，所有字段 null
-- 已验证做法：这些 **平台外壳字段** 必须放在与 `role_data`、`scenario_role_id` 同级的**外层**，不可写入 `role_data` 内部。平台回读后可稳定解析的角色结构：
-
-```json
-// ✅ 正确 —— 外壳字段在外层
-{
-  "scenario_role_id": "role_chen",
-  "customization_level": "full",    // ← 外层
-  "is_custom_role": true,           // ← 外层
-  "role_data": {
-    "name": "陈检查员",
-    "avatar": "<头像URL>",
-    "voice_id": "<语音ID>",
-    "description": "...",
-    "communication_style": "...",
-    "personality_type": "ISTJ",
-    "personality": "..."
-  }
-}
-```
-
-```json
-// ❌ 错误 —— 外壳字段在 role_data 内
-{
-  "scenario_role_id": "role_chen",
-  "role_data": {
-    "name": "陈检查员",
-    "customization_level": "full",    // ← 错，触发"角色数据异常"
-    "is_custom_role": true,           // ← 错
-    "customized_fields": [...],       // ← 错
-    "source_type": "custom"           // ← 错
-  }
-}
-```
-
-- 备注：`sync-engine.md` 字段映射表只标注了业务字段的 `role_data.xxx` 路径，容易让人误以为外壳字段也属于 `role_data` 内部。**写 JSON 时先问：这个字段是描述"角色有什么属性"（→ `role_data` 内），还是描述"这个角色数据本身是什么类型"（→ 外层）**
-
-### 常见错误
-
-- 把外壳字段（`customization_level`/`is_custom_role`/`customized_fields`/`source_type`）错放进 `role_data` 内 → 角色数据异常
-- 把 `knowledge_level` 写成单个字符串
-- 只生成业务按需画像，不补平台外壳字段
-- `taboos_objections` 写成长段散文，无法稳定映射为列表
-
-## 4.2 Part2 首次写入默认不要整包 replace
-
-- 历史误区：为了省步骤，直接一次 `replace_ai_roles` 写入多个角色，再同时写 OS
-- 真实结果：preview/apply 可能成功，但回读时某一个角色被平台打成“角色数据异常”
-- 已验证做法：新场景首写 Part2 时，默认改为逐个保守写入：
-  1. 先 `add_ai_role` 写入第1个角色
-  2. 立刻 `+get-scenario` 验收
-  3. 验收通过后再逐个追加剩余角色
-  4. 最后单独 `update_basic` 写 `ai_roles_overall_description`
-- 备注：只有目标平台已被实证验证整包稳定时，才允许回退为 `replace_ai_roles`
-
-## 5. preview / apply 成功，不等于平台最终可正常解析
-
-- 历史误区：只要 preview 通过、apply 成功，就等于配置闭环完成
-- 真实结果：评分配置可能 UI 不渲染、角色数据可能异常、字段可能未同步
-- 已验证做法：每个 Part（Part1/Part2/Part3/Part4/Part5）apply 后，都要再做一次 `soke-cli ai-training +get-scenario --raw` 验收，逐项检查目标字段是否已正确写入平台
-
-## 6. 乐观锁必须每次重取最新 `updated_at`
-
-- 历史误区：沿用上一个 Part 的 `updated_at`
-- 真实结果：`base_updated_at` 过期导致冲突或误判
-- 已验证做法：每次 preview/apply 前先 `soke-cli ai-training +get-scenario`，永远以最新 `updated_at` 作为基线
-
-## 7. 身份字段不能作为授权/选租户依据
-
-- 历史误区：把 `corp_id` / `company_id` / `user_id` / `implementation_corp_id` 写进请求体，当作显式选租户手段
-- 真实结果：这些字段可能被代理剥离，也不应作为授权依据
-- 已验证做法：先通过环境检查确认登录态和企业绑定；请求体里不要依赖这些字段实现租户切换
-
-## 推荐执行顺序
-
-1. 先做环境检测
-2. Step1 创建前先准备封面
-3. 每个 Part 同步前先 `soke-cli ai-training +get-scenario`
-4. 先 preview，再 apply
-5. apply 后立刻 `soke-cli ai-training +get-scenario --raw` 验收该 Part 的目标字段
-6. Part2 一旦回读异常，优先检查 avatar / knowledge_level / custom role 外壳 / customized_fields / **background**，而不是盲目重试。**background 为 null 是最常见疏漏**
-7. Part4 一旦回读异常，优先检查 `data.config.criteria_data` 三层嵌套完整性、`source_type`/`total_weight`/`tags` 元数据字段、维度 `id`/`sort_order`
-8. Part5 仅检查练习配置字段（时长/次数/分数/难度/助答），不检查 closing_dialogue/gold_dialogue/key_points
-
-## 8. `add_conversation_step` apply 成功但数据不持久化
-
-- 历史误区：以为 `add_conversation_step` apply 返回 snapshot_id 就代表保存成功
-- 真实结果：`+get-scenario` 永远返回 `conversation_steps: []`——数据完全不保存（CLI v1.0.65/1.0.66 均存在此 bug）
-- 影响范围：`add_conversation_step`（平铺 data + data.step 格式均无效）、`replace_conversation_steps`（422 校验拒绝不支持此 operation type）
-- 已验证做法：最新官方语义仍要求用 `add_conversation_step` / `patch_conversation_step` 等操作先尝试 CLI 更新；若 apply 后 `get-scenario` 回读仍为空，再判定当前版本存在持久化缺陷，并改走 MentorAI Web 管理后台手动添加
-- 备注：全量创建 `+create-scenario --request-file` 中 `conversation_steps` 理论上可写入，但实测时 `ai_roles` 和 `scoring_criteria_config` 等其他复杂字段被同时忽略（见 §9）
-
-## 9. 全量创建 `--request-file` 只保存基础字段
-
-- 历史误区：以为 `+create-scenario --request-file` 支持一次性写入所有字段
-- 真实结果：仅 `name`/`description`/`tags`/`key_points`/`scene_lang`/`scenario_cover` 基础字段持久化；`ai_roles`/`scoring_criteria_config`/`conversation_steps`/练习配置等复杂字段全部被忽略（get 后返回 0 或 null）
-- 已验证做法：创建后必须通过 `+apply-scenario-update` 逐 Part 写入角色（replace_ai_roles/patch_ai_role）、评分（replace_scoring_criteria_config）、教练设置（update_basic）；对话步骤使用 Web 后台
-
-