@deveco/deveco-code-darwin-arm64 0.0.0-daily-20260912

package/CHANGELOG.md

@@ -0,0 +1,350 @@
+# Changelog
+
+## v0.1.12 (2026-09-04)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 云端模型配置无损保留，支持 `Ctrl+T` 切换推理强度档位，状态栏展示当前生效档位（`a1568e0`）
+- 更新内置 DevEco CLI 至 v1.3.2（`acfaa13`）
+
+#### 缺陷修复
+
+- 修复推理模型的思考内容被误用作会话标题（`6a78fac`）
+
+## v0.1.11 (2026-09-02)
+
+### DevEco Code 核心
+
+#### 缺陷修复
+
+- 实名认证复核改为复用浏览器登录流程，简化重新验证操作（`849623b9ce`）
+
+#### 文档
+
+- Provider 配置示例改用通用占位符，消除误导性内置 provider 示例（`0e75e01467`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增 `/usage` 和 `/stats` 命令，打开标签式面板展示用量与配额统计，含热力图、模型卡片及配额进度（`a063068cf2`）
+
+## v0.1.10 (2026-08-29)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增 `--auto`/`--yolo` 权限自动批准标志，跳过工具调用确认（`89c7804`）
+- 更新内置 DevEco CLI 至 v1.3.0（`c95e744`、`ecd05b6`）
+
+#### 优化
+
+- 移除过时的 `DEVECO_DEFAULTS` 回退逻辑（`f353e9a`）
+
+#### 缺陷修复
+
+- 修复登录 URL 在 Windows 上无法通过 shell 打开的问题（`185b685`）
+- 限制会话重试次数，配额耗尽时提前终止（`10f8246`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增 subagent 监控侧边栏面板（`57be7fa`）
+- 流式编辑统计改为按行计数（`690909f`）
+
+#### 缺陷修复
+
+- 修复模板化技能体的技能徽章渲染问题（`0c326df`）
+- 优化收集对话框交互细节（`e1816523`）
+
+## v0.1.9 (2026-08-20)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 内置 [DevEco CLI](https://gitcode.com/openharmony-sig/deveco-cli)，封装 `ohpm`、`hvigor`、`hdc` 等工具链，集成脚手架、技能安装与 MCP 服务
+
+#### 优化
+
+- 加固 Windows 安装程序：新增互斥锁防并发安装、失败自动重试、原子切换启动器（`1452fe8`）
+
+#### 缺陷修复
+
+- 修复 Windows baseline 包 CLI 入口缺失问题（`437de3d`）
+
+### TUI 终端界面
+
+#### 优化
+
+- 音频播放支持设备热切换：输出设备变更时自动重新绑定，恢复播放（`2bf3a39`）
+- 更新日志导出命令的国际化描述（`73882b9`）
+
+## v0.1.8 (2026-08-18)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增 Web UI 服务，支持通过浏览器直接访问 DevEco Code（`9d0e9ad`、`f11cd68`）
+- 凭证存储采用操作系统钥匙串加密，提升静态安全性（`02271d0`）
+- 登录流程新增第三方供应商确认环节（`1cf075d`）
+- 地区访问策略新增欧洲时区限制（`cf5b6c0`）
+
+#### 优化
+
+- 版本检查改为后台异步执行，不阻塞启动流程（`6174dc9`）
+
+#### 缺陷修复
+
+- 多项安全加固：防御路径穿越与 SQL 注入、SSRF 与 HTML 注入防护、认证 Cookie 加固、分享 ID 防猜测、图标上传校验、账单 URL 加固、管理员权限校验、密钥字段重命名、移除 URL 中的认证参数（`86d6cfc`、`d75cad2`、`8ef8464`、`e1442c6`、`6b5f93f`、`4957539`、`e26bc29`、`ba09517`、`d033446`、`67b45f3`、`9fec08d`、`76dc880`、`e89f08d`、`96f78c1`、`5ffe841`、`c6f60db`、`5bb6e89`、`745d33a`、`598b1c4`、`35e5a31`）
+- 修复 TLS 密码套件兼容性问题，适配 BoringSSL 环境（`2e16be9`、`cded53e`、`86d5be8`、`f1d0b45`、`7982bc8`、`bf1f25a`）
+- 修复版本检查挂起导致自升级失败，消除重复升级通知（`1a03fa6`、`f3c75ba`、`6b92f54`、`44fd3e1`）
+- 修复会话排序因 ID 回绕导致乱序（`340893e`）
+- 修复重跑失败命令问题，新增 list-issues 命令（`5de32c2`）
+- 加固 ui-verification 进程清理与环境变量限制（`bead02d`、`0cc4a4d`）
+- 修复 Web 搜索 API 密钥传递方式（`a7d9a23`）
+- 修复地区受限错误未正确展示（`5b4eb0e`）
+- 移除内置默认模型回退逻辑（`53c7042`）
+- 修复实名认证状态检查返回缓存数据导致状态不同步（`e4d8905`）
+- 修复 token 刷新失败时未正确触发重新登录（`e842e4e`）
+
+#### 文档
+
+- 统一 CLAUDE.md 与 AGENTS.md 规范（`119f9f7`、`b4766ae`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增 token 用量统计，支持 verbose 模式查看（`51c36bd`）
+
+#### 优化
+
+- 版本检查流程重构：后台异步检查并展示 spinner 动画，升级等待界面显示 logo（`d6472f5`、`1a7c557`、`44fd3e1`）
+
+#### 缺陷修复
+
+- 修复升级状态管理：成功后清除状态、消除重复通知弹窗（`f3c75ba`、`6b92f54`）
+- 修复升级进度条卡顿问题（`1a7c557`）
+- 修复日志导出对话框 URL 校验（`31ac49c`）
+
+## v0.1.7 (2026-08-03)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 地区访问策略新增 UTC+8 偏移回退与系统区域检测，扩展中国时区白名单（`bc637c8`）
+
+### TUI 终端界面
+
+#### 缺陷修复
+
+- 修复流式编辑/写入字数统计因 JSON 转义未解码导致计数虚高（`a6e432e`）
+- 修复启动时布局竞争导致的偶现启动失败问题（`c17c895`）
+
+## v0.1.6 (2026-08-01)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增地区访问策略，基于时区与实名国籍限制中国大陆区域使用（`5810c71`、`2e408b5`）
+- 集成 Magpie 埋点：采集工具调用链路，复用端点配置，过滤非 DevEco 事件，优化归因精度与统一同意管理（`8a0413a`、`6e6043e`、`1776688`、`766509a`、`fbfd228`、`4a888ee`）
+- 新增 GitCode CI/CD 工作流，涵盖发版、类型检查与测试（`7df5df8`）
+
+#### 缺陷修复
+
+- 安全加固：密码采用恒定时间比对、登录 URL 防命令注入、工具参数限制为 JSON（`20e4567`、`9fb4045`、`273b7d7`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 编辑流式输出时实时显示字数统计（`af0d72d`）
+
+#### 优化
+
+- 移除 `/btw` 命令说明文本（`c0191d1`）
+
+## v0.1.5 (2026-07-27)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 启动前弹出工作区信任确认，防止在不受信目录下误执行（`e4c18b6`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增通知设置对话框，支持全局开关、音量调节及 6 类事件的独立音效选择（`c3f91a6`）
+
+#### 优化
+
+- 移除日志收集菜单与崩溃后自动上报弹窗（`0483e25`）
+
+#### 缺陷修复
+
+- 规范化 btw 浮层错误展示：按错误码映射 i18n 文案，修复出错时提示键误显示（`1f0e98e`）
+
+## v0.1.4 (2026-07-24)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增崩溃检测与日志自动上传，上传前对敏感信息做脱敏处理（`a7d9157`、`17e1bc4`、`99dafcc`、`3722c14`）
+- 新增 TUI 使用遥测与会话级 AI 追踪打点（`0e9ff88`、`ab5d917`、`5f0ec58`）
+- 同步会话级调试能力，增强 debug 命令的会话诊断（`2e41d04`）
+
+#### 优化
+
+- 清理冗余 `.ts` 技能脚本源文件（`af8bf56`）
+- 修复斜杠命令需额外空格才能退出搜索模式的问题（`8754402`）
+- 技能默认资源新增 `customize-deveco`，修复 `deveco-create-project` 的 codeCheck 校验规则（`89f9fd0`、`21a76ef`）
+- 0-1 技能新增 `AGENTS.md` 配置引导，修复 goal 模式 `plan.md` 未指定 v2 状态管理（`845fa8d`、`7cd45ac`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增 `/btw` 浮层，支持会话中随时提追问（`3902edf`）
+- 智能 Esc 中断：单击中断生成，再按确认取消对话（`510cbca`）
+- 登录页展示错误信息，未通过时即时反馈原因（`29afa10`）
+
+#### 缺陷修复
+
+- 修复 JetBrains Terminal 下鼠标悬停异常（`806bd0a`）
+- 修复反复 `Ctrl+C` 重启后终端黑屏（`cefa9a8`）
+
+## v0.1.3 (2026-07-17)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增离线发版说明查看器，登录后可在 TUI 内直接浏览历史版本的更新内容（`44540db`）
+- 登录流程增加实名校验环节，未通过时引导用户完成实名（`a8671f2`）
+- 协议需重新签署时显示 toast 提示，及时告知用户协议状态变更（`dff7998`）
+- 适配 API >= 26 的 `sdkVersion` 格式，确保新版本 API 元数据与构建链一致（`9ce4d1f`）
+- 过滤技能加载时引入的冗余 `skill_files`，仅保留运行所需文件（`25acb4d`）
+- OpenAI 兼容 provider 支持 `user_id` 透传，便于追踪与会话关联（`4ed0b88`）
+
+#### 优化
+
+- 缓存认证检查结果，执行 `/new` 命令时跳过重复校验，提升新建会话响应速度（`82eb48d`）
+- 升级版本时，patch 版本（x.y.z → x.y.z+1）的更新无需用户确认（`e4d57ef`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 终端支持双击选词，便于按词粒度复制或编辑（`8f7b12c`）
+- `Ctrl+C` / `Ctrl+D` 退出改为两段式确认，避免误触导致会话意外终止（`14a16c3`）
+- 替换 AI 提示的警告图标，并补齐对应 i18n 文案（`a292d16`）
+
+#### 缺陷修复
+
+- 优化 onboarding 页面间距与滚动条可见性，改善长内容场景下的浏览体验（`70f52b5`）
+
+## v0.1.2 (2026-07-09)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 全面更新 `arkts` 技能知识库，扩展 ArkUI 组件参考与 API 护栏，提升代码生成准确性（`638c180`）
+
+#### 优化
+
+- goal 模式 `plan.md` 工程结构输出对齐 ArkUI 最佳实践（`3b11304`）
+
+#### 缺陷修复
+
+- 加固认证链路：改进 token 刷新错误处理，启动时自动检测 JWT 过期并提示重登录（`802431c`、`b45c586`）
+- 修复 `arkts-check` 对 `$$` / `$` 绑定语法糖的假阳性告警（`f427e94`）
+- plan 模式阶段评审检测需求范围变化并强制回溯（`16e4024`）
+
+#### 重构
+
+- 登录与 `DEVECO_HOME` 检测迁移至 TUI onboarding，统一引导入口（`7c26d1e`）
+- 清理过时 `arkui-knowledge` 技能引用（`43b826e`）
+- 提示词补充 DevEco Studio 签名配置手动操作提醒（`6cc90ad`）
+
+### TUI 终端界面
+
+#### 优化
+
+- `/feedback` 跳转修正为 GitCode issues 页面（`a8ba6c8`）
+
+#### 缺陷修复
+
+- 恢复主视图选中即复制（copy-on-select）功能（`5901beb`）
+
+## v0.1.1 (2026-07-02)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增 `arkts_check` 静态检查工具，于项目构建前置执行，并替代原有的 `check_ets_files` 校验（`30ebb05`、`f7afb1b`、`471fd82`）
+- 新增 `debug` 调试命令，并完善其中文使用说明（`32bfb77`、`0ea5493`）
+- 为 DevEco Code 推理模型启用 `thinking` 参数，支持推理过程输出（`766e2d6`）
+- 默认启用后台 subagent 运行时开关，提升并行任务处理能力（`7eb2c42`）
+- 模板复制脚本（`copy-template.mjs`）执行完成后，会话工作目录自动切换至生成的项目根目录（`44a56b1`）
+- 新增 Windows baseline 版本包发布，以兼容不支持 AVX2 指令集的 CPU（`f198b45`）
+
+#### 优化
+
+- 强化 goal 模式需求澄清能力，并在 spec-implementation 阶段抽离专用 subagent 承载实现（`615b731`、`4963e0d`）
+- 工具调用支持并行执行，缩短多工具场景耗时（`9c89cc1`）
+- 加固 `arkts_check` 的 `ensureScriptOnDisk` 校验，提升脚本落盘检查的稳健性（`b6790b0`）
+- 主包打包纳入 `README.md` 与 `assets/` 资源，保障安装后文档与素材随包可用（`1d54cef`）
+- 调整一项 runtime flag 默认值为 `false`，收敛默认行为（`0fdb5fc`）
+
+#### 缺陷修复
+
+- 加固 token 刷新链路：整合刷新逻辑、防御空 `accessToken`、新增 `SESSION_EXPIRED` 状态并在刷新时同步更新内存态 token，避免会话因令牌失效而中断（`b545602`、`17ad7a5`、`cb71b79`）
+- `deveco-create-project` 的 SDK 错误改为立即终止而非回退兜底，并完善 SDK 版本确认逻辑（含 codeCheck），防止错误被静默吞没（`c185817`、`8b3270b`、`2277984`）
+- 修复复制模板时 `modelVersion` 与 `EntryAbility_label` 字段未正确同步的问题（`d438216`）
+- 修复内置技能提取与开发模式加载失效的问题（`0e9dee5`）
+- 升级 `@deveco-codegenie/mcp-bridge` 至 1.1.11，并将其从 `minimumReleaseAge` 发布门禁中豁免（`f60775a`、`c93e1cc`）
+- 恢复 deveco-code 打包的自定义构建配置，并补回 ripgrep / mcp-bridge 下载的 postinstall 钩子，保障安装期二进制就位（`5ff55b5`、`107cfb8`）
+- 对齐 `build.ts` 与 `pipeline-build.ts` 中的 vendor 路径，消除本地与流水线构建产物差异（`7dded29`）
+- 修复 PowerShell 下中文输出乱码，保障 Windows 终端中文可读（`5d72cbb`）
+
+#### 重构
+
+- 将全部 `Log.create` 调用迁移至 `Effect.log*`，并移除旧版 Log 模块，统一日志体系（`d169b1c`）
+
+#### 文档
+
+- 上线离线文档站点，并于 README 中补充访问入口（`42b361f`）
+- 移除冗余的 overview 条目与 Releases 下载说明，精简文档表述（`6c7e6a5`）
+- 在 UI 校验文档中澄清多模态模型的使用方式，避免误用（`4453391`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 落地中英文国际化首版，覆盖命令菜单、权限提示、`/init`、`/review` 等交互节点，支持运行时语言切换（`999e6df`、`89d5698`、`093451b`、`80b4eb7`、`ba3701d`）
+- 点击 logo 时新增交互式爆破动效，增强启动时刻的视觉反馈（`bace2c3`）
+- `@` 弹层新增「输入即过滤」提示，提升智能体 / 文件检索的引导性（`d86ac61`）
+
+#### 优化
+
+- 默认启用会话滚动条，改善长会话浏览体验（`05e6a93`）
+
+#### 缺陷修复
+
+- 移除 `/language` 斜杠命令（保留调色板入口）并清理冗余的 `prompt.*` i18n 键（`fac0737`、`57ed63b`）
+- 退出尾声 logo 配色与 CLI banner 调色板对齐，统一视觉收尾（`f0a93b4`）
+- 恢复 `DEVECO_HOME` 自动检测与登录检查（含 `requireLogin` 前置校验），避免未登录态误入主界面（`b33e8d4`、`cd4a560`）
+- 修复 `unknown component type: spinner` 运行报错，消除启动期组件渲染异常（`912ab20`）

package/README.md

@@ -0,0 +1,334 @@
+<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>
+
+<p align="center">
+  <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">
+  <img src="https://raw.gitcode.com/openharmony-sig/deveco-code/raw/develop/assets/readme/readme-screenshot.png" alt="DevEco Code" width="600">
+</p>
+
+***
+
+## 快速开始
+
+```bash
+# 1. 安装
+npm install -g @deveco/deveco-code
+
+# 2. 启动
+deveco
+
+# 3. 开始对话 —— 在终端中直接描述你的 HarmonyOS 开发需求
+提示词示例：
+- 解释一下代码库的架构
+- 帮我重构login_check这个函数
+- 帮我检查并修复语法错误
+```
+
+> 建议使用 [npm 官方源](https://registry.npmjs.org/) 或 [淘宝镜像源](https://registry.npmmirror.com/) 安装，其他镜像源可能因同步延迟导致安装失败或版本滞后。
+
+> 如需编译构建、设备运行等能力，请先安装 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/) 并配置 `DEVECO_HOME` 环境变量。
+
+## 简介
+
+DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具，支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。
+
+DevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力，并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。
+
+## 支持平台
+
+DevEco Code 当前通过 npm 提供以下平台安装包：
+
+| 平台 | 架构 | 说明 |
+| --- | --- | --- |
+| Windows | x64 | Windows 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 及以上
+- **macOS**：macOS 15 Sequoia 及以上
+
+**硬件**
+
+- **日常使用**（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存
+- **重度使用**（大工程、长会话、频繁编译构建与模拟器/真机调试）：16 GB 及以上内存；建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间
+
+**运行时与工具链**
+
+- [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 7+（推荐）、Windows PowerShell 5.1+
+- macOS：Zsh（推荐）、Bash
+
+**网络**
+
+- 需要稳定的互联网连接（华为账号登录、模型调用、HarmonyOS 知识库检索等）
+
+## 安装前置
+
+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 安装目录，默认路径示例：
+   - **macOS**：`/Applications/DevEco-Studio.app`
+   - **Windows**：`C:\Program Files\Huawei\DevEco Studio`
+
+可先在终端验证 Node.js 环境：
+
+```bash
+node -v
+npm -v
+```
+
+## 安装与卸载
+
+安装：
+
+```bash
+npm install -g @deveco/deveco-code
+```
+
+查看版本、启动：
+
+```bash
+deveco --version
+deveco
+```
+
+更新：
+
+```bash
+deveco upgrade
+```
+
+卸载运行时数据与全局包：
+
+```bash
+deveco uninstall
+npm uninstall -g @deveco/deveco-code
+```
+
+## 登录与登出
+
+使用 DevEco Code 需先通过华为账号登录。首次执行 `deveco` 时会在终端内引导完成登录；也可单独执行登录命令：
+
+```bash
+deveco auth login
+```
+
+登出会清除当前华为账号的本地登录状态，下次启动需重新登录。执行：
+
+```bash
+deveco auth logout
+```
+
+## 模型配置
+
+登录后可使用 DevEco Code 提供的免费模型通道。
+
+在 DevEco Code 中输入 `/models` 可进入模型配置界面。当前免费提供 `GLM-5.1` 模型，单账号默认每分钟 50 次请求。也可以通过 `/connect` 进入 Provider 选择界面，配置支持的第三方模型。
+
+内置免费模型通道在登录后自动可用，无需在配置文件中手动配置。如需接入其他模型服务，可以通过 `deveco.jsonc` 配置第三方 Provider（以下字段均为占位符，请替换为你的服务商信息）：
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    // Provider ID，自定义命名即可，其他配置中通过 "<provider-id>/<model-id>" 引用模型
+    "myprovider": {
+      // 可选，缺省即为 openai-compatible；非 OpenAI 兼容的服务商才需要指定
+      "npm": "@ai-sdk/openai-compatible",
+      // 显示名称，可自定义
+      "name": "My Provider",
+      "models": {
+        // 替换为服务商提供的模型 ID
+        "<your-model-id>": {
+          "tool_call": true,
+          "limit": {
+            "context": 200000,
+            "output": 8192
+          }
+        }
+      },
+      "options": {
+        // 替换为服务商的 API 地址
+        "baseURL": "https://<your-endpoint>/v1",
+        // 替换为你的 API Key
+        "apiKey": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+**UI 检查配置**
+
+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-id>/<model-id>
+      "hidden": true,
+    },
+  },
+}
+```
+
+配置文件读取优先级：
+
+1. 项目目录下 `.deveco/deveco.jsonc`
+2. 项目目录下 `deveco.jsonc`
+3. 用户目录下 `.config/deveco/deveco.jsonc`
+
+## Agent 配置
+
+DevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置（按 `Tab` 键切换）：
+
+- `Build`：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行
+- `Plan`：适合需求拆解、技术方案、发布规划、测试规划和文档生成
+- `Goal`：适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付
+
+## HarmonyOS 场景能力
+
+DevEco Code 集成了常用 HarmonyOS 开发工具能力：
+
+| 工具                       | 说明                   |
+| ------------------------ | -------------------- |
+| `build_project`          | 执行编译构建并导出构建产物        |
+| `start_app`              | 在模拟器或真机上运行应用         |
+| `hdc_log`                | 收集/清理设备日志/查看连接模拟器    |
+| `verify_ui`              | 执行 UI 操作验证功能是否正确        |
+| `arkts_check`            | ArkTS 静态语法检查         |
+| `switch_cwd`             | 切换构建项目路径             |
+
+常见场景包括：从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。
+
+## 扩展能力
+
+DevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。
+
+> 新增或修改 Skill、MCP、Plugin 配置后，需退出并重新执行 `deveco` 启动后才会生效。
+
+### Skills
+
+```bash
+npx skills add vercel-labs/agent-skills
+```
+
+也可以把 Skill 放到 `~/.config/deveco/skills` 目录。
+
+### MCP
+
+可在 `~/.config/deveco/deveco.jsonc` 中配置 MCP：
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "playwright": {
+      "type": "local",
+      "command": ["npx", "@playwright/mcp@latest"],
+      "enabled": true
+    }
+  }
+}
+```
+
+### Plugins
+
+```bash
+npm install -g oh-my-opencode
+```
+
+然后在 `deveco.jsonc` 中配置插件入口：
+
+```jsonc
+{
+  "plugin": [
+    "node_modules/oh-my-opencode/dist/index.js"
+  ]
+}
+```
+
+## 从 OpenCode 迁移
+
+如果需要从 OpenCode 迁移到 DevEco Code，请将配置文件迁移到 DevEco Code 目录。主配置文件可参考：
+
+```powershell
+# Windows PowerShell
+Copy-Item -Force "{源路径}\opencode.jsonc" "~\.config\deveco\deveco.jsonc"
+```
+
+```bash
+# macOS
+cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc
+```
+
+Skills、Agents、Plugins 也可以迁移到 `~/.config/deveco` 下的对应目录；MCP 配置项可迁移到 `deveco.jsonc` 中。
+
+## 参与贡献
+
+欢迎贡献！请在提交 Pull Request 前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+## 帮助与支持
+
+- 完整文档请参阅 [DevEco Code 使用文档](docs/deveco-code-docs.html)（需下载到本地后打开），也可在线阅读 [OpenCode TUI 文档](https://opencode.ai/docs/zh-cn/tui/)
+- 常见问题请参阅 [FAQ 文档](https://gitcode.com/openharmony-sig/deveco-code/wiki/FAQ.md)
+- 反馈与交流 [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 社区。