# @deepexi/datasense-cli 中文文档

规范地址：https://npmcn.com/package/%40deepexi/datasense-cli/

版本：3\.3\.0
npm 元数据更新时间：2026-11-11T11:13:06.739Z
中文译文更新时间：2026-11-13T06:31:53.447Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40deepexi/datasense-cli
原文对照：https://npmcn.com/package/%40deepexi/datasense-cli/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.6 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：0 个
- 首次发布：2026-09-05T10:51:00.123Z
- 最新版本发布：2026-11-11T11:13:06.477Z
- 近 30 天下载量：2147（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。

## 安装

```sh
npm install @deepexi/datasense-cli
```

也可以使用：`pnpm add @deepexi/datasense-cli`、`yarn add @deepexi/datasense-cli`、`bun add @deepexi/datasense-cli`

## README

# ontos

Ontos 平台命令行工具。npm 包名为 `@deepexi/datasense-cli`，终端命令为 `ontos`。

需要 Node.js ≥22.12.0 与 npm。

## 安装

向目标环境安装，不要直接 `npm install -g @deepexi/datasense-cli@latest`：

```bash
curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
ontos auth host set https://your-host
```

Windows 使用 `/api/cli/install.ps1`。安装脚本会按该 host 的兼容清单安装对应版本。

升级：

```bash
ontos update          # 按当前 host 兼容范围升级
ontos update --check  # 只查看，不安装
```

查看 CLI 版本：`ontos -v` / `ontos --version`。子命令里的 `--version <n>` 是该命令自己的版本参数，例如 `kb get`。

## 快速开始

```bash
ontos auth host set https://your-host
ontos auth login
ontos project list
ontos project set <name>
```

`project set` 会在当前目录写入 `ontos.yaml`。

## 常用命令

| 命令 | 说明 |
| :-- | :-- |
| `auth` | 登录、退出、查看会话；`host get` / `host set` |
| `project` | 项目列表、落地与成员 |
| `update` | 按当前 host 升级 CLI |
| `skill list` / `skill install` / `skill context` / `skill prune` | 列出、安装技能存根，运行时取技能内容，清理已下线存根 |
| `query` | 只读查询 |
| `search` | 检索对象 |
| `execute` | 执行动作 |
| `compute` | 执行已发布函数 |
| `kb` | 知识库读取：`ls` / `cat` / `fetch` / `history` / `search` |
| `simulation` | 场景推演 |
| `admin` | 平台管理（租户、环境、资源、同步、校验等），详见 `ontos admin --help` |

完整命令与参数以 `ontos --help` 和各子命令 `--help` 为准。

## 技能

`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 get` 默认一次输出全文并带行号：首行给行号范围与补读命令，末行是 `[end …]`；空行不带行号，单行超过 500 字截断。宿主截断输出时，agent 从行号断档或缺失的末行发现，用 `--line <行> --limit <行数>` 补读。需要分段时用 `--limit`，或设 `ONTOS_PAGE_LINES` / `ONTOS_PAGE_CHARS`（每段非空行数 / 正文字符数，缺省的一项取 240 / 26000）。脚本要不带行号的原文，用 `--raw` 或把输出重定向到文件。技能删了用 `ontos skill prune` 清掉本地存根。

Grok 和 Codex 在仓库未被信任时不加载项目级技能，把仓库标为信任后才会看到存根。OpenCode v1 不热加载技能文件，存根改写之后要新开一个会话，description 才会更新；`ontos skill context` 取到的内容不受影响。

## 输出

默认输出 Markdown 表格。脚本与编排器请显式使用 `--format json`（或 `ONTOS_FORMAT=json`）。

失败时错误 JSON 写在 stderr，含稳定的 `code` 字段；不要解析 `message` 文本。退出码：`0` 成功，`2` 用法/配置/输入错误，`1` 运行时或远端失败。

## 项目清单

每个项目目录一份 `ontos.yaml`：

```yaml
tenant: acme
project: sales
specDir: ./spec
sync:
  domains: [ontology]
```

```bash
ontos --cwd ./sales project list
ontos --cwd ./sales admin sync diff
```

-   `--cwd` 指定工作目录；`--manifest` 显式指定清单文件。
-   自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
-   切换已绑定项目使用 `--cwd` / `--manifest`。覆盖已有绑定需 `ontos project set --rebind`。
-   清单不存放登录凭据。更换 `auth host set` 后需要重新登录。

## 常见问题

### @deepexi/datasense-cli 是什么？

Ontos 平台命令行工具。npm 包名为 @deepexi/datasense-cli，终端命令为 ontos。

### 如何安装 @deepexi/datasense-cli？

在项目目录运行 npm install @deepexi/datasense-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ontos，可以用 npx ontos 直接运行。

### @deepexi/datasense-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/deepexi\_\_datasense-cli 是否存在。

### @deepexi/datasense-cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @deepexi/datasense-cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @deepexi/datasense-cli 可以商用吗？

@deepexi/datasense-cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @deepexi/datasense-cli 的下载量有多少？

根据 npm 官方下载统计，@deepexi/datasense-cli 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,147 次，日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @deepexi/datasense-cli 还在维护吗？

最新版本 3\.3\.0 发布于 2026/11/11（2 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/09/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。