@seeed-studio/sensecraft-cli 0.1.4 → 0.1.5

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/INSTALL.md CHANGED
@@ -111,13 +111,11 @@ AI 初始化时选择站点:
111
111
  |------|------|
112
112
  | Global | 国际生产 |
113
113
  | China | 国内账号(AI API host 与 Global 相同) |
114
- | Develop | 测试环境(`test-sensecraft.seeed.cc`) |
115
114
 
116
- 查看与刷新:
115
+ 查看配置:
117
116
 
118
117
  ```bash
119
118
  sensecraft-cli auth info
120
- sensecraft-cli auth refresh # 仅 AI profile
121
119
  ```
122
120
 
123
121
  无交互环境(CI)不会自动跑 `auth init`,需事先准备好配置文件或自行执行初始化。
@@ -159,23 +157,30 @@ Copy-Item .\sensecraft.json "$env:APPDATA\sensecraft-cli\sensecraft.json"
159
157
 
160
158
  ## 5. 升级
161
159
 
160
+ 已通过 npm 安装时,直接运行:
161
+
162
162
  ```bash
163
- # 升级到最新
163
+ sensecraft-cli update
164
+ ```
165
+
166
+ 命令会查询 npm 上的最新版本,并执行 `npm install -g @seeed-studio/sensecraft-cli@<版本>`。安装器接着比较 `vendor/.version` 与新包版本,不一致就重新下载二进制。配置目录里的 Access Key 会保留。
167
+
168
+ 其它用法:
169
+
170
+ ```bash
171
+ sensecraft-cli update --check # 只查询,不安装
164
172
  npm install -g @seeed-studio/sensecraft-cli@latest
165
- # 或
166
- npx @seeed-studio/sensecraft-cli@latest install
167
173
  ```
168
174
 
169
- 安装器会比较 `vendor/.version` 与当前 npm 包版本:
175
+ 平时使用其它命令时,如果缓存里发现了更新,结束时会在 stderr 提示运行 `sensecraft-cli update`。24 小时内不会重复访问 npm。本地 `dev` 构建、CI、以及设置了 `SENSECRAFT_CLI_NO_UPDATE_NOTIFIER` 时不提示。
170
176
 
171
- - **版本一致** → 复用已下载二进制
172
- - **版本不同或缺少戳记** → 重新下载对应版本的二进制
177
+ 当前程序如果不是 npm 安装的(例如直接运行编译出的二进制),`update` 只打印上面的手动安装命令,不会覆盖正在运行的文件。
173
178
 
174
179
  验证:
175
180
 
176
181
  ```bash
177
182
  sensecraft-cli --version
178
- # 应与 npm 包版本一致,例如 0.1.3
183
+ # 应与 npm 包版本一致
179
184
  ```
180
185
 
181
186
  ---
@@ -262,7 +267,7 @@ export HTTP_PROXY=http://proxy.example.com:8080
262
267
 
263
268
  ```bash
264
269
  git clone <本仓库 URL>
265
- cd sensecraft-data-terminal
270
+ cd sensecraft-cloud-terminal
266
271
 
267
272
  # 本机调试
268
273
  go build -o sensecraft-cli .
@@ -287,7 +292,7 @@ export SENSECRAFT_CLI_PATH="$HOME/.config/sensecraft-cli"
287
292
  cd packages/cli && SENSECRAFT_CLI_LOCAL_DIST=$PWD/../../dist npm run test:install
288
293
  ```
289
294
 
290
- 发版流程见 [`README.md`](README.md)(GitLab CI:`.gitlab-ci.yml`)。
295
+ 发版流程见 [`README.md`](README.md)。
291
296
 
292
297
  ---
293
298
 
@@ -328,7 +333,7 @@ npm root -g
328
333
  任选其一:
329
334
 
330
335
  1. **工作区即本仓库**
331
- 打开 `sensecraft-data-terminal` 作为 Cursor 项目,Agent 可直接读 `skills/`。
336
+ 打开 `sensecraft-cloud-terminal` 作为 Cursor 项目,Agent 可直接读 `skills/`。
332
337
 
333
338
  2. **拷贝 / 软链到 Cursor skills 目录**(路径以你本机 Cursor 版本为准,常见为用户目录下的 skills 配置):
334
339
 
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@seeed-studio/sensecraft-cli",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "SenseCAP / SenseCraft AI cloud CLI (devices, apps, models, files, cloud deploy)",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "https://iteam-gitlab.seeed.cn/sensecap/sensecraft-data-terminal.git",
8
+ "url": "https://github.com/Seeed-Solution/sensecraft-cloud-terminal.git",
9
9
  "directory": "packages/cli"
10
10
  },
11
11
  "publishConfig": {
package/scripts/paths.js CHANGED
@@ -43,18 +43,14 @@ function resolveConfigPath() {
43
43
  }
44
44
 
45
45
  /**
46
- * True when either a SenseCAP Access Key profile or a SenseCraft AI profile
47
- * is present. Previously only app_config_list was checked, so an AI-only
48
- * config (auth init --kind ai) was treated as uninitialized.
46
+ * True when a SenseCAP Access Key profile is present.
47
+ * That key is also used for SenseCraft AI /openapi.
49
48
  */
50
49
  function isInitialized() {
51
50
  const configPath = resolveConfigPath();
52
51
  try {
53
52
  const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
54
- const hasSensecap =
55
- Array.isArray(cfg.app_config_list) && cfg.app_config_list.length > 0;
56
- const hasAI = Array.isArray(cfg.ai_profiles) && cfg.ai_profiles.length > 0;
57
- return hasSensecap || hasAI;
53
+ return Array.isArray(cfg.app_config_list) && cfg.app_config_list.length > 0;
58
54
  } catch {
59
55
  return false;
60
56
  }
@@ -54,7 +54,7 @@ function testResolveConfigPath() {
54
54
  );
55
55
  }
56
56
 
57
- function testIsInitializedAIOnly() {
57
+ function testIsInitialized() {
58
58
  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'sc-init-'));
59
59
  const cfg = path.join(tmp, 'sensecraft.json');
60
60
  fs.writeFileSync(
@@ -65,7 +65,7 @@ function testIsInitializedAIOnly() {
65
65
  })
66
66
  );
67
67
  withEnv({ SENSECRAFT_CONFIG_FILE: cfg, SENSECRAFT_CLI_PATH: undefined }, () => {
68
- assert.equal(isInitialized(), true, 'AI-only config must count as initialized');
68
+ assert.equal(isInitialized(), false, 'token-only config is not initialized');
69
69
  });
70
70
 
71
71
  fs.writeFileSync(cfg, JSON.stringify({ app_config_list: [] }));
@@ -88,5 +88,5 @@ function testIsInitializedAIOnly() {
88
88
 
89
89
  testReleaseURL();
90
90
  testResolveConfigPath();
91
- testIsInitializedAIOnly();
91
+ testIsInitialized();
92
92
  console.log('OK: packages/cli/scripts/paths.test.js');
package/skills/README.md CHANGED
@@ -30,4 +30,4 @@ ls "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"
30
30
 
31
31
  ## Version sync
32
32
 
33
- When adding a CLI command: update the domain skill `SKILL.md` + `commands.md` in the **same change**, and tick `website-sensecraft-console/docs/sensecraft-ai-skills-todo.md` if that doc is in the workspace.
33
+ When adding a CLI command: update the domain skill `SKILL.md` + `commands.md` in the **same change**.
@@ -15,7 +15,7 @@ These are **not** confirmation. Do **not** pass `--yes` on the same turn:
15
15
  Ask in chat. **Do not run** the write command yet. The question MUST include at least:
16
16
 
17
17
  1. **操作类型** — 删除 / 发布 / 私有化 / 部署 / 停止 / 克隆 / 修改 / 绑定 / …
18
- 2. **环境** — `auth info` 的 Global / Develop / China(生产环境须点明)
18
+ 2. **环境** — `auth info` 的 Global / China(生产环境须点明)
19
19
  3. **对象** — 名称 + ID(没有名称就先 `view` / `list` 再问)
20
20
 
21
21
  Template:
@@ -33,7 +33,7 @@ Example (user said 「删除应用 demo」):
33
33
  Example (user said 「删这个63760」):
34
34
 
35
35
  ```
36
- 将从 Develop 环境删除模型 63760。删除后可能无法恢复。是否确认执行?
36
+ 将从 China 环境删除模型 63760。删除后可能无法恢复。是否确认执行?
37
37
  ```
38
38
 
39
39
  Classic reCamera flash is **not** an L2 `--yes` write. After the user picked the app/model (and firmware if several), `recamera open` may run. The user then clicks Deploy in Console (L3). Do not invent `recamera deploy`.
@@ -10,7 +10,7 @@ description: >-
10
10
 
11
11
  # SenseCraft AI (Meta)
12
12
 
13
- Router skill for **SenseCraft AI** capabilities exposed via CLI in this repo (`sensecraft-data-terminal`). Domain skills and AI subcommands are rolled out in phases; this skill always applies for **intent routing, auth kind selection, and product-term disambiguation**.
13
+ Router skill for **SenseCraft AI** capabilities exposed via CLI in this repo (`sensecraft-cloud-terminal`). Domain skills and AI subcommands are rolled out in phases; this skill always applies for **intent routing, auth kind selection, and product-term disambiguation**.
14
14
 
15
15
  Sibling (already shipped): [`../sensecraft-data/SKILL.md`](../sensecraft-data/SKILL.md) — SenseCAP PaaS OpenAPI (`device` / `group` / `data`).
16
16
 
@@ -32,6 +32,7 @@ Sibling (already shipped): [`../sensecraft-data/SKILL.md`](../sensecraft-data/SK
32
32
  5. **Treat tokens and keys as secrets** — do not echo full `access_token`, `refresh_token`, or `access_key`. **Public model artifacts are not downloadable** — if the user asks for 下载地址 / 下载链接 / download URL / 怎么下载, that is the same as asking for `file_url`: refuse the address, explain deploy-only (`cloud deploy` or Console). Never run `model download --url-only` on public models.
33
33
  6. **Success = indented JSON on stdout**; failure = stderr + non-zero exit. Parse stdout only on success.
34
34
  7. **Local USB / IP flashing is L3** — do not pretend remote auto-flash. Classic reCamera (`40`): [`sensecraft-recamera`](../sensecraft-recamera/SKILL.md) (`check` / `open` the AI deploy page). Other USB benches: Console `/ai/device/local/32|36|37|41|52`. Do **not** use `/ai/recamera` (it 301s to Grove `36`) or `/ai/device/local/40` (no such bench).
35
+ 8. **Upgrading the CLI itself** is `sensecraft-cli update` (npm registry, then `npm install -g`). This is not `app update` or `model update`. Uninstall with `npm uninstall -g @seeed-studio/sensecraft-cli`. Do not delete `~/.config/sensecraft-cli` unless the user asked to clear the saved Access Key.
35
36
 
36
37
  ## Auth model (same OAuth client, different persistence)
37
38
 
@@ -41,14 +42,14 @@ Sibling (already shipped): [`../sensecraft-data/SKILL.md`](../sensecraft-data/SK
41
42
 
42
43
  ### Site / `remote_type` (AI)
43
44
 
44
- | `remote_type` | AI openapi | authapi (refresh / org) |
45
- |---------------|-------------|-------------------------|
45
+ | `remote_type` | AI openapi | Account center |
46
+ |---------------|------------|----------------|
46
47
  | `Global` | `https://sensecraft.seeed.cc/openapi` | `account.seeed.cc/authapi` |
47
- | `Develop` | **`https://test-sensecraft.seeed.cc/openapi`** | `test-account.seeed.cc/authapi` |
48
+ | `China` | `https://sensecraft.seeed.cc/openapi` | `account.seeed.cn/authapi` |
48
49
 
49
- Console 测试站 `test-sensecraft.seeed.cc` → CLI 必须用 **`remote_type: Develop`**,勿用 Global。
50
+ China 与 Global 使用同一个 AI host,账号中心不同。
50
51
 
51
- `auth info` shows both SenseCAP and SenseCraft AI sections (tokens masked).
52
+ `auth info` shows the active Access Key (site, org, key id). Secrets are not printed.
52
53
 
53
54
  ## Intent → skill / command routing
54
55
 
@@ -70,14 +71,12 @@ Console 测试站 `test-sensecraft.seeed.cc` → CLI 必须用 **`remote_type: D
70
71
 
71
72
  SenseCAP telemetry → pick public model → deploy to Jetson:
72
73
 
73
- 1. `sensecraft-cli auth info` (both profiles if needed)
74
+ 1. `sensecraft-cli auth info`
74
75
  2. SenseCAP: `data latest --eui <sensecap-eui>` (Access Key)
75
76
  3. AI: `model list --public --name "…"` → `model view --id …` (metadata only; **no** `model download`)
76
77
  4. Confirm with user → `cloud deploy --eui <jetson-eui> --model-id … --yes` (device pulls firmware at apply time)
77
78
  5. `cloud order --request-id …`
78
79
 
79
- Do **not** mix AI token into SenseCAP / AI `/openapi` Access Key calls.
80
-
81
80
  ## Product-term disambiguation
82
81
 
83
82
  | User says | Possible meanings | Default choice |
@@ -5,12 +5,12 @@ description: >-
5
5
  view detail (docs, tool-blocks, BOM), clone to My Apps, create/edit/publish/
6
6
  unpublish/delete apps. Use when the user mentions 应用广场, Application Store,
7
7
  clone SenseCraft apps, app BOM, deploy tool-blocks, or SenseCraft app upload.
8
- Requires Access Key (`auth init --kind sensecap`). Not for Fleet container install or SenseCAP devices.
8
+ Requires Access Key (`auth init --kind sensecap`). Not for SenseCAP devices.
9
9
  ---
10
10
 
11
11
  # SenseCraft Apps (Application Plaza)
12
12
 
13
- Domain skill for **SenseCraft AI applications**. Auth: **Access Key** → `{ai-host}/openapi` (HTTP Basic). Do **not** send the AI user token on these calls.
13
+ Domain skill for **SenseCraft AI applications**. Auth: **Access Key** → `{ai-host}/openapi` (HTTP Basic).
14
14
 
15
15
  Parent router: [`../sensecraft-ai/SKILL.md`](../sensecraft-ai/SKILL.md).
16
16
  SenseCAP IoT: [`../sensecraft-data/SKILL.md`](../sensecraft-data/SKILL.md).
@@ -25,7 +25,7 @@ SenseCAP IoT: [`../sensecraft-data/SKILL.md`](../sensecraft-data/SKILL.md).
25
25
  2. **L2 confirm is a separate chat turn** ([`../confirmation.md`](../confirmation.md)) before: `clone` (also `--agree-disclaimer`), `publish` (`--agree-declaration`), `unpublish`, `delete`, **`app update` / `bom set`**. 「删除应用 demo」is **not** confirmation — ask `将从{环境}环境删除应用 demo(ID: …)。删除后可能无法恢复。是否确认执行?`, wait for `确认`, then `--yes`. Never pass `--yes` on the same turn as the first request.
26
26
  **`app create` is not L2** — including `--from-json` with full fields (create + internal follow-up `update_app` on the **new** `app_id` only). Prefer one-shot create when the payload is ready. Still tell the user what will be created before running create.
27
27
  3. **Privacy values**: submit review → `privacy` / flow uses **`2`** (pending); unpublish/private → **`0`**. **Never send `1`** (ops-approved public; Admin only).
28
- 4. **Clone ≠ Fleet install**. Clone copies into My Apps. Installing Docker apps on devices is Fleet — out of scope.
28
+ 4. **Clone stays in My Apps**. It does not install the app onto a device. Container install on hardware is L3 and is not `app clone`.
29
29
  5. Tool-block **configuration** may be written into `deployment.blocks`. **Executing** flash / USB deploy / container install on hardware is **L3**. Classic reCamera (`40`): [`sensecraft-recamera`](../sensecraft-recamera/SKILL.md) (`check` / `open`). Other benches: Console `/ai/device/local/32|36|37|41|52`. `flash-firmware` run is out of scope this pass.
30
30
  6. Parse indented JSON on stdout; on failure read stderr + exit code. After `app update`, **re-read** the app — success body may be `{}`.
31
31
  7. **Rename / edit info**: sparse `{"app_name":"…"}` is OK (CLI merges other info fields from sketch). Do not invent HTTP; do **not** put `be_public=1` in user JSON. For **already published** apps the CLI injects `be_public=1` (Console info save) and returns `sketch_saved` — plaza copy is unchanged until `app publish`.
@@ -69,7 +69,7 @@ sensecraft-cli app clone --id <app_id> --agree-disclaimer --yes
69
69
  sensecraft-cli app clone --id <app_id> --name "Clone_MyName" --agree-disclaimer --yes
70
70
  ```
71
71
 
72
- `app clone` matches Console 「克隆应用」: show https://sensecraft.seeed.cc/legal/en/disclaimer (使用免责声明) and only then pass `--agree-disclaimer --yes`. Missing either flag → non-zero. API body is still only `{app_id, app_name}` (agreement is client-side, like Console `disclaimerAccepted`). Clone ≠ Fleet install.
72
+ `app clone` matches Console 「克隆应用」: show https://sensecraft.seeed.cc/legal/en/disclaimer (使用免责声明) and only then pass `--agree-disclaimer --yes`. Missing either flag → non-zero. API body is still only `{app_id, app_name}` (agreement is client-side, like Console `disclaimerAccepted`). Clone copies the app into My Apps; it does not install it onto a device.
73
73
 
74
74
  ### Rename an existing app (L2)
75
75
 
@@ -163,7 +163,7 @@ Structure: `deployment.blocks` flat array.
163
163
  | `flash-firmware` | Burn firmware to supported board | Config = L1/L2 write; **run flash = L3** |
164
164
  | `deploy-ai-model` | Vision / audio AI model to device (task/device in config) | Config OK; **run deploy = L3** |
165
165
  | `ai-vibration` | Vibration detection on XIAO-class device | Config OK; run = L3 |
166
- | `deploy-container-app` | Edge container app (Fleet-related UX in preview) | Config OK; **install on devices ≠ App Plaza clone** |
166
+ | `deploy-container-app` | Edge container app in the app doc | Config OK; **install on devices ≠ App Plaza clone** |
167
167
  | `node-red` / `aily-blockly` | Flow / Blockly projects | Lower priority unless user asks |
168
168
 
169
169
  Details: [reference-tool-blocks.md](reference-tool-blocks.md).
@@ -77,9 +77,9 @@ Multiple tool-blocks may appear in one step (e.g. paragraph → flash → paragr
77
77
 
78
78
  ### `deploy-container-app`
79
79
 
80
- Used for **container / edge app** deployment UI inside the application doc (Fleet-related preview).
80
+ Used for **container / edge app** deployment UI inside the application doc.
81
81
 
82
- **Agent:** configure the block for documentation; installing onto a device fleet is **not** `app clone` and may need Fleet auth — see meta skill routing. Prefer linking users to Console preview deploy when CLI container control is not wired.
82
+ **Agent:** configure the block for documentation. Installing the container is **not** `app clone`. Prefer linking users to Console preview deploy when the CLI has no container control.
83
83
 
84
84
  ## Other tool-blocks
85
85
 
@@ -10,7 +10,7 @@ description: >-
10
10
 
11
11
  # SenseCraft Data (SenseCAP PaaS)
12
12
 
13
- SenseCraft CLI wrappers for the [SenseCAP HTTP OpenAPI](https://sensecap-docs.seeed.cc/). Every `device`, `group`, and `data` command sends authenticated HTTP requests to the user's configured site (Global / China / Develop). The CLI unwraps the API envelope (`code`, `msg`, `data`) and prints only the `data` payload as indented JSON on stdout.
13
+ SenseCraft CLI wrappers for the [SenseCAP HTTP OpenAPI](https://sensecap-docs.seeed.cc/). Every `device`, `group`, and `data` command sends authenticated HTTP requests to the user's configured site (Global / China). The CLI unwraps the API envelope (`code`, `msg`, `data`) and prints only the `data` payload as indented JSON on stdout.
14
14
 
15
15
  Parent router: [`../sensecraft-ai/SKILL.md`](../sensecraft-ai/SKILL.md).
16
16
 
@@ -70,7 +70,6 @@ Resolved path priority: `SENSECRAFT_CONFIG_FILE` (absolute or relative to `SENSE
70
70
  |------|------------------|
71
71
  | Global (International) | `https://sensecap.seeed.cc/openapi` |
72
72
  | China | `https://sensecap.seeed.cn/openapi` |
73
- | Develop (test) | Selected during `auth init` / `auth add`; stored in config |
74
73
 
75
74
  Authentication: HTTP Basic Auth with Key ID (username) and Access Key (password), obtained via `auth init` (OAuth Device Flow) or `auth add` (manual import).
76
75
 
@@ -18,7 +18,7 @@ Interactive setup wizard (OAuth Device Flow). Obtains an Access Key and writes `
18
18
 
19
19
  ### Wizard steps
20
20
 
21
- 1. Select site: Global (International), China, or Develop (test)
21
+ 1. Select site: Global (International) or China
22
22
  2. Browser OAuth Device Flow authorization
23
23
  3. Organization selection
24
24
  4. Access Key creation
@@ -47,7 +47,7 @@ Site defaults to Global when omitted. In an interactive terminal, missing `--key
47
47
  |------|----------|---------|-------------|
48
48
  | `--key-id` | Yes* | — | Access Key ID (API ID) |
49
49
  | `--access-key` | Yes* | — | Access Key secret |
50
- | `--site` | No | `Global` | Site: `Global`, `China`, or `Develop` |
50
+ | `--site` | No | `Global` | Site: `Global` or `China` |
51
51
 
52
52
  \* Required unless running interactively (then prompted).
53
53
 
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  name: sensecraft-devices-cloud
3
3
  description: >-
4
- Manages SenseCraft AI cloud devices (Jetson / kit fleet via {ai-host}/openapi
4
+ Manages SenseCraft AI cloud devices (Jetson / cloud kits via {ai-host}/openapi
5
5
  list_node): list/view devices, deploy models with update_stream, poll order
6
6
  records. Use when the user mentions Jetson 部署, 云端设备, cloud device,
7
7
  Requires Access Key (`auth init --kind sensecap`). Not SenseCAP device CLI,
8
- not Fleet, not local USB flash.
8
+ not local USB flash.
9
9
  ---
10
10
 
11
11
  # SenseCraft Devices Cloud
@@ -18,8 +18,7 @@ Auth: **Access Key** (`auth init --kind sensecap`) → `{ai-host}/openapi`. Pare
18
18
  2. **Never** use SenseCAP `device` commands here (`device list` = SenseCAP OpenAPI).
19
19
  3. **L2 confirm is a separate chat turn** ([`../confirmation.md`](../confirmation.md)) before `cloud deploy --yes` (and device output / order writes). 「部署到这台设备」is **not** confirmation — ask (部署 + 环境 + EUI + model_id), wait for `确认`, then `--yes`. Never pass `--yes` on the same turn as the first request.
20
20
  4. Local USB / Web Serial = **L3** → guide Console `/ai/device/local/...`.
21
- 5. Fleet Docker install = [`sensecraft-fleet`](../sensecraft-fleet/SKILL.md) + `fleet …`;**same `sensecraft-ai` token**, different API host (`api.seeed-fleet.com`).
22
- 6. **reCamera Pro** (`uniform_type=53`) local IP/USB RC2/ALPKG deploy is **not** `cloud deploy` / `update_stream` — guide users to Console device workspace (L3).
21
+ 5. **reCamera Pro** (`uniform_type=53`) local IP/USB RC2/ALPKG deploy is **not** `cloud deploy` / `update_stream` — guide users to Console device workspace (L3).
23
22
 
24
23
  ## CLI status
25
24
 
@@ -39,7 +38,7 @@ sensecraft-cli cloud deploy --eui <EUI> --model-id <id> --from-json ./stream.jso
39
38
  sensecraft-cli cloud order --request-id <request_id> --device-uuid <uuid>
40
39
  ```
41
40
 
42
- `uniform_type` 26 is common for Jetson fleet UI; model deploy pages may pass other types / `adapteds`.
41
+ `uniform_type` 26 is common for the Jetson cloud device UI; model deploy pages may pass other types / `adapteds`.
43
42
 
44
43
  Full flag reference and copyable examples: [commands.md](commands.md).
45
44
 
@@ -49,5 +48,4 @@ Full flag reference and copyable examples: [commands.md](commands.md).
49
48
  |------|-----|
50
49
  | SenseCAP node/gateway telemetry | `sensecraft-cli device …` (Access Key) |
51
50
  | Jetson / AI cloud kit | `cloud device …` (this skill) |
52
- | Fleet multi-host Docker apps | `fleet …` + [`sensecraft-fleet`](../sensecraft-fleet/SKILL.md) |
53
51
  | USB flash | Console local device (L3) |
@@ -1,12 +1,12 @@
1
1
  # sensecraft-devices-cloud — CLI commands
2
2
 
3
- Binary: `sensecraft-cli`. Auth: active **`sensecraft-ai`** profile.
3
+ Binary: `sensecraft-cli`. Auth: Access Key (`auth init --kind sensecap`).
4
4
 
5
5
  ## `cloud device list`
6
6
 
7
7
  | Flag | Default | Notes |
8
8
  |------|---------|-------|
9
- | `--uniform-type` | `26` | Device type; Jetson fleet UI commonly uses `26` |
9
+ | `--uniform-type` | `26` | Device type; Jetson cloud UI commonly uses `26` |
10
10
  | `--adapteds` | — | Optional adapted-device/model filter |
11
11
  | `--name` | — | Filter by `device_name` |
12
12
  | `--page` / `--length` | `1` / `20` | Pagination |
@@ -54,5 +54,4 @@ This command only polls deployment status and is not L2.
54
54
 
55
55
  - `cloud device …`: SenseCraft AI Jetson / cloud kit.
56
56
  - `device …`: SenseCAP node/gateway OpenAPI.
57
- - `fleet …`: Seeed Fleet Docker apps.
58
57
  - Local USB / Web Serial flashing: Console L3, not this CLI.
@@ -30,7 +30,7 @@ Auth: **Access Key** → `{ai-host}/openapi`. Parent: [`../sensecraft-ai/SKILL.m
30
30
  6. Upload alone is not L2; attaching to a model/app (`--id` / `--model-id` / `--app-id`) **is L2**. Follow [`../confirmation.md`](../confirmation.md): ask first, wait for `确认`, then `--yes`. Never pass `--yes` on the same turn as the first request. `--unlinked` is an explicit orphan opt-in (not L2).
31
31
  7. Do not pass oversized files or more than 16 app image URLs; CLI rejects them before upload/update.
32
32
  8. Types `3`–`6` have no model/app attach path and upload directly (no `--unlinked` needed).
33
- 9. **Security gates**: empty (0 B) files rejected; type 2–6 / train sample zips ≤ **100 MB**; images 2 MB (model) / 5 MB (app). Upload rate limited to **8 / 10s** and **30 / minute** (client `acquire_file_url` + train multipart).
33
+ 9. **Security gates**: empty (0 B) files rejected; type 2–6 ≤ **100 MB**; images 2 MB (model) / 5 MB (app). Upload frequency is enforced by the server, not this CLI.
34
34
 
35
35
  ## Examples
36
36
 
@@ -1,6 +1,6 @@
1
1
  # sensecraft-files — CLI commands
2
2
 
3
- Binary: `sensecraft-cli`. Auth: active **`sensecraft-ai`** profile.
3
+ Binary: `sensecraft-cli`. Auth: Access Key (`auth init --kind sensecap`).
4
4
 
5
5
  ## `file upload`
6
6
 
@@ -14,7 +14,7 @@ Domain skill for **SenseCraft AI models**. Auth: **Access Key** → `{ai-host}/o
14
14
 
15
15
  Parent: [`../sensecraft-ai/SKILL.md`](../sensecraft-ai/SKILL.md).
16
16
  Apps: [`../sensecraft-apps/SKILL.md`](../sensecraft-apps/SKILL.md).
17
- Training artifacts (train job model download): [`sensecraft-train`](../sensecraft-train/SKILL.md) + `train model download` — distinct from library `model download`.
17
+ Library `model download` is the published model file, not a training-job export.
18
18
 
19
19
  ## Agent rules
20
20