ontos
Ontos 平台命令行工具。npm 包名为 @deepexi/datasense-cli，终端命令为 ontos。
需要 Node.js ≥22.12.0 与 npm。
安装
向目标环境安装，不要直接 npm install -g @deepexi/datasense-cli@latest：
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 的兼容清单安装对应版本。
升级：
ontos update # 按当前 host 兼容范围升级
ontos update --check # 只查看，不安装
查看 CLI 版本：ontos -v / ontos --version。子命令里的 --version <n> 是该命令自己的版本参数，例如 kb get。
快速开始
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：
tenant: acme
project: sales
specDir: ./spec
sync:
domains: [ontology]
ontos --cwd ./sales project list
ontos --cwd ./sales admin sync diff
--cwd指定工作目录；--manifest显式指定清单文件。- 自动发现从当前目录向上查找，止于最近 Git 根或用户主目录。
- 切换已绑定项目使用
--cwd/--manifest。覆盖已有绑定需ontos project set --rebind。 - 清单不存放登录凭据。更换
auth host set后需要重新登录。