@deepexi/datasense-cli 1.10.2 → 1.12.0

package/README.md

@@ -5,26 +5,29 @@ Ontos 平台命令行工具。
 ## 安装
 
 ```bash
-# 全局安装
-npm install -g @deepexi/datasense-cli
-
-# 或直接运行
-npx @deepexi/datasense-cli <command>
+curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
+ontos auth host set https://your-host
 ```
 
-需要 Node.js ≥ 18。
+需要 Node.js ≥22.12.0 与 npm。安装脚本会查询目标 host 的兼容清单，再安装推荐的精确版本。不要追随 npm `latest`。
 
 npm 包名为 `@deepexi/datasense-cli`，终端命令仍为 `ontos`。
 
 ## 发布到 npm
 
-CLI 使用自身 semver（当前 **1.10.2**），与服务端镜像 tag **不是同一套号**。服务端在部署时指定日期 tag。当前兼容矩阵为 **`v2026.09.08` 推荐 CLI 1.10.2**；CLI 1.10.0 的 Workbench 互信需要服务端部署对应的认证改动并开启外部身份，不能只凭日期 tag 判断已支持。部署命令示例：
+CLI 使用自身 semver（当前 **1.12.0**），与服务端镜像 tag **不是同一套号**。服务端在部署时指定日期 tag。当前兼容矩阵为 **`v2026.09.08` 推荐 CLI 1.12.0**（范围 `>=1.12.0 <2.0.0`）；更旧的 CLI 会被 Gateway 拒绝。CLI 1.10.0 的 Workbench 互信需要服务端部署对应的认证改动并开启外部身份，不能只凭日期 tag 判断已支持。部署命令示例：
 
 ```bash
 bun run deploy:test -- v2026.09.08
 ```
 
-兼容范围见 [docs/compatibility](../../docs/compatibility/README.md)。Gateway 兼容门禁尚未落地，发布后 `ontos update` 仍会追随 npm `latest`。
+兼容范围见 [docs/compatibility](../../docs/compatibility/README.md)。安装与更新都先查询目标 host 的 `/api/cli/compatibility`，再安装范围内精确版本：
+
+```bash
+curl -fsSL https://your-host/api/cli/install.sh | sh -s -- https://your-host
+ontos update          # 按当前 host 兼容范围升级
+ontos update --check  # 只看范围、推荐版本和可安装版本
+```
 
 使用具有 `@deepexi` scope 发布权限的 npm 账号，在 `packages/ontos-cli` 目录执行：
 
@@ -44,27 +47,28 @@ ontos auth host set http://localhost:3000
 ontos auth login --email your@email.com
 
 # 查看可访问的项目
-ontos auth project list
+ontos project list
 
 # 在项目目录落地上下文（写 ontos.yaml，自动解析所属 tenant）
-ontos auth project set <name>
+ontos project set <name>
 ```
 
 ## 命令
 
 | 命令 | 说明 |
 | :--- | :--- |
-| `auth` | 用户会话上下文：`login`/`logout`、`host get/set`、`project list/set`、`status`（`config` 命令已删除，会话上下文统一走此命令组） |
+| `auth` | 用户会话：`login`/`logout`、`host get/set`、`status`/`whoami`（`config` 命令已删除） |
+| `project` | 项目发现、落地与治理：`list`/`set`/`get`/`create`/`update`/`archive`/`member` |
 | `update` | 升级本机全局安装的 `@deepexi/datasense-cli`（`--check` 只查不装） |
-| `admin project` | 项目管理（含 `project member` 项目成员） |
 | `admin tenant` | 租户 CRUD、用户开户与租户成员 |
 | `admin env` | 环境管理 |
-| `admin resources` | 资源 CRUD（datasource / property-type / object / relation / function / action / skill / scenario / evaluator） |
-| `admin sync` | 声明式 YAML 同步（init / pull / push / diff / schema） |
+| `admin resources` | 资源 CRUD（datasource / property-type / object-type / relation / function / action / skill / scenario / evaluator） |
+| `admin datasource test <name>` | 测试已保存数据源连通性（服务端解析 SecretReference） |
+| `admin sync` | 声明式 YAML 同步（init / pull / push / diff / schema / migrate-manifest） |
 | `admin validate` | 本地 YAML spec 离线校验 |
 | `skill list` | 列出可安装的平台技能 |
 | `skill install` | 下载技能到本地 agent 目录 |
-| `codegen` | 生成本地 TypeScript 类型声明 |
+| `admin codegen` | 生成本地 TypeScript 类型声明 |
 | `query` | 只读执行查询 |
 | `execute` | 运行态一步执行写动作并落库（内联 `--params`，支持分支/版本） |
 | `compute` | 运行态执行已发布函数计算（内联 `--params`，支持分支/版本） |
@@ -108,7 +112,7 @@ ontos --manifest ./ontos.inventory.yaml admin sync push
 - `.yaml` 和 `.yml` 均可发现，同层共存时报错。新文件统一写 `.yaml`；自定义名称用 `--manifest` 选择。
 - specDir 与缺省 `ontos-project` 相对清单目录解析；`--dir` 为命令行资源目录。它命中另一项目清单时，租户、项目、同步域一起切换；显式清单与目录清单不一致时拒绝执行。
 - `-p` / `ONTOS_PROJECT` 仍是远端项目覆盖。同步、remote validate、codegen 不允许借此改绑另一项目；name/id 经只读校验等价才允许。
-- `auth project set` 写显式或最近清单；更换已有绑定必须加 `--rebind`，保留原 specDir，并输出旧/新绑定。日常切换项目使用 `--cwd` / `--manifest`。损坏 YAML 不会被清空重建。
+- `project set` 写显式或最近清单；更换已有绑定必须加 `--rebind`，保留原 specDir，并输出旧/新绑定。日常切换项目使用 `--cwd` / `--manifest`。损坏 YAML 不会被清空重建。
 - `sync init` 不在继承祖先清单的目录中创建影子清单；请定位项目根或独立目录。资源目录不要使用清单所在目录或其祖先，否则 pull 会拒绝，避免清单被目录替换删除。
 - status 的 `context` 展示清单路径、本地目录和字段来源；保留已有 status 顶层字段。
 - 跨 Host 使用对应 token 或独立 `XDG_CONFIG_HOME`；不会把旧 Host 的登录 token 发给覆盖后的新 Host。清单不存凭据。`auth host set` 更换实例时会清除旧登录身份，需要登录新实例。