{"_id":"@deveco-ai/deveco-code-windows-x64","name":"@deveco-ai/deveco-code-windows-x64","dist-tags":{"alpha":"0.0.2-rn.0","latest":"0.0.2-rn.0"},"versions":{"0.0.2-rn.0":{"name":"@deveco-ai/deveco-code-windows-x64","version":"0.0.2-rn.0","preferUnplugged":true,"os":["win32"],"cpu":["x64"],"_id":"@deveco-ai/deveco-code-windows-x64@0.0.2-rn.0","description":"<p align=\"center\">   <h1 align=\"center\">DevEco Code</h1> </p> <p align=\"center\">面向 HarmonyOS 开发场景的 AI Agent 工具。</p> <p align=\"center\">   <a href=\"README.en.md\">English</a> · 简体中文 </p>","_integrity":"sha512-AnfpCy+sGrnzZGXEiL8M6cF43rF5kQUoSwaAa52ewF9NMbTpHCkh7W93WaVYQwD18HdeA3XA2FnQmAmS7a0Btg==","_resolved":"/Users/insight/XCoding/OwenO/DevEco-Code/deveco-code/packages/opencode/dist/deveco-windows-x64/deveco-ai-deveco-code-windows-x64-0.0.2-rn.0.tgz","_from":"file:dist/deveco-windows-x64/deveco-ai-deveco-code-windows-x64-0.0.2-rn.0.tgz","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-AnfpCy+sGrnzZGXEiL8M6cF43rF5kQUoSwaAa52ewF9NMbTpHCkh7W93WaVYQwD18HdeA3XA2FnQmAmS7a0Btg==","shasum":"bf99c3659287fc3b138741bf82dd4efc8d3c1cc5","tarball":"https://registry.npmjs.org/@deveco-ai/deveco-code-windows-x64/-/deveco-code-windows-x64-0.0.2-rn.0.tgz","fileCount":8,"unpackedSize":177566111,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCVRSI1I48l2+HvE9I0a1OaN2pf0VebbY4tRA2bgxxMwQIhAIntbSTnkzm3nQR/Ee3bhbRDZmqmlPCKLaXHckPwo70w"}]},"_npmUser":{"name":"owenclaw","email":"owen.s677u@gmail.com"},"directories":{},"maintainers":[{"name":"owenclaw","email":"owen.s677u@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/deveco-code-windows-x64_0.0.2-rn.0_1784127812155_0.8137430972590445"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-15T15:03:32.002Z","0.0.2-rn.0":"2026-07-15T15:03:33.282Z","modified":"2026-07-15T15:03:33.466Z"},"maintainers":[{"name":"owenclaw","email":"owen.s677u@gmail.com"}],"description":"<p align=\"center\">   <h1 align=\"center\">DevEco Code</h1> </p> <p align=\"center\">面向 HarmonyOS 开发场景的 AI Agent 工具。</p> <p align=\"center\">   <a href=\"README.en.md\">English</a> · 简体中文 </p>","readme":"<p align=\"center\">\n  <h1 align=\"center\">DevEco Code</h1>\n</p>\n<p align=\"center\">面向 HarmonyOS 开发场景的 AI Agent 工具。</p>\n<p align=\"center\">\n  <a href=\"README.en.md\">English</a> · 简体中文\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@deveco/deveco-code\"><img alt=\"NPM Version\" src=\"https://img.shields.io/npm/v/@deveco/deveco-code.svg\" /></a>\n  <a href=\"https://www.npmjs.com/package/@deveco/deveco-code\"><img alt=\"NPM Downloads\" src=\"https://img.shields.io/npm/dm/@deveco/deveco-code.svg\" /></a>\n  <img alt=\"Node.js\" src=\"https://img.shields.io/badge/Node.js-%3E%3D22-green.svg\" />\n  <img alt=\"platform\" src=\"https://img.shields.io/badge/platform-macOS%20(Arm%20%7C%20x64)%20%7C%20Windows-blue.svg\" />\n  <a href=\"https://developer.huawei.com/consumer/cn/deveco-studio/\"><img alt=\"DevEco Studio\" src=\"https://img.shields.io/badge/DevEco%20Studio-%3E%3D6.1-orange.svg\" /></a>\n  <a href=\"https://gitcode.com/openharmony-sig/deveco-code/blob/develop/LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/badge/license-MIT-green.svg\" /></a>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://raw.gitcode.com/openharmony-sig/deveco-code/raw/develop/assets/readme/readme-screenshot.png\" alt=\"DevEco Code\" width=\"600\">\n</p>\n\n***\n\n## 快速开始\n\n```bash\n# 1. 安装\nnpm install -g @deveco/deveco-code\n\n# 2. 启动\ndeveco\n\n# 3. 开始对话 —— 在终端中直接描述你的 HarmonyOS 开发需求\n提示词示例：\n- 解释一下代码库的架构\n- 帮我重构login_check这个函数\n- 帮我检查并修复语法错误\n```\n\n> 建议使用 [npm 官方源](https://registry.npmjs.org/) 或 [淘宝镜像源](https://registry.npmmirror.com/) 安装，其他镜像源可能因同步延迟导致安装失败或版本滞后。\n\n> 如需编译构建、设备运行等能力，请先安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) 并配置 `DEVECO_HOME` 环境变量。\n\n## 简介\n\nDevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具，支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。\n\nDevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力，并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。\n\n## 支持平台\n\nDevEco Code 当前通过 npm 提供以下平台安装包：\n\n| 平台 | 架构 | 说明 |\n| --- | --- | --- |\n| Windows | x64 | Windows 11 |\n| macOS | arm64（Apple Silicon） | M 系列芯片 |\n| macOS | x64（Intel） | Intel 芯片 Mac |\n\n> 暂不支持 Linux。HarmonyOS 编译构建、模拟器与真机调试依赖 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，且目前仅提供 Windows 与 macOS 版本。\n\n## 推荐配置\n\n**操作系统**\n\n- **Windows**：Windows 11 22H2 及以上\n- **macOS**：macOS 15 Sequoia 及以上\n\n**硬件**\n\n- **日常使用**（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存\n- **重度使用**（大工程、长会话、频繁编译构建与模拟器/真机调试）：16 GB 及以上内存；建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间\n\n**运行时与工具链**\n\n- [Node.js](https://nodejs.org) **22 及以上**\n- [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) **6.1 及以上**（编译构建、Hvigor、HDC、模拟器/真机运行）\n- 已配置 `DEVECO_HOME` 环境变量，指向 DevEco Studio 安装目录\n\n**终端 Shell**\n\n- Windows：PowerShell 7+（推荐）、Windows PowerShell 5.1+\n- macOS：Zsh（推荐）、Bash\n\n**网络**\n\n- 需要稳定的互联网连接（华为账号登录、模型调用、HarmonyOS 知识库检索等）\n\n## 安装前置\n\nDevEco Code 通过 npm 分发，安装前请先准备以下环境：\n\n1. 安装 [Node.js](https://nodejs.org)，**推荐使用 22 及更高版本**\n2. （可选）安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，**推荐使用 6.1 及更高版本**；若不安装，HarmonyOS 应用构建、推包等工具将无法使用\n3. （可选）配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录，默认路径示例：\n   - **macOS**：`/Applications/DevEco-Studio.app`\n   - **Windows**：`C:\\Program Files\\Huawei\\DevEco Studio`\n\n可先在终端验证 Node.js 环境：\n\n```bash\nnode -v\nnpm -v\n```\n\n## 安装与卸载\n\n安装：\n\n```bash\nnpm install -g @deveco/deveco-code\n```\n\n查看版本、启动：\n\n```bash\ndeveco --version\ndeveco\n```\n\n更新：\n\n```bash\ndeveco upgrade\n```\n\n卸载运行时数据与全局包：\n\n```bash\ndeveco uninstall\nnpm uninstall -g @deveco/deveco-code\n```\n\n## 登录与登出\n\n使用 DevEco Code 需先通过华为账号登录。首次执行 `deveco` 时会在终端内引导完成登录；也可单独执行登录命令：\n\n```bash\ndeveco auth login\n```\n\n登出会清除当前华为账号的本地登录状态，下次启动需重新登录。执行：\n\n```bash\ndeveco auth logout\n```\n\n## 模型配置\n\n登录后可使用 DevEco Code 提供的免费模型通道。\n\n在 DevEco Code 中输入 `/models` 可进入模型配置界面。当前免费提供 `GLM-5.1` 模型，单账号默认每分钟 50 次请求。也可以通过 `/connect` 进入 Provider 选择界面，配置支持的第三方模型。\n\n也可以通过 `deveco.jsonc` 配置模型：\n\n```jsonc\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"provider\": {\n    \"deveco\": {\n      \"name\": \"DevEco Code\",\n      \"models\": {\n        \"glm-5\": {\n          \"tool_call\": true,\n          \"limit\": {\n            \"context\": 200000,\n            \"output\": 8192\n          }\n        }\n      },\n      \"options\": {\n        \"baseURL\": \"https://api.openbitfun.com/v1\",\n        \"apiKey\": \"{env:DEVECO_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n**UI 检查配置**\n\nUI 检查是功能验证阶段的可选能力，用于验证界面是否符合需求描述。\n\n该功能需调用多模态模型（仅用于 UI 检查，不作为主对话模型）：已登录账号时默认使用内置 Qwen3-VL 模型，未登录时则跳过 UI 检查。\n\n如需配置第三方多模态模型（仅支持 Qwen 系列），可在 `deveco.jsonc` 的 `agent` 中指定，以qwen3-vl-plus为例：\n\n```jsonc\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"provider\": {\n    \"myprovider\": {\n      \"npm\": \"@ai-sdk/openai-compatible\",\n      \"name\": \"alibaba\",\n      \"options\": {\n        \"baseURL\": \"https://dashscope.aliyuncs.com/compatible-mode/v1\",\n        \"apiKey\": \"your-api-key\",\n      },\n      \"models\": {\n        \"qwen3-vl-plus\": {\n          \"modalities\": {\n            \"input\": [\"text\", \"image\"],\n            \"output\": [\"text\"],\n          },\n        },\n      },\n    },\n  },\n  \"agent\": {\n    \"ui_verification\": {\n      \"mode\": \"subagent\",\n      \"model\": \"myprovider/qwen3-vl-plus\", // 格式为<provider-name>/<model-name>\n      \"hidden\": true,\n    },\n  },\n}\n```\n\n配置文件读取优先级：\n\n1. 项目目录下 `.deveco/deveco.jsonc`\n2. 项目目录下 `deveco.jsonc`\n3. 用户目录下 `.config/deveco/deveco.jsonc`\n\n## Agent 配置\n\nDevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置（按 `Tab` 键切换）：\n\n- `Build`：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行\n- `Plan`：适合需求拆解、技术方案、发布规划、测试规划和文档生成\n- `Goal`：适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付\n\n## HarmonyOS 场景能力\n\nDevEco Code 集成了常用 HarmonyOS 开发工具能力：\n\n| 工具                       | 说明                   |\n| ------------------------ | -------------------- |\n| `build_project`          | 执行编译构建并导出构建产物        |\n| `start_app`              | 在模拟器或真机上运行应用         |\n| `hdc_log`                | 收集/清理设备日志/查看连接模拟器    |\n| `verify_ui`              | 执行 UI 操作验证功能是否正确        |\n| `arkts_check`            | ArkTS 静态语法检查         |\n| `arkts_knowledge_search` | HarmonyOS 知识搜索 |\n| `switch_cwd`             | 切换构建项目路径             |\n\n常见场景包括：从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。\n\n## 扩展能力\n\nDevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。\n\n> 新增或修改 Skill、MCP、Plugin 配置后，需退出并重新执行 `deveco` 启动后才会生效。\n\n### Skills\n\n```bash\nnpx skills add vercel-labs/agent-skills\n```\n\n也可以把 Skill 放到 `~/.config/deveco/skills` 目录。\n\n### MCP\n\n可在 `~/.config/deveco/deveco.jsonc` 中配置 MCP：\n\n```jsonc\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"@playwright/mcp@latest\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Plugins\n\n```bash\nnpm install -g oh-my-opencode\n```\n\n然后在 `deveco.jsonc` 中配置插件入口：\n\n```jsonc\n{\n  \"plugin\": [\n    \"node_modules/oh-my-opencode/dist/index.js\"\n  ]\n}\n```\n\n## 从 OpenCode 迁移\n\n如果需要从 OpenCode 迁移到 DevEco Code，请将配置文件迁移到 DevEco Code 目录。主配置文件可参考：\n\n```powershell\n# Windows PowerShell\nCopy-Item -Force \"{源路径}\\opencode.jsonc\" \"~\\.config\\deveco\\deveco.jsonc\"\n```\n\n```bash\n# macOS\ncp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc\n```\n\nSkills、Agents、Plugins 也可以迁移到 `~/.config/deveco` 下的对应目录；MCP 配置项可迁移到 `deveco.jsonc` 中。\n\n## 参与贡献\n\n欢迎贡献！请在提交 Pull Request 前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## 帮助与支持\n\n- 完整文档请参阅 [DevEco Code 使用文档](docs/deveco-code-docs.html)（需下载到本地后打开），也可在线阅读 [OpenCode TUI 文档](https://opencode.ai/docs/zh-cn/tui/)\n- 常见问题请参阅 [FAQ 文档](https://gitcode.com/openharmony-sig/deveco-code/wiki/FAQ.md)\n- 反馈与交流 [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues)\n\n## 开源许可\n\n[MIT License](LICENSE)\n\n## 基于 OpenCode 构建的声明\n\n本项目基于开源项目 [OpenCode](https://opencode.ai) 扩展开发。DevEco Code **并非** OpenCode 团队出品，也与 OpenCode 团队无任何附属或关联关系。如有与 DevEco Code 相关的问题，请通过 [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues) 反馈，而非联系 OpenCode 社区。\n","readmeFilename":"README.md","_rev":"1-546c3f4c1b37d825075db34ac0e25b00"}