Runtime Helper

此能力只为已命中的 KS 专项准备 CLI runtime，不处理项目身份、注册表、版本规则或项目文件。 它是 plugin 更新与全局 ks 安装分离时的受控修复入口。

CLI Runtime Contract

不得直接读写 ~/.ks、$KS_HOME 或项目文件。只使用当前激活 plugin 中随附的 tarball：

详细约束见 Runtime Tarball Contract。

<plugin-root>/resources/kaleidosphere-<version>.tgz

执行步骤

1. 只能执行当前激活 plugin 随附的检查器，不得由模型自行拼接版本比较或安装命令：

   node <plugin-root>/skills/runtime-helper/scripts/ensure-runtime.js --json

2. 检查器确认 resources/ 中唯一的 kaleidosphere-<version>.tgz，运行 ks --version，仅在版本不一致或命令不可用时执行 npm install --global <plugin-root>/resources/kaleidosphere-<version>.tgz，再精确复检。
3. 只有检查器返回 ok: true 且 afterVersion 等于 expectedVersion 时，才向原专项返回“runtime 已就绪”。
4. tarball 缺失、npm 安装失败、复检失败或当前 shell 找不到 ks 时停止，并如实报告；Windows 先确认 npm global bin 位于 PATH。

边界

• 不得从网络、开发工作树或未知目录下载同名包。
• 不得假设 marketplace/plugin 更新会自动更新全局 CLI。
• 不得在 runtime 未就绪时继续调用 ks project、ks version 或其他需要 CLI 的专项命令。
• 这不是完整 self-management：安装、卸载、doctor、plugin repair 与跨 Agent runtime 适配仍需单独能力。