@delta-infra/cli 1.1.0 → 1.1.1
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/README.md +12 -2
- package/checksums.txt +5 -5
- package/package.json +1 -1
- package/scripts/install-wizard.js +701 -701
- package/scripts/install.js +442 -442
- package/scripts/run.js +65 -65
- package/skills/delta-sandbox/SKILL.md +383 -383
- package/skills/delta-sandbox/agents/openai.yaml +4 -4
- package/skills/delta-sandbox/references/commands.md +58 -58
- package/skills/delta-sandbox/references/lifecycle.md +100 -100
- package/skills/delta-sandbox/references/recipes.md +138 -138
- package/skills/delta-science/AGENTS.md +47 -47
- package/skills/delta-science/SKILL.md +174 -151
- package/skills/delta-science/agents/openai.yaml +4 -4
- package/skills/delta-science/references/antbo.md +100 -100
- package/skills/delta-science/references/delta-bo.md +89 -89
- package/skills/delta-science/references/gsasii.md +116 -116
- package/skills/delta-science/references/lammps.md +66 -66
- package/skills/delta-science/references/ldm-bo.md +129 -129
- package/skills/delta-science/references/materials-design.md +118 -109
- package/skills/delta-science/references/pubchem.md +126 -126
- package/skills/delta-science/references/pymatgen.md +68 -68
- package/skills/delta-science/references/qe.md +125 -123
- package/skills/delta-science/references/rdkit.md +138 -138
- package/skills/delta-science/references/strbo.md +87 -87
- package/skills/delta-science/references/synbo.md +198 -198
- package/skills/delta-science/scripts/catalog.py +92 -92
- package/skills/delta-science/scripts/generated_catalog.py +69 -69
- package/skills/delta-science/scripts/invoke.py +346 -346
- package/skills/delta-shared/SKILL.md +97 -97
- package/skills/delta-shared/agents/openai.yaml +4 -4
- package/skills/manifest.json +19 -19
|
@@ -1,97 +1,97 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: delta-shared
|
|
3
|
-
description: "delta-cli 全局共享规则:配置/认证检查、安全红线、错误处理、sandbox 销毁。"
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# delta-cli 共享规则
|
|
7
|
-
|
|
8
|
-
指导 AI 使用 `delta-cli` 的通用规则。核心原则:**只检查、不猜测、不泄露密钥**。
|
|
9
|
-
|
|
10
|
-
## 执行任何操作之前
|
|
11
|
-
|
|
12
|
-
1. 确认服务端地址:
|
|
13
|
-
```bash
|
|
14
|
-
delta-cli config show
|
|
15
|
-
```
|
|
16
|
-
2. 确认认证状态:
|
|
17
|
-
```bash
|
|
18
|
-
delta-cli auth status
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
- 若 `auth status` 显示 `method: token`,**直接执行目标命令**,不要重复登录或初始化配置。
|
|
22
|
-
- 若显示 `method: none`,或操作返回 `error.type: auth` / `permission`,才进入下面的“补全配置”流程。
|
|
23
|
-
|
|
24
|
-
## 补全配置
|
|
25
|
-
|
|
26
|
-
缺少服务端地址或凭证时,**向用户询问一次**,然后用 flag 初始化:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
delta-cli config init --base-url <server-url> --token <token>
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
不要用交互式 `config init`(无 flag),避免在 stdin 不可用时卡住。
|
|
33
|
-
|
|
34
|
-
### 信息来源优先级
|
|
35
|
-
|
|
36
|
-
1. 环境变量:`DELTA_INFRA_BASE_URL`、`DELTA_INFRA_TOKEN`
|
|
37
|
-
2. `~/.delta-infra/config.json` 中的 `base_url` / `token`
|
|
38
|
-
3. 默认值:仅 `base_url` 有内部默认值
|
|
39
|
-
4. 以上都缺失时,**必须询问用户**,禁止虚构
|
|
40
|
-
|
|
41
|
-
### 运行时凭证
|
|
42
|
-
|
|
43
|
-
CLI 使用 `token` 发送请求头 `Authorization: Bearer <token>`,并自动从 JWT 中提取 `uid` 作为 `X-User-Uid`。
|
|
44
|
-
|
|
45
|
-
## 安全红线
|
|
46
|
-
|
|
47
|
-
- **禁止输出密钥**:`token` 不得出现在日志、消息、终端。
|
|
48
|
-
- **禁止自己拼 URL / 构造 HTTP 请求**:所有请求都走 `delta-cli`。
|
|
49
|
-
- **不要主动安装 CLI**:如果用户说没装,建议他去 README 或 install.sh,不要自己选安装方式。
|
|
50
|
-
- **写入/删除操作前确认意图**:`sandbox kill`、`sandbox finish`、`sandbox write` 等必须告诉用户影响。
|
|
51
|
-
- `~/.delta-infra/config.json` 权限为 `0600`,不要手动放宽。
|
|
52
|
-
- **sandbox 必须销毁**:调用 `sandbox create` 后,当前任务结束前必须调用 `sandbox kill`。server 端无自动清理,不销毁 = 永久占用 GPU;即使出错也不得跳过。
|
|
53
|
-
|
|
54
|
-
## JSON 输出约定
|
|
55
|
-
|
|
56
|
-
```json
|
|
57
|
-
{"ok":true,"data":{...}}
|
|
58
|
-
{"ok":false,"error":{"type":"auth","message":"...","hint":"..."}}
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
AI Agent 解析规则:
|
|
62
|
-
- 始终检查 `ok`,不要只看 exit code。
|
|
63
|
-
- `error.type` 是稳定分支字段:`auth`, `permission`, `not_found`, `validation`, `network`, `api`, `command_failed`, `internal`。
|
|
64
|
-
- `error.hint` 可展示给用户。
|
|
65
|
-
|
|
66
|
-
## 退出码约定
|
|
67
|
-
|
|
68
|
-
| Type | Exit Code | 场景 |
|
|
69
|
-
|------|-----------|------|
|
|
70
|
-
| validation | 2 | flag / 参数错误 |
|
|
71
|
-
| auth | 3 | 未认证或认证失败 |
|
|
72
|
-
| permission | 4 | 权限不足 |
|
|
73
|
-
| not_found | 5 | sandbox/file 不存在 |
|
|
74
|
-
| network | 6 | DNS、超时、连接失败 |
|
|
75
|
-
| api | 7 | 服务端非 2xx |
|
|
76
|
-
| command_failed | 8 | sandbox 内命令执行失败(非零 exit_code 或报错);SSE 路径在 complete 帧后追加该 error 信封,**message 附 stderr 尾部**便于快速扫读 |
|
|
77
|
-
| internal | 10 | 客户端内部错误 |
|
|
78
|
-
|
|
79
|
-
## 升级检查
|
|
80
|
-
|
|
81
|
-
完成用户请求后,如果 JSON 中有 `_notice.update`,可建议:
|
|
82
|
-
|
|
83
|
-
```bash
|
|
84
|
-
delta-cli upgrade
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
## 常见恢复
|
|
88
|
-
|
|
89
|
-
| 错误 / 现象 | 恢复动作 |
|
|
90
|
-
|-------------|----------|
|
|
91
|
-
| `error.type: auth` / `method: none` | 询问用户后执行 `config init --base-url <url> --token <token>` |
|
|
92
|
-
| `error.type: permission` | 确认当前认证是否有权限;必要时换 token |
|
|
93
|
-
| `error.type: not_found` | 检查 `sandbox_id` / path |
|
|
94
|
-
| `error.type: network` | 检查 `base_url` 和网络连通性 |
|
|
95
|
-
| `error.type: validation` | 检查必填 flag 和参数格式 |
|
|
96
|
-
| `error.type: command_failed` | sandbox 内命令失败:信封 `message` 已带 stderr 尾部,可快速定位;完整 `stderr`/`result_summary` 在 complete 帧里,重试或修正命令 |
|
|
97
|
-
| 配置文件解析失败 | 检查 `~/.delta-infra/config.json` 是否为有效 JSON |
|
|
1
|
+
---
|
|
2
|
+
name: delta-shared
|
|
3
|
+
description: "delta-cli 全局共享规则:配置/认证检查、安全红线、错误处理、sandbox 销毁。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# delta-cli 共享规则
|
|
7
|
+
|
|
8
|
+
指导 AI 使用 `delta-cli` 的通用规则。核心原则:**只检查、不猜测、不泄露密钥**。
|
|
9
|
+
|
|
10
|
+
## 执行任何操作之前
|
|
11
|
+
|
|
12
|
+
1. 确认服务端地址:
|
|
13
|
+
```bash
|
|
14
|
+
delta-cli config show
|
|
15
|
+
```
|
|
16
|
+
2. 确认认证状态:
|
|
17
|
+
```bash
|
|
18
|
+
delta-cli auth status
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
- 若 `auth status` 显示 `method: token`,**直接执行目标命令**,不要重复登录或初始化配置。
|
|
22
|
+
- 若显示 `method: none`,或操作返回 `error.type: auth` / `permission`,才进入下面的“补全配置”流程。
|
|
23
|
+
|
|
24
|
+
## 补全配置
|
|
25
|
+
|
|
26
|
+
缺少服务端地址或凭证时,**向用户询问一次**,然后用 flag 初始化:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
delta-cli config init --base-url <server-url> --token <token>
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
不要用交互式 `config init`(无 flag),避免在 stdin 不可用时卡住。
|
|
33
|
+
|
|
34
|
+
### 信息来源优先级
|
|
35
|
+
|
|
36
|
+
1. 环境变量:`DELTA_INFRA_BASE_URL`、`DELTA_INFRA_TOKEN`
|
|
37
|
+
2. `~/.delta-infra/config.json` 中的 `base_url` / `token`
|
|
38
|
+
3. 默认值:仅 `base_url` 有内部默认值
|
|
39
|
+
4. 以上都缺失时,**必须询问用户**,禁止虚构
|
|
40
|
+
|
|
41
|
+
### 运行时凭证
|
|
42
|
+
|
|
43
|
+
CLI 使用 `token` 发送请求头 `Authorization: Bearer <token>`,并自动从 JWT 中提取 `uid` 作为 `X-User-Uid`。
|
|
44
|
+
|
|
45
|
+
## 安全红线
|
|
46
|
+
|
|
47
|
+
- **禁止输出密钥**:`token` 不得出现在日志、消息、终端。
|
|
48
|
+
- **禁止自己拼 URL / 构造 HTTP 请求**:所有请求都走 `delta-cli`。
|
|
49
|
+
- **不要主动安装 CLI**:如果用户说没装,建议他去 README 或 install.sh,不要自己选安装方式。
|
|
50
|
+
- **写入/删除操作前确认意图**:`sandbox kill`、`sandbox finish`、`sandbox write` 等必须告诉用户影响。
|
|
51
|
+
- `~/.delta-infra/config.json` 权限为 `0600`,不要手动放宽。
|
|
52
|
+
- **sandbox 必须销毁**:调用 `sandbox create` 后,当前任务结束前必须调用 `sandbox kill`。server 端无自动清理,不销毁 = 永久占用 GPU;即使出错也不得跳过。
|
|
53
|
+
|
|
54
|
+
## JSON 输出约定
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{"ok":true,"data":{...}}
|
|
58
|
+
{"ok":false,"error":{"type":"auth","message":"...","hint":"..."}}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
AI Agent 解析规则:
|
|
62
|
+
- 始终检查 `ok`,不要只看 exit code。
|
|
63
|
+
- `error.type` 是稳定分支字段:`auth`, `permission`, `not_found`, `validation`, `network`, `api`, `command_failed`, `internal`。
|
|
64
|
+
- `error.hint` 可展示给用户。
|
|
65
|
+
|
|
66
|
+
## 退出码约定
|
|
67
|
+
|
|
68
|
+
| Type | Exit Code | 场景 |
|
|
69
|
+
|------|-----------|------|
|
|
70
|
+
| validation | 2 | flag / 参数错误 |
|
|
71
|
+
| auth | 3 | 未认证或认证失败 |
|
|
72
|
+
| permission | 4 | 权限不足 |
|
|
73
|
+
| not_found | 5 | sandbox/file 不存在 |
|
|
74
|
+
| network | 6 | DNS、超时、连接失败 |
|
|
75
|
+
| api | 7 | 服务端非 2xx |
|
|
76
|
+
| command_failed | 8 | sandbox 内命令执行失败(非零 exit_code 或报错);SSE 路径在 complete 帧后追加该 error 信封,**message 附 stderr 尾部**便于快速扫读 |
|
|
77
|
+
| internal | 10 | 客户端内部错误 |
|
|
78
|
+
|
|
79
|
+
## 升级检查
|
|
80
|
+
|
|
81
|
+
完成用户请求后,如果 JSON 中有 `_notice.update`,可建议:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
delta-cli upgrade
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## 常见恢复
|
|
88
|
+
|
|
89
|
+
| 错误 / 现象 | 恢复动作 |
|
|
90
|
+
|-------------|----------|
|
|
91
|
+
| `error.type: auth` / `method: none` | 询问用户后执行 `config init --base-url <url> --token <token>` |
|
|
92
|
+
| `error.type: permission` | 确认当前认证是否有权限;必要时换 token |
|
|
93
|
+
| `error.type: not_found` | 检查 `sandbox_id` / path |
|
|
94
|
+
| `error.type: network` | 检查 `base_url` 和网络连通性 |
|
|
95
|
+
| `error.type: validation` | 检查必填 flag 和参数格式 |
|
|
96
|
+
| `error.type: command_failed` | sandbox 内命令失败:信封 `message` 已带 stderr 尾部,可快速定位;完整 `stderr`/`result_summary` 在 complete 帧里,重试或修正命令 |
|
|
97
|
+
| 配置文件解析失败 | 检查 `~/.delta-infra/config.json` 是否为有效 JSON |
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
interface:
|
|
2
|
-
display_name: "Delta CLI 共享规则"
|
|
3
|
-
short_description: "处理 Delta CLI 的配置、认证、错误与安全边界"
|
|
4
|
-
default_prompt: "使用 $delta-shared 检查并处理 Delta CLI 的配置或认证问题。"
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Delta CLI 共享规则"
|
|
3
|
+
short_description: "处理 Delta CLI 的配置、认证、错误与安全边界"
|
|
4
|
+
default_prompt: "使用 $delta-shared 检查并处理 Delta CLI 的配置或认证问题。"
|
package/skills/manifest.json
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skills": [
|
|
3
|
-
"delta-sandbox",
|
|
4
|
-
"delta-shared",
|
|
5
|
-
"delta-science"
|
|
6
|
-
],
|
|
7
|
-
"retired_skills": [
|
|
8
|
-
"pubchem",
|
|
9
|
-
"rdkit",
|
|
10
|
-
"pymatgen",
|
|
11
|
-
"gsasii",
|
|
12
|
-
"lammps",
|
|
13
|
-
"delta-bo",
|
|
14
|
-
"ldm-bo",
|
|
15
|
-
"synbo-service",
|
|
16
|
-
"antbo-service",
|
|
17
|
-
"antbo-ldm-guard"
|
|
18
|
-
]
|
|
19
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"skills": [
|
|
3
|
+
"delta-sandbox",
|
|
4
|
+
"delta-shared",
|
|
5
|
+
"delta-science"
|
|
6
|
+
],
|
|
7
|
+
"retired_skills": [
|
|
8
|
+
"pubchem",
|
|
9
|
+
"rdkit",
|
|
10
|
+
"pymatgen",
|
|
11
|
+
"gsasii",
|
|
12
|
+
"lammps",
|
|
13
|
+
"delta-bo",
|
|
14
|
+
"ldm-bo",
|
|
15
|
+
"synbo-service",
|
|
16
|
+
"antbo-service",
|
|
17
|
+
"antbo-ldm-guard"
|
|
18
|
+
]
|
|
19
|
+
}
|