@zleap-ai/sag-cli 0.6.0 → 0.6.2
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/dist/cli.js +115 -26
- package/dist/cli.js.map +1 -1
- package/dist/sag-knowledge.zip +0 -0
- package/dist/skill-cli.cjs +3 -3
- package/package.json +1 -1
- package/skill/SKILL.md +32 -15
- package/skill/manifest.json +2 -2
- package/skill/references/cli-reference.md +17 -13
- package/skill/scripts/sag-knowledge.cjs +3 -3
package/package.json
CHANGED
package/skill/SKILL.md
CHANGED
|
@@ -19,26 +19,43 @@ metadata:
|
|
|
19
19
|
node scripts/sag-knowledge.cjs version --output ndjson
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
保存 Origin 的 Skill，向用户询问完整的 SAG 地址，包括 `http://` 或 `https://`；
|
|
24
|
-
两种协议都可接受。
|
|
22
|
+
先让运行程序解析安装或授权时保存的当前 Origin：
|
|
25
23
|
|
|
26
|
-
|
|
24
|
+
```bash
|
|
25
|
+
node scripts/sag-knowledge.cjs skill auth status --output ndjson
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
不要在首次尝试前询问 Origin，也不要直接读取 `~/.sag/config.json`。只有命令返回
|
|
29
|
+
`AUTH_REQUIRED` 且 `error.details.required_option` 为 `--origin` 时，才询问用户完整的
|
|
30
|
+
SAG 地址，包括 `http://` 或 `https://`；两种协议都可接受。用户明确切换 SAG 服务时，
|
|
31
|
+
可用 `--origin <sag-origin>` 覆盖保存的当前 Origin。
|
|
32
|
+
|
|
33
|
+
命令返回 `AUTH_REQUIRED` 时，先让用户选择授权方式。优先询问是否持有管理员提供的
|
|
34
|
+
开放链接令牌；持有时执行：
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
node scripts/sag-knowledge.cjs skill auth paste-token --origin <sag-origin> --token <open-link-token> --output ndjson
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
令牌的知识库范围、工具权限和有效性完全跟随该开放链接。令牌无效、链接暂停或已撤销时，
|
|
41
|
+
直接说明凭据已失效，并请用户向链接管理员索取当前令牌；不尝试改用账号授权。
|
|
42
|
+
|
|
43
|
+
用户选择浏览器授权时，为当前已登录的 SAG 账号发起授权：
|
|
27
44
|
|
|
28
45
|
```bash
|
|
29
46
|
node scripts/sag-knowledge.cjs skill auth login --origin <sag-origin> --output ndjson
|
|
30
47
|
```
|
|
31
48
|
|
|
32
|
-
告知用户在打开的 SAG
|
|
33
|
-
|
|
49
|
+
告知用户在打开的 SAG 页面完成授权。运行程序会把当前 Origin 的授权保存到
|
|
50
|
+
`~/.sag/config.json`；手动令牌和浏览器账号授权会互相替换，账号会话会在需要时自动刷新。
|
|
34
51
|
|
|
35
52
|
## 读取与问答
|
|
36
53
|
|
|
37
54
|
```bash
|
|
38
|
-
node scripts/sag-knowledge.cjs skill knowledge list --
|
|
39
|
-
node scripts/sag-knowledge.cjs skill knowledge documents --
|
|
40
|
-
node scripts/sag-knowledge.cjs skill knowledge ask <question> --
|
|
41
|
-
node scripts/sag-knowledge.cjs skill knowledge ask <question> --
|
|
55
|
+
node scripts/sag-knowledge.cjs skill knowledge list --output ndjson
|
|
56
|
+
node scripts/sag-knowledge.cjs skill knowledge documents --knowledge-base <name-or-id> --output ndjson
|
|
57
|
+
node scripts/sag-knowledge.cjs skill knowledge ask <question> --output ndjson
|
|
58
|
+
node scripts/sag-knowledge.cjs skill knowledge ask <question> --knowledge-base <name-or-id> --output ndjson
|
|
42
59
|
```
|
|
43
60
|
|
|
44
61
|
全局问答时省略 `--knowledge-base`，让 SAG 应用当前搜索策略。保留 SAG 返回的
|
|
@@ -50,11 +67,11 @@ node scripts/sag-knowledge.cjs skill knowledge ask <question> --origin <sag-orig
|
|
|
50
67
|
不明确，询问：`是否上传到 xx 知识库？`。用户已经明确目标和操作时，不要重复询问。
|
|
51
68
|
|
|
52
69
|
```bash
|
|
53
|
-
node scripts/sag-knowledge.cjs skill knowledge upload <path> --
|
|
54
|
-
node scripts/sag-knowledge.cjs skill knowledge upload <path> --
|
|
55
|
-
node scripts/sag-knowledge.cjs skill knowledge upload-status <import-id> --
|
|
56
|
-
node scripts/sag-knowledge.cjs skill knowledge rename <document-id> --
|
|
57
|
-
node scripts/sag-knowledge.cjs skill knowledge delete <document-id> --
|
|
70
|
+
node scripts/sag-knowledge.cjs skill knowledge upload <path> --knowledge-base <name-or-id> --output ndjson
|
|
71
|
+
node scripts/sag-knowledge.cjs skill knowledge upload <path> --knowledge-base <name-or-id> --overwrite-document-id <existing-document-id> --output ndjson
|
|
72
|
+
node scripts/sag-knowledge.cjs skill knowledge upload-status <import-id> --knowledge-base <name-or-id> --output ndjson
|
|
73
|
+
node scripts/sag-knowledge.cjs skill knowledge rename <document-id> --knowledge-base <name-or-id> --expected-version <n> --title <title> --output ndjson
|
|
74
|
+
node scripts/sag-knowledge.cjs skill knowledge delete <document-id> --knowledge-base <name-or-id> --expected-version <n> --output ndjson
|
|
58
75
|
```
|
|
59
76
|
|
|
60
77
|
一次只上传一个普通文件，不得上传文件夹或批量文件。文件超过 SAG 当前有效限制
|
package/skill/manifest.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"schema": 1,
|
|
3
3
|
"name": "sag-knowledge",
|
|
4
4
|
"package": "@zleap-ai/sag-cli",
|
|
5
|
-
"packageVersion": "0.6.
|
|
5
|
+
"packageVersion": "0.6.2",
|
|
6
6
|
"agent": "template",
|
|
7
|
-
"bundleDigest": "sha256:
|
|
7
|
+
"bundleDigest": "sha256:c59f5a54da5dc900f241172854ebffcb916f7ffb504d631e3a50ca226204abef"
|
|
8
8
|
}
|
|
@@ -1,25 +1,29 @@
|
|
|
1
1
|
# sag-knowledge 命令参考
|
|
2
2
|
|
|
3
3
|
通过 `node scripts/sag-knowledge.cjs` 运行随 Skill 一起复制的运行程序。
|
|
4
|
-
本文中的每条命令都使用 `--output ndjson
|
|
4
|
+
本文中的每条命令都使用 `--output ndjson`；逐行解析标准输出。默认省略 `--origin`，
|
|
5
|
+
让运行程序使用安装或授权时保存的当前 Origin；只有用户明确切换服务时才传入它。
|
|
5
6
|
|
|
6
7
|
## 账号授权
|
|
7
8
|
|
|
8
9
|
```bash
|
|
10
|
+
node scripts/sag-knowledge.cjs skill auth paste-token --origin <sag-origin> --token <open-link-token> --output ndjson
|
|
9
11
|
node scripts/sag-knowledge.cjs skill auth login --origin <sag-origin> --output ndjson
|
|
10
|
-
node scripts/sag-knowledge.cjs skill auth status --
|
|
11
|
-
node scripts/sag-knowledge.cjs skill auth logout --
|
|
12
|
+
node scripts/sag-knowledge.cjs skill auth status --output ndjson
|
|
13
|
+
node scripts/sag-knowledge.cjs skill auth logout --output ndjson
|
|
12
14
|
```
|
|
13
15
|
|
|
14
|
-
`
|
|
15
|
-
|
|
16
|
+
`paste-token` 保存管理员提供的开放链接令牌；它的范围和有效性由链接决定。`login`
|
|
17
|
+
会打开 SAG 授权页面，并保存该 Origin 对应的账号会话。两种方式会替换该 Origin 的上一份
|
|
18
|
+
授权。`status` 只报告当前 Origin 和授权方式，不输出令牌。首次执行 `status` 返回缺少
|
|
19
|
+
`--origin` 的 `AUTH_REQUIRED` 时，再向用户询问完整地址。`logout` 删除当前授权。
|
|
16
20
|
|
|
17
21
|
## 知识库与问答
|
|
18
22
|
|
|
19
23
|
```bash
|
|
20
|
-
node scripts/sag-knowledge.cjs skill knowledge list --
|
|
21
|
-
node scripts/sag-knowledge.cjs skill knowledge documents --
|
|
22
|
-
node scripts/sag-knowledge.cjs skill knowledge ask <question>
|
|
24
|
+
node scripts/sag-knowledge.cjs skill knowledge list --output ndjson
|
|
25
|
+
node scripts/sag-knowledge.cjs skill knowledge documents --knowledge-base <name-or-id> --output ndjson
|
|
26
|
+
node scripts/sag-knowledge.cjs skill knowledge ask <question> [--knowledge-base <name-or-id>] --output ndjson
|
|
23
27
|
```
|
|
24
28
|
|
|
25
29
|
知识库选择器接受准确的 ID、准确的别名，或忽略大小写后唯一匹配的名称。只有
|
|
@@ -29,11 +33,11 @@ node scripts/sag-knowledge.cjs skill knowledge ask <question> --origin <sag-orig
|
|
|
29
33
|
## 文档操作
|
|
30
34
|
|
|
31
35
|
```bash
|
|
32
|
-
node scripts/sag-knowledge.cjs skill knowledge upload <path> --
|
|
33
|
-
node scripts/sag-knowledge.cjs skill knowledge upload <path> --
|
|
34
|
-
node scripts/sag-knowledge.cjs skill knowledge upload-status <import-id> --
|
|
35
|
-
node scripts/sag-knowledge.cjs skill knowledge rename <document-id> --
|
|
36
|
-
node scripts/sag-knowledge.cjs skill knowledge delete <document-id> --
|
|
36
|
+
node scripts/sag-knowledge.cjs skill knowledge upload <path> --knowledge-base <name-or-id> [--wait <ms>] --output ndjson
|
|
37
|
+
node scripts/sag-knowledge.cjs skill knowledge upload <path> --knowledge-base <name-or-id> --overwrite-document-id <existing-document-id> [--wait <ms>] --output ndjson
|
|
38
|
+
node scripts/sag-knowledge.cjs skill knowledge upload-status <import-id> --knowledge-base <name-or-id> --output ndjson
|
|
39
|
+
node scripts/sag-knowledge.cjs skill knowledge rename <document-id> --knowledge-base <name-or-id> --expected-version <n> --title <title> --output ndjson
|
|
40
|
+
node scripts/sag-knowledge.cjs skill knowledge delete <document-id> --knowledge-base <name-or-id> --expected-version <n> --output ndjson
|
|
37
41
|
```
|
|
38
42
|
|
|
39
43
|
上传命令只接受一个普通文件。`--wait 0` 会在 SAG 接受任务后立即返回；使用返回的
|