@sokeai/cli 1.0.0 → 1.0.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 +65 -2
- package/package.json +7 -4
package/README.md
CHANGED
|
@@ -42,9 +42,52 @@ cd soke-cli
|
|
|
42
42
|
make install
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
+
## AI Agent Skills
|
|
46
|
+
|
|
47
|
+
`soke-cli` 提供了 AI Agent 技能（Skills），使 AI 助手能够自动发现和调用 CLI 功能，无需记忆复杂的命令参数。
|
|
48
|
+
|
|
49
|
+
### 安装 Skills
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 安装 CLI 后，安装 AI Agent Skills
|
|
53
|
+
npx skills add liuchenlong1111/soke-cli -y -g
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### 使用方式
|
|
57
|
+
|
|
58
|
+
安装 Skills 后，在支持 Skills 的 AI Agent（如 Claude Code）中，可以直接用自然语言描述需求：
|
|
59
|
+
|
|
60
|
+
- **"查询考试成绩"** - AI 会自动调用 `soke-cli exam +get-exam-user`
|
|
61
|
+
- **"列出最近的考试"** - AI 会自动调用 `soke-cli exam +list-exams`
|
|
62
|
+
- **"查看考试分类"** - AI 会自动调用 `soke-cli exam +list-categories`
|
|
63
|
+
|
|
64
|
+
AI Agent 会自动：
|
|
65
|
+
1. 识别你的意图
|
|
66
|
+
2. 选择合适的命令
|
|
67
|
+
3. 提示你提供必要的参数
|
|
68
|
+
4. 执行命令并展示结果
|
|
69
|
+
|
|
70
|
+
### 可用的 Skills
|
|
71
|
+
|
|
72
|
+
- **soke-shared**: 配置初始化、用户认证、权限处理等基础功能
|
|
73
|
+
- **soke-exam**: 考试管理（查询考试、考试成绩、考试分类）
|
|
74
|
+
- 更多业务模块的 Skills 正在开发中...
|
|
75
|
+
|
|
76
|
+
详细文档：[skills/README.md](skills/README.md)
|
|
77
|
+
|
|
45
78
|
## 快速开始
|
|
46
79
|
|
|
47
|
-
### 1.
|
|
80
|
+
### 1. 安装 CLI 和 Skills
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
# 安装 CLI
|
|
84
|
+
npm install -g @sokeai/cli
|
|
85
|
+
|
|
86
|
+
# 安装 AI Agent Skills（可选，推荐）
|
|
87
|
+
npx skills add liuchenlong1111/soke-cli -y -g
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### 2. 初始化配置
|
|
48
91
|
首次使用前，需要配置你的开放平台凭证：
|
|
49
92
|
```bash
|
|
50
93
|
soke-cli config init
|
|
@@ -53,7 +96,7 @@ soke-cli config init
|
|
|
53
96
|
|
|
54
97
|
可以使用 `soke-cli config show` 来查看当前配置。
|
|
55
98
|
|
|
56
|
-
###
|
|
99
|
+
### 3. 用户登录授权
|
|
57
100
|
配置完成后，进行设备授权登录：
|
|
58
101
|
```bash
|
|
59
102
|
soke-cli auth login
|
|
@@ -61,6 +104,26 @@ soke-cli auth login
|
|
|
61
104
|
命令会返回一个设备码和链接，请在浏览器中打开链接并输入设备码完成授权。成功后即可调用需要用户授权的接口。
|
|
62
105
|
如果需要退出登录，可以执行 `soke-cli auth logout`。
|
|
63
106
|
|
|
107
|
+
### 4. 开始使用
|
|
108
|
+
|
|
109
|
+
**方式一：通过 AI Agent（推荐）**
|
|
110
|
+
|
|
111
|
+
如果已安装 Skills，在 AI Agent 中直接用自然语言：
|
|
112
|
+
```
|
|
113
|
+
"查询考试成绩"
|
|
114
|
+
"列出最近的考试"
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**方式二：直接使用命令行**
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
# 查看课程列表
|
|
121
|
+
soke-cli course +list-courses --start-time 1672502400000 --end-time 1704038400000
|
|
122
|
+
|
|
123
|
+
# 查询考试成绩
|
|
124
|
+
soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
|
|
125
|
+
```
|
|
126
|
+
|
|
64
127
|
## 使用示例
|
|
65
128
|
|
|
66
129
|
### 调用快捷业务命令
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sokeai/cli",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "授客AI官方CLI工具",
|
|
3
|
+
"version": "1.0.1",
|
|
4
|
+
"description": "授客AI官方CLI工具 - 支持AI Agent Skills",
|
|
5
5
|
"bin": {
|
|
6
6
|
"soke-cli": "scripts/run.js"
|
|
7
7
|
},
|
|
@@ -15,14 +15,17 @@
|
|
|
15
15
|
],
|
|
16
16
|
"repository": {
|
|
17
17
|
"type": "git",
|
|
18
|
-
"url": "https://
|
|
18
|
+
"url": "https://github.com/liuchenlong1111/soke-cli.git"
|
|
19
19
|
},
|
|
20
20
|
"keywords": [
|
|
21
21
|
"soke",
|
|
22
22
|
"cli",
|
|
23
23
|
"授客AI",
|
|
24
24
|
"shouke",
|
|
25
|
-
"command-line"
|
|
25
|
+
"command-line",
|
|
26
|
+
"ai-agent",
|
|
27
|
+
"skills",
|
|
28
|
+
"claude-code"
|
|
26
29
|
],
|
|
27
30
|
"author": "授客AI",
|
|
28
31
|
"license": "MIT",
|