huaweicloud-devkit 0.1.20 → 0.1.21

package/README.md

@@ -1,155 +1,169 @@
-# HuaweiCloud DevKit
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![CI](https://github.com/huaweicloud-mate/huaweicloud-devkit/actions/workflows/ci.yml/badge.svg)](https://github.com/huaweicloud-mate/huaweicloud-devkit/actions/workflows/ci.yml)
-
-帮助 AI 编码助手安全、准确地使用华为云——技能引导、KooCLI 工具、安全策略一站式集成。
-
-HuaweiCloud DevKit 为 AI 编码助手提供操作华为云所需的知识、工具和安全护栏，支持 OpenCode、Codex、Claude Code、Cursor 等主流 Agent。
-
-## 快速开始
-
-### OpenCode
-
-```bash
-npx --yes huaweicloud-devkit install
-```
-
-自动安装 27 个技能、MCP 服务器和安全策略，并更新 OpenCode 配置。安装后**重启会话**使 MCP 工具生效。
-
-```bash
-npx --yes huaweicloud-devkit doctor   # 自检：hcloud、MCP、技能、认证
-npx --yes huaweicloud-devkit status   # 查看安装状态
-npx --yes huaweicloud-devkit update   # 更新到最新版
-npx --yes huaweicloud-devkit uninstall # 卸载
-```
-
-### Codex
-
-```bash
-npx --yes huaweicloud-devkit install --target codex
-```
-
-> 需要先安装 Codex CLI。`--target all` 会在 Codex CLI 缺失时跳过 Codex。
-
-### Claude Code
-
-通过 **设置 → 插件 → 团队市场 → 添加市场 → 从仓库导入**，指向 `huaweicloud-mate/huaweicloud-devkit`。Claude Code 会自动索引插件。
-
-安装插件：
-
-```
-/plugin install huaweicloud-core@huaweicloud-devkit
-```
-
-### Cursor
-
-通过 **设置 → 插件 → 团队市场 → 添加市场 → 从仓库导入**，指向 `huaweicloud-mate/huaweicloud-devkit`。
-
-然后在**插件**面板中安装 **huaweicloud-core** 插件。
-
-### 其他 Agent
-
-对于支持 Model Context Protocol (MCP) 的 Agent，手动配置 MCP 服务器：
-
-```json
-{
-  "mcp": {
-    "huaweicloud": {
-      "type": "local",
-      "command": ["node", "<路径>/plugins/huaweicloud-core/src/mcp-server.mjs"],
-      "enabled": true
-    }
-  }
-}
-```
-
-然后安装技能：
-
-```bash
-npx --yes huaweicloud-devkit install
-```
-
-> **前置条件：** 需要安装 [KooCLI](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)（`hcloud`）并完成认证。MCP 服务器需要 Node.js >= 20。如果 `hcloud` 不在 `PATH` 中，请设置 `HCLOUD_BIN` 环境变量指向完整路径。
-
-## 包含内容
-
-### 插件
-
-`huaweicloud-core` 插件将 MCP 服务器配置、27 个 Agent 技能和安全策略打包为一次性安装。
-
-| 插件 | 说明 |
-|------|------|
-| [huaweicloud-core](plugins/huaweicloud-core/) | 核心插件，含技能、MCP 服务器、安全策略。**从这里开始。** |
-
-### 技能
-
-Agent 技能是经过整理的指令和参考材料包，帮助 Agent 完成特定的华为云任务。技能按需加载——Agent 只发现和检索与当前任务相关的内容。
-
-包含 6 个元技能（路由、发现、CLI/认证、API/SDK、安全、排错）和 20 个服务技能（覆盖 ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、ModelArts、Cloud Eye、CTS、DEW、Billing、CBR、WAF/AAD、DDS/DCS、Deployment、Getting Started）。
-
-浏览 [`skills/`](plugins/huaweicloud-core/skills/) 目录查看所有可用技能。
-
-### Rules 文件
-
-推荐的项目级配置文件，告诉 Agent 如何高效使用华为云——例如优先使用 MCP 服务器、发现可用技能、遵循最小权限 IAM 原则。
-
-详见 [`rules/huawei-agent-rules.md`](rules/huawei-agent-rules.md)。
-
-### MCP 服务器
-
-本地 MCP 服务器（`plugins/huaweicloud-core/src/mcp-server.mjs`）通过 Model Context Protocol 为 Agent 提供安全的 KooCLI 访问。
-
-- **安全优先执行** — 所有 `hcloud` 命令执行前自动分类（读/写/密钥），写操作需用户明确批准。
-- **输出脱敏** — 凭证形态的值（AK/SK、Token、密码）自动替换为 `***REDACTED***`。
-- **12 个结构化工具** — 技能搜索、CLI 检查、只读命令、区域发现、错误解释等。
-- **零运行时依赖** — 纯 Node.js（>= 20），无需 npm install。
-
-详见 [MCP 工具表](#mcp-工具)。
-
-## 安全模型
-
-三层防御体系：
-
-| 层级 | 机制 | 说明 |
-|------|------|------|
-| 技能层 | `SKILL.md` 流程文档 | 教会 Agent 正确的行为规则和安全用法 |
-| 钩子层 | `huaweicloud-safety.py` | PreToolUse Hook 阻断高风险工具调用（Claude Code、Cursor 可用） |
-| MCP 层 | `safety-policy.mjs` | Node.js 安全策略包装器，在所有 Agent 环境中强制执行 |
-
-详见 [`docs/safety-model.md`](docs/safety-model.md)。
-
-## MCP 工具
-
-| 类别 | 工具 | 说明 |
-|------|------|------|
-| 知识发现 | `huaweicloud_search_docs` | 跨技能文件及文档全文搜索 |
-| 知识发现 | `huaweicloud_retrieve_skill` | 按名称加载完整技能内容及参考文件 |
-| 知识发现 | `huaweicloud_list_regions` | 列出可用华为云区域 |
-| 知识发现 | `huaweicloud_get_regional_availability` | 检查目标区域的服务可用性 |
-| CLI | `huaweicloud_check_cli` | 检查 KooCLI `hcloud` 是否已安装 |
-| CLI | `huaweicloud_plan_cli_command` | 分类计划命令（读/写/密钥）但不执行 |
-| CLI | `huaweicloud_list_operations` | 列出服务的可用 KooCLI 操作 |
-| CLI | `huaweicloud_run_readonly_command` | 执行只读命令并脱敏输出 |
-| CLI | `huaweicloud_run_approved_command` | 经用户明确批准后执行写命令 |
-| 安全 | `huaweicloud_show_profile_redacted` | 安全查看 KooCLI 配置（凭证脱敏） |
-| 路由 | `huaweicloud_service_catalog` | 返回推荐的能力来源排序 |
-| 排错 | `huaweicloud_explain_error` | 解释错误码并建议诊断步骤 |
-
-## 文档
-
-- [系统架构设计](docs/01-系统架构设计.md)
-- [核心技能设计](docs/02-核心技能设计.md)
-- [安全模型](docs/safety-model.md)
-- [KooCLI 官方文档](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
-
-## 发布流程
-
-发布采用两步 workflow，全部在 GitHub Actions 中完成：
-
-1. **Prepare Release**（手动触发，选 `patch` / `minor` / `major`）：自动 bump 版本、跑质量门、推 `release/vX.Y.Z` 分支并创建 PR，CI 全绿后自动合并进 `main`。
-2. **Publish Release**（PR 合并后手动触发）：读取 `main` 版本，创建并推送 `vX.Y.Z` tag，生成 GitHub Release；tag 触发 `CD Production`，经 `production` 环境人工审批后发布到 npm（包名 `huaweicloud-devkit`）。
-
-## 许可证
-
-本项目基于 Apache-2.0 许可证发布。详见 [LICENSE](LICENSE)。
+# HuaweiCloud DevKit
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+[![CI](https://github.com/huaweicloud-mate/huaweicloud-devkit/actions/workflows/ci.yml/badge.svg)](https://github.com/huaweicloud-mate/huaweicloud-devkit/actions/workflows/ci.yml)
+
+帮助 AI 编码助手安全、准确地使用华为云——技能引导、KooCLI 工具、安全策略一站式集成。
+
+HuaweiCloud DevKit 为 AI 编码助手提供操作华为云所需的知识、工具和安全护栏，支持 OpenCode、Codex、Claude Code、Cursor、码道（CodeArts Agent）等主流 Agent。
+
+## 快速开始
+
+### OpenCode
+
+```bash
+npx --yes huaweicloud-devkit install
+```
+
+自动安装 27 个技能、MCP 服务器和安全策略，并更新 OpenCode 配置。安装后**重启会话**使 MCP 工具生效。
+
+```bash
+npx --yes huaweicloud-devkit doctor   # 自检：hcloud、MCP、技能、认证
+npx --yes huaweicloud-devkit status   # 查看安装状态
+npx --yes huaweicloud-devkit update   # 更新到最新版
+npx --yes huaweicloud-devkit uninstall # 卸载
+```
+
+### Codex
+
+```bash
+npx --yes huaweicloud-devkit install --target codex
+```
+
+> 需要先安装 Codex CLI。`--target all` 会在 Codex CLI 缺失时跳过 Codex。
+
+### Claude Code
+
+通过 **设置 → 插件 → 团队市场 → 添加市场 → 从仓库导入**，指向 `huaweicloud-mate/huaweicloud-devkit`。Claude Code 会自动索引插件。
+
+安装插件：
+
+```
+/plugin install huaweicloud-core@huaweicloud-devkit
+```
+
+### CodeArts Agent（码道）
+
+码道没有插件市场，通过技能 + MCP 机制适配：
+
+```bash
+npx --yes huaweicloud-devkit install --target codearts
+```
+
+自动安装 27 个技能到 `~/.codeartsdoer/skills/` 与项目级 `.codeartsdoer/skills/`，MCP 服务器注册到用户级与项目级 `.codeartsdoer/mcp/mcp_settings.json`。若本机已存在 KooCLI（`~/hcloud/hcloud.exe`），会自动将 `HCLOUD_BIN` 注入 MCP 配置。安装后**重启会话**使 MCP 工具生效。
+
+```bash
+npx --yes huaweicloud-devkit install-hcloud   # 安装 KooCLI（自动接受隐私协议）
+npx --yes huaweicloud-devkit doctor           # 自检：hcloud、MCP、技能、沙箱模式
+npx --yes huaweicloud-devkit status --target codearts   # 查看码道安装状态
+npx --yes huaweicloud-devkit uninstall --target codearts # 卸载
+```
+
+> **沙箱模式**：码道默认 `bash_mode: sandbox` 会阻止 KooCLI 写入配置目录（如 `~/.hcloud/root`），导致隐私协议无法持久化、KooCLI 无法运行。`install-hcloud` 会自动检测沙箱模式并给出明确指引——请在**码道外终端**安装使用 KooCLI，或在码道设置中关闭沙箱模式（设置 → 权限 → Bash 模式）后重试。
+>
+> **认证**：KooCLI 就绪后，还需在码道外终端执行 `hcloud configure init` 配置 AK/SK 与区域，然后即可在码道中描述你的华为云任务。
+
+### Cursor
+
+通过 **设置 → 插件 → 团队市场 → 添加市场 → 从仓库导入**，指向 `huaweicloud-mate/huaweicloud-devkit`。
+
+然后在**插件**面板中安装 **huaweicloud-core** 插件。
+
+### 其他 Agent
+
+对于支持 Model Context Protocol (MCP) 的 Agent，手动配置 MCP 服务器：
+
+```json
+{
+  "mcp": {
+    "huaweicloud": {
+      "type": "local",
+      "command": ["node", "<路径>/plugins/huaweicloud-core/src/mcp-server.mjs"],
+      "enabled": true
+    }
+  }
+}
+```
+
+然后安装技能：
+
+```bash
+npx --yes huaweicloud-devkit install
+```
+
+> **前置条件：** 需要安装 [KooCLI](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)（`hcloud`）并完成认证。MCP 服务器需要 Node.js >= 20。如果 `hcloud` 不在 `PATH` 中，请设置 `HCLOUD_BIN` 环境变量指向完整路径。
+
+## 包含内容
+
+### 插件
+
+`huaweicloud-core` 插件将 MCP 服务器配置、27 个 Agent 技能和安全策略打包为一次性安装。
+
+| 插件 | 说明 |
+|------|------|
+| [huaweicloud-core](plugins/huaweicloud-core/) | 核心插件，含技能、MCP 服务器、安全策略。**从这里开始。** |
+
+### 技能
+
+Agent 技能是经过整理的指令和参考材料包，帮助 Agent 完成特定的华为云任务。技能按需加载——Agent 只发现和检索与当前任务相关的内容。
+
+包含 6 个元技能（路由、发现、CLI/认证、API/SDK、安全、排错）和 20 个服务技能（覆盖 ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、ModelArts、Cloud Eye、CTS、DEW、Billing、CBR、WAF/AAD、DDS/DCS、Deployment、Getting Started）。
+
+浏览 [`skills/`](plugins/huaweicloud-core/skills/) 目录查看所有可用技能。
+
+### Rules 文件
+
+推荐的项目级配置文件，告诉 Agent 如何高效使用华为云——例如优先使用 MCP 服务器、发现可用技能、遵循最小权限 IAM 原则。
+
+详见 [`rules/huawei-agent-rules.md`](rules/huawei-agent-rules.md)。
+
+### MCP 服务器
+
+本地 MCP 服务器（`plugins/huaweicloud-core/src/mcp-server.mjs`）通过 Model Context Protocol 为 Agent 提供安全的 KooCLI 访问。
+
+- **安全优先执行** — 所有 `hcloud` 命令执行前自动分类（读/写/密钥），写操作需用户明确批准。
+- **输出脱敏** — 凭证形态的值（AK/SK、Token、密码）自动替换为 `***REDACTED***`。
+- **12 个结构化工具** — 技能搜索、CLI 检查、只读命令、区域发现、错误解释等。
+- **零运行时依赖** — 纯 Node.js（>= 20），无需 npm install。
+
+详见 [MCP 工具表](#mcp-工具)。
+
+## 安全模型
+
+三层防御体系：
+
+| 层级 | 机制 | 说明 |
+|------|------|------|
+| 技能层 | `SKILL.md` 流程文档 | 教会 Agent 正确的行为规则和安全用法 |
+| 钩子层 | `huaweicloud-safety.py` | PreToolUse Hook 阻断高风险工具调用（Claude Code、Cursor 可用） |
+| MCP 层 | `safety-policy.mjs` | Node.js 安全策略包装器，在所有 Agent 环境中强制执行 |
+
+详见 [`docs/safety-model.md`](docs/safety-model.md)。
+
+## MCP 工具
+
+| 类别 | 工具 | 说明 |
+|------|------|------|
+| 知识发现 | `huaweicloud_search_docs` | 跨技能文件及文档全文搜索 |
+| 知识发现 | `huaweicloud_retrieve_skill` | 按名称加载完整技能内容及参考文件 |
+| 知识发现 | `huaweicloud_list_regions` | 列出可用华为云区域 |
+| 知识发现 | `huaweicloud_get_regional_availability` | 检查目标区域的服务可用性 |
+| CLI | `huaweicloud_check_cli` | 检查 KooCLI `hcloud` 是否已安装 |
+| CLI | `huaweicloud_plan_cli_command` | 分类计划命令（读/写/密钥）但不执行 |
+| CLI | `huaweicloud_list_operations` | 列出服务的可用 KooCLI 操作 |
+| CLI | `huaweicloud_run_readonly_command` | 执行只读命令并脱敏输出 |
+| CLI | `huaweicloud_run_approved_command` | 经用户明确批准后执行写命令 |
+| 安全 | `huaweicloud_show_profile_redacted` | 安全查看 KooCLI 配置（凭证脱敏） |
+| 路由 | `huaweicloud_service_catalog` | 返回推荐的能力来源排序 |
+| 排错 | `huaweicloud_explain_error` | 解释错误码并建议诊断步骤 |
+
+## 文档
+
+- [系统架构设计](docs/01-系统架构设计.md)
+- [核心技能设计](docs/02-核心技能设计.md)
+- [安全模型](docs/safety-model.md)
+- [KooCLI 官方文档](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
+
+## 许可证
+
+本项目基于 Apache-2.0 许可证发布。详见 [LICENSE](LICENSE)。

package/bin/setup.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-'use strict';
-const path = require('path');
-const fileUrl = require('url').pathToFileURL(path.join(__dirname, '..', 'plugins', 'huaweicloud-core', 'src', 'setup-cli.mjs')).href;
-import(fileUrl).catch(e => {
-  console.error(e.message);
-  process.exit(1);
-});
+'use strict';
+const path = require('path');
+const fileUrl = require('url').pathToFileURL(path.join(__dirname, '..', 'plugins', 'huaweicloud-core', 'src', 'setup-cli.mjs')).href;
+import(fileUrl).catch(e => {
+  console.error(e.message);
+  process.exit(1);
+});

package/integrations/opencode/commands/huaweicloud-doctor.md

@@ -1,14 +1,14 @@
----
-description: Self-check Huawei Cloud DevKit readiness — hcloud, MCP, skills, auth.
----
-
-Use HuaweiCloud Devkit tools and skills to perform a comprehensive readiness check:
-
-1. Check if KooCLI `hcloud` is installed: `huaweicloud_check_cli`. If not, guide user to install.
-2. Check if hcloud has active credentials: `hcloud configure list` (redacted).
-3. List installed skills via `huaweicloud_search_docs` or count directories in `~/.config/opencode/skills/`.
-4. Verify MCP server is reachable by calling any read-only tool.
-5. Summarize: installed (OK) vs missing (action needed).
-6. Do not print AK/SK, tokens, passwords, credential files, or raw profile secrets.
-
-If MCP tools are unavailable (fresh install), run `npx huaweicloud-devkit doctor` in terminal.
+---
+description: Self-check Huawei Cloud DevKit readiness — hcloud, MCP, skills, auth.
+---
+
+Use HuaweiCloud Devkit tools and skills to perform a comprehensive readiness check:
+
+1. Check if KooCLI `hcloud` is installed: `huaweicloud_check_cli`. If not, guide user to install.
+2. Check if hcloud has active credentials: `hcloud configure list` (redacted).
+3. List installed skills via `huaweicloud_search_docs` or count directories in `~/.config/opencode/skills/`.
+4. Verify MCP server is reachable by calling any read-only tool.
+5. Summarize: installed (OK) vs missing (action needed).
+6. Do not print AK/SK, tokens, passwords, credential files, or raw profile secrets.
+
+If MCP tools are unavailable (fresh install), run `npx huaweicloud-devkit doctor` in terminal.

package/integrations/opencode/opencode.json

@@ -1,14 +1,14 @@
-{
-  "$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.",
-  "mcp": {
-    "huaweicloud": {
-      "type": "local",
-      "command": [
-        "node",
-        "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"
-      ],
-      "enabled": true
-    }
-  }
-}
+{
+  "$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.",
+  "mcp": {
+    "huaweicloud": {
+      "type": "local",
+      "command": [
+        "node",
+        "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"
+      ],
+      "enabled": true
+    }
+  }
+}

package/integrations/opencode/skills/huaweicloud-core/SKILL.md

@@ -1,30 +1,30 @@
----
-name: huaweicloud-core
-description: OpenCode entry skill for HuaweiCloud Devkit. Use when a developer asks OpenCode to use Huawei Cloud Skills, KooCLI, APIs, SDKs, future MCP tools, or low-priority Terraform guidance.
----
-
-# Huawei Cloud Core For OpenCode
-
-Use this skill as the OpenCode entry point. Prefer the full skill set under `plugins/huaweicloud-core/skills/` when the repository is available, or install those skills into OpenCode's skill directory with `scripts/install-opencode-local.ps1`.
-
-## Routing
-
-1. Use Huawei Cloud Skills for scenario workflows.
-2. Use KooCLI `hcloud` for local read-only inspection and reviewed commands.
-3. Use official API docs for exact request and response contracts.
-4. Use SDK docs when writing application integration code.
-5. Use approved MCP tools when they exist.
-6. Keep Terraform Provider low priority in V1; mention it for reviewed IaC only.
-
-## Safety
-
-Never ask the user to paste credentials. Never read `.hcloud` or `.huaweicloud` files into context. Plan writes first, ask for explicit approval, then verify with read-only checks.
-
-## KooCLI Basics
-
-- Install guide: `https://support.huaweicloud.com/qs-hcli/hcli_02_003.html`.
-- Verify with `hcloud version`; set `HCLOUD_BIN` if OpenCode cannot find `hcloud`.
-- Discover exact operations with `hcloud <Service> --help` before guessing.
-- Prefer `--param=value`; array indexes start at 1, for example `--server.nics.1.subnet_id=<subnet-id>`.
-- Respect region intent: Singapore -> `ap-southeast-3`, Hong Kong -> `ap-southeast-2`, Beijing -> `cn-north-4`. Do not scan all regions blindly.
-- Warn before commands containing `adminPass`, `password`, tokens, or other values that may remain in shell history.
+---
+name: huaweicloud-core
+description: OpenCode entry skill for HuaweiCloud Devkit. Use when a developer asks OpenCode to use Huawei Cloud Skills, KooCLI, APIs, SDKs, future MCP tools, or low-priority Terraform guidance.
+---
+
+# Huawei Cloud Core For OpenCode
+
+Use this skill as the OpenCode entry point. Prefer the full skill set under `plugins/huaweicloud-core/skills/` when the repository is available, or install those skills into OpenCode's skill directory with `scripts/install-opencode-local.ps1`.
+
+## Routing
+
+1. Use Huawei Cloud Skills for scenario workflows.
+2. Use KooCLI `hcloud` for local read-only inspection and reviewed commands.
+3. Use official API docs for exact request and response contracts.
+4. Use SDK docs when writing application integration code.
+5. Use approved MCP tools when they exist.
+6. Keep Terraform Provider low priority in V1; mention it for reviewed IaC only.
+
+## Safety
+
+Never ask the user to paste credentials. Never read `.hcloud` or `.huaweicloud` files into context. Plan writes first, ask for explicit approval, then verify with read-only checks.
+
+## KooCLI Basics
+
+- Install guide: `https://support.huaweicloud.com/qs-hcli/hcli_02_003.html`.
+- Verify with `hcloud version`; set `HCLOUD_BIN` if OpenCode cannot find `hcloud`.
+- Discover exact operations with `hcloud <Service> --help` before guessing.
+- Prefer `--param=value`; array indexes start at 1, for example `--server.nics.1.subnet_id=<subnet-id>`.
+- Respect region intent: Singapore -> `ap-southeast-3`, Hong Kong -> `ap-southeast-2`, Beijing -> `cn-north-4`. Do not scan all regions blindly.
+- Warn before commands containing `adminPass`, `password`, tokens, or other values that may remain in shell history.

package/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "huaweicloud-devkit",
-  "version": "0.1.20",
-  "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
-  "type": "module",
-  "files": [
-    "bin",
-    ".agents",
-    "plugins/huaweicloud-core",
-    "integrations/opencode"
-  ],
-  "bin": {
-    "huaweicloud-devkit": "./bin/setup.cjs"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/huaweicloud-mate/huaweicloud-devkit.git"
-  },
-  "scripts": {
-    "test": "node --test",
-    "lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\"",
-    "lint": "npm run lint:md",
-    "validate": "node ./scripts/validate-package.mjs",
-    "postinstall": "node -e \"console.log('\\nHuaweiCloud DevKit installed. Run: npx huaweicloud-devkit install\\n')\""
-  },
-  "devDependencies": {
-    "markdownlint-cli2": "^0.23.2"
-  },
-  "keywords": [
-    "huaweicloud",
-    "huawei-cloud",
-    "agent",
-    "codex",
-    "opencode",
-    "mcp",
-    "koocli",
-    "hcloud"
-  ],
-  "license": "Apache-2.0",
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "huaweicloud-devkit",
+  "version": "0.1.21",
+  "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
+  "type": "module",
+  "files": [
+    "bin",
+    ".agents",
+    "plugins/huaweicloud-core",
+    "integrations/opencode"
+  ],
+  "bin": {
+    "huaweicloud-devkit": "./bin/setup.cjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/huaweicloud-mate/huaweicloud-devkit.git"
+  },
+  "scripts": {
+    "test": "node --test",
+    "lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\"",
+    "lint": "npm run lint:md",
+    "validate": "node ./scripts/validate-package.mjs",
+    "postinstall": "node -e \"console.log('\\nHuaweiCloud DevKit installed. Run: npx huaweicloud-devkit install\\n')\""
+  },
+  "devDependencies": {
+    "markdownlint-cli2": "^0.23.2"
+  },
+  "keywords": [
+    "huaweicloud",
+    "huawei-cloud",
+    "agent",
+    "codex",
+    "opencode",
+    "mcp",
+    "koocli",
+    "hcloud"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20"
+  }
+}

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

@@ -20,7 +20,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": "0.1.20",
+  "version": "0.1.21",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud-mate"

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

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-core",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "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/.cursor-plugin/plugin.json

@@ -20,7 +20,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": "0.1.20",
+  "version": "0.1.21",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud-mate"

package/plugins/huaweicloud-core/.mcp.json

@@ -1,13 +1,13 @@
-{
-  "mcpServers": {
-    "huaweicloud": {
-      "command": "node",
-      "args": [
-        "./src/mcp-server.mjs"
-      ],
-      "env": {
-        "HUAWEICLOUD_AGENT_TOOLKIT_MODE": "local"
-      }
-    }
-  }
-}
+{
+  "mcpServers": {
+    "huaweicloud": {
+      "command": "node",
+      "args": [
+        "./src/mcp-server.mjs"
+      ],
+      "env": {
+        "HUAWEICLOUD_AGENT_TOOLKIT_MODE": "local"
+      }
+    }
+  }
+}