# opencode-harmonyos-code


**opencode-harmonyos-code**是一个opencode插件，可以作为HarmonyOS全生命周期开发助手。专注于HarmonyOS应用的完整开发生命周期，包括项目创建、UI开发、状态管理、网络请求、数据存储、权限请求、性能优化、测试和发布。

## 功能特性

- **HarmonyOS设计专家**：为HarmonyOS应用和原子化服务创建详细的PRD设计文档
- **HarmonyOS开发专家**：根据设计文档遵循HarmonyOS规范实现功能
- **HarmonyOS构建**：使用harmonyos-hvigor技能构建项目并确保编译成功

## 快速开始

### 环境要求

- Node.js 18+
- 安装opencode CLI工具，参考官方文档：<https://opencode.ai/docs/zh-cn/#安装>

### 安装步骤

#### 1. 安装所需Skills

本项目依赖以下三个skill，需要先安装到opencode中：

- `harmonyos-atomic-dev` - HarmonyOS原子化服务开发专家
- `harmonyos-hvigor` - Hvigor构建工具使用指南
- `harmonyos-prd-design` - HarmonyOS PRD设计生成专家

#### 2. 编译项目

```bash
# 安装依赖
npm install

# 构建项目
npm run build
```

#### 3. 配置当前插件到opencode配置文件

##### 3.1  将编译后的插件添加到opencode配置文件中：

````
```bash
# 查看配置文件
cat ~/.config/opencode/opencode.json
```

配置示例：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["$PWD"]
}
```
*$PWD* 替换为本项目的实际路径。
````

##### 3.2 重启opencode

```
参考：<https://opencode.ai/docs/zh-cn/plugins/#%E4%BD%BF%E7%94%A8%E6%8F%92%E4%BB%B6>
```

## 体验

安装成功后，你的opencode中将会多出3个Agent，分别是harmonyos-plugin，harmoyos-dev，harmonyos-design，多出3个skill ，接下来就可以进行鸿蒙开发了。

!\[Agent架构]\(doc/agents.png null)
!\[Agent使用流程]\(doc/use-agent.png null)

## 许可证

MIT