huaweicloud-devkit 1.0.3-dev.0 → 1.1.0-next.0

package/.agents/plugins/marketplace.json

@@ -1,20 +1,20 @@
 {
-    "name":  "huaweicloud-devkit",
-    "interface":  {
-                      "displayName":  "HuaweiCloud Devkit"
-                  },
-    "plugins":  [
-                    {
-                        "name":  "huaweicloud-core",
-                        "source":  {
-                                       "source":  "local",
-                                       "path":  "./plugins/huaweicloud-core"
-                                   },
-                        "policy":  {
-                                       "installation":  "AVAILABLE",
-                                       "authentication":  "ON_USE"
-                                   },
-                        "category":  "Cloud"
-                    }
-                ]
+  "name": "huaweicloud-devkit",
+  "interface": {
+    "displayName": "HuaweiCloud Devkit"
+  },
+  "plugins": [
+    {
+      "name": "huaweicloud-devkit",
+      "source": {
+        "source": "local",
+        "path": "./plugins/huaweicloud-core"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE"
+      },
+      "category": "Cloud"
+    }
+  ]
 }

package/README.md

@@ -8,46 +8,32 @@
 
 Help AI coding agents use Huawei Cloud safely and accurately — a single integration that gives agents cloud knowledge, CLI tooling, and safety guardrails.
 
-Supports OpenCode, Codex, CodeArts Agent, and WorkBuddy.
+Supports OpenCode, CodeArts Agent, WorkBuddy, DeepSeek Harness (DSH), OfficeAce, OpenClaw, and AtomCode.
 
 ## Prerequisites
 
-- Node.js >= 20
+- Node.js >= 22
 
 ## Quick Start
 
-### OpenCode
-
-```bash
-npx --yes huaweicloud-devkit install
-```
-
-Installs the DevKit into OpenCode automatically. **Restart the session** after installation.
-
-```bash
-npx --yes huaweicloud-devkit doctor    # self-check
-npx --yes huaweicloud-devkit status    # show status
-npx --yes huaweicloud-devkit update    # update
-npx --yes huaweicloud-devkit uninstall # uninstall
-```
+> If `--target` is omitted, the installer auto-detects agents on your machine. When multiple agents are detected, **all of them** will be installed. Specify `--target` to control which agent receives the install.
 
-### Codex
+### OpenCode
 
 ```bash
-npx --yes huaweicloud-devkit install --target codex
+npx --yes huaweicloud-devkit install --target opencode
 ```
 
-> The Codex CLI must be installed first.
+**Restart the session** after installation.
 
 ```bash
-npx --yes huaweicloud-devkit doctor                        # self-check
-npx --yes huaweicloud-devkit status --target codex
-npx --yes huaweicloud-devkit update --target codex         # update
-npx --yes huaweicloud-devkit uninstall --target codex
+npx --yes huaweicloud-devkit doctor --target opencode
+npx --yes huaweicloud-devkit status --target opencode
+npx --yes huaweicloud-devkit update --target opencode
+npx --yes huaweicloud-devkit uninstall --target opencode
+rm -rf ~/.npm/_npx/  # Linux/macOS only; Windows path TBD
 ```
 
-> **Codex Desktop** (Windows): use `--target codex-desktop` with the same commands.
-
 ### CodeArts Agent
 
 ```bash
@@ -57,16 +43,13 @@ npx --yes huaweicloud-devkit install --target codearts
 **Restart the session** after installation.
 
 ```bash
-npx --yes huaweicloud-devkit install-hcloud   # install KooCLI
-npx --yes huaweicloud-devkit doctor           # self-check
+npx --yes huaweicloud-devkit doctor --target codearts
 npx --yes huaweicloud-devkit status --target codearts
 npx --yes huaweicloud-devkit update --target codearts
 npx --yes huaweicloud-devkit uninstall --target codearts
 ```
 
-> **Sandbox mode**: CodeArts defaults to sandbox mode which blocks KooCLI. `install-hcloud` detects this and shows how to resolve it — install KooCLI outside the sandbox terminal, or disable sandbox mode in CodeArts settings (Settings → Permissions → Bash mode).
->
-> **Authentication**: Run `npx huaweicloud-devkit auth init` to configure unified AK/SK credentials for KooCLI, OBS, and sandbox APIs.
+> **Sandbox mode**: CodeArts defaults to sandbox mode which blocks KooCLI. `install-hcloud` detects this and shows how to resolve it — install KooCLI outside the sandbox terminal, or disable sandbox mode in CodeArts settings (Settings → Chats → Agents Terminal Command Running Mode → Auto Running).
 
 ### WorkBuddy
 
@@ -77,37 +60,125 @@ npx --yes huaweicloud-devkit install --target workbuddy
 **Restart the session** after installation.
 
 ```bash
-npx --yes huaweicloud-devkit doctor
+npx --yes huaweicloud-devkit doctor --target workbuddy
 npx --yes huaweicloud-devkit status --target workbuddy
-npx --yes huaweicloud-devkit update --target workbuddy   # update
+npx --yes huaweicloud-devkit update --target workbuddy
 npx --yes huaweicloud-devkit uninstall --target workbuddy
 ```
 
-> **Updating**: `update` is incremental per agent — it refreshes only the installed files and leaves your config untouched. Use `update --target all` to update every installed agent at once.
+### DeepSeek Harness (DSH)
+
+```bash
+npx --yes huaweicloud-devkit install --target dsh
+```
+
+**Restart the DSH session** after installation.
+
+```bash
+npx --yes huaweicloud-devkit doctor --target dsh
+npx --yes huaweicloud-devkit status --target dsh
+npx --yes huaweicloud-devkit update --target dsh
+npx --yes huaweicloud-devkit uninstall --target dsh
+```
+
+> DSH V1 reuses the existing MCP server through `@deepseek-ai/dsh-mcp-client`. If the installer reports that the client is not detected, run: `npx @deepseek-ai/dsh plugin --profile web add @deepseek-ai/dsh-mcp-client`.
+
+### OfficeAce
+
+```bash
+npx --yes huaweicloud-devkit install --target officeace
+```
+
+**Restart OfficeAce** after installation.
+
+```bash
+npx --yes huaweicloud-devkit doctor --target officeace
+npx --yes huaweicloud-devkit status --target officeace
+npx --yes huaweicloud-devkit update --target officeace
+npx --yes huaweicloud-devkit uninstall --target officeace
+```
+
+### OpenClaw
+
+```bash
+# Recommended (ClawHub)
+openclaw plugins install clawhub:huaweicloud-devkit
+openclaw plugins uninstall huaweicloud-devkit
+openclaw plugins update huaweicloud-devkit
+```
+
+**Restart OpenClaw** after installation. If prompted for security risk acknowledgment, add `--acknowledge-clawhub-risk`.
+
+```bash
+# Or via npx
+npx --yes huaweicloud-devkit install --target openclaw
+npx --yes huaweicloud-devkit status --target openclaw
+npx --yes huaweicloud-devkit update --target openclaw
+npx --yes huaweicloud-devkit uninstall --target openclaw
+rm -rf ~/.npm/_npx/  # Linux/macOS only; Windows path TBD
+```
+
+### AtomCode
+
+```bash
+npx --yes huaweicloud-devkit install --target atomcode
+```
+
+**Restart the AtomCode session** after installation.
+
+```bash
+npx --yes huaweicloud-devkit doctor --target atomcode
+npx --yes huaweicloud-devkit status --target atomcode
+npx --yes huaweicloud-devkit update --target atomcode
+npx --yes huaweicloud-devkit uninstall --target atomcode
+```
 
 ### Other Agents
 
-For agents that support the Model Context Protocol (MCP):
+Any agent that supports MCP can use the standard config:
 
 ```json
 {
-  "mcp": {
+  "mcpServers": {
     "huaweicloud-devkit": {
-      "type": "local",
-      "command": ["node", "<path>/plugins/huaweicloud-core/src/mcp-server.mjs"],
-      "enabled": true
+      "command": "npx",
+      "args": ["-y", "-p", "huaweicloud-devkit", "huaweicloud-devkit-mcp"]
     }
   }
 }
 ```
 
-Then install:
+No installation required — `npx` handles everything.
+
+> Set `HW_ACCESS_KEY`/`HW_SECRET_KEY` in the MCP config `env` field for project-level credentials.
+
+### Install KooCLI
+
+```bash
+npx --yes huaweicloud-devkit install-hcloud
+```
+
+### Configure Credentials
+
+```bash
+npx --yes huaweicloud-devkit auth init
+```
+
+Synchronizes AK/SK to KooCLI, OBS, and sandbox APIs in one step.
+
+### Install All Agents
+
+```bash
+npx --yes huaweicloud-devkit install --target all
+```
+
+### Update All Agents
 
 ```bash
-npx --yes huaweicloud-devkit install
+npx --yes huaweicloud-devkit update --target all
 ```
 
-> **Prerequisite:** Node.js >= 20. Run `npx huaweicloud-devkit auth init` for unified credentials.
+`update` is incremental — it refreshes installed files without touching your config.
 
 ## What It Does
 
@@ -115,6 +186,7 @@ npx --yes huaweicloud-devkit install
 - **Safety-first execution** — all write operations require explicit user approval; credentials and secrets are automatically redacted from output
 - **Pre-execution risk checks** — public exposure, credential leaks, and destructive operations are caught before they run
 - **Regional awareness** — auto-discovers available regions and checks service availability before creating resources
+- **Sandbox (DevStation)** — temporary cloud runtime for web app deployment with instant public URL preview
 
 ## Supported Services
 
@@ -125,6 +197,7 @@ ECS, OBS, VPC, IAM, RDS, GaussDB, FunctionGraph, APIG, CCE, SMN/DMS, ModelArts,
 - [Architecture](docs/architecture.md)
 - [Safety Model](docs/safety-model.md)
 - [Hook Rule Model](docs/hook-rule-model.md)
+- [DeepSeek Harness Integration](docs/dsh-integration.md)
 - [Changelog](docs/CHANGELOG.md)
 - [KooCLI official docs](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
 

package/README.zh-CN.md

@@ -8,46 +8,32 @@
 
 帮助 AI 编码助手安全、准确地使用华为云——一站式集成云知识、CLI 工具和安全护栏。
 
-支持 OpenCode、Codex、码道（CodeArts Agent）、WorkBuddy。
+支持 OpenCode、码道（CodeArts Agent）、WorkBuddy、DeepSeek Harness（DSH）、OfficeAce、OpenClaw、AtomCode。
 
 ## 前置条件
 
-- Node.js >= 20
+- Node.js >= 22
 
 ## 快速开始
 
-### OpenCode
-
-```bash
-npx --yes huaweicloud-devkit install
-```
-
-自动安装 DevKit。安装后**重启会话**。
-
-```bash
-npx --yes huaweicloud-devkit doctor   # 自检
-npx --yes huaweicloud-devkit status   # 查看状态
-npx --yes huaweicloud-devkit update   # 更新
-npx --yes huaweicloud-devkit uninstall # 卸载
-```
+> 省略 `--target` 时，安装器会自动检测机器上的 agent，检测到多个时**全部安装**。建议始终指定 `--target` 以明确安装目标。
 
-### Codex
+### OpenCode
 
 ```bash
-npx --yes huaweicloud-devkit install --target codex
+npx --yes huaweicloud-devkit install --target opencode
 ```
 
-> 需要先安装 Codex CLI。
+安装后**重启会话**。
 
 ```bash
-npx --yes huaweicloud-devkit doctor                        # 自检
-npx --yes huaweicloud-devkit status --target codex
-npx --yes huaweicloud-devkit update --target codex         # 更新
-npx --yes huaweicloud-devkit uninstall --target codex
+npx --yes huaweicloud-devkit doctor --target opencode
+npx --yes huaweicloud-devkit status --target opencode
+npx --yes huaweicloud-devkit update --target opencode
+npx --yes huaweicloud-devkit uninstall --target opencode
+rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows 路径待确认
 ```
 
-> **Codex Desktop**（Windows）：将 `--target codex` 换成 `--target codex-desktop`，命令相同。
-
 ### CodeArts Agent（码道）
 
 ```bash
@@ -57,16 +43,13 @@ npx --yes huaweicloud-devkit install --target codearts
 安装后**重启会话**。
 
 ```bash
-npx --yes huaweicloud-devkit install-hcloud   # 安装 KooCLI
-npx --yes huaweicloud-devkit doctor           # 自检
+npx --yes huaweicloud-devkit doctor --target codearts
 npx --yes huaweicloud-devkit status --target codearts
 npx --yes huaweicloud-devkit update --target codearts
 npx --yes huaweicloud-devkit uninstall --target codearts
 ```
 
-> **沙箱模式**：码道默认沙箱模式会阻止 KooCLI 运行。`install-hcloud` 自动检测并给出指引——请在码道外终端安装使用 KooCLI，或在码道设置中关闭沙箱模式（设置 → 权限 → Bash 模式）。
->
-> **认证**：执行 `npx huaweicloud-devkit auth init`，统一配置 KooCLI、OBS 和沙箱接口所需的 AK/SK。
+> **沙箱模式**：码道默认沙箱模式会阻止 KooCLI 运行。`install-hcloud` 自动检测并给出指引——请在码道外终端安装使用 KooCLI，或在码道设置中关闭沙箱模式（设置 → 对话流 → 智能体 终端命令运行模式 → 自动运行）。
 
 ### WorkBuddy
 
@@ -77,37 +60,125 @@ npx --yes huaweicloud-devkit install --target workbuddy
 安装后**重启会话**。
 
 ```bash
-npx --yes huaweicloud-devkit doctor
+npx --yes huaweicloud-devkit doctor --target workbuddy
 npx --yes huaweicloud-devkit status --target workbuddy
-npx --yes huaweicloud-devkit update --target workbuddy   # 更新
+npx --yes huaweicloud-devkit update --target workbuddy
 npx --yes huaweicloud-devkit uninstall --target workbuddy
 ```
 
-> **更新机制**：`update` 按 agent 增量更新，只刷新必要文件、不动你的配置文件。`update --target all` 可一次更新所有已安装的 agent。
+### DeepSeek Harness（DSH）
+
+```bash
+npx --yes huaweicloud-devkit install --target dsh
+```
+
+安装后**重启 DSH 会话**。
+
+```bash
+npx --yes huaweicloud-devkit doctor --target dsh
+npx --yes huaweicloud-devkit status --target dsh
+npx --yes huaweicloud-devkit update --target dsh
+npx --yes huaweicloud-devkit uninstall --target dsh
+```
+
+> DSH V1 通过 `@deepseek-ai/dsh-mcp-client` 复用现有 MCP Server。如果安装器提示客户端未检测到，请执行：`npx @deepseek-ai/dsh plugin --profile web add @deepseek-ai/dsh-mcp-client`。
+
+### OfficeAce
+
+```bash
+npx --yes huaweicloud-devkit install --target officeace
+```
+
+安装后**重启 OfficeAce**。
+
+```bash
+npx --yes huaweicloud-devkit doctor --target officeace
+npx --yes huaweicloud-devkit status --target officeace
+npx --yes huaweicloud-devkit update --target officeace
+npx --yes huaweicloud-devkit uninstall --target officeace
+```
+
+### OpenClaw
+
+```bash
+# 推荐方式 (ClawHub)
+openclaw plugins install clawhub:huaweicloud-devkit
+openclaw plugins uninstall huaweicloud-devkit
+openclaw plugins update huaweicloud-devkit
+```
+
+安装后**重启 OpenClaw**。如提示安全风险确认，加 `--acknowledge-clawhub-risk`。
+
+```bash
+# 或通过 npx
+npx --yes huaweicloud-devkit install --target openclaw
+npx --yes huaweicloud-devkit status --target openclaw
+npx --yes huaweicloud-devkit update --target openclaw
+npx --yes huaweicloud-devkit uninstall --target openclaw
+rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows 路径待确认
+```
+
+### AtomCode
+
+```bash
+npx --yes huaweicloud-devkit install --target atomcode
+```
+
+安装后**重启 AtomCode 会话**。
+
+```bash
+npx --yes huaweicloud-devkit doctor --target atomcode
+npx --yes huaweicloud-devkit status --target atomcode
+npx --yes huaweicloud-devkit update --target atomcode
+npx --yes huaweicloud-devkit uninstall --target atomcode
+```
 
 ### 其他 Agent
 
-支持 MCP 协议的 Agent，手动配置：
+任何支持 MCP 协议的 Agent，直接使用标准 MCP 配置：
 
 ```json
 {
-  "mcp": {
+  "mcpServers": {
     "huaweicloud-devkit": {
-      "type": "local",
-      "command": ["node", "<路径>/plugins/huaweicloud-core/src/mcp-server.mjs"],
-      "enabled": true
+      "command": "npx",
+      "args": ["-y", "-p", "huaweicloud-devkit", "huaweicloud-devkit-mcp"]
     }
   }
 }
 ```
 
-然后安装：
+无需预安装 — `npx` 自动处理一切。
+
+> 项目级 AK/SK 可通过 MCP 配置的 `env` 字段设置 `HW_ACCESS_KEY`/`HW_SECRET_KEY`。
+
+### 安装 KooCLI
+
+```bash
+npx --yes huaweicloud-devkit install-hcloud
+```
+
+### 配置凭据
+
+```bash
+npx --yes huaweicloud-devkit auth init
+```
+
+一步同步 AK/SK 到 KooCLI、OBS 和沙箱接口。
+
+### 安装所有 Agent
+
+```bash
+npx --yes huaweicloud-devkit install --target all
+```
+
+### 更新所有 Agent
 
 ```bash
-npx --yes huaweicloud-devkit install
+npx --yes huaweicloud-devkit update --target all
 ```
 
-> **前置条件：** Node.js >= 20。执行 `npx huaweicloud-devkit auth init` 完成统一认证。
+`update` 是增量更新——只刷新已安装的文件，不动配置文件。
 
 ## 功能特性
 
@@ -115,6 +186,7 @@ npx --yes huaweicloud-devkit install
 - **安全优先执行** — 所有写操作需用户明确批准；凭证和密钥自动脱敏
 - **执行前风险检查** — 公网暴露、凭证泄露、破坏性操作在执行前即被拦截
 - **区域感知** — 自动发现可用区域，创建资源前检查服务可用性
+- **沙箱（DevStation）** — 临时云端运行环境，部署 Web 应用并即刻获得公网预览地址
 
 ## 支持的服务
 
@@ -125,6 +197,7 @@ ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、M
 - [架构](docs/architecture.md)
 - [安全模型](docs/safety-model.md)
 - [Hook 规则模型](docs/hook-rule-model.md)
+- [DeepSeek Harness 集成](docs/dsh-integration.md)
 - [变更记录](docs/CHANGELOG.md)
 - [KooCLI 官方文档](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
 

package/bin/setup.cjs

@@ -1,8 +1,11 @@
 #!/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);
+const path = require('node:path');
+const fileUrl = require('node:url').pathToFileURL(
+  path.join(__dirname, '..', 'plugins', 'huaweicloud-core', 'src', 'setup-cli.mjs'),
+).href;
+
+import(fileUrl).catch((error) => {
+  console.error(error.message);
   process.exit(1);
 });

package/integrations/opencode/opencode.json

@@ -4,10 +4,7 @@
   "mcp": {
     "huaweicloud-devkit": {
       "type": "local",
-      "command": [
-        "node",
-        "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"
-      ],
+      "command": ["node", "<绝对路径>/plugins/huaweicloud-core/src/mcp-server.mjs"],
       "enabled": true
     }
   }

package/package.json

@@ -1,44 +1,65 @@
 {
-    "name": "huaweicloud-devkit",
-    "version": "1.0.3-dev.0",
-    "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/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",
-        "workbuddy",
-        "mcp",
-        "koocli",
-        "hcloud"
-    ],
-    "license": "Apache-2.0",
-    "engines": {
-        "node": ">=20"
-    }
+  "name": "huaweicloud-devkit",
+  "version": "1.1.0-next.0",
+  "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",
+    "huaweicloud-devkit-mcp": "./plugins/huaweicloud-core/src/mcp-server.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/huaweicloud/huaweicloud-devkit.git"
+  },
+  "scripts": {
+    "test": "node --test",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\"",
+    "lint:js": "eslint .",
+    "lint": "npm run lint:md && npm run lint:js",
+    "validate": "node ./scripts/validate-package.mjs",
+    "pack:verify": "node ./scripts/pack-verify.mjs",
+    "postinstall": "node -e \"console.log('\\nHuaweiCloud DevKit installed. Run: npx huaweicloud-devkit install\\n')\""
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "undici": "^8.10.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.8.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-n": "^18.3.0",
+    "eslint-plugin-unicorn": "^73.0.0",
+    "globals": "^17.11.0",
+    "markdownlint-cli2": "^0.23.2",
+    "prettier": "^3.9.6"
+  },
+  "keywords": [
+    "huaweicloud",
+    "huawei-cloud",
+    "agent",
+    "codex",
+    "opencode",
+    "officeace",
+    "office-claw",
+    "workbuddy",
+    "dsh",
+    "deepseek-harness",
+    "mcp",
+    "koocli",
+    "hcloud"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22"
+  }
 }