rl-rockcli 0.0.12 → 0.0.13
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 +1 -96
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
# ROCK CLI (rockcli)
|
|
2
2
|
|
|
3
|
-
ROCK CLI
|
|
3
|
+
ROCK CLI 是一个开源的命令行工具，用于管理和操作沙箱环境。
|
|
4
4
|
|
|
5
5
|
## 功能特性
|
|
6
6
|
|
|
7
|
-
- **日志查询** - 搜索和实时查看日志数据
|
|
8
7
|
- **沙箱管理** - 启动、停止、执行、上传/下载文件、交互式 REPL
|
|
9
8
|
- **会话管理** - 持久化执行环境，支持环境变量继承
|
|
10
9
|
|
|
@@ -35,99 +34,6 @@ rockcli <command> [options]
|
|
|
35
34
|
|
|
36
35
|
## 命令详解
|
|
37
36
|
|
|
38
|
-
### 日志查询 (log)
|
|
39
|
-
|
|
40
|
-
日志查询功能支持两种模式：
|
|
41
|
-
- **search**：查询指定时间范围内的日志
|
|
42
|
-
- **tail**：实时滚动查看日志，每 5 秒自动刷新
|
|
43
|
-
|
|
44
|
-
#### 命令
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
# 搜索日志
|
|
48
|
-
rockcli log search [options]
|
|
49
|
-
|
|
50
|
-
# 实时滚动查看日志
|
|
51
|
-
rockcli log tail [options]
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
#### 选项说明
|
|
55
|
-
|
|
56
|
-
##### 查询条件参数
|
|
57
|
-
|
|
58
|
-
- `[sandboxId]` - 位置参数，指定沙箱 ID
|
|
59
|
-
- `--sandbox-id` - 按沙箱 ID 过滤
|
|
60
|
-
- `-k, --keyword` - 搜索关键词
|
|
61
|
-
- `-f, --field` - 按字段名和值搜索（格式：`field=value`，可多次指定）
|
|
62
|
-
- `--log-file` - 指定日志文件名（需配合 --sandbox-id 使用）
|
|
63
|
-
|
|
64
|
-
##### 时间范围参数（仅 search 支持）
|
|
65
|
-
|
|
66
|
-
- `-m, --minutes` - 搜索最近 N 分钟的日志（默认：15）
|
|
67
|
-
- `-s, --start-time` - 开始时间
|
|
68
|
-
- `-e, --end-time` - 结束时间
|
|
69
|
-
|
|
70
|
-
##### 结果控制参数
|
|
71
|
-
|
|
72
|
-
- `-l, --limit` - 限制返回结果数量（默认：100）
|
|
73
|
-
- `-o, --offset` - 跳过前 N 条日志（默认：0，仅 search 支持）
|
|
74
|
-
|
|
75
|
-
##### 输出格式参数
|
|
76
|
-
|
|
77
|
-
- `--raw` - 显示原始输出（默认：false）
|
|
78
|
-
- `--log-format` - 输出格式：`logfmt`（默认）、`json`、`columns`
|
|
79
|
-
- `--columns` - 过滤显示的字段（逗号分隔）
|
|
80
|
-
- `--multilines` - 允许多行展示（默认：false）
|
|
81
|
-
- `--truncate` - 截断长字段值（默认：2048 字符）
|
|
82
|
-
|
|
83
|
-
##### 特殊功能参数
|
|
84
|
-
|
|
85
|
-
- `--count` - 仅显示匹配的日志条数（仅 search 支持）
|
|
86
|
-
- `--debug` - 启用调试模式，输出执行的查询语句
|
|
87
|
-
- `-i, --interval` - 扫描间隔（秒），默认：5（仅 tail 支持）
|
|
88
|
-
- `-n` - 首次显示的最近日志条数，默认：10（仅 tail 支持）
|
|
89
|
-
|
|
90
|
-
#### 示例
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
# 搜索最近 15 分钟的日志
|
|
94
|
-
rockcli log search -k "error"
|
|
95
|
-
|
|
96
|
-
# 搜索最近 30 分钟的日志
|
|
97
|
-
rockcli log search -k "error" -m 30
|
|
98
|
-
|
|
99
|
-
# 使用位置参数指定沙箱 ID
|
|
100
|
-
rockcli log search abc123
|
|
101
|
-
|
|
102
|
-
# 限制返回结果数量（返回 50 条）
|
|
103
|
-
rockcli log search -k "error" -l 50
|
|
104
|
-
|
|
105
|
-
# 按字段名精确搜索
|
|
106
|
-
rockcli log search -f "level=ERROR" -m 15
|
|
107
|
-
|
|
108
|
-
# 实时滚动查看日志（默认 5 秒间隔）
|
|
109
|
-
rockcli log tail -k "error"
|
|
110
|
-
|
|
111
|
-
# 自定义扫描间隔为 10 秒
|
|
112
|
-
rockcli log tail -k "error" -i 10
|
|
113
|
-
|
|
114
|
-
# 显示最近 20 条日志，然后实时更新
|
|
115
|
-
rockcli log tail -k "error" -n 20
|
|
116
|
-
|
|
117
|
-
# 监控特定沙箱的日志
|
|
118
|
-
rockcli log tail --sandbox-id abc123
|
|
119
|
-
|
|
120
|
-
# 使用 JSON 格式输出
|
|
121
|
-
rockcli log search -k "error" --log-format json
|
|
122
|
-
|
|
123
|
-
# 只统计日志条数，不显示内容
|
|
124
|
-
rockcli log search -k "error" -m 15 --count
|
|
125
|
-
|
|
126
|
-
# 使用原始输出格式
|
|
127
|
-
rockcli log search -k "error" --raw
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
### 沙箱管理 (sandbox)
|
|
131
37
|
|
|
132
38
|
#### 基本语法
|
|
133
39
|
|
|
@@ -265,7 +171,6 @@ REPL 模式支持：
|
|
|
265
171
|
- 命令历史（上下键浏览）
|
|
266
172
|
- Tab 补全
|
|
267
173
|
- 内置命令（以 `/` 开头）：
|
|
268
|
-
- `/log` - 搜索日志
|
|
269
174
|
- `/upload` / `/download` - 文件传输
|
|
270
175
|
- `/status` - 查看状态
|
|
271
176
|
- `/help` - 帮助
|