@solgridai/cli 0.1.0 → 0.2.0-beta.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/README.md +41 -0
- package/dist/index.js +1244 -46
- package/package.json +1 -1
- package/skills/solgrid-cli/SKILL.md +81 -7
package/README.md
CHANGED
|
@@ -45,6 +45,13 @@ solgrid run -p <provider> -e <endpoint> -i '{"screen_name":"nasa"}' --wait
|
|
|
45
45
|
| `files get -i <fileId>` | 查看文件的类型、大小和状态 |
|
|
46
46
|
| `files url -i <fileId>` | 为已上传的文件重新签发 24 小时有效的 URL |
|
|
47
47
|
| `files download -i <fileId> [-o path] [--force]` | 通过签名 URL 下载文件到本地 |
|
|
48
|
+
| `skills list [-q text] [--kind k] [--mine] [-l n] [--page n]` | 在 SkillHub 搜索 Skill（匹配标题和标签） |
|
|
49
|
+
| `skills get (-s slug \| -i id)` | 查看 Skill 详情 |
|
|
50
|
+
| `skills tags` | 列出 Skill 可用的标签 |
|
|
51
|
+
| `skills create [-s slug] -t <title> --kind <k> -d <text> (--dir <dir> \| --zip <file>) [--cover f] [--preview f] [--tag id]… [-y]` | 发布 Skill，创建后立即公开 |
|
|
52
|
+
| `skills update (-s slug \| -i id) [与 create 相同的内容选项]` | 修改自己的 Skill，只改传入的选项，slug 不可修改 |
|
|
53
|
+
| `skills delete (-s slug \| -i id) [-y]` | 删除自己的 Skill |
|
|
54
|
+
| `skills download -s <slug> [-o path] [--force]` | 下载 Skill 的 ZIP 包 |
|
|
48
55
|
| `generate_session_id` | 生成 12 位随机 ID，可作为任务步骤的幂等键 |
|
|
49
56
|
|
|
50
57
|
每个命令都可以用 `--help` 查看完整参数。
|
|
@@ -53,6 +60,40 @@ solgrid run -p <provider> -e <endpoint> -i '{"screen_name":"nasa"}' --wait
|
|
|
53
60
|
|
|
54
61
|
生成类工具（视频、图片等）的结果里给出的媒体链接是临时链接，大约 24 小时后失效，需要保留的请及时下载。
|
|
55
62
|
|
|
63
|
+
### SkillHub
|
|
64
|
+
|
|
65
|
+
Skill 由 slug 唯一标识，slug 就是 `SKILL.md` 头信息里的 `name`（创建后不可修改）。Skill 创建后立即在 SkillHub 公开：
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
solgrid skills create -t "Mecha portrait" --kind image \
|
|
69
|
+
-d "把照片变成机甲风格的肖像" --dir ./mecha-portrait --cover ./cover.png --tag cat_anime
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- `--dir` 指定 Skill 目录，CLI 会先检查再打包上传；也可以用 `--zip` 上传已打包好的 ZIP。目录要求：
|
|
73
|
+
- 顶层有 `SKILL.md`（大小写准确，UTF-8），以 YAML 头信息开头，之后是正文：
|
|
74
|
+
|
|
75
|
+
```markdown
|
|
76
|
+
---
|
|
77
|
+
name: mecha-portrait
|
|
78
|
+
description: 把照片变成机甲风格的肖像。在用户想要机甲风格头像时使用。
|
|
79
|
+
---
|
|
80
|
+
# Mecha portrait
|
|
81
|
+
…
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
`name` 为 1–64 个小写字母、数字或连字符，不能以连字符开头或结尾，也不能有连续的连字符；`description` 为 1–1024 个字符；
|
|
85
|
+
- 最多 200 个文件，总大小不超过 10,000,000 字节；
|
|
86
|
+
- 不能有符号链接；文件名不能包含 `:`、反斜杠或控制字符。
|
|
87
|
+
|
|
88
|
+
`.git` 和 `.DS_Store` 会被自动排除。
|
|
89
|
+
|
|
90
|
+
用 `--dir` 时 slug 默认取 `name`，传了 `-s` 就必须和 `name` 一致；用 `--zip` 时必须传 `-s`，由服务端核对。`skills update` 换包时，新包的 `name` 也必须等于原来的 slug。
|
|
91
|
+
- `-d` 是显示在标题下的简短描述（纯文本，不按 Markdown 渲染）。Skill 的详细说明请写在 `SKILL.md` 里。
|
|
92
|
+
- `--kind` 表示 Skill 产出的作品类型：`image`、`video`、`web`、`audio`。除视频外都需要封面（`--cover`）；视频和音频需要预览（`--preview`，图片、视频或音频）。
|
|
93
|
+
- `--tag` 填 `solgrid skills tags` 列出的标签 ID，最多 3 个。
|
|
94
|
+
- `create`、`delete` 会先请你确认；在脚本或 Agent 中使用时加 `-y`。
|
|
95
|
+
- `update` 只修改传入的选项；`--tag` 会替换全部标签，`--clear-tags` 清空标签，`--clear-preview` 去掉预览（仅图片和网页类 Skill）。只能修改、删除自己的 Skill。
|
|
96
|
+
|
|
56
97
|
## 给 Agent 使用
|
|
57
98
|
|
|
58
99
|
[`skills/solgrid-cli/SKILL.md`](skills/solgrid-cli/SKILL.md) 是给 Agent 的使用说明：什么时候用、标准流程、安全重试和费用注意事项。把 `skills/solgrid-cli/` 目录放进 Agent 的 skill 目录即可。npm 包里也带了这个目录，全局安装后位于 `$(npm root -g)/@solgridai/cli/skills/solgrid-cli/`。
|