同步 Platform Kit 1.0.17 运行时环境变量契约

development/RUNTIME.md

@@ -2,7 +2,7 @@
 
 ## 共享 Python Runtime
 
-**skill-template** 及复制出的新技能，公共能力均来自宿主匠厂安装的共享 Python Runtime（`jiangchang-platform-kit>=1.0.14` 及其传递依赖，含 `playwright`）。`jiangchang_skill_core` **不得**在技能仓库内 vendored，应由共享 venv 的 site-packages 提供。
+**skill-template** 及复制出的新技能，公共能力均来自宿主匠厂安装的共享 Python Runtime（`jiangchang-platform-kit>=1.0.17` 及其传递依赖，含 `playwright`）。`jiangchang_skill_core` **不得**在技能仓库内 vendored，应由共享 venv 的 site-packages 提供。
 
 技能根目录 `requirements.txt` **只声明技能特有依赖**；**不要**重复声明 `jiangchang-platform-kit` 或 `playwright`。`SKILL.md` 的 `platform_kit_min_version` 是运行契约，**不是** pip 依赖声明。
 
@@ -22,15 +22,15 @@ Windows:
   <shared-python> {baseDir}/scripts/main.py health
 ```
 
-`<shared-python>` 通常位于 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。数据根由宿主注入；开发模式下也可能通过 `CLAW_DATA_ROOT` 解析（见 `jiangchang_skill_core.runtime_env`）。
+`<shared-python>` 通常位于 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。数据根由宿主注入；开发模式下也可能通过 `JIANGCHANG_DATA_ROOT` 解析（见 `jiangchang_skill_core.runtime_env`）。
 
-## Runtime 诊断（platform-kit 1.0.14+）
+## Runtime 诊断（platform-kit 1.0.17+）
 
 `health` 命令通过 **`jiangchang_skill_core.collect_runtime_diagnostics`** 输出共享 runtime 诊断，**不在技能内重复实现**。典型字段：
 
 - `skill_slug`、`python_executable`、`platform_kit_version`、`platform_kit_min_version`
 - `jiangchang_skill_core_file` — 若从技能目录加载会输出 `runtime_issue[warning]`
-- `CLAW_DATA_ROOT` / `JIANGCHANG_DATA_ROOT` / `resolved_data_root`
+- `JIANGCHANG_DATA_ROOT` / `resolved_data_root`
 - `media_assets_root`、`ffmpeg_path`、`background_music_*`
 - `record_video_enabled`、`runtime_issue[warning|error]`
 
@@ -39,10 +39,10 @@ Windows:
 ## 配置 bootstrap
 
 - 仓库内 `.env.example` 是配置模板（单一事实来源）。
-- 用户实际 `.env`：`{CLAW_DATA_ROOT}/{CLAW_USER_ID}/{skill_slug}/.env`。
+- 用户实际 `.env`：`{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/{skill_slug}/.env`。
 - `scripts/main.py` 与 `cli.app.main()` 启动时调用 `util.config_bootstrap.bootstrap_skill_config()`。
 - 配置优先级：**进程环境变量** > **用户 `.env`** > **`.env.example` 默认值**。
-- 公共 `config` / `merge_missing_env_keys` 来自共享 runtime 的 `jiangchang-platform-kit>=1.0.14`，**不得** vendored `scripts/jiangchang_skill_core/`。
+- 公共 `config` / `merge_missing_env_keys` 来自共享 runtime 的 `jiangchang-platform-kit>=1.0.17`，**不得** vendored `scripts/jiangchang_skill_core/`。
 
 ## media-assets / ffmpeg / 背景音乐
 
@@ -52,7 +52,7 @@ Windows:
 {JIANGCHANG_DATA_ROOT}/shared/media-assets
 ```
 
-（与 `CLAW_DATA_ROOT` 解析规则一致，由宿主注入。）
+（由宿主注入 `JIANGCHANG_DATA_ROOT`。）
 
 RPA 录屏成片（`RpaVideoSession`）、ffmpeg 路径、背景音乐探测均由 platform-kit 提供；技能只 import，不重复实现。
 
@@ -80,7 +80,7 @@ RPA 录屏成片（`RpaVideoSession`）、ffmpeg 路径、背景音乐探测均
 推荐：
 
 ```text
-{CLAW_DATA_ROOT}/{CLAW_USER_ID}/{skill_slug}/
+{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/{skill_slug}/
 ```
 
 数据库文件建议：
@@ -97,12 +97,12 @@ RPA 录屏成片（`RpaVideoSession`）、ffmpeg 路径、背景音乐探测均
 
 ## 测试时的运行时隔离
 
-本模板的 `tests/_support.IsolatedDataRoot` 会在测试期间同时设置：
+本模板的 `tests/_support.IsolatedDataRoot` 会在测试期间设置：
 
-- `CLAW_DATA_ROOT` / `JIANGCHANG_DATA_ROOT` → 临时 tempfile 目录
-- `CLAW_USER_ID` / `JIANGCHANG_USER_ID` → `_test`
+- `JIANGCHANG_DATA_ROOT` → 临时 tempfile 目录
+- `JIANGCHANG_USER_ID` → `_test`
 
-退出时四个变量恢复，临时目录删除。所有 DB / 文件写入都被限制在临时目录内，不污染本机。
+退出时两个变量恢复，临时目录删除。所有 DB / 文件写入都被限制在临时目录内，不污染本机。
 
 详见 `TESTING.md` 第 3 节。