@deveco-test/deveco-cli 1.3.1-Test.1 → 1.3.3-Test.1

package/README.md

@@ -208,7 +208,7 @@ devecocli init --agent <agents> --project <path> --path <path> --skill --mcp --f
 
 | 参数名         | 说明                                                                                        |
 | ----------- | ----------------------------------------------------------------------------------------- |
-| --agent     | 可选，智能体名称，多个智能体名称以英文逗号分隔。缺省时配置到所有已检测到的智能体中                                                 |
+| --agent     | 可选，智能体名称，多个智能体名称以英文逗号分隔。支持 `trae-cn`、`opencode`、`pi`、`cursor`、`codebuddy`、`qoder`、`claude-code`、`codex`。缺省时配置到所有已检测到的智能体中 |
 | --project   | 可选，指定工程路径，将`deveco-cli` `Skill` 或 `MCP` 服务安装到该工程项目中                                       |
 | --path      | 可选，指定 `deveco-cli` `Skill` 的配置路径。不可与 `--project` 、`--agent` 、 `--mcp` 同时使用                |
 | --skill     | 可选，安装 `deveco-cli` `Skill`。不可与 `--mcp` 同时使用。`--mcp` 与 `--skill` 都缺省时，执行 `--skill`         |
@@ -829,6 +829,56 @@ devecocli device view -t "My Device Name"
 devecocli device view -t 127.0.0.1:5555 --format json
 ```
 
+### `device file`
+
+在主机与设备（真机或模拟器）之间传输文件，底层映射为 `hdc -t <serial> file send/recv <src> <dst>`。
+
+**命令格式：**
+
+```bash
+devecocli device file [--device <name|serial>] send <src> <dst>
+devecocli device file [--device <name|serial>] recv <src> <dst>
+```
+
+**参数：**
+
+| 参数名 | 说明 |
+| --- | --- |
+| --device | 可选，目标设备名称或序列号。单设备可省略，多设备时必填 |
+| send <src> <dst> | 子命令，上传本地文件到设备 `<src>`(本地) → `<dst>`(设备端) |
+| recv <src> <dst> | 子命令，下载设备文件到主机 `<src>`(设备端) → `<dst>`(本地) |
+
+**示例：**
+
+```bash
+devecocli device file send ./local.txt /data/local/tmp/remote.txt
+devecocli device file recv /data/local/tmp/remote.txt ./local.txt --device 127.0.0.1:5555
+```
+
+### `device sqlite3`
+
+在设备上执行 `sqlite3`，底层映射为 `hdc -t <serial> shell sqlite3 <db-path> [args...]`，后续参数原样透传给设备的 `sqlite3`。
+
+**命令格式：**
+
+```bash
+devecocli device sqlite3 [--device <name|serial>] <db-path> [args...]
+```
+
+**参数：**
+
+| 参数名 | 说明 |
+| --- | --- |
+| --device | 可选，目标设备名称或序列号。单设备可省略，多设备时必填 |
+| db-path | 设备端 SQLite 数据库文件路径 |
+| args | 可选，透传给设备 `sqlite3` 的参数，如 `-json`、`-header`、`-readonly`、SQL 语句、点命令等 |
+
+**示例：**
+
+```bash
+devecocli device sqlite3 /data/app/el2/100/database/com.example.app/foo.db "select * from user limit 5" -json
+```
+
 ### `ui screenshot`
 
 对真机或模拟器执行 UI 截图。

package/SKILL.md

@@ -73,6 +73,8 @@ Search/read local HarmonyOS docs.
 ### `devecocli device`
 - `list`: Show active real devices and running emulators. Opt: `--format <table|json>` (default: `table`).
 - `view`: Detailed info. Req `-t <name|serial>` on multi-device hosts. Opt: `--format <table|json>` (default: `table`).
+- `file`: Transfer files between the host and a device. Opt: `--device <name|serial>` (optional when exactly one device is connected, required when multiple). `send <local> <remote>` pushes a local file onto the device; `recv <remote> <local>` pulls a file back. Maps to `hdc -t <serial> file send/recv <src> <dst>`; the operation only succeeds when hdc reports `FileTransfer finish`.
+- `sqlite3`: Run `sqlite3` on a device. Opt: `--device <name|serial>` (optional when exactly one device is connected, required when multiple). `db-path` is the on-device SQLite file; all further args are forwarded to the device `sqlite3` as-is (e.g. `-json`, `-readonly`, SQL strings, dot-commands). Maps to `hdc -t <serial> shell sqlite3 <db-path> [args...]`.
 
 ### `devecocli run` `[Outside sandbox]`
 Build, install, and launch.
@@ -151,11 +153,11 @@ MUTUALLY EXCLUSIVE modes for setup:
 1. `--skill` (Default): Install `deveco-cli` skill to AI agents.
 2. `--mcp`: Configure `deveco-mcp` server (ArkTS/C++ syntax checking).
 *Options*:
-- `--agent <agents>`: Comma-separated (e.g. `opencode,cursor`). Omitting targets all.
+- `--agent <agents>`: Comma-separated (e.g. `opencode,pi,cursor`). Omitting targets all.
 - `--project <path>`: Project-level config (Abs path for MCP).
 - `--path <path>`: Direct skill install path.
 - `-f, --force`: Overwrite existing config.
-*MCP Rules*: Global MCP (no `--project`) only supports `opencode` and `cursor`. Others require `--project`.
+*MCP Rules*: All configured MCP agents support global (no `--project`) and project-level MCP, except `qoder` (not supported).
 
 ### `devecocli auth login`
 Sign in to your Huawei Developer account. Opens a browser for OAuth authentication. Required before `signature generate`.
@@ -216,7 +218,7 @@ Validation order: `files` + `--modules` mutually exclusive → `--source-version
 - **`Not logged in. Run devecocli auth login first`**: Run `devecocli auth login` to authenticate.
 - **`Provision number exceeds limit`**: Test provision quota is full. Delete old test provisions in DevEco Studio (Signing Configs) or AGC console, then retry `devecocli signature generate`.
 - **`Invalid AccessToken. Sign in and try again`**: Token expired. Run `devecocli auth login` again.
-- **`skills add` agent not found**: Valid: `atomcode`, `codebuddy`, `cursor`, `opencode`, `qoder`, `trae-cn`.
+- **`skills add` agent not found**: Valid: `atomcode`, `codebuddy`, `claude-code`, `codex`, `cursor`, `deveco`, `opencode`, `pi`, `qoder`, `trae-cn`.
 - **`emulator start` / `image download` blocked on agreement**: User MUST accept agreements. Interactive: `devecocli emulator license` (requires TTY). Non-interactive (CI/scripts): `devecocli emulator license accept`. Agents cannot run the interactive form; suggest the user run it, or use `license accept` if a non-TTY flow is acceptable. Do not retry until accepted.
 - **`image download` failure / timeout**: Do NOT auto-retry. Give the command to the user to run manually in their terminal.
 - **`emulator create` timeout**: Treat as user-action step. Ask user to open DevEco Studio -> Device Manager. Check `emulator list` after user confirms. Do NOT auto-retry or edit SDK files.