{"_id":"@deveco-test/hmos-deveco-cli-fortest","_rev":"3-622b7c24e2f3579a5118fd32fbe9d3bb","name":"@deveco-test/hmos-deveco-cli-fortest","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@deveco-test/hmos-deveco-cli-fortest","version":"0.1.0","keywords":["harmonyos","deveco","cli"],"license":"MIT","_id":"@deveco-test/hmos-deveco-cli-fortest@0.1.0","maintainers":[{"name":"jiangfeng52","email":"jiangfeng52@h-partners.com"},{"name":"anieo","email":"601905510@qq.com"},{"name":"owenclaw","email":"owen.s677u@gmail.com"},{"name":"jliu666","email":"jliu666@hotmail.com"}],"bin":{"devecocli":"dist/cli.js"},"dist":{"shasum":"60de9f2c8bf70fe939215cb8aef9009a0dde0dc8","tarball":"https://registry.npmjs.org/@deveco-test/hmos-deveco-cli-fortest/-/hmos-deveco-cli-fortest-0.1.0.tgz","fileCount":30,"integrity":"sha512-dP6sIKUOoP9T9AjHGjh9qWVn12U9tDw0EPInipwh3+HECr+XRzFypLEF2d8J1Of+a9zx/er+Umr8kCrnQYRv0A==","signatures":[{"sig":"MEYCIQDdUQXVYoq5qetirko1RLUxDv9WH12qtYM6BDT2YcK+bgIhANSrWXTABQA7nFMezItuZh2/qmu1v5ZtLOCmXhaGHhP+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42669702},"type":"module","engines":{"node":">=18"},"scripts":{"dev":"tsx watch src/cli.ts","lint":"eslint src","build":"tsup","start":"tsx src/cli.ts","format":"prettier --write src","license":"generate-license-file --input package.json --output THIRD-PARTY-LICENSES --overwrite --ci","prepare":"husky","lint:fix":"eslint src --fix","download-docs":"tsx scripts/download-docs.ts","prepublishOnly":"npm run lint && npm run license && npm run build"},"_npmUser":{"name":"jiangfeng52","email":"jiangfeng52@h-partners.com"},"overrides":{"dotenv":"16.4.7"},"_npmVersion":"10.8.2","description":"HarmonyOS application development command line tool","directories":{},"_nodeVersion":"20.20.1","dependencies":{"ora":"^8.2.0","zod":"^4.4.3","axios":"1.15.2","execa":"^9.6.1","json5":"^2.2.3","adm-zip":"^0.5.17","p-limit":"^5.0.0","regedit":"^5.1.4","ripgrep":"^0.3.1","fs-extra":"^11.3.4","colorette":"^2.0.20","commander":"^13.1.0","smol-toml":"^1.6.1","xdg-basedir":"^5.1.0","global-agent":"^4.1.3","@vscode/ripgrep":"^1.18.0","proper-lockfile":"^4.1.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","husky":"9.1.7","eslint":"^10.2.1","prettier":"^3.8.3","turndown":"^7.2.4","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^25.6.0","@types/adm-zip":"^0.5.8","@types/fs-extra":"^11.0.4","@types/turndown":"^5.0.5","typescript-eslint":"^8.59.1","@types/global-agent":"^3.0.0","generate-license-file":"^4.2.1"},"_npmOperationalInternal":{"tmp":"tmp/hmos-deveco-cli-fortest_0.1.0_1782982454151_0.1689263370321794","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-07-02T08:54:13.957Z","modified":"2026-08-10T02:07:42.236Z","0.1.0":"2026-07-02T08:54:14.681Z"},"license":"MIT","keywords":["harmonyos","deveco","cli"],"description":"HarmonyOS application development command line tool","maintainers":[{"email":"jiangfeng52@h-partners.com","name":"jiangfeng52"},{"email":"15827509426@163.com","name":"tylorsenna"},{"email":"601905510@qq.com","name":"anieo"},{"email":"owen.s677u@gmail.com","name":"owenclaw"},{"email":"1643457850@qq.com","name":"action-passion"},{"email":"jliu666@hotmail.com","name":"jliu666"}],"readme":"<div align=\"center\">\n  <h1>DevEco CLI</h1>\n  <p>一个面向 HarmonyOS 应用开发的统一命令行入口。</p>\n  <p>\n    <a href=\"https://www.npmjs.com/package/@deveco/deveco-cli\"><img src=\"https://img.shields.io/npm/v/@deveco/deveco-cli.svg\" alt=\"NPM Version\" /></a>\n    <a href=\"https://www.npmjs.com/package/@deveco/deveco-cli\"><img src=\"https://img.shields.io/npm/dm/@deveco/deveco-cli.svg\" alt=\"NPM Downloads\" /></a>\n    <a href=\"https://nodejs.org/\"><img src=\"https://img.shields.io/badge/Node.js-%3E%3D18-green.svg\" alt=\"Node.js\" /></a>\n    <img src=\"https://img.shields.io/badge/platform-macOS%20%7C%20Windows-blue.svg\" alt=\"Platform\" />\n    <a href=\"https://developer.huawei.com/consumer/cn/download/\"><img src=\"https://img.shields.io/badge/DevEco%20Studio-%3E%3D6.1.0-orange.svg\" alt=\"DevEco Studio\" /></a>\n    <a href=\"./LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-green.svg\" alt=\"License\" /></a>\n  </p>\n</div>\n\n`DevEco CLI` 将 `DevEco Studio` 工具链统一封装为一个 `CLI`，内置 `ohpm`、`hvigor`、`hdc`、`emulator`、`hilog`，同时集成 HarmonyOS 技能安装、项目脚手架、本地  HarmonyOS 文档检索和 `MCP` 服务。\n\n\n## 快速开始\n\n### 前置要求\n\n- 操作系统为 `macOS` 或 `Windows`\n- Node.js >= 18，推荐使用22及以上版本\n- [DevEco Studio](https://developer.huawei.com/consumer/cn/download/) >= 6.1.0\n  - **macOS**：必须安装在 `~/Applications` 或 `/Applications` 目录下。\n\n### 安装\n\n```bash\nnpm install -g @deveco/deveco-cli@latest\n```\n\n安装后可以通过以下命令更新到最新版本：\n\n```bash\ndevecocli update\n```\n\n### 最短工作流\n\n```bash\ndevecocli create --app-name MyApp\ncd MyApp\ndevecocli run\ndevecocli log --level E\n```\n\n### 文档检索\n\n```bash\ndevecocli docs search List\ndevecocli docs read harmonyos-guides/application-models/arkts-page-start-overview\n```\n\n更多命令和参数可通过 `devecocli --help` 或各子命令的 `--help` 查看。\n\n## AI Agent 集成\n\n`DevEco CLI` 支持通过命令行将自身技能添加到 `Agent` 中。下面以 `opencode` 为例展示最短流程：\n\n```bash\n# 1. 给 opencode 安装 deveco-cli 技能\ndevecocli init --agent opencode\n\n# 2. 给 opencode 在当前 HarmonyOS 项目配置 MCP\ndevecocli init --mcp --agent opencode --project ./MyApp\n\n# 3. 进入项目并启动 opencode\ncd MyApp\nopencode\n```\n\n如果 `Agent` 不在 `--agent` 参数取值范围内，可使用 `--path` 参数进行添加，参考如下命令：\n\n```bash\ndevecocli init --path D:\\work\\ARKTS\\NewData\n```\n\n进入 `Agent` 后可以直接描述任务，例如：\n\n- `Build this project in release mode and run it on my emulator`\n- `Tail the last error logs from this app`\n- `Check for syntax errors in src/main/ets/pages/Index.ets`\n\n## 常用命令\n\n| 命令                        | 用途                                        |\n| ------------------------- | ----------------------------------------- |\n| `devecocli create`        | 创建新的 HarmonyOS 项目                         |\n| `devecocli build`         | 构建项目并产出 `.hap` / `.hsp` / `.har` / `.app` |\n| `devecocli run`           | 安装并运行应用                                   |\n| `devecocli device list`   | 查看当前连接设备                                  |\n| `devecocli emulator list` | 查看本地模拟器实例                                 |\n| `devecocli log`           | 查看 `hilog` 或崩溃日志                          |\n| `devecocli docs search`   | 搜索本地 HarmonyOS 文档                         |\n| `devecocli init`          | 安装内置技能或配置 `MCP`                           |\n| `devecocli skills`        | 管理 HarmonyOS 技能市场中的技能                     |\n\n## 命令集\n\n### `help`\n\n查看版本、帮助信息以及所有子命令\n\n**命令格式：**\n\n```bash\ndevecocli help\n```\n\n```text\n# 返回结果\nUsage: devecocli [options] [command]\n\nHarmonyOS application development command line tool\n\nOptions:\n  -V, --version          output the version number\n  -h, --help             display help for command\n\nCommands:\n  build [options]        Build the HarmonyOS project\n  run [options]          Build and run the project on a connected device\n  update                 Update deveco-cli to the latest version\n  device                 Manage connected devices\n  emulator               Manage emulator instances\n  skills                 Manage HarmonyOS skills\n  log [options]          Obtain device application logs\n  create [options]       Scaffold a new HarmonyOS application project\n  init [options]         Install the deveco-cli skill or configure the deveco-mcp server into AI agents\n  serve                  Host bundled auxiliary protocol servers\n  docs [options]         Search and read HarmonyOS documentation from local docs directory\n  help [command]         display help for command\n```\n\n### `init`\n\n将`deveco-cli` `Skill` 或者 `MCP` 服务配置到智能体中\n\n**命令格式：**\n\n```bash\ndevecocli init --agent <agents> --project <path> --path <path> --skill --mcp --force\n```\n\n**参数：**\n\n| 参数名         | 说明                                                                                        |\n| ----------- | ----------------------------------------------------------------------------------------- |\n| --agent     | 可选，智能体名称，多个智能体名称以英文逗号分隔。缺省时配置到所有已检测到的智能体中                                                 |\n| --project   | 可选，指定工程路径，将`deveco-cli` `Skill` 或 `MCP` 服务安装到该工程项目中                                       |\n| --path      | 可选，指定 `deveco-cli` `Skill` 的配置路径。不可与 `--project` 、`--agent` 、 `--mcp` 同时使用                |\n| --skill     | 可选，安装 `deveco-cli` `Skill`。不可与 `--mcp` 同时使用。`--mcp` 与 `--skill` 都缺省时，执行 `--skill`         |\n| --mcp       | 可选，配置 `MCP` 服务，与 `--project` 一起使用表示配置工程级 `MCP` 服务，独立使用表示配置用户级 `MCP` 服务。不可与 `--skill` 同时使用 |\n| -f, --force | 可选，当目标位置已存在 `deveco-cli` `Skill` 或 `MCP` 服务时，覆盖重装                                         |\n\n**示例：**\n\n```bash\n# 配置Skill\ndevecocli init -f   # 安装或更新deveco-cli Skill\ndevecocli init --skill\ndevecocli init --agent agentname    # agentname需替换为实际的智能体名称\ndevecocli init --path D:\\work\\ARKTS\\NewData -f\n\n# 配置MCP\ndevecocli init --mcp\ndevecocli init --mcp --agent agentname    # agentname需替换为实际的智能体名称   \ndevecocli init --mcp --project D:\\work\\ARKTS\\NewData -f\n```\n\n### `docs search`\n\n将关键词搜索版本说明、指南、API参考、最佳实践、`FAQ` 、变更预告等中的内容\n\n**命令格式：**\n\n```bash\ndevecocli docs search <keywords...> --catalog <name> --format <fmt> --limit <n>\n```\n\n**参数：**\n\n| 参数名         | 说明                                                                                                                                                                                 |\n| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| keywords... | 必选，搜索关键词，多个关键词用空格隔开                                                                                                                                                                |\n| --catalog   | 可选，文档类别，取值包含`harmonyos-releases`（版本说明）、 `harmonyos-guides`（指南）、`harmonyos-references`（API参考）、`best-practices`（最佳实践）、`harmonyos-faqs`（FAQ）、`harmonyos-roadmap`（变更预告）、`all`（所有分类，默认） |\n| --format    | 可选，控制输出格式，取值包括 `default` 、`json` ，默认为`default` ，输出结果包括文档ID、标题、文档的概括内容                                                                                                              |\n| --limit     | 可选，设置搜索结果返回条数，默认为20                                                                                                                                                                |\n\n**示例：**\n\n```bash\ndevecocli docs search 沉浸光感\ndevecocli docs search '@State' '@Prop' --catalog best-practices --limit 10\ndevecocli docs search Row Column --format json\n```\n\n### `docs read`\n\n按文档ID查询文档的完整内容\n\n**命令格式：**\n\n```bash\ndevecocli docs read <documentId> \n```\n\n**参数：**\n\n| 参数名        | 说明      |\n| ---------- | ------- |\n| documentId | 必选，文档ID |\n\n**示例：**\n\n```bash\ndevecocli docs read 开发指南/应用框架/UI_Design_Kit_UI设计套件/沉浸光感/ui-design-hds-component-material\n```\n\n### `docs catalog`\n\n查询文档分类和分类名称\n\n**命令格式：**\n\n```bash\ndevecocli docs catalog --format <fmt> \n```\n\n**参数：**\n\n| 参数名      | 说明                                        |\n| -------- | ----------------------------------------- |\n| --format | 可选，输出格式，`default` 或 `json` ，默认为 `default` |\n\n**示例：**\n\n```bash\ndevecocli docs catalog \ndevecocli docs catalog --format json\n```\n\n### `create`\n\n创建 HarmonyOS 应用工程，仅支持创建工程模板中的 `Empty Ability` 模板\n\n**命令格式：**\n\n```bash\ndevecocli create --app-name <name> --project-path <path> --bundle-name <bundle> --api-level <level> \n```\n\n**参数：**\n\n| 参数名            | 说明                                                                |\n| -------------- | ----------------------------------------------------------------- |\n| --app-name     | 必选，应用名称                                                           |\n| --project-path | 可选，工程路径，默认为：`./<appname>`                                         |\n| --bundle-name  | 可选，包名，默认为：`com.example.<appname>` ，`appname` 自动转为小写               |\n| --api-level    | 可选，API级别，最小值为17，最大值从安装的 `Deveco Studio` 的 `HarmonyOS` `SDK` 中自动获取 |\n\n**示例：**\n\n```bash\ndevecocli create --project-path ./MyApp --app-name MyApp\ndevecocli create --project-path ./MyApp --app-name MyApp --bundle-name com.acme.myapp --api-level 23\ndevecocli create --app-name MyApp\n```\n\n### `build`\n\n编译并打包 HarmonyOS 工程或工程中的模块\n\n**命令格式：**\n\n```bash\ndevecocli build --product <product> --modules <modules> --build-mode <mode>\n```\n\n**参数：**\n\n| 参数名          | 说明                                                                                                      |\n| ------------ | ------------------------------------------------------------------------------------------------------- |\n| --product    | 可选，产品的名称，默认为 `default`                                                                                  |\n| --modules    | 可选，模块的名称。如需指定模块的 `target` 信息，使用 `module@target` 形式。当工程中只有一个模块时，可缺省；当工程中存在多个模块，且仅存在一个 `entry` 类型的模块时，可缺省 |\n| --build-mode | 可选，构建模式，默认为 `debug`                                                                                     |\n\n**示例：**\n\n```bash\ndevecocli build --build-model release\ndevecocli build --modules entry library\ndevecocli build --modules library@phone\ndevecocli build --product oversea --modules entry --build-model release\n```\n\n**说明：**\n\n- 选定模块的依赖会被自动解析和构建\n- 执行`devecocli build --product <name>`命令后，产物为 `.app`\n- 执行`devecocli build --product <name> --modules <m1>`命令后，产物为 `.hap` / `.hsp` / `.har`\n\n### `build clean`\n\n清理 HarmonyOS 项目的构建产物\n\n**命令格式：**\n\n```bash\ndevecocli build clean\n```\n\n### `emulator list`\n\n查看模拟器实例\n\n**命令格式：**\n\n```bash\ndevecocli emulator list\n```\n\n### `emulator start`\n\n启动模拟器。首次使用时，需要签署 HarmonyOS 软件许可与服务协议，具体请参考 `emulator license accept`\n\n**命令格式：**\n\n```bash\ndevecocli emulator start [names...]\n```\n\n**参数：**\n\n| 参数名         | 说明                                        |\n| ----------- | ----------------------------------------- |\n| \\[names...] | 必选，模拟器实例名称，多个名称用空格隔开。若名称中带有空格，则名称需要添加英文引号 |\n\n**示例：**\n\n```bash\ndevecocli emulator start Phone\ndevecocli emulator start Phone1 Phone2\n```\n\n**说明：**\n\n- `emulator start` 命令仅支持启动 `release` 版本的模拟器\n\n### `emulator stop`\n\n关闭模拟器\n\n**命令格式：**\n\n```bash\ndevecocli emulator stop [names...]\n```\n\n**参数：**\n\n| 参数名         | 说明                                        |\n| ----------- | ----------------------------------------- |\n| \\[names...] | 必选，模拟器实例名称，多个名称用空格隔开。若名称中带有空格，则名称需要添加英文引号 |\n\n**示例：**\n\n```bash\ndevecocli emulator stop Phone\ndevecocli emulator stop 127.0.0.1:5555\n```\n\n### `emulator create`\n\n创建模拟器\n\n**命令格式：**\n\n```bash\ndevecocli emulator create <name> --device-type <type> --os-version <version> --force\n```\n\n**参数：**\n\n| 参数名           | 说明                                                                                                                              |\n| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| name          | 必选，模拟器名称                                                                                                                        |\n| --device-type | 必选，模拟器设备类型，支持 `phone` ， `foldable` ， `widefold` ， `triplefold` ， `tablet` ， `2in1` ， `2in1 foldable` ， `tv` ， `wearable` ，全小写 |\n| --os-version  | 必选，模拟器镜像版本                                                                                                                      |\n| --force       | 可选，覆盖已有同名的模拟器                                                                                                                   |\n\n**示例：**\n\n```bash\ndevecocli emulator create MyPhone --device-type phone --os-version \"HarmonyOS 6.0.1(21)\"\n```\n\n### `emulator delete`\n\n创建模拟器\n\n**命令格式：**\n\n```bash\ndevecocli emulator delete <name>\n```\n\n**参数：**\n\n| 参数名  | 说明             |\n| ---- | -------------- |\n| name | 必选，模拟器实例名称或序列号 |\n\n**示例：**\n\n```bash\ndevecocli emulator delete MyPhone\n```\n\n### `emulator image list`\n\n查询模拟器镜像列表\n\n**命令格式：**\n\n```bash\ndevecocli emulator image list --device-type <type> --all --format <format>\n```\n\n**参数：**\n\n| 参数名           | 说明                                                                                                                         |\n| ------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| --device-type | 可选，模拟器设备类型，支持 `phone` ， `foldable` ， `widefold` ， `triplefold` ， `tablet` ， `2in1` ， `2in1 foldable` ， `tv` ， `wearable` |\n| --all         | 可选，查询已下载和未下载的所有镜像                                                                                                          |\n| --format      | 可选，控制输出格式，取值为 `table` 或 `json` ，默认为 `table`                                                                                |\n\n**示例：**\n\n```bash\ndevecocli emulator image list\ndevecocli emulator image list --all\ndevecocli emulator image list --device-type phone\ndevecocli emulator image list --format json\n```\n\n### `emulator image download`\n\n下载模拟器镜像。首次使用时，需要签署 HarmonyOS `SDK` 许可协议，具体请参考 `emulator license accept`\n\n**命令格式：**\n\n```bash\ndevecocli emulator image download --device-type <type> --os-version <version> --force\n```\n\n**参数：**\n\n| 参数名           | 说明                                                                                                                              |\n| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| --device-type | 必选，模拟器设备类型，支持 `phone` ， `foldable` ， `widefold` ， `triplefold` ， `tablet` ， `2in1` ， `2in1 foldable` ， `tv` ， `wearable` ，全小写 |\n| --os-version  | 必选，模拟器镜像版本                                                                                                                      |\n| --force       | 可选，覆盖已有的模拟器镜像                                                                                                                   |\n\n**示例：**\n\n```bash\ndevecocli emulator image download --device-type phone --os-version \"HarmonyOS 6.0.1(21)\" --force\n```\n\n**说明：**\n\n- `emulator image download` 命令仅支持下载 `release` 版本的模拟器镜像\n\n### `emulator image remove`\n\n删除模拟器镜像\n\n**命令格式：**\n\n```bash\ndevecocli emulator image remove --device-type <type> --os-version <version>\n```\n\n**参数：**\n\n| 参数名           | 说明                             |\n| ------------- | ------------------------------ |\n| --device-type | 必选，模拟器设备类型，与下载镜像的device-type一致 |\n| --os-version  | 必选，模拟器镜像版本，与下载镜像的os-version一致  |\n\n**示例：**\n\n```bash\ndevecocli emulator image remove --device-type phone --os-version \"HarmonyOS 6.0.1(21)\"\n```\n\n### `emulator license view`\n\n查看协议文本（只读）\n\n**命令格式：**\n\n```bash\ndevecocli emulator license view\n```\n\n### `emulator license accept`\n\n查看并接受协议。使用模拟器需要同意 HarmonyOS 软件许可与服务协议，下载镜像需要同意 HarmonyOS `SDK` 许可协议\n\n**命令格式：**\n\n```bash\ndevecocli emulator license accept\n```\n\n### `device list`\n\n查询所有已连接的设备，包括真机设备和运行中的模拟器\n\n**命令格式：**\n\n```bash\ndevecocli device list\n```\n\n### `device view`\n\n查询已连接的设备的详细信息，包括设备序列号、设备名称、设备类型、 `OS` 版本等\n\n**命令格式：**\n\n```bash\ndevecocli device view --target <serialOrName>\n```\n\n**参数：**\n\n| 参数名         | 说明                                    |\n| ----------- | ------------------------------------- |\n| -t，--target | 可选，目标设备名称或序列号。多设备缺省时，会列出所有已连接设备序列号和名称 |\n\n**示例：**\n\n```bash\ndevecocli device view\ndevecocli device view --target 127.0.0.1:5555\ndevecocli device view -t \"My Device Name\"\n```\n\n### `run`\n\n构建应用后，将应用安装到真机设备或模拟器上，并启动执行\n\n**命令格式：**\n\n```bash\ndevecocli run --module <module> --device <device> --product <product> --build-mode <mode> --ability <ability> --uninstall --skip-build\n```\n\n**参数：**\n\n| 参数名          | 说明                                                                                                     |\n| ------------ | ------------------------------------------------------------------------------------------------------ |\n| --module     | 可选，模块名称。如需指定模块的 `target` 信息，使用 `module@target` 形式。当工程中只有一个可运行模块（ `entry` / `feature` / `shared` ）时，可缺省 |\n| --device     | 设备名称或设备序列号，单设备时可选，多设备时必选                                                                               |\n| --product    | 可选，产品的名称，默认为 `default`                                                                                 |\n| --build-mode | 可选，构建模式名称，默认为 `debug`                                                                                  |\n| --ability    | 可选，待启动的 `Ability` ，默认：模块 `module.json5` 中的`mainElement`                                                |\n| --uninstall  | 可选，安装前先卸载已有应用                                                                                          |\n| --skip-build | 可选，跳过构建操作，直接安装应用 。\\*\\*说明：\\*\\*使用该参数时，需确保对应模块已有构建产物                                                      |\n\n**示例：**\n\n```bash\ndevecocli run\ndevecocli run --module entry --device 127.0.0.1:5555\ndevecocli run --module library@phone --device 127.0.0.1:5555\ndevecocli run --product oversea --module entry --ability EntryAbility\ndevecocli run --build-mode release\ndevecocli run --uninstall\n```\n\n### `log`\n\n查看`hilog`普通日志或崩溃日志\n\n**命令格式：**\n\n```bash\ndevecocli log --device <device> --crash --level <level> --bundle-name <bundle-name> --keyword <keyword> --tail <num> --from <start> --to <end> --follow\n```\n\n**参数：**\n\n| 参数名           | 说明                                                                                                                         |\n| ------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| --device      | 设备名称或设备序列号，单设备时可选，多设备时必选                                                                                                   |\n| --crash       | 可选，查看崩溃日志                                                                                                                  |\n| --level       | 可选，日志级别，取值包括`D`（ `Debug` ）、`I`（ `Info` ）、`W`（ `Warn` ）、`E`（ `Error` ）、`F`（ `Fatal` ）                                       |\n| --bundle-name | 可选，根据包名查看日志                                                                                                                |\n| --keyword     | 可选，根据关键词查看日志，关键词区分大小写                                                                                                      |\n| --tail        | 可选，显示最新的N行日志，取值为正整数                                                                                                        |\n| --from        | 可选，起始时间，单位为`m`和`s`，`m`和`s`为小写，默认为`s`，`start`的取值需要大于等于`end`                                                                 |\n| --to          | 可选，结束时间，单位为`m`和`s`，`m`和`s`为小写，默认为`s` 。不可与--follow同时使用。**说明：** 如当前时间为05：00，`start`设置为30s，`end`设置为10s，则起始时间为04：30，结束时间为04：50 |\n| --follow      | 可选，实时输出日志。不可与--to同时使用                                                                                                      |\n\n**示例：**\n\n```bash\ndevecocli log --level E\ndevecocli log --crash --bundle-name com.example.app\ndevecocli log --device 127.0.0.1:5555 --level W --keyword Init\ndevecocli log --tail 100 --from 5m --to 2m\ndevecocli log --follow --bundle-name com.example.app\n```\n\n### `skills list`\n\n查询可用的 `Skill`\n\n**命令格式：**\n\n```bash\ndevecocli skills list --long\n```\n\n**参数：**\n\n| 参数名       | 说明                                              |\n| --------- | ----------------------------------------------- |\n| -l，--long | 可选，`Skill` 详情，包括描述和已安装的智能体列表。缺省时，仅显示 `Skill` 名称 |\n\n**示例：**\n\n```bash\ndevecocli skills list\ndevecocli skills list --long\ndevecocli skills list -l\n```\n\n### `skills find`\n\n按关键词搜索 `Skill`\n\n**命令格式：**\n\n```bash\ndevecocli skills find <keyword>\n```\n\n**参数：**\n\n| 参数名     | 说明       |\n| ------- | -------- |\n| keyword | 必选，搜索关键词 |\n\n**示例：**\n\n```bash\ndevecocli skills find deveco\n```\n\n### `skills add`\n\n将 `Skill` 添加到智能体中\n\n**命令格式：**\n\n```bash\ndevecocli skills add --all --agent <agents> --skill <skill-name> --project <path> --path <path> --force\n```\n\n**参数：**\n\n| 参数名        | 说明                                                        |\n| ---------- | --------------------------------------------------------- |\n| --all      | 可选，添加所有可用的 `Skill` ，与 `--skill` 二选一                       |\n| --agent    | 可选，智能体名称，多个智能体时以英文逗号分隔。缺省时，添加到已检测到的智能体中                   |\n| --skill    | 可选，待添加的 `Skill` 名称，与 `--all` 二选一                          |\n| --project  | 可选，指定项目路径，将 `Skill` 添加到该工程项目中                             |\n| --path     | 可选，指定路径，将 `Skill` 添加到该路径，不可与 `--project` 或 `--agent` 同时使用 |\n| -f，--force | 可选，当目标位置已有同名 `Skill` 时，覆盖重添加                              |\n\n**示例：**\n\n```bash\ndevecocli skills add --all\ndevecocli skills add --skill skillname --agent agentname --force # skillname需替换成实际的Skill名称\ndevecocli skills add --skill skillname --project ./my-app  # skillname需替换成实际的Skill名称\n```\n\n### `skills remove`\n\n从智能体中删除已添加的 `Skill`\n\n**命令格式：**\n\n```bash\ndevecocli skills remove --skill <skill-name> --agent <agents> --project <path> --path <path>\n```\n\n**参数：**\n\n| 参数名       | 说明                                                       |\n| --------- | -------------------------------------------------------- |\n| --skill   | 必选，待删除的 `Skill` 名称                                       |\n| --agent   | 可选，智能体名称，多个智能体时以英文逗号分隔。缺省时，删除到已检测到的智能体中的 `Skill`         |\n| --project | 可选，指定项目路径，删除该项目中的 `Skill`                                |\n| --path    | 可选，指定路径，删除该项目中的 `Skill`，不可与 `--project` 或 `--agent` 同时使用 |\n\n**示例：**\n\n```bash\ndevecocli skills remove --skill skillname  # skillname需替换成实际的Skill名称\ndevecocli skills remove --skill skillname --agent agentname  # skillname需替换成实际的Skill名称\n```\n\n### `serve mcp`\n\n启动本地 `MCP` 服务。智能体配置 `MCP` 服务后，可通过 `MCP` 协议调用 `ArkTS` / `C++` 语法检查工具。不同智能体平台配置 `MCP` 服务的界面不一样，一个智能体平台的配置示例如下。\n推荐通过 `devecocli init --mcp` 自动配置\n\n```bash\n{\n  \"mcp\": {\n    \"deveco-mcp\": {\n      \"type\": \"local\",\n      \"command\": [\n        \"devecocli\",\n        \"serve\",\n        \"mcp\"\n      ],\n      \"environment\":{\n        \"PROJECT_PATH\": \"D:\\\\code\\\\sample_project\", // 工程路径\n        \"NODE_MAX_OLD_SPACE_SIZE\": \"8192\", // 可选，设置内部node进程最大的老生代内存大小，默认为8192\n        \"DEVECO_PATH\": \"D:\\\\Application\\\\DevEco Studio\" // 可选，Deveco Studio的路径\n      },\n      \"enbale\": true\n    }\n  }\n}\n```\n\n## 常见问题\n\n[FAQ](https://gitcode.com/openharmony-sig/deveco-cli/wiki/FAQ.md)\n\n## 开发\n\n```bash\nnpm install\nnpm run dev\nnpm start -- <command>\nnpm run lint\nnpm run format\nnpm run build\n```\n\n- 架构与目录说明见 [`AGENTS.md`](./AGENTS.md)\n- 如需参与维护，建议先阅读 `AGENTS.md` 中的约定与架构说明\n\n## 许可证\n\n[MIT](./LICENSE)\n","readmeFilename":"README.md"}