{"_id":"@anieo/deveco-code-darwin-arm64","name":"@anieo/deveco-code-darwin-arm64","dist-tags":{"test":"0.1.0-test.1","latest":"0.1.0-test.1"},"versions":{"0.1.0-test.1":{"name":"@anieo/deveco-code-darwin-arm64","version":"0.1.0-test.1","preferUnplugged":true,"os":["darwin"],"cpu":["arm64"],"_id":"@anieo/deveco-code-darwin-arm64@0.1.0-test.1","description":"面向 HarmonyOS（鸿蒙）开发场景的 AI Agent 工具。","_integrity":"sha512-geEBRoOEPzsobk+pY4CGLGpwQLVWvwAcOT4iNGLyS9c9Q7oSpvwABgaMVPDxuvaYkf/LLrnoIQJiGwYxZZ/frg==","_resolved":"/Users/opencode/project/codegenie/codegenie_cli/packages/opencode/dist/deveco-darwin-arm64/anieo-deveco-code-darwin-arm64-0.1.0-test.1.tgz","_from":"file:anieo-deveco-code-darwin-arm64-0.1.0-test.1.tgz","_nodeVersion":"25.8.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-geEBRoOEPzsobk+pY4CGLGpwQLVWvwAcOT4iNGLyS9c9Q7oSpvwABgaMVPDxuvaYkf/LLrnoIQJiGwYxZZ/frg==","shasum":"8e3cc1147dc4f0dd7e8d6436edab1ef17147c33f","tarball":"https://registry.npmjs.org/@anieo/deveco-code-darwin-arm64/-/deveco-code-darwin-arm64-0.1.0-test.1.tgz","fileCount":6,"unpackedSize":116038760,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC6nOFvAk/LTsyxgSA8mBBGHs35Nr453kdoFphKZTXqGwIgbAkBAN7Mw3oPejbGFfQihOZu6KtIUs1fMQ93VGoH/TE="}]},"_npmUser":{"name":"anieo","email":"601905510@qq.com"},"directories":{},"maintainers":[{"name":"anieo","email":"601905510@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/deveco-code-darwin-arm64_0.1.0-test.1_1780410042847_0.6891959682466346"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T14:20:42.628Z","0.1.0-test.1":"2026-06-02T14:20:43.452Z","modified":"2026-06-02T14:20:43.988Z"},"maintainers":[{"name":"anieo","email":"601905510@qq.com"}],"description":"面向 HarmonyOS（鸿蒙）开发场景的 AI Agent 工具。","readme":"# DevEco Code\n\n面向 HarmonyOS（鸿蒙）开发场景的 AI Agent 工具。\n\n[![npm](https://img.shields.io/npm/v/@deveco/deveco-code?style=flat-square&label=npm)](https://www.npmjs.com/package/@deveco/deveco-code)\n[![license](https://img.shields.io/npm/l/@deveco/deveco-code?style=flat-square&label=license)](https://gitcode.com/openharmony-sig/deveco-code/blob/main/LICENSE)\n[![GitCode](https://img.shields.io/badge/GitCode-openharmony--sig%2Fdeveco--code-blue?style=flat-square)](https://gitcode.com/openharmony-sig/deveco-code)\n\n[English](README_EN.md) |\n[npm 包页面](https://www.npmjs.com/package/@deveco/deveco-code) |\n[GitCode 仓库](https://gitcode.com/openharmony-sig/deveco-code) |\n[OpenCode](https://opencode.ai)\n\n***\n\n## 快速开始\n\n```bash\n# 1. 安装\nnpm install -g @deveco/deveco-code\n\n# 2. 启动\ndeveco\n\n# 3. 开始对话 —— 在终端中直接描述你的鸿蒙开发需求\n```\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 等能力，并针对鸿蒙工程增加了 DevEco Studio、Hvigor、HDC、ArkTS 检查和设备调试相关集成。\n\n## 支持平台\n\n- Windows x64\n- macOS Apple Silicon\n- macOS Intel x64\n\n## 安装前置\n\nDevEco Code 通过 npm 分发，安装前请先准备以下环境：\n\n1. 安装 [Node.js LTS](https://nodejs.org)\n2. 如需使用鸿蒙工程的编译、运行和调试能力，请安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)\n3. 配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录\n\n可先在终端验证 Node.js 环境：\n\n```bash\nnode -v\nnpm -v\n```\n\n## 安装与卸载\n\n```bash\n# 安装\nnpm install -g @deveco/deveco-code\n\n# 查看版本\ndeveco --version\n\n# 启动\ndeveco\n\n# 更新\ndeveco upgrade\n\n# 卸载运行时数据\ndeveco uninstall\n\n# 卸载 npm 全局包\nnpm uninstall -g @deveco/deveco-code\n```\n\n> macOS 如果遇到全局安装权限问题，可尝试 `sudo -i npm install -g @deveco/deveco-code`。\n\n## 登录与模型\n\n启动 `deveco` 后可使用华为账号登录。登录后可使用 DevEco Code 提供的免费模型通道；不登录时也可以沿用 OpenCode 的 Provider 配置体系，自行配置模型。\n\n```bash\n# 退出登录\ndeveco auth logout\n```\n\n在 DevEco Code 中输入 `/models` 可进入模型配置界面。当前免费提供 `glm-5`、`deepseek-v3.2` 两款模型，单账号默认每分钟 50 次请求。也可以通过 `Ctrl+A` 进入 Provider 选择界面，配置智谱、阿里等 OpenAI-compatible 模型。\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配置文件读取优先级：\n\n1. 项目目录下 `.deveco/deveco.jsonc`\n2. 项目目录下 `deveco.jsonc`\n3. 用户目录下 `.config/deveco/deveco.jsonc`\n\n## Agent 模式\n\nDevEco Code 面向鸿蒙开发提供以下 Agent 模式（按 `Tab` 键切换）：\n\n- `build`：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行\n- `plan`：适合需求拆解、技术方案、发布规划、测试规划和文档生成\n- `sdd`：适合 `spec` 定义、规范驱动、代码生成和功能验证\n\n## 鸿蒙场景能力\n\nDevEco Code 集成了常用鸿蒙开发工具能力：\n\n| 工具                       | 说明                   |\n| ------------------------ | -------------------- |\n| `build_project`          | 执行编译构建并导出构建产物        |\n| `start_app`              | 在模拟器或真机上运行应用         |\n| `hdc_log`                | 收集/清理设备日志/查看连接模拟器    |\n| `check_ets_files`        | ArkTS 静态语法检查         |\n| `arkts_knowledge_search` | 鸿蒙知识搜索（需要登录华为账号才能使用） |\n| `switch_cwd`             | 切换构建项目路径             |\n\n常见场景包括：从 0 到 1 创建鸿蒙工程、增量开发页面、修复编译报错、真机调试，以及基于多模态模型的图生文界面生成。\n\n## 扩展能力\n\nDevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。\n\n### Skills\n\n```bash\nnpx skills add vercel-labs/agent-skills\n```\n\n也可以把 Skill 放到 `~/.config/deveco/skills`，重启 DevEco Code 后加载。\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    \"file:///C:/Users/<username>/AppData/Roaming/npm/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## FAQ\n\n### 这和 OpenCode 有什么关系？\n\nDevEco Code 基于 OpenCode 扩展开发，保留其终端 UI、Provider、MCP、Skill、Plugin 和配置体系，并额外针对 HarmonyOS 开发链路加入编译构建、设备运行、日志采集、ArkTS 检查和运行时调试等能力。\n\n## Contributing\n\n欢迎贡献！请在提交 Pull Request 前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## License\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\n***\n\n**反馈与交流** [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues)\n","readmeFilename":"README.md","_rev":"1-5c2a6705582c8b603dfa5ff5eb16c04d"}