@deepexi/datasense-cli 2.0.2 → 2.0.4
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 +88 -88
- package/dist/ontos.js +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,88 +1,88 @@
|
|
|
1
|
-
# ontos
|
|
2
|
-
|
|
3
|
-
Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。
|
|
4
|
-
|
|
5
|
-
需要 Node.js ≥22.12.0 与 npm。
|
|
6
|
-
|
|
7
|
-
## 安装
|
|
8
|
-
|
|
9
|
-
向目标环境安装，不要直接 `npm install -g @deepexi/datasense-cli@latest`：
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
|
|
13
|
-
ontos auth host set https://your-host
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
Windows 使用 `/api/cli/install.ps1`。安装脚本会按该 host 的兼容清单安装对应版本。
|
|
17
|
-
|
|
18
|
-
升级：
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
ontos update # 按当前 host 兼容范围升级
|
|
22
|
-
ontos update --check # 只查看，不安装
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
查看 CLI 版本：`ontos -v` / `ontos --version`。子命令里的 `--version <n>` 是该命令自己的版本参数，例如 `kb cat`。
|
|
26
|
-
|
|
27
|
-
## 快速开始
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
ontos auth host set https://your-host
|
|
31
|
-
ontos auth login
|
|
32
|
-
ontos project list
|
|
33
|
-
ontos project set <name>
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
`project set` 会在当前目录写入 `ontos.yaml`。
|
|
37
|
-
|
|
38
|
-
## 常用命令
|
|
39
|
-
|
|
40
|
-
| 命令 | 说明 |
|
|
41
|
-
| :--- | :--- |
|
|
42
|
-
| `auth` | 登录、退出、查看会话；`host get` / `host set` |
|
|
43
|
-
| `project` | 项目列表、落地与成员 |
|
|
44
|
-
| `update` | 按当前 host 升级 CLI |
|
|
45
|
-
| `skill list` / `skill install` / `skill context` / `skill prune` | 列出、安装技能存根，运行时取技能内容，清理已下线存根 |
|
|
46
|
-
| `query` | 只读查询 |
|
|
47
|
-
| `search` | 检索对象 |
|
|
48
|
-
| `execute` | 执行动作 |
|
|
49
|
-
| `compute` | 执行已发布函数 |
|
|
50
|
-
| `kb` | 知识库读取：`ls` / `cat` / `fetch` / `history` / `search` |
|
|
51
|
-
| `simulation` | 场景推演 |
|
|
52
|
-
| `admin` | 平台管理（租户、环境、资源、同步、校验等），详见 `ontos admin --help` |
|
|
53
|
-
|
|
54
|
-
完整命令与参数以 `ontos --help` 和各子命令 `--help` 为准。
|
|
55
|
-
|
|
56
|
-
## 技能
|
|
57
|
-
|
|
58
|
-
`ontos skill install <skill...>` 只在当前目录写入技能存根（一份 `SKILL.md`：触发描述、所属项目，以及「先运行 `ontos skill context <name>`」）。默认同时写入 `.opencode/skills`、`.agents/skills`、`.claude/skills`；`--agent` 选择子集，`--global` 写到各宿主的用户目录。能力内容不落盘：agent 每次用 `ontos skill context <name>` 按当前身份、环境和快照取得；`--ref <path>`
|
|
59
|
-
|
|
60
|
-
Grok 和 Codex 在仓库未被信任时不加载项目级技能，把仓库标为信任后才会看到存根。OpenCode v1 不热加载技能文件，存根改写之后要新开一个会话，description 才会更新；`ontos skill context` 取到的内容不受影响。
|
|
61
|
-
|
|
62
|
-
## 输出
|
|
63
|
-
|
|
64
|
-
默认输出 Markdown 表格。脚本与编排器请显式使用 `--format json`（或 `ONTOS_FORMAT=json`）。
|
|
65
|
-
|
|
66
|
-
失败时错误 JSON 写在 stderr，含稳定的 `code` 字段；不要解析 `message` 文本。退出码：`0` 成功，`2` 用法/配置/输入错误，`1` 运行时或远端失败。
|
|
67
|
-
|
|
68
|
-
## 项目清单
|
|
69
|
-
|
|
70
|
-
每个项目目录一份 `ontos.yaml`：
|
|
71
|
-
|
|
72
|
-
```yaml
|
|
73
|
-
tenant: acme
|
|
74
|
-
project: sales
|
|
75
|
-
specDir: ./spec
|
|
76
|
-
sync:
|
|
77
|
-
domains: [ontology]
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
ontos --cwd ./sales project list
|
|
82
|
-
ontos --cwd ./sales admin sync diff
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
- `--cwd` 指定工作目录；`--manifest` 显式指定清单文件。
|
|
86
|
-
- 自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
|
|
87
|
-
- 切换已绑定项目使用 `--cwd` / `--manifest`。覆盖已有绑定需 `ontos project set --rebind`。
|
|
88
|
-
- 清单不存放登录凭据。更换 `auth host set` 后需要重新登录。
|
|
1
|
+
# ontos
|
|
2
|
+
|
|
3
|
+
Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。
|
|
4
|
+
|
|
5
|
+
需要 Node.js ≥22.12.0 与 npm。
|
|
6
|
+
|
|
7
|
+
## 安装
|
|
8
|
+
|
|
9
|
+
向目标环境安装，不要直接 `npm install -g @deepexi/datasense-cli@latest`：
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
|
|
13
|
+
ontos auth host set https://your-host
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Windows 使用 `/api/cli/install.ps1`。安装脚本会按该 host 的兼容清单安装对应版本。
|
|
17
|
+
|
|
18
|
+
升级：
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
ontos update # 按当前 host 兼容范围升级
|
|
22
|
+
ontos update --check # 只查看，不安装
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
查看 CLI 版本：`ontos -v` / `ontos --version`。子命令里的 `--version <n>` 是该命令自己的版本参数，例如 `kb cat`。
|
|
26
|
+
|
|
27
|
+
## 快速开始
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
ontos auth host set https://your-host
|
|
31
|
+
ontos auth login
|
|
32
|
+
ontos project list
|
|
33
|
+
ontos project set <name>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
`project set` 会在当前目录写入 `ontos.yaml`。
|
|
37
|
+
|
|
38
|
+
## 常用命令
|
|
39
|
+
|
|
40
|
+
| 命令 | 说明 |
|
|
41
|
+
| :--- | :--- |
|
|
42
|
+
| `auth` | 登录、退出、查看会话；`host get` / `host set` |
|
|
43
|
+
| `project` | 项目列表、落地与成员 |
|
|
44
|
+
| `update` | 按当前 host 升级 CLI |
|
|
45
|
+
| `skill list` / `skill install` / `skill context` / `skill prune` | 列出、安装技能存根，运行时取技能内容，清理已下线存根 |
|
|
46
|
+
| `query` | 只读查询 |
|
|
47
|
+
| `search` | 检索对象 |
|
|
48
|
+
| `execute` | 执行动作 |
|
|
49
|
+
| `compute` | 执行已发布函数 |
|
|
50
|
+
| `kb` | 知识库读取：`ls` / `cat` / `fetch` / `history` / `search` |
|
|
51
|
+
| `simulation` | 场景推演 |
|
|
52
|
+
| `admin` | 平台管理（租户、环境、资源、同步、校验等），详见 `ontos admin --help` |
|
|
53
|
+
|
|
54
|
+
完整命令与参数以 `ontos --help` 和各子命令 `--help` 为准。
|
|
55
|
+
|
|
56
|
+
## 技能
|
|
57
|
+
|
|
58
|
+
`ontos skill install <skill...>` 只在当前目录写入技能存根（一份 `SKILL.md`：触发描述、所属项目，以及「先运行 `ontos skill context <name>`」）。默认同时写入 `.opencode/skills`、`.agents/skills`、`.claude/skills`；`--agent` 选择子集，`--global` 写到各宿主的用户目录。能力内容不落盘：agent 每次用 `ontos skill context <name>` 按当前身份、环境和快照取得；`--ref <path>` 取单篇参考。平台升级和项目发布后不用重装。`skill context` 与 `kb cat` 默认一次输出全文并带行号：首行给行号范围与补读命令，末行是 `[end …]`；空行不带行号，单行超过 500 字截断。宿主截断输出时，agent 从行号断档或缺失的末行发现，用 `--offset <行> --limit <行数>` 补读。需要分段时用 `--limit`，或设 `ONTOS_PAGE_LINES` / `ONTOS_PAGE_CHARS`（每段非空行数 / 正文字符数，缺省的一项取 240 / 26000）。脚本要不带行号的原文，用 `--raw` 或把输出重定向到文件。技能删了用 `ontos skill prune` 清掉本地存根。
|
|
59
|
+
|
|
60
|
+
Grok 和 Codex 在仓库未被信任时不加载项目级技能，把仓库标为信任后才会看到存根。OpenCode v1 不热加载技能文件，存根改写之后要新开一个会话，description 才会更新；`ontos skill context` 取到的内容不受影响。
|
|
61
|
+
|
|
62
|
+
## 输出
|
|
63
|
+
|
|
64
|
+
默认输出 Markdown 表格。脚本与编排器请显式使用 `--format json`（或 `ONTOS_FORMAT=json`）。
|
|
65
|
+
|
|
66
|
+
失败时错误 JSON 写在 stderr，含稳定的 `code` 字段；不要解析 `message` 文本。退出码：`0` 成功，`2` 用法/配置/输入错误，`1` 运行时或远端失败。
|
|
67
|
+
|
|
68
|
+
## 项目清单
|
|
69
|
+
|
|
70
|
+
每个项目目录一份 `ontos.yaml`：
|
|
71
|
+
|
|
72
|
+
```yaml
|
|
73
|
+
tenant: acme
|
|
74
|
+
project: sales
|
|
75
|
+
specDir: ./spec
|
|
76
|
+
sync:
|
|
77
|
+
domains: [ontology]
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
ontos --cwd ./sales project list
|
|
82
|
+
ontos --cwd ./sales admin sync diff
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
- `--cwd` 指定工作目录；`--manifest` 显式指定清单文件。
|
|
86
|
+
- 自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
|
|
87
|
+
- 切换已绑定项目使用 `--cwd` / `--manifest`。覆盖已有绑定需 `ontos project set --rebind`。
|
|
88
|
+
- 清单不存放登录凭据。更换 `auth host set` 后需要重新登录。
|