huaweicloud-devkit 1.0.3-dev.0 → 1.0.3-next.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +18 -18
- package/README.md +99 -41
- package/README.zh-CN.md +99 -41
- package/bin/setup.cjs +5 -3
- package/integrations/opencode/opencode.json +1 -4
- package/package.json +61 -42
- package/plugins/huaweicloud-core/.claude-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.codex-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.cursor-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.hermes-plugin/plugin.json +30 -0
- package/plugins/huaweicloud-core/.mcp.json +2 -5
- package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json +4 -18
- package/plugins/huaweicloud-core/hooks/huaweicloud-safety.py +32 -9
- package/plugins/huaweicloud-core/openclaw.plugin.json +20 -0
- package/plugins/huaweicloud-core/safety/policy.json +75 -99
- package/plugins/huaweicloud-core/safety/rules/cloud-risk-rules.json +41 -13
- package/plugins/huaweicloud-core/skills/huawei-apig/SKILL.md +34 -34
- package/plugins/huaweicloud-core/skills/huawei-billing/SKILL.md +18 -18
- package/plugins/huaweicloud-core/skills/huawei-cbr/SKILL.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-cce/SKILL.md +34 -32
- package/plugins/huaweicloud-core/skills/huawei-cloud-eye/SKILL.md +30 -30
- package/plugins/huaweicloud-core/skills/huawei-cts/SKILL.md +20 -20
- package/plugins/huaweicloud-core/skills/huawei-dds-dcs/SKILL.md +31 -31
- package/plugins/huaweicloud-core/skills/huawei-deployment/SKILL.md +21 -20
- package/plugins/huaweicloud-core/skills/huawei-dew/SKILL.md +39 -30
- package/plugins/huaweicloud-core/skills/huawei-dew/references/csms-usage.md +8 -1
- package/plugins/huaweicloud-core/skills/huawei-dew/references/kms-usage.md +6 -0
- package/plugins/huaweicloud-core/skills/huawei-ecs/SKILL.md +39 -36
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/create-instance.md +15 -4
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/flavors.md +11 -9
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/troubleshooting.md +13 -13
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/SKILL.md +40 -39
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/apig-event-format.md +12 -10
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/create-function.md +21 -20
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/triggers.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-gaussdb/SKILL.md +20 -20
- package/plugins/huaweicloud-core/skills/huawei-getting-started/SKILL.md +27 -23
- package/plugins/huaweicloud-core/skills/huawei-iam/SKILL.md +27 -27
- package/plugins/huaweicloud-core/skills/huawei-iam/references/policy-examples.md +65 -39
- package/plugins/huaweicloud-core/skills/huawei-iam/references/quick-ref.md +9 -9
- package/plugins/huaweicloud-core/skills/huawei-modelarts/SKILL.md +33 -25
- package/plugins/huaweicloud-core/skills/huawei-obs/SKILL.md +51 -44
- package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-create.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-lifecycle.md +12 -7
- package/plugins/huaweicloud-core/skills/huawei-obs/references/common-pitfalls.md +13 -12
- package/plugins/huaweicloud-core/skills/huawei-obs/references/single-file-share.md +4 -4
- package/plugins/huaweicloud-core/skills/huawei-rds/SKILL.md +63 -58
- package/plugins/huaweicloud-core/skills/huawei-sandbox/SKILL.md +128 -42
- package/plugins/huaweicloud-core/skills/huawei-smn-dms/SKILL.md +26 -26
- package/plugins/huaweicloud-core/skills/huawei-vpc/SKILL.md +39 -39
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/network.md +13 -12
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/security-group.md +20 -19
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/subnet.md +15 -15
- package/plugins/huaweicloud-core/skills/huawei-waf-aad/SKILL.md +18 -18
- package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/SKILL.md +13 -13
- package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/SKILL.md +25 -2
- package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md +27 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-core/SKILL.md +65 -47
- package/plugins/huaweicloud-core/skills/huaweicloud-core/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-core/references/report-issue.md +6 -6
- package/plugins/huaweicloud-core/skills/huaweicloud-core/references/select.md +15 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-safety/SKILL.md +0 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-safety/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/SKILL.md +33 -33
- package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/src/auth/agent-registration.mjs +123 -2
- package/plugins/huaweicloud-core/src/auth/credentials.mjs +77 -4
- package/plugins/huaweicloud-core/src/auth/service.mjs +1 -1
- package/plugins/huaweicloud-core/src/data/icons-manifest.v1.json +3517 -0
- package/plugins/huaweicloud-core/src/hcloud-cli.mjs +25 -7
- package/plugins/huaweicloud-core/src/icon-library.mjs +171 -0
- package/plugins/huaweicloud-core/src/mcp-server.mjs +30 -3
- package/plugins/huaweicloud-core/src/proxy/proxy-agent.mjs +73 -0
- package/plugins/huaweicloud-core/src/proxy/proxy-config.mjs +94 -0
- package/plugins/huaweicloud-core/src/risk-rule-engine.mjs +4 -1
- package/plugins/huaweicloud-core/src/safety-policy.mjs +122 -68
- package/plugins/huaweicloud-core/src/sandbox/hdkitservice-api.mjs +14 -10
- package/plugins/huaweicloud-core/src/sandbox/hwlink-api.mjs +34 -27
- package/plugins/huaweicloud-core/src/sandbox/sandbox-file-server.py +45 -0
- package/plugins/huaweicloud-core/src/sandbox/session-manager.mjs +521 -8
- package/plugins/huaweicloud-core/src/search-market.mjs +53 -14
- package/plugins/huaweicloud-core/src/setup-cli.mjs +1741 -215
- package/plugins/huaweicloud-core/src/tools.mjs +667 -123
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-exec-client.js +72 -38
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-fair-queue.js +10 -5
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-multiplexer.js +12 -15
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-packet.js +12 -16
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-terminal-channel.js +46 -31
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-tunnel-channel.mjs +267 -0
- package/plugins/huaweicloud-core/src/ws-exec/index.js +3 -0
- package/plugins/huaweicloud-core/src/ws-exec/ws-exec-client.js +9 -5
- package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/SKILL.md +0 -190
- package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/scripts/search-skills.mjs +0 -124
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
2
|
+
"name": "huaweicloud-devkit",
|
|
3
|
+
"interface": {
|
|
4
|
+
"displayName": "HuaweiCloud Devkit"
|
|
5
|
+
},
|
|
6
|
+
"plugins": [
|
|
7
|
+
{
|
|
8
|
+
"name": "huaweicloud-devkit",
|
|
9
|
+
"source": {
|
|
10
|
+
"source": "local",
|
|
11
|
+
"path": "./plugins/huaweicloud-core"
|
|
12
|
+
},
|
|
13
|
+
"policy": {
|
|
14
|
+
"installation": "AVAILABLE",
|
|
15
|
+
"authentication": "ON_USE"
|
|
16
|
+
},
|
|
17
|
+
"category": "Cloud"
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
20
|
}
|
package/README.md
CHANGED
|
@@ -8,46 +8,32 @@
|
|
|
8
8
|
|
|
9
9
|
Help AI coding agents use Huawei Cloud safely and accurately — a single integration that gives agents cloud knowledge, CLI tooling, and safety guardrails.
|
|
10
10
|
|
|
11
|
-
Supports OpenCode,
|
|
11
|
+
Supports OpenCode, CodeArts Agent, WorkBuddy, DeepSeek Harness (DSH), OfficeAce, and OpenClaw.
|
|
12
12
|
|
|
13
13
|
## Prerequisites
|
|
14
14
|
|
|
15
|
-
- Node.js >=
|
|
15
|
+
- Node.js >= 22
|
|
16
16
|
|
|
17
17
|
## Quick Start
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
npx --yes huaweicloud-devkit install
|
|
23
|
-
```
|
|
19
|
+
> 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.
|
|
24
20
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
npx --yes huaweicloud-devkit doctor # self-check
|
|
29
|
-
npx --yes huaweicloud-devkit status # show status
|
|
30
|
-
npx --yes huaweicloud-devkit update # update
|
|
31
|
-
npx --yes huaweicloud-devkit uninstall # uninstall
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
### Codex
|
|
21
|
+
### OpenCode
|
|
35
22
|
|
|
36
23
|
```bash
|
|
37
|
-
npx --yes huaweicloud-devkit install --target
|
|
24
|
+
npx --yes huaweicloud-devkit install --target opencode
|
|
38
25
|
```
|
|
39
26
|
|
|
40
|
-
|
|
27
|
+
**Restart the session** after installation.
|
|
41
28
|
|
|
42
29
|
```bash
|
|
43
|
-
npx --yes huaweicloud-devkit doctor
|
|
44
|
-
npx --yes huaweicloud-devkit status --target
|
|
45
|
-
npx --yes huaweicloud-devkit update --target
|
|
46
|
-
npx --yes huaweicloud-devkit uninstall --target
|
|
30
|
+
npx --yes huaweicloud-devkit doctor --target opencode
|
|
31
|
+
npx --yes huaweicloud-devkit status --target opencode
|
|
32
|
+
npx --yes huaweicloud-devkit update --target opencode
|
|
33
|
+
npx --yes huaweicloud-devkit uninstall --target opencode
|
|
34
|
+
rm -rf ~/.npm/_npx/ # Linux/macOS only; Windows path TBD
|
|
47
35
|
```
|
|
48
36
|
|
|
49
|
-
> **Codex Desktop** (Windows): use `--target codex-desktop` with the same commands.
|
|
50
|
-
|
|
51
37
|
### CodeArts Agent
|
|
52
38
|
|
|
53
39
|
```bash
|
|
@@ -57,16 +43,13 @@ npx --yes huaweicloud-devkit install --target codearts
|
|
|
57
43
|
**Restart the session** after installation.
|
|
58
44
|
|
|
59
45
|
```bash
|
|
60
|
-
npx --yes huaweicloud-devkit
|
|
61
|
-
npx --yes huaweicloud-devkit doctor # self-check
|
|
46
|
+
npx --yes huaweicloud-devkit doctor --target codearts
|
|
62
47
|
npx --yes huaweicloud-devkit status --target codearts
|
|
63
48
|
npx --yes huaweicloud-devkit update --target codearts
|
|
64
49
|
npx --yes huaweicloud-devkit uninstall --target codearts
|
|
65
50
|
```
|
|
66
51
|
|
|
67
|
-
> **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 →
|
|
68
|
-
>
|
|
69
|
-
> **Authentication**: Run `npx huaweicloud-devkit auth init` to configure unified AK/SK credentials for KooCLI, OBS, and sandbox APIs.
|
|
52
|
+
> **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).
|
|
70
53
|
|
|
71
54
|
### WorkBuddy
|
|
72
55
|
|
|
@@ -77,37 +60,110 @@ npx --yes huaweicloud-devkit install --target workbuddy
|
|
|
77
60
|
**Restart the session** after installation.
|
|
78
61
|
|
|
79
62
|
```bash
|
|
80
|
-
npx --yes huaweicloud-devkit doctor
|
|
63
|
+
npx --yes huaweicloud-devkit doctor --target workbuddy
|
|
81
64
|
npx --yes huaweicloud-devkit status --target workbuddy
|
|
82
|
-
npx --yes huaweicloud-devkit update --target workbuddy
|
|
65
|
+
npx --yes huaweicloud-devkit update --target workbuddy
|
|
83
66
|
npx --yes huaweicloud-devkit uninstall --target workbuddy
|
|
84
67
|
```
|
|
85
68
|
|
|
86
|
-
|
|
69
|
+
### DeepSeek Harness (DSH)
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npx --yes huaweicloud-devkit install --target dsh
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Restart the DSH session** after installation.
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npx --yes huaweicloud-devkit doctor --target dsh
|
|
79
|
+
npx --yes huaweicloud-devkit status --target dsh
|
|
80
|
+
npx --yes huaweicloud-devkit update --target dsh
|
|
81
|
+
npx --yes huaweicloud-devkit uninstall --target dsh
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
> 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`.
|
|
85
|
+
|
|
86
|
+
### OfficeAce
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npx --yes huaweicloud-devkit install --target officeace
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**Restart OfficeAce** after installation.
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx --yes huaweicloud-devkit doctor --target officeace
|
|
96
|
+
npx --yes huaweicloud-devkit status --target officeace
|
|
97
|
+
npx --yes huaweicloud-devkit update --target officeace
|
|
98
|
+
npx --yes huaweicloud-devkit uninstall --target officeace
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### OpenClaw
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
# Recommended (ClawHub)
|
|
105
|
+
openclaw plugins install clawhub:huaweicloud-devkit
|
|
106
|
+
openclaw plugins uninstall huaweicloud-devkit
|
|
107
|
+
openclaw plugins update huaweicloud-devkit
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
**Restart OpenClaw** after installation. If prompted for security risk acknowledgment, add `--acknowledge-clawhub-risk`.
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# Or via npx
|
|
114
|
+
npx --yes huaweicloud-devkit install --target openclaw
|
|
115
|
+
npx --yes huaweicloud-devkit status --target openclaw
|
|
116
|
+
npx --yes huaweicloud-devkit update --target openclaw
|
|
117
|
+
npx --yes huaweicloud-devkit uninstall --target openclaw
|
|
118
|
+
rm -rf ~/.npm/_npx/ # Linux/macOS only; Windows path TBD
|
|
119
|
+
```
|
|
87
120
|
|
|
88
121
|
### Other Agents
|
|
89
122
|
|
|
90
|
-
|
|
123
|
+
Any agent that supports MCP can use the standard config:
|
|
91
124
|
|
|
92
125
|
```json
|
|
93
126
|
{
|
|
94
|
-
"
|
|
127
|
+
"mcpServers": {
|
|
95
128
|
"huaweicloud-devkit": {
|
|
96
|
-
"
|
|
97
|
-
"
|
|
98
|
-
"enabled": true
|
|
129
|
+
"command": "npx",
|
|
130
|
+
"args": ["-y", "-p", "huaweicloud-devkit", "huaweicloud-devkit-mcp"]
|
|
99
131
|
}
|
|
100
132
|
}
|
|
101
133
|
}
|
|
102
134
|
```
|
|
103
135
|
|
|
104
|
-
|
|
136
|
+
No installation required — `npx` handles everything.
|
|
137
|
+
|
|
138
|
+
> Set `HW_ACCESS_KEY`/`HW_SECRET_KEY` in the MCP config `env` field for project-level credentials.
|
|
139
|
+
|
|
140
|
+
### Install KooCLI
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
npx --yes huaweicloud-devkit install-hcloud
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Configure Credentials
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
npx --yes huaweicloud-devkit auth init
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Synchronizes AK/SK to KooCLI, OBS, and sandbox APIs in one step.
|
|
153
|
+
|
|
154
|
+
### Install All Agents
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
npx --yes huaweicloud-devkit install --target all
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### Update All Agents
|
|
105
161
|
|
|
106
162
|
```bash
|
|
107
|
-
npx --yes huaweicloud-devkit
|
|
163
|
+
npx --yes huaweicloud-devkit update --target all
|
|
108
164
|
```
|
|
109
165
|
|
|
110
|
-
|
|
166
|
+
`update` is incremental — it refreshes installed files without touching your config.
|
|
111
167
|
|
|
112
168
|
## What It Does
|
|
113
169
|
|
|
@@ -115,6 +171,7 @@ npx --yes huaweicloud-devkit install
|
|
|
115
171
|
- **Safety-first execution** — all write operations require explicit user approval; credentials and secrets are automatically redacted from output
|
|
116
172
|
- **Pre-execution risk checks** — public exposure, credential leaks, and destructive operations are caught before they run
|
|
117
173
|
- **Regional awareness** — auto-discovers available regions and checks service availability before creating resources
|
|
174
|
+
- **Sandbox (DevStation)** — temporary cloud runtime for web app deployment with instant public URL preview
|
|
118
175
|
|
|
119
176
|
## Supported Services
|
|
120
177
|
|
|
@@ -125,6 +182,7 @@ ECS, OBS, VPC, IAM, RDS, GaussDB, FunctionGraph, APIG, CCE, SMN/DMS, ModelArts,
|
|
|
125
182
|
- [Architecture](docs/architecture.md)
|
|
126
183
|
- [Safety Model](docs/safety-model.md)
|
|
127
184
|
- [Hook Rule Model](docs/hook-rule-model.md)
|
|
185
|
+
- [DeepSeek Harness Integration](docs/dsh-integration.md)
|
|
128
186
|
- [Changelog](docs/CHANGELOG.md)
|
|
129
187
|
- [KooCLI official docs](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
|
|
130
188
|
|
package/README.zh-CN.md
CHANGED
|
@@ -8,46 +8,32 @@
|
|
|
8
8
|
|
|
9
9
|
帮助 AI 编码助手安全、准确地使用华为云——一站式集成云知识、CLI 工具和安全护栏。
|
|
10
10
|
|
|
11
|
-
支持 OpenCode
|
|
11
|
+
支持 OpenCode、码道(CodeArts Agent)、WorkBuddy、DeepSeek Harness(DSH)、OfficeAce、OpenClaw。
|
|
12
12
|
|
|
13
13
|
## 前置条件
|
|
14
14
|
|
|
15
|
-
- Node.js >=
|
|
15
|
+
- Node.js >= 22
|
|
16
16
|
|
|
17
17
|
## 快速开始
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
npx --yes huaweicloud-devkit install
|
|
23
|
-
```
|
|
19
|
+
> 省略 `--target` 时,安装器会自动检测机器上的 agent,检测到多个时**全部安装**。建议始终指定 `--target` 以明确安装目标。
|
|
24
20
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
npx --yes huaweicloud-devkit doctor # 自检
|
|
29
|
-
npx --yes huaweicloud-devkit status # 查看状态
|
|
30
|
-
npx --yes huaweicloud-devkit update # 更新
|
|
31
|
-
npx --yes huaweicloud-devkit uninstall # 卸载
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
### Codex
|
|
21
|
+
### OpenCode
|
|
35
22
|
|
|
36
23
|
```bash
|
|
37
|
-
npx --yes huaweicloud-devkit install --target
|
|
24
|
+
npx --yes huaweicloud-devkit install --target opencode
|
|
38
25
|
```
|
|
39
26
|
|
|
40
|
-
|
|
27
|
+
安装后**重启会话**。
|
|
41
28
|
|
|
42
29
|
```bash
|
|
43
|
-
npx --yes huaweicloud-devkit doctor
|
|
44
|
-
npx --yes huaweicloud-devkit status --target
|
|
45
|
-
npx --yes huaweicloud-devkit update --target
|
|
46
|
-
npx --yes huaweicloud-devkit uninstall --target
|
|
30
|
+
npx --yes huaweicloud-devkit doctor --target opencode
|
|
31
|
+
npx --yes huaweicloud-devkit status --target opencode
|
|
32
|
+
npx --yes huaweicloud-devkit update --target opencode
|
|
33
|
+
npx --yes huaweicloud-devkit uninstall --target opencode
|
|
34
|
+
rm -rf ~/.npm/_npx/ # 仅 Linux/macOS;Windows 路径待确认
|
|
47
35
|
```
|
|
48
36
|
|
|
49
|
-
> **Codex Desktop**(Windows):将 `--target codex` 换成 `--target codex-desktop`,命令相同。
|
|
50
|
-
|
|
51
37
|
### CodeArts Agent(码道)
|
|
52
38
|
|
|
53
39
|
```bash
|
|
@@ -57,16 +43,13 @@ npx --yes huaweicloud-devkit install --target codearts
|
|
|
57
43
|
安装后**重启会话**。
|
|
58
44
|
|
|
59
45
|
```bash
|
|
60
|
-
npx --yes huaweicloud-devkit
|
|
61
|
-
npx --yes huaweicloud-devkit doctor # 自检
|
|
46
|
+
npx --yes huaweicloud-devkit doctor --target codearts
|
|
62
47
|
npx --yes huaweicloud-devkit status --target codearts
|
|
63
48
|
npx --yes huaweicloud-devkit update --target codearts
|
|
64
49
|
npx --yes huaweicloud-devkit uninstall --target codearts
|
|
65
50
|
```
|
|
66
51
|
|
|
67
|
-
> **沙箱模式**:码道默认沙箱模式会阻止 KooCLI 运行。`install-hcloud` 自动检测并给出指引——请在码道外终端安装使用 KooCLI,或在码道设置中关闭沙箱模式(设置 →
|
|
68
|
-
>
|
|
69
|
-
> **认证**:执行 `npx huaweicloud-devkit auth init`,统一配置 KooCLI、OBS 和沙箱接口所需的 AK/SK。
|
|
52
|
+
> **沙箱模式**:码道默认沙箱模式会阻止 KooCLI 运行。`install-hcloud` 自动检测并给出指引——请在码道外终端安装使用 KooCLI,或在码道设置中关闭沙箱模式(设置 → 对话流 → 智能体 终端命令运行模式 → 自动运行)。
|
|
70
53
|
|
|
71
54
|
### WorkBuddy
|
|
72
55
|
|
|
@@ -77,37 +60,110 @@ npx --yes huaweicloud-devkit install --target workbuddy
|
|
|
77
60
|
安装后**重启会话**。
|
|
78
61
|
|
|
79
62
|
```bash
|
|
80
|
-
npx --yes huaweicloud-devkit doctor
|
|
63
|
+
npx --yes huaweicloud-devkit doctor --target workbuddy
|
|
81
64
|
npx --yes huaweicloud-devkit status --target workbuddy
|
|
82
|
-
npx --yes huaweicloud-devkit update --target workbuddy
|
|
65
|
+
npx --yes huaweicloud-devkit update --target workbuddy
|
|
83
66
|
npx --yes huaweicloud-devkit uninstall --target workbuddy
|
|
84
67
|
```
|
|
85
68
|
|
|
86
|
-
|
|
69
|
+
### DeepSeek Harness(DSH)
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npx --yes huaweicloud-devkit install --target dsh
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
安装后**重启 DSH 会话**。
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npx --yes huaweicloud-devkit doctor --target dsh
|
|
79
|
+
npx --yes huaweicloud-devkit status --target dsh
|
|
80
|
+
npx --yes huaweicloud-devkit update --target dsh
|
|
81
|
+
npx --yes huaweicloud-devkit uninstall --target dsh
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
> DSH V1 通过 `@deepseek-ai/dsh-mcp-client` 复用现有 MCP Server。如果安装器提示客户端未检测到,请执行:`npx @deepseek-ai/dsh plugin --profile web add @deepseek-ai/dsh-mcp-client`。
|
|
85
|
+
|
|
86
|
+
### OfficeAce
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npx --yes huaweicloud-devkit install --target officeace
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
安装后**重启 OfficeAce**。
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx --yes huaweicloud-devkit doctor --target officeace
|
|
96
|
+
npx --yes huaweicloud-devkit status --target officeace
|
|
97
|
+
npx --yes huaweicloud-devkit update --target officeace
|
|
98
|
+
npx --yes huaweicloud-devkit uninstall --target officeace
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### OpenClaw
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
# 推荐方式 (ClawHub)
|
|
105
|
+
openclaw plugins install clawhub:huaweicloud-devkit
|
|
106
|
+
openclaw plugins uninstall huaweicloud-devkit
|
|
107
|
+
openclaw plugins update huaweicloud-devkit
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
安装后**重启 OpenClaw**。如提示安全风险确认,加 `--acknowledge-clawhub-risk`。
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# 或通过 npx
|
|
114
|
+
npx --yes huaweicloud-devkit install --target openclaw
|
|
115
|
+
npx --yes huaweicloud-devkit status --target openclaw
|
|
116
|
+
npx --yes huaweicloud-devkit update --target openclaw
|
|
117
|
+
npx --yes huaweicloud-devkit uninstall --target openclaw
|
|
118
|
+
rm -rf ~/.npm/_npx/ # 仅 Linux/macOS;Windows 路径待确认
|
|
119
|
+
```
|
|
87
120
|
|
|
88
121
|
### 其他 Agent
|
|
89
122
|
|
|
90
|
-
|
|
123
|
+
任何支持 MCP 协议的 Agent,直接使用标准 MCP 配置:
|
|
91
124
|
|
|
92
125
|
```json
|
|
93
126
|
{
|
|
94
|
-
"
|
|
127
|
+
"mcpServers": {
|
|
95
128
|
"huaweicloud-devkit": {
|
|
96
|
-
"
|
|
97
|
-
"
|
|
98
|
-
"enabled": true
|
|
129
|
+
"command": "npx",
|
|
130
|
+
"args": ["-y", "-p", "huaweicloud-devkit", "huaweicloud-devkit-mcp"]
|
|
99
131
|
}
|
|
100
132
|
}
|
|
101
133
|
}
|
|
102
134
|
```
|
|
103
135
|
|
|
104
|
-
|
|
136
|
+
无需预安装 — `npx` 自动处理一切。
|
|
137
|
+
|
|
138
|
+
> 项目级 AK/SK 可通过 MCP 配置的 `env` 字段设置 `HW_ACCESS_KEY`/`HW_SECRET_KEY`。
|
|
139
|
+
|
|
140
|
+
### 安装 KooCLI
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
npx --yes huaweicloud-devkit install-hcloud
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### 配置凭据
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
npx --yes huaweicloud-devkit auth init
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
一步同步 AK/SK 到 KooCLI、OBS 和沙箱接口。
|
|
153
|
+
|
|
154
|
+
### 安装所有 Agent
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
npx --yes huaweicloud-devkit install --target all
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### 更新所有 Agent
|
|
105
161
|
|
|
106
162
|
```bash
|
|
107
|
-
npx --yes huaweicloud-devkit
|
|
163
|
+
npx --yes huaweicloud-devkit update --target all
|
|
108
164
|
```
|
|
109
165
|
|
|
110
|
-
|
|
166
|
+
`update` 是增量更新——只刷新已安装的文件,不动配置文件。
|
|
111
167
|
|
|
112
168
|
## 功能特性
|
|
113
169
|
|
|
@@ -115,6 +171,7 @@ npx --yes huaweicloud-devkit install
|
|
|
115
171
|
- **安全优先执行** — 所有写操作需用户明确批准;凭证和密钥自动脱敏
|
|
116
172
|
- **执行前风险检查** — 公网暴露、凭证泄露、破坏性操作在执行前即被拦截
|
|
117
173
|
- **区域感知** — 自动发现可用区域,创建资源前检查服务可用性
|
|
174
|
+
- **沙箱(DevStation)** — 临时云端运行环境,部署 Web 应用并即刻获得公网预览地址
|
|
118
175
|
|
|
119
176
|
## 支持的服务
|
|
120
177
|
|
|
@@ -125,6 +182,7 @@ ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、M
|
|
|
125
182
|
- [架构](docs/architecture.md)
|
|
126
183
|
- [安全模型](docs/safety-model.md)
|
|
127
184
|
- [Hook 规则模型](docs/hook-rule-model.md)
|
|
185
|
+
- [DeepSeek Harness 集成](docs/dsh-integration.md)
|
|
128
186
|
- [变更记录](docs/CHANGELOG.md)
|
|
129
187
|
- [KooCLI 官方文档](https://support.huaweicloud.com/qs-hcli/hcli_02_003.html)
|
|
130
188
|
|
package/bin/setup.cjs
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
'use strict';
|
|
3
|
-
const path = require('path');
|
|
4
|
-
const fileUrl = require('url').pathToFileURL(
|
|
5
|
-
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const fileUrl = require('node:url').pathToFileURL(
|
|
5
|
+
path.join(__dirname, '..', 'plugins', 'huaweicloud-core', 'src', 'setup-cli.mjs'),
|
|
6
|
+
).href;
|
|
7
|
+
import(fileUrl).catch((e) => {
|
|
6
8
|
console.error(e.message);
|
|
7
9
|
process.exit(1);
|
|
8
10
|
});
|
package/package.json
CHANGED
|
@@ -1,44 +1,63 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
"
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
"
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
"
|
|
41
|
-
"
|
|
42
|
-
|
|
43
|
-
|
|
2
|
+
"name": "huaweicloud-devkit",
|
|
3
|
+
"version": "1.0.3-next.0",
|
|
4
|
+
"description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"files": [
|
|
7
|
+
"bin",
|
|
8
|
+
".agents",
|
|
9
|
+
"plugins/huaweicloud-core",
|
|
10
|
+
"integrations/opencode"
|
|
11
|
+
],
|
|
12
|
+
"bin": {
|
|
13
|
+
"huaweicloud-devkit": "./bin/setup.cjs",
|
|
14
|
+
"huaweicloud-devkit-mcp": "./plugins/huaweicloud-core/src/mcp-server.mjs"
|
|
15
|
+
},
|
|
16
|
+
"repository": {
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "https://github.com/huaweicloud/huaweicloud-devkit.git"
|
|
19
|
+
},
|
|
20
|
+
"scripts": {
|
|
21
|
+
"test": "node --test",
|
|
22
|
+
"format": "prettier --write .",
|
|
23
|
+
"format:check": "prettier --check .",
|
|
24
|
+
"lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\"",
|
|
25
|
+
"lint:js": "eslint .",
|
|
26
|
+
"lint": "npm run lint:md && npm run lint:js",
|
|
27
|
+
"validate": "node ./scripts/validate-package.mjs",
|
|
28
|
+
"pack:verify": "node ./scripts/pack-verify.mjs",
|
|
29
|
+
"postinstall": "node -e \"console.log('\\nHuaweiCloud DevKit installed. Run: npx huaweicloud-devkit install\\n')\""
|
|
30
|
+
},
|
|
31
|
+
"dependencies": {
|
|
32
|
+
"better-sqlite3": "^13.0.3",
|
|
33
|
+
"undici": "^8.10.0"
|
|
34
|
+
},
|
|
35
|
+
"devDependencies": {
|
|
36
|
+
"@eslint/js": "^10.0.1",
|
|
37
|
+
"eslint": "^10.8.1",
|
|
38
|
+
"eslint-config-prettier": "^10.1.8",
|
|
39
|
+
"eslint-plugin-n": "^18.3.0",
|
|
40
|
+
"globals": "^17.11.0",
|
|
41
|
+
"markdownlint-cli2": "^0.23.2",
|
|
42
|
+
"prettier": "^3.9.6"
|
|
43
|
+
},
|
|
44
|
+
"keywords": [
|
|
45
|
+
"huaweicloud",
|
|
46
|
+
"huawei-cloud",
|
|
47
|
+
"agent",
|
|
48
|
+
"codex",
|
|
49
|
+
"opencode",
|
|
50
|
+
"officeace",
|
|
51
|
+
"office-claw",
|
|
52
|
+
"workbuddy",
|
|
53
|
+
"dsh",
|
|
54
|
+
"deepseek-harness",
|
|
55
|
+
"mcp",
|
|
56
|
+
"koocli",
|
|
57
|
+
"hcloud"
|
|
58
|
+
],
|
|
59
|
+
"license": "Apache-2.0",
|
|
60
|
+
"engines": {
|
|
61
|
+
"node": ">=22"
|
|
62
|
+
}
|
|
44
63
|
}
|
|
@@ -5,10 +5,7 @@
|
|
|
5
5
|
"longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
|
|
6
6
|
"developerName": "HuaweiCloud Mate",
|
|
7
7
|
"category": "Cloud",
|
|
8
|
-
"capabilities": [
|
|
9
|
-
"Read",
|
|
10
|
-
"Interactive"
|
|
11
|
-
],
|
|
8
|
+
"capabilities": ["Read", "Interactive"],
|
|
12
9
|
"websiteURL": "https://github.com/huaweicloud/HuaweiCloud-Devkit",
|
|
13
10
|
"brandColor": "#C7000B",
|
|
14
11
|
"defaultPrompt": [
|
|
@@ -20,25 +17,15 @@
|
|
|
20
17
|
"mcpServers": "./.mcp.json",
|
|
21
18
|
"description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
|
|
22
19
|
"skills": "./skills/",
|
|
23
|
-
"version": "1.0.3-
|
|
20
|
+
"version": "1.0.3-next.0",
|
|
24
21
|
"author": {
|
|
25
22
|
"name": "HuaweiCloud Mate",
|
|
26
23
|
"url": "https://github.com/huaweicloud"
|
|
27
24
|
},
|
|
28
25
|
"hooks": "./hooks/",
|
|
29
|
-
"name": "huaweicloud-
|
|
26
|
+
"name": "huaweicloud-devkit",
|
|
30
27
|
"homepage": "https://github.com/huaweicloud/HuaweiCloud-Devkit",
|
|
31
28
|
"repository": "https://github.com/huaweicloud/HuaweiCloud-Devkit",
|
|
32
29
|
"license": "Apache-2.0",
|
|
33
|
-
"keywords": [
|
|
34
|
-
"huaweicloud",
|
|
35
|
-
"huawei-cloud",
|
|
36
|
-
"koocli",
|
|
37
|
-
"hcloud",
|
|
38
|
-
"agent",
|
|
39
|
-
"mcp",
|
|
40
|
-
"api",
|
|
41
|
-
"sdk",
|
|
42
|
-
"skills"
|
|
43
|
-
]
|
|
30
|
+
"keywords": ["huaweicloud", "huawei-cloud", "koocli", "hcloud", "agent", "mcp", "api", "sdk", "skills"]
|
|
44
31
|
}
|