@deveco-test/deveco-code-darwin-arm64 0.1.0-1.1 → 0.1.0-1.3-GREY

package/README.md

@@ -3,7 +3,7 @@
 </p>
 <p align="center">面向 HarmonyOS 开发场景的 AI Agent 工具。</p>
 <p align="center">
-  <a href="README_EN.md">English</a> · 简体中文
+  <a href="README.en.md">English</a> · 简体中文
 </p>
 
 <p align="center">
@@ -37,6 +37,8 @@ deveco
 - 帮我检查并修复语法错误
 ```
 
+> 建议使用 [npm 官方源](https://registry.npmjs.org/) 或 [淘宝镜像源](https://registry.npmmirror.com/) 安装，其他镜像源可能因同步延迟导致安装失败或版本滞后。
+
 > 如需编译构建、设备运行等能力，请先安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) 并配置 `DEVECO_HOME` 环境变量。
 
 ## 简介
@@ -51,7 +53,7 @@ DevEco Code 当前通过 npm 提供以下平台安装包：
 
 | 平台 | 架构 | 说明 |
 | --- | --- | --- |
-| Windows | x64 | Windows 10 / 11 |
+| Windows | x64 | Windows 11 |
 | macOS | arm64（Apple Silicon） | M 系列芯片 |
 | macOS | x64（Intel） | Intel 芯片 Mac |
 
@@ -61,24 +63,24 @@ DevEco Code 当前通过 npm 提供以下平台安装包：
 
 **操作系统**
 
-- **Windows**：Windows 11 22H2 及以上（最低支持 Windows 10 x64）
-- **macOS**：macOS 13 Ventura 及以上（Apple Silicon 或 Intel x64）
+- **Windows**：Windows 11 22H2 及以上
+- **macOS**：macOS 15 Sequoia 及以上
 
 **硬件**
 
-- **日常使用**（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存，建议使用 SSD
+- **日常使用**（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存
 - **重度使用**（大工程、长会话、频繁编译构建与模拟器/真机调试）：16 GB 及以上内存；建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间
 
 **运行时与工具链**
 
-- [Node.js](https://nodejs.org) **22 及以上**（运行 DevEco Code CLI）
+- [Node.js](https://nodejs.org) **22 及以上**
 - [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（系统默认终端即可）
+- Windows：PowerShell 7+（推荐）、PowerShell 5.1+
+- macOS：Zsh（推荐）、Bash
 
 **网络**
 
@@ -89,8 +91,10 @@ DevEco Code 当前通过 npm 提供以下平台安装包：
 DevEco Code 通过 npm 分发，安装前请先准备以下环境：
 
 1. 安装 [Node.js](https://nodejs.org)，**推荐使用 22 及更高版本**
-2. （可选）安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，**推荐使用 6.1 及更高版本**；若不安装，构建、推包等 HarmonyOS 工程工具将无法使用
-3. （可选）配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录（安装 DevEco Studio 时需要）
+2. （可选）安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)，**推荐使用 6.1 及更高版本**；若不安装，HarmonyOS 应用构建、推包等工具将无法使用
+3. （可选）配置 `DEVECO_HOME` 环境变量指向 DevEco Studio 安装目录，默认路径示例：
+   - **macOS**：`/Applications/DevEco-Studio.app`
+   - **Windows**：`C:\Program Files\Huawei\DevEco Studio`
 
 可先在终端验证 Node.js 环境：
 
@@ -173,6 +177,45 @@ deveco auth logout
 }
 ```
 
+**UI 检查配置**
+
+UI 检查是功能验证阶段的可选能力，用于验证界面是否符合需求描述。
+
+该功能需调用多模态模型：已登录账号时默认使用内置 Qwen3-VL 模型，未登录时则跳过UI检查。
+
+如需配置第三方多模态模型（仅支持 Qwen 系列），可在 `deveco.jsonc` 的 `agent` 中指定，以qwen3-vl-plus为例：
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "myprovider": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "alibaba",
+      "options": {
+        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
+        "apiKey": "your-api-key",
+      },
+      "models": {
+        "qwen3-vl-plus": {
+          "modalities": {
+            "input": ["text", "image"],
+            "output": ["text"],
+          },
+        },
+      },
+    },
+  },
+  "agent": {
+    "ui_verification": {
+      "mode": "subagent",
+      "model": "myprovider/qwen3-vl-plus", // 格式为<provider-name>/<model-name>
+      "hidden": true,
+    },
+  },
+}
+```
+
 配置文件读取优先级：
 
 1. 项目目录下 `.deveco/deveco.jsonc`
@@ -196,6 +239,7 @@ DevEco Code 集成了常用 HarmonyOS 开发工具能力：
 | `build_project`          | 执行编译构建并导出构建产物        |
 | `start_app`              | 在模拟器或真机上运行应用         |
 | `hdc_log`                | 收集/清理设备日志/查看连接模拟器    |
+| `verify_ui`              | 执行 UI 操作验证功能是否正确        |
 | `check_ets_files`        | ArkTS 静态语法检查         |
 | `arkts_knowledge_search` | HarmonyOS 知识搜索 |
 | `switch_cwd`             | 切换构建项目路径             |
@@ -265,20 +309,20 @@ cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc
 
 Skills、Agents、Plugins 也可以迁移到 `~/.config/deveco` 下的对应目录；MCP 配置项可迁移到 `deveco.jsonc` 中。
 
-## Contributing
+## 参与贡献
 
 欢迎贡献！请在提交 Pull Request 前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
 
-## License
+## 帮助与支持
+
+- 常见问题请参阅 [FAQ 文档](https://gitcode.com/openharmony-sig/deveco-code/wiki/FAQ.md)
+- 终端常用命令（如 `/models`、`/connect` 等）请参阅 [OpenCode TUI 文档](https://opencode.ai/docs/zh-cn/tui/)
+- 反馈与交流 [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues)
+
+## 开源许可
 
 [MIT License](LICENSE)
 
 ## 基于 OpenCode 构建的声明
 
 本项目基于开源项目 [OpenCode](https://opencode.ai) 扩展开发。DevEco Code **并非** OpenCode 团队出品，也与 OpenCode 团队无任何附属或关联关系。如有与 DevEco Code 相关的问题，请通过 [GitCode Issue](https://gitcode.com/openharmony-sig/deveco-code/issues) 反馈，而非联系 OpenCode 社区。
-
-***
-
-**提示：** 终端常用命令（如 `/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.1",
+  "version": "0.1.0-1.3-GREY",
   "preferUnplugged": true,
   "os": [
     "darwin"
@@ -11,6 +11,7 @@
   "files": [
     "bin/**/*",
     "vendor/**/*",
-    "README.md"
+    "README.md",
+    "assets/**/*"
   ]
 }