@seeed-studio/solution-cli 0.3.0 → 0.3.1

package/README.md

@@ -10,18 +10,30 @@ Compatible with **Claude Code, Codex, Google Antigravity (AGY), Work Buddy, and
 
 ## 1. Quick Start & Agent Installation
 
-Install the underlying engine and configure the AI Agent Skill with a single command:
+Install the underlying engine and configure the AI Agent Skill with one command:
 
 ```bash
-# Interactive mode (auto-scans local agent environments and prompts for selection)
-npx @seeed-studio/solution-cli install
+npx -y @seeed-studio/solution-cli@latest install -y
+```
+
+The same command is safe to repeat. It checks the signed stable Engine release,
+reuses an equal or newer local Engine, and upgrades an older one. Existing
+modified or unregistered skills and protected symlinks are preserved. Use
+`--agent claude,antigravity` to select agents, or `--engine-path <path>` to pin
+a valid Engine binary. `--force` re-downloads an equal or older Engine and
+overwrites existing skill files, including user modifications; use it only when
+that overwrite is intended. Protected external symlinks are not followed, and
+it never downgrades a newer discovered Engine.
 
-# Non-interactive mode (e.g. install to Claude Code and Antigravity)
-npx @seeed-studio/solution-cli install --agent claude,antigravity -y
+Automatic reuse/upgrade rules start with solution-cli 0.3.1; if npm `latest` is
+still 0.3.0, those rules are not live. At this verification, 0.3.1 is pending
+publication. A latest release or signature failure stops before changing the
+Engine or skills; an offline host must use a valid explicit local Engine path.
 
-# Install globally
-npm install -g @seeed-studio/solution-cli
-solution-cli install -y
+The interactive form remains available when prompts are wanted:
+
+```bash
+npx -y @seeed-studio/solution-cli@latest install
 ```
 
 ### Supported AI Agent Harnesses
@@ -110,7 +122,7 @@ Once installed, your AI Agent gains deep domain knowledge as an Edge IoT Solutio
 > 1. 提供方案对应的官方 GitHub 开源仓库地址；
 > 2. 指导用户克隆到本地工作区；
 > 3. 指导通过 TensorRT `trtexec` 完成端侧引擎转换，并在 `docker-compose.override.yml` 中挂载自定义模型；
-> 4. 使用 `sensecraft-engine deploy --solutions-dir ./solutions` 进行本地快速调测。
+> 4. 使用 `sensecraft-engine deploy <id> --solutions-dir ./solutions` 进行本地快速调测。
 
 ---
 

package/bin/cli.js

@@ -42,7 +42,7 @@ Options:
   -y, --yes            Accept default detected selections non-interactively
   --dry-run            Simulate operations without making changes to filesystem
   --skip-content       Skip pulling IoT solution packages from CDN
-  --force              Force re-download or re-link even if already installed
+  --force              Re-download equal/older stable Engine and overwrite existing skill files, including local modifications; never downgrade a newer local Engine
   --json               Output machine-readable JSON (supported by all query/diagnostic commands)
   --locale <zh|en>     Language for hub and product results (default: zh)
   --limit <num>        Maximum results for search (default: 5)