rainskills 0.1.28 → 0.1.30

package/README.md

@@ -1,6 +1,6 @@
 # Rainskills
 
-Rainskills 是一组面向应用识别、部署、排障和交付的 AI Skills，支持 Codex、Claude Code 和 Pi Agent。用户在市场中只会看到一个 `Rainskills` 产品，安装后 10 个 `rainbond-*` Skill 仍会独立触发。
+Rainskills 是一组面向应用识别、部署、排障和交付的 AI Skills，支持 Codex、Claude Code、Pi Agent、DeepSeek Harness 和 WorkBuddy。用户在市场中只会看到一个 `Rainskills` 产品，安装后 11 个 `rainbond-*` Skill 仍会独立触发。
 
 ## 安装
 
@@ -41,7 +41,23 @@ Claude Code：
 /reload-plugins
 ```
 
-安装流程支持 Codex、Claude Code 和 Pi Agent；Pi 与其他 Agent 共用同一组 Skills 和本地 Rainskills CLI，不再提供单独的 Pi MCP adapter。macOS、Linux 和 WSL 不支持 OpenClaw 安装。不要手工复制 Skill、拼接凭据或修改 Agent 配置。
+DeepSeek Harness：
+
+```bash
+npx --yes rainskills dsh
+```
+
+默认安装到 `${DSH_HOME:-~/.dsh}/skills`。DeepSeek Harness 使用原生 Skill catalog 和 `skill` loader 加载，不配置客户端 MCP。
+
+WorkBuddy：
+
+```bash
+npx --yes rainskills workbuddy
+```
+
+默认安装到 `${WORKBUDDY_CONFIG_DIR:-~/.workbuddy-ai}/skills`。如果安装发生在一个已经打开的 WorkBuddy 任务中，先刷新 Skill 列表或新建任务；部署时明确指定 Rainbond/Rainskills，或让项目保留 `rainbond.app.json`、`.rainbond/local.json` 标记，以避免被内置 Sites 路由抢占。
+
+安装流程支持 Codex、Claude Code、Pi Agent、DeepSeek Harness 和 WorkBuddy；所有 Agent 共用同一组 Skills 和本地 Rainskills CLI，不提供单独的客户端 MCP adapter。macOS、Linux 和 WSL 不支持 OpenClaw 安装。不要手工复制 Skill、拼接凭据或修改 Agent 配置。
 
 ## 安装完成时用户会看到什么
 
@@ -223,7 +239,7 @@ node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-
 
 Rainskills 会在用户下一次发起业务动作时，由本地运行时立即返回环境查询结果，并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
 
-发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.28`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
+发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.30`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
 
 升级只更新 Rainskills 自身，不触发 Rainbond 安装、运行环境选择、登录授权或重新对接，也不会新增 Agent MCP 配置。更新内容仅包括 Skills 和本地 CLI。原始业务操作会继续执行；只有该业务操作本身需要运行环境时，才按既有门禁检查当前连接。可用连接直接复用，401 只重新授权一次，403 立即停止，从未连接过运行环境时才进入环境选择。
 

package/SKILL.md

@@ -9,7 +9,7 @@ This is the single marketplace entry for the complete Rainskills product. The in
 
 ## Initialize
 
-1. Detect the current host client and map it to exactly one supported installer target: Codex=`codex`, Claude Code=`claude`, or Pi Agent=`pi`. All three use the same installed Skills and protected local Rainskills CLI; Pi has no separate MCP adapter or generated extension. The macOS, Linux, and WSL installer intentionally does not support OpenClaw; report that limitation instead of invoking an unsupported target. Do not ask the user which supported client they are currently using. If the host cannot be determined reliably, omit the target and let the installer ask.
+1. Detect the current host client and map it to exactly one supported installer target: Codex=`codex`, Claude Code=`claude`, Pi Agent=`pi`, DeepSeek Harness=`dsh`, or WorkBuddy=`workbuddy`. All five use the same installed Skills and protected local Rainskills CLI; Pi and DeepSeek Harness have no separate MCP adapter or generated extension. DeepSeek Harness installs to `$DSH_HOME/skills` (default `~/.dsh/skills`). WorkBuddy installs to `$WORKBUDDY_CONFIG_DIR/skills` (default `~/.workbuddy-ai/skills`). The macOS, Linux, and WSL installer intentionally does not support OpenClaw; report that limitation instead of invoking an unsupported target. Do not ask the user which supported client they are currently using. If the host cannot be determined reliably, omit the target and let the installer ask.
 2. Resolve the directory containing this `SKILL.md`. On native Windows, if the adjacent `bin/rainskills.js` exists, run it by absolute path with the detected target in an attached interactive terminal: `node <skill-directory>/bin/rainskills.js <target>`. On macOS, Linux, or WSL, if the adjacent `install.sh` exists, run `bash <skill-directory>/install.sh <target>` the same way. Do not replace the installer with manual file copies.
 3. Keep stdin, stdout, and stderr attached. When `RAINSKILLS_USER_INPUT_REQUIRED` appears, pause for that installer choice. If the installer emits `rainskills.next-action.v1`, execute only its fixed `argv` through the same launcher; never evaluate output as a shell command. If the adjacent `bin/rainskills.js` exists, use it for fixed next actions; otherwise use the same versioned npm package fallback described below.
 4. Stay attached until every independent Skill is installed. Do not select, connect, or configure an application runtime during installation. In the user-facing response, output only the fixed completion message below.
@@ -48,7 +48,9 @@ Rainskills 安装完成，下一条消息即可直接使用。
 
 Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id` 反复调用 `write_stdin`（空输入轮询），直到工具返回 `exit_code`。连接器输出 `[RAINSKILLS_AGENT_WAIT_REQUIRED:runtime-connect]` 后进入上述轮询；看到 `[RAINSKILLS_AGENT_WAIT_COMPLETE:runtime-connect]` 后仍须继续轮询，直到取得退出码和最终 JSON。
 
-Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.28`）：
+DeepSeek Harness 和 WorkBuddy 也必须保持原命令附着直到退出；如果宿主把长命令转成持久终端或后台任务，只能轮询该原始命令句柄，不得另起 `runtime status` 推测授权结果。WorkBuddy 安装后若当前任务的 Skill 清单尚未刷新，在下一条业务动作前先刷新 Skill 列表或新建任务，不得退回内置 Sites 代替 Rainbond 部署。
+
+Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.30`）：
 
 - 状态：执行 `runtime status --json`。
 - 首次连接：执行 `runtime connect <target> --saas` 或 `runtime connect <target> --rainbond-url <Console origin>`。

package/bin/rainskills-tools.js

@@ -449,6 +449,56 @@ function skillManifestPath(config) {
   return path.join(config.homeDir || os.homedir(), CONFIG_DIRECTORY, "bin", SKILL_MANIFEST_FILENAME);
 }
 
+function loadTelemetryPackageVersion(config) {
+  try {
+    const manifest = JSON.parse(fs.readFileSync(skillManifestPath(config), "utf8"));
+    return typeof manifest.package_version === "string" && manifest.package_version
+      ? manifest.package_version
+      : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function createBridgeTelemetry(config) {
+  try {
+    const directory = path.join(config.homeDir || os.homedir(), CONFIG_DIRECTORY, "rainskills", "telemetry");
+    const { createResultTelemetry } = requireRuntimeModule("result-telemetry.js");
+    return createResultTelemetry({
+      directory,
+      packageVersion: loadTelemetryPackageVersion(config),
+    });
+  } catch {
+    return null;
+  }
+}
+
+async function executeWithUsageTelemetry(command, config) {
+  const tracksUsage = command.command === "read" || command.command === "call";
+  const telemetry = tracksUsage ? createBridgeTelemetry(config) : null;
+  if (telemetry) await telemetry.flushPending(3).catch(() => {});
+  try {
+    const output = await execute(command, config);
+    if (telemetry) {
+      const firstUse = telemetry.recordFirstUse("success");
+      const active = telemetry.recordActiveDaily();
+      await Promise.allSettled([firstUse.delivery, active.delivery]);
+    }
+    return output;
+  } catch (error) {
+    if (telemetry) {
+      const firstUse = telemetry.recordFirstUse("failed", {
+        error_stage: "first_use",
+        error_code: error instanceof BridgeError && error.exitCode === EXIT.TRANSPORT
+          ? "transport_failed"
+          : "tool_call_failed",
+      });
+      await firstUse.delivery.catch(() => false);
+    }
+    throw error;
+  }
+}
+
 function loadSkillBinding(config, skillId, rootSkillId) {
   const target = skillManifestPath(config);
   let manifest;
@@ -1370,7 +1420,7 @@ async function main(args = process.argv.slice(2)) {
       if (config.isInsecureHttp) {
         process.stderr.write('{"warning":"using insecure HTTP transport"}\n');
       }
-      const output = await execute(command, config);
+      const output = await executeWithUsageTelemetry(command, config);
       process.stdout.write(`${JSON.stringify(fitOutput(output))}\n`);
       return;
     }
@@ -1380,7 +1430,7 @@ async function main(args = process.argv.slice(2)) {
     if (config.isInsecureHttp) {
       process.stderr.write('{"warning":"using insecure HTTP transport"}\n');
     }
-    const output = await execute(command, config);
+    const output = await executeWithUsageTelemetry(command, config);
     process.stdout.write(`${JSON.stringify(fitOutput(output))}\n`);
   } catch (error) {
     const bridgeError = error instanceof BridgeError

package/bin/rainskills.js

@@ -13,6 +13,9 @@ const {
 const {
   renderCatalogUserMessage,
 } = require("../rainbond-platform-installer/scripts/user-message.js");
+const {
+  isHostTarget,
+} = require("../rainbond-platform-installer/scripts/host-targets.js");
 
 const AUTO_UPDATE_FALLBACK_EXIT_CODE = 75;
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
@@ -67,7 +70,7 @@ function parseRuntimeAssertConnectArgs(args) {
     throw new Error("runtime connect 内部门禁参数无效");
   }
   if (!UUID_PATTERN.test(args[3] || "")) throw new Error("runtime connect operation 无效");
-  if (!["codex", "claude", "pi", "all"].includes(args[5])) throw new Error("runtime connect target 无效");
+  if (!isHostTarget(args[5])) throw new Error("runtime connect target 无效");
   if (!["saas", "private"].includes(args[7])) throw new Error("runtime connect environment kind 无效");
   return {
     operationId: args[3],
@@ -95,8 +98,8 @@ function parseRuntimeConnectArgs(args) {
     throw new Error("不是 runtime connect 命令");
   }
   const targetClient = args[2];
-  if (!["codex", "claude", "pi", "all"].includes(targetClient)) {
-    throw new Error("runtime connect 需要固定目标 codex、claude、pi 或 all");
+  if (!isHostTarget(targetClient)) {
+    throw new Error("runtime connect 需要固定的受支持宿主目标");
   }
   let environmentChoice = "";
   let rainbondUrl = "";
@@ -319,7 +322,7 @@ async function runBuiltin(args, {
     return true;
   }
   if (args[0] === "runtime" && args[1] === "reconnect") {
-    if (args.length !== 3 || !["codex", "claude", "pi", "all"].includes(args[2])) {
+    if (args.length !== 3 || !isHostTarget(args[2])) {
       throw new Error("runtime reconnect 参数无效");
     }
     const current = getSingleRuntimeStore().read();