huaweicloud-devkit 1.1.8-next.1 → 1.1.8-next.3

package/README.md

@@ -344,6 +344,54 @@ Configures HTTP/HTTPS proxy for connections to Huawei Cloud services (e.g. enter
 
 Environment variables `HTTPS_PROXY`, `HTTP_PROXY`, and `NO_PROXY` take precedence over the file configuration — use `proxy show` to inspect the effective settings.
 
+## Telemetry
+
+HuaweiCloud DevKit collects **anonymous** telemetry to understand usage patterns and improve the plugin. Telemetry is **enabled by default**.
+
+### What We Collect
+
+- **Installation ID** — a SHA-256 hash derived from a machine fingerprint (hostname + MAC address + OS type + home directory). The raw values are never sent or stored.
+- **User hash** — a server-generated user identifier hash (produced by the Huawei Cloud backend `check-user` / `generatorUserIDHash` API). It is cached locally and sent with every event; it is not derived from any local PII.
+- **Plugin version** — the installed `huaweicloud-devkit` version.
+- **Agent harness** — which AI coding agent is running (e.g. `opencode`, `codex`, `codearts`).
+- **Agent version** — the agent's version string.
+- **OS type and version** — e.g. `Linux`, `Darwin`, `Windows_NT`.
+- **Capability** — how the event was triggered: `mcp` (MCP tool invocation) or `cli` (CLI command), derived from the event key.
+- **Event type** — what happened, e.g. `plugin:install`, `plugin:first_use`, `dau:active_today` (daily active), `tool:<tool_name>`, `skill:retrieve`, `sandbox:connect`.
+- **Event value** — a short sanitized string (max 255 chars, newlines/tabs stripped). For tool events this is typically `1`; for skill retrieval it is the skill name.
+
+### What We Do **Not** Collect
+
+- No AK/SK, access keys, or any credentials
+- No user input, prompts, or code content
+- No IP addresses
+- No personally identifiable information (PII)
+- No file paths or project names
+
+### How Data Is Transmitted
+
+Events are queued in memory and sent in batches (up to 100 events per batch) via HTTP POST to Huawei Cloud's telemetry endpoint every 60 seconds. Transmission respects your proxy configuration. Failed requests are retried up to 3 times, then dropped.
+
+### Disable Telemetry (Opt-Out)
+
+Set the environment variable:
+
+```bash
+export HUAWEICLOUD_DEVKIT_TELEMETRY=off
+```
+
+When set to `off`, no telemetry events are collected or transmitted.
+
+### Debug Mode
+
+To log telemetry activity for troubleshooting:
+
+```bash
+export HUAWEICLOUD_DEVKIT_DEBUG=true
+```
+
+Debug logs are written to the plugin's `telemetry/telemetry-debug.log` file.
+
 ## What It Does
 
 - **Guided cloud operations** — agents get step-by-step guidance for 20+ commonly used Huawei Cloud services (ECS, OBS, VPC, RDS, GaussDB, FunctionGraph, APIG, CCE, and more)

package/README.zh-CN.md

@@ -338,6 +338,54 @@ npx --yes huaweicloud-devkit proxy clear   # 删除代理配置
 
 环境变量 `HTTPS_PROXY`、`HTTP_PROXY`、`NO_PROXY` 优先级高于文件配置——可使用 `proxy show` 查看最终生效的设置。
 
+## 遥测
+
+HuaweiCloud DevKit 收集**匿名**遥测数据，以了解使用模式并改进插件。遥测**默认开启**。
+
+### 收集哪些数据
+
+- **安装 ID** — 基于机器指纹（主机名 + MAC 地址 + OS 类型 + home 目录）生成的 SHA-256 哈希。原始值不会被发送或存储。
+- **用户哈希** — 服务端生成的用户标识哈希（由华为云后端 `check-user` / `generatorUserIDHash` API 生成）。本地缓存后随每次事件发送，非本地 PII 派生。
+- **插件版本** — 已安装的 `huaweicloud-devkit` 版本。
+- **Agent harness** — 正在运行的 AI 编码助手（如 `opencode`、`codex`、`codearts`）。
+- **Agent 版本** — Agent 版本号。
+- **OS 类型和版本** — 如 `Linux`、`Darwin`、`Windows_NT`。
+- **Capability** — 事件触发方式：`mcp`（MCP 工具调用）或 `cli`（CLI 命令），由事件 key 派生。
+- **事件类型** — 发生了什么，如 `plugin:install`（安装）、`plugin:first_use`（首次使用）、`dau:active_today`（日活）、`tool:<工具名>`（工具调用）、`skill:retrieve`（技能加载）、`sandbox:connect`（沙箱连接）。
+- **事件值** — 简短的脱敏字符串（最长 255 字符，换行符/制表符已清除）。工具事件通常为 `1`；技能加载事件为技能名称。
+
+### **不**收集哪些数据
+
+- 不收集 AK/SK、访问密钥或任何凭据
+- 不收集用户输入、提示词或代码内容
+- 不收集 IP 地址
+- 不收集个人可识别信息（PII）
+- 不收集文件路径或项目名称
+
+### 数据如何传输
+
+事件先在内存中排队，然后每 60 秒批量（每批最多 100 条）通过 HTTP POST 发送到华为云遥测端点。传输过程遵循你的代理配置。发送失败最多重试 3 次后丢弃。
+
+### 禁用遥测（Opt-Out）
+
+设置环境变量：
+
+```bash
+export HUAWEICLOUD_DEVKIT_TELEMETRY=off
+```
+
+设置为 `off` 后，不会收集或传输任何遥测事件。
+
+### 调试模式
+
+如需记录遥测活动以供排查：
+
+```bash
+export HUAWEICLOUD_DEVKIT_DEBUG=true
+```
+
+调试日志写入插件的 `telemetry/telemetry-debug.log` 文件。
+
 ## 功能特性
 
 - **引导式云操作** — Agent 获得 20+ 常用华为云服务的分步操作指引（ECS、OBS、VPC、RDS、GaussDB、FunctionGraph、APIG、CCE 等）

package/integrations/hermes/skills-snapshot.json

@@ -3,9 +3,9 @@
   "exported_at": "2026-09-07T00:00:00Z",
   "skills": [
     {
-      "name": "huawei-apig",
+      "name": "huawei-cloud-apig-instance-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-apig",
+      "identifier": "official/huaweicloud/huawei-cloud-apig-instance-management",
       "category": "huaweicloud"
     },
     {
@@ -39,27 +39,27 @@
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-cts",
+      "name": "huawei-cloud-cts-trace-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-cts",
+      "identifier": "official/huaweicloud/huawei-cloud-cts-trace-management",
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-dds-dcs",
+      "name": "huawei-cloud-dds-dcs-instance-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-dds-dcs",
+      "identifier": "official/huaweicloud/huawei-cloud-dds-dcs-instance-management",
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-deployment",
+      "name": "huawei-cloud-deployment-task-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-deployment",
+      "identifier": "official/huaweicloud/huawei-cloud-deployment-task-management",
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-dew",
+      "name": "huawei-cloud-dew-key-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-dew",
+      "identifier": "official/huaweicloud/huawei-cloud-dew-key-management",
       "category": "huaweicloud"
     },
     {
@@ -75,9 +75,9 @@
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-gaussdb",
+      "name": "huawei-cloud-gaussdb-instance-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-gaussdb",
+      "identifier": "official/huaweicloud/huawei-cloud-gaussdb-instance-management",
       "category": "huaweicloud"
     },
     {
@@ -117,9 +117,9 @@
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-smn-dms",
+      "name": "huawei-cloud-smn-dms-message",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-smn-dms",
+      "identifier": "official/huaweicloud/huawei-cloud-smn-dms-message",
       "category": "huaweicloud"
     },
     {
@@ -129,9 +129,9 @@
       "category": "huaweicloud"
     },
     {
-      "name": "huawei-waf-aad",
+      "name": "huawei-cloud-waf-aad-rule-management",
       "source": "official",
-      "identifier": "official/huaweicloud/huawei-waf-aad",
+      "identifier": "official/huaweicloud/huawei-cloud-waf-aad-rule-management",
       "category": "huaweicloud"
     },
     {

package/integrations/opencode/hooks/skill-tracker.js

@@ -1,6 +1,7 @@
 import { appendFileSync, mkdirSync, existsSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 
 const DEBUG = process.env.HUAWEICLOUD_DEVKIT_DEBUG === 'true';
 
@@ -98,19 +99,91 @@ function getHooks() {
   };
 }
 
-// ── Export: function-as-object serves both IDE and CLI ────────
-//
-//  IDE : plugin.default()      -> returns hooks
-//  CLI : plugin.default.server -> returns hooks (via { id, server })
+// ── V2 setup: register hooks on their owning domains via the context. ──────
+//    `tool.execute.before` → ctx.tool.hook("execute.before", ...) whose single
+//    event carries `.tool` (name) and `.input` (args), replacing V1's (input, output).
+//    `event` → ctx.event.subscribe(AsyncIterable of { type, properties }).
+async function setupV2(ctx) {
+  await ctx.tool.hook('execute.before', (event) => {
+    try {
+      debugLog(`HOOK tool.execute.before tool=${event?.tool}`);
+      if (event?.tool === 'skill') {
+        const name = event?.input?.name ?? event?.args?.name;
+        debugLog(`SKILL name=${name}`);
+        if (isHuaweiCloudSkill(name)) {
+          writeEvent('skill:retrieve', name);
+          debugLog(`SKILL TRACKED: ${name}`);
+        }
+        return;
+      }
+      if (event?.tool === 'bash') {
+        const cmd = event?.input?.command ?? event?.args?.command ?? '';
+        if (!cmd) return;
+        const result = classifyHcloud(cmd);
+        if (result) writeEvent(result.key, result.value, { capability: 'cli' });
+      }
+    } catch (error) {
+      debugLog(`HOOK ERROR: ${error?.message || error}`);
+    }
+  });
 
-function plugin() {
-  debugLog('=== PLUGIN EXPORT CALLED ===');
-  return getHooks();
+  const controller = new AbortController();
+  void (async () => {
+    try {
+      for await (const event of ctx.event.subscribe({ signal: controller.signal })) {
+        if (event?.type === 'message.part.updated') {
+          const text = event?.properties?.part?.text;
+          if (typeof text === 'string') {
+            const m = text.match(/Base directory for this skill:\s*.*?skills[/\\]([a-z0-9-]+)/i);
+            if (m && isHuaweiCloudSkill(m[1])) writeEvent('skill:retrieve', m[1]);
+          }
+        }
+      }
+    } catch (error) {
+      debugLog(`EVENT ERROR: ${error?.message || error}`);
+    }
+  })();
+
+  return () => controller.abort();
 }
 
-plugin.id = 'huaweicloud-skill-tracker';
-plugin.server = async () => getHooks();
+// ── Dual export: one default object serves OpenCode V1 and V2 ───────────────
+//    V1 loader reads `server()` (returns legacy string-keyed hooks).
+//    V2 loader reads `id` + `setup(ctx)` (registers hooks on the context domains).
+//    `Plugin.define` is a type/runtime helper injected lazily so a V1 host that
+//    lacks `@opencode/plugin` still loads (fallback to an identity define).
+let Plugin = { define: (def) => def };
+try {
+  const require = createRequire(import.meta.url);
+  for (const pkg of ['@opencode/plugin', '@opencode-ai/plugin']) {
+    try {
+      const mod = require(pkg);
+      if (mod?.Plugin?.define) {
+        Plugin = mod.Plugin;
+        break;
+      }
+      if (typeof mod?.define === 'function') {
+        Plugin = mod;
+        break;
+      }
+    } catch {
+      // not installed in this host; keep the identity define
+    }
+  }
+} catch {
+  // createRequire unavailable; keep the identity define
+}
 
-export default plugin;
+export default {
+  ...Plugin.define({
+    id: 'huaweicloud-skill-tracker',
+    async setup(ctx) {
+      return setupV2(ctx);
+    },
+  }),
+  async server() {
+    return getHooks();
+  },
+};
 
 debugLog('=== PLUGIN INIT DONE ===');

package/integrations/opencode/opencode.json

@@ -1,11 +1,12 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "_note": "Merge this into ~/.config/opencode/opencode.jsonc. Replace the path with the absolute path to your mcp-server.mjs installation.",
+  "_note": "Merge this into ~/.config/opencode/opencode.jsonc (OpenCode 2.x). Replace the path with the absolute path to your mcp-server.mjs installation. For OpenCode 1.x, place the same entry directly under \"mcp\" (without the \"servers\" level) and add \"enabled\": true.",
   "mcp": {
-    "huaweicloud-devkit": {
-      "type": "local",
-      "command": ["node", "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"],
-      "enabled": true
+    "servers": {
+      "huaweicloud-devkit": {
+        "type": "local",
+        "command": ["node", "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"]
+      }
     }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "huaweicloud-devkit",
   "mcpName": "io.github.huaweicloud/huaweicloud-devkit",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "kooCliVersion": "7.2.12",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "type": "module",
@@ -43,7 +43,7 @@
     "postinstall": "node ./bin/dsh-postinstall.cjs"
   },
   "dependencies": {
-    "undici": "^8.10.0"
+    "undici": "^8.11.2"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -57,7 +57,9 @@
     "prettier": "^3.9.6"
   },
   "overrides": {
-    "smol-toml": "1.8.0"
+    "smol-toml": "^1.9.0",
+    "brace-expansion": "5.0.12",
+    "katex": "^0.19.0"
   },
   "keywords": [
     "huaweicloud",

package/plugins/huaweicloud-core/.claude-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.codex-plugin/plugin.json

@@ -20,7 +20,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "skills": "./skills/",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.cursor-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.hermes-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "name": "huaweicloud-devkit",
   "id": "huaweicloud-devkit",
   "displayName": "HuaweiCloud DevKit",
-  "version": "1.1.8-next.1",
+  "version": "1.1.8-next.3",
   "family": "bundle-plugin",
   "bundleFormat": "codex",
   "description": "Guide coding agents to use Huawei Cloud safely — KooCLI, APIs, SDKs, 28 MCP tools, skills, and safety guardrails.",