@deveco-test/deveco-code-darwin-arm64 0.1.0-1 → 0.1.0-1.1

package/README.md

@@ -1,17 +1,18 @@
 <p align="center">
   <h1 align="center">DevEco Code</h1>
 </p>
-<p align="center">面向 HarmonyOS（鸿蒙）开发场景的 AI Agent 工具。</p>
+<p align="center">面向 HarmonyOS 开发场景的 AI Agent 工具。</p>
 <p align="center">
-  <a href="https://www.npmjs.com/package/@deveco/deveco-code"><img alt="npm" src="https://img.shields.io/npm/v/@deveco/deveco-code?style=flat-square&label=npm" /></a>
-  <a href="https://gitcode.com/openharmony-sig/deveco-code/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/npm/l/@deveco/deveco-code?style=flat-square&label=license" /></a>
-  <a href="https://gitcode.com/openharmony-sig/deveco-code"><img alt="GitCode" src="https://img.shields.io/badge/GitCode-openharmony--sig%2Fdeveco--code-blue?style=flat-square" /></a>
+  <a href="README_EN.md">English</a> · 简体中文
 </p>
+
 <p align="center">
-  <a href="README_EN.md">English</a> |
-  <a href="https://www.npmjs.com/package/@deveco/deveco-code">npm 包页面</a> |
-  <a href="https://gitcode.com/openharmony-sig/deveco-code">GitCode 仓库</a> |
-  <a href="https://opencode.ai">OpenCode</a>
+  <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>
+  <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>
+  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-%3E%3D22-green.svg" />
+  <img alt="platform" src="https://img.shields.io/badge/platform-macOS%20(Arm%20%7C%20x64)%20%7C%20Windows-blue.svg" />
+  <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>
+  <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>
 </p>
 
 <p align="center">
@@ -29,7 +30,7 @@ npm install -g @deveco/deveco-code
 # 2. 启动
 deveco
 
-# 3. 开始对话 —— 在终端中直接描述你的鸿蒙开发需求
+# 3. 开始对话 —— 在终端中直接描述你的 HarmonyOS 开发需求
 提示词示例：
 - 解释一下代码库的架构
 - 帮我重构login_check这个函数
@@ -42,21 +43,54 @@ deveco
 
 DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具，支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。
 
-DevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力，并针对鸿蒙工程增加了 DevEco Studio、Hvigor、HDC、ArkTS 检查和设备调试相关集成。
+DevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力，并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。
 
 ## 支持平台
 
-- Windows x64
-- macOS Apple Silicon
-- macOS Intel x64
+DevEco Code 当前通过 npm 提供以下平台安装包：
+
+| 平台 | 架构 | 说明 |
+| --- | --- | --- |
+| Windows | x64 | Windows 10 / 11 |
+| macOS | arm64（Apple Silicon） | M 系列芯片 |
+| macOS | x64（Intel） | Intel 芯片 Mac |
+
+> 暂不支持 Linux。HarmonyOS 编译构建、模拟器与真机调试依赖 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，且目前仅提供 Windows 与 macOS 版本。
+
+## 推荐配置
+
+**操作系统**
+
+- **Windows**：Windows 11 22H2 及以上（最低支持 Windows 10 x64）
+- **macOS**：macOS 13 Ventura 及以上（Apple Silicon 或 Intel x64）
+
+**硬件**
+
+- **日常使用**（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存，建议使用 SSD
+- **重度使用**（大工程、长会话、频繁编译构建与模拟器/真机调试）：16 GB 及以上内存；建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间
+
+**运行时与工具链**
+
+- [Node.js](https://nodejs.org) **22 及以上**（运行 DevEco Code CLI）
+- [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) **6.1 及以上**（编译构建、Hvigor、HDC、模拟器/真机运行）
+- 已配置 `DEVECO_HOME` 环境变量，指向 DevEco Studio 安装目录
+
+**终端 Shell**
+
+- Windows：PowerShell 5.1+ 或 PowerShell 7+（推荐）、CMD
+- macOS：Bash、Zsh（系统默认终端即可）
+
+**网络**
+
+- 需要稳定的互联网连接（华为账号登录、模型调用、HarmonyOS 知识库检索等）
 
 ## 安装前置
 
 DevEco Code 通过 npm 分发，安装前请先准备以下环境：
 
 1. 安装 [Node.js](https://nodejs.org)，**推荐使用 22 及更高版本**
-2. 安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，**推荐使用 6.1 及更高版本**
-3. 配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录
+2. （可选）安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，**推荐使用 6.1 及更高版本**；若不安装，构建、推包等 HarmonyOS 工程工具将无法使用
+3. （可选）配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录（安装 DevEco Studio 时需要）
 
 可先在终端验证 Node.js 环境：
 
@@ -67,37 +101,50 @@ npm -v
 
 ## 安装与卸载
 
+安装：
+
 ```bash
-# 安装
 npm install -g @deveco/deveco-code
+```
 
-# 查看版本
-deveco --version
+查看版本、启动：
 
-# 启动
+```bash
+deveco --version
 deveco
+```
+
+更新：
 
-# 更新
+```bash
 deveco upgrade
+```
 
-# 卸载运行时数据
-deveco uninstall
+卸载运行时数据与全局包：
 
-# 卸载 npm 全局包
+```bash
+deveco uninstall
 npm uninstall -g @deveco/deveco-code
 ```
 
-> macOS 如果遇到全局安装权限问题，可尝试 `sudo -i npm install -g @deveco/deveco-code`。
+## 登录与登出
+
+使用 DevEco Code 需先通过华为账号登录。首次执行 `deveco` 时会在终端内引导完成登录；也可单独执行登录命令：
 
-## 登录与模型
+```bash
+deveco auth login
+```
 
-启动 `deveco` 需华为账号登录。登录后可使用 DevEco Code 提供的免费模型通道。
+登出会清除当前华为账号的本地登录状态，下次启动需重新登录。执行：
 
 ```bash
-# 退出登录
 deveco auth logout
 ```
 
+## 模型配置
+
+登录后可使用 DevEco Code 提供的免费模型通道。
+
 在 DevEco Code 中输入 `/models` 可进入模型配置界面。当前免费提供 `GLM-5.1` 模型，单账号默认每分钟 50 次请求。也可以通过 `Ctrl+A` 进入 Provider 选择界面，配置支持的第三方模型。
 
 也可以通过 `deveco.jsonc` 配置模型：
@@ -132,17 +179,17 @@ deveco auth logout
 2. 项目目录下 `deveco.jsonc`
 3. 用户目录下 `.config/deveco/deveco.jsonc`
 
-## Agent 模式
+## Agent 配置
 
-DevEco Code 面向鸿蒙开发提供以下 Agent 模式（按 `Tab` 键切换）：
+DevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置（按 `Tab` 键切换）：
 
 - `Build`：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行
 - `Plan`：适合需求拆解、技术方案、发布规划、测试规划和文档生成
-- `Goal`：适合 `spec` 定义、规范驱动、代码生成和功能验证
+- `Goal`：适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付
 
-## 鸿蒙场景能力
+## HarmonyOS 场景能力
 
-DevEco Code 集成了常用鸿蒙开发工具能力：
+DevEco Code 集成了常用 HarmonyOS 开发工具能力：
 
 | 工具                       | 说明                   |
 | ------------------------ | -------------------- |
@@ -150,22 +197,24 @@ DevEco Code 集成了常用鸿蒙开发工具能力：
 | `start_app`              | 在模拟器或真机上运行应用         |
 | `hdc_log`                | 收集/清理设备日志/查看连接模拟器    |
 | `check_ets_files`        | ArkTS 静态语法检查         |
-| `arkts_knowledge_search` | 鸿蒙知识搜索 |
+| `arkts_knowledge_search` | HarmonyOS 知识搜索 |
 | `switch_cwd`             | 切换构建项目路径             |
 
-常见场景包括：从 0 到 1 创建鸿蒙工程、增量开发页面、修复编译报错、真机调试，以及基于多模态模型的图生文界面生成。
+常见场景包括：从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。
 
 ## 扩展能力
 
 DevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。
 
+> 新增或修改 Skill、MCP、Plugin 配置后，需退出并重新执行 `deveco` 启动后才会生效。
+
 ### Skills
 
 ```bash
 npx skills add vercel-labs/agent-skills
 ```
 
-也可以把 Skill 放到 `~/.config/deveco/skills`，重启 DevEco Code 后加载。
+也可以把 Skill 放到 `~/.config/deveco/skills` 目录。
 
 ### MCP
 
@@ -216,12 +265,6 @@ cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc
 
 Skills、Agents、Plugins 也可以迁移到 `~/.config/deveco` 下的对应目录；MCP 配置项可迁移到 `deveco.jsonc` 中。
 
-## FAQ
-
-### 这和 OpenCode 有什么关系？
-
-DevEco Code 基于 OpenCode 扩展开发，保留其终端 UI、Provider、MCP、Skill、Plugin 和配置体系，并额外针对 HarmonyOS 开发链路加入编译构建、设备运行、日志采集、ArkTS 检查和运行时调试等能力。
-
 ## Contributing
 
 欢迎贡献！请在提交 Pull Request 前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
@@ -236,4 +279,6 @@ DevEco Code 基于 OpenCode 扩展开发，保留其终端 UI、Provider、MCP
 
 ***
 
+**提示：** 终端常用命令（如 `/models`、`/help` 等）请参阅 [OpenCode TUI 文档](https://opencode.ai/docs/zh-cn/tui/)。
+
 **反馈与交流** [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deveco-test/deveco-code-darwin-arm64",
-  "version": "0.1.0-1",
+  "version": "0.1.0-1.1",
   "preferUnplugged": true,
   "os": [
     "darwin"