ZeroCode

ZeroCode 是一个 AI 驱动的鸿蒙应用生成工具，通过自然语言描述自动生成完整、可编译的 HarmonyOS Next 应用。

🚀 只需一句话描述，即可生成完整的鸿蒙应用！

✨ 特性

• 🎯 一键生成 - 输入应用描述，自动生成完整 HarmonyOS 项目
• ✅ 可编译运行 - 生成的代码符合 HarmonyOS Next SDK 标准，可直接在 DevEco Studio 编译
• 🔧 多 LLM 支持 - 支持通义千问、DeepSeek、豆包、OpenAI、本地 Ollama 等
• 📱 DevEco Studio 兼容 - 生成的项目可直接导入 DevEco Studio
• 🤖 OpenCode 集成 - 作为 OpenCode Agent 的 skill/agent，复用 memory 等机制
• 🎨 标准项目结构 - 包含完整的构建配置、资源文件、模块配置

🚀 快速开始

1. 安装依赖

git clone https://github.com/YOUR_USERNAME/ZeroCode.git
cd ZeroCode
pip3 install -r zerocode/requirements.txt

2. 配置 LLM

python3 zerocode.py config

选择 LLM 并输入 API Key。

推荐配置:

LLM	获取 API Key	推荐模型
通义千问	阿里云百炼	qwen3.5-plus
DeepSeek	DeepSeek 平台	deepseek-chat
豆包	火山引擎	doubao-lite

3. 生成应用

python3 zerocode.py

输入应用描述，例如：

生成一个鸿蒙版的简易计算器 App，包含加减乘除等基础操作

4. 在 DevEco Studio 中运行

1. 打开 DevEco Studio
2. File → Open → 选择 outputs/YourAppName/ 目录
3. 等待索引完成
4. 点击运行按钮

📖 使用方法

CLI 命令

# 生成鸿蒙应用
python3 zerocode.py

# 配置 LLM
python3 zerocode.py config

# 查看帮助
python3 zerocode.py help

OpenCode 集成

在 OpenCode 中使用：

# 在 OpenCode 中调用
@zerocode-builder 创建一个天气应用，显示温度和 7 天预报

或加载 skill：

skill({ name: "zerocode" })

📁 项目结构

ZeroCode/
├── zerocode/                    # Python 包
│   ├── core/
│   │   ├── config.py           # LLM 配置管理
│   │   ├── llm.py              # LLM 客户端
│   │   ├── generator.py        # 鸿蒙项目生成器
│   │   └── validator.py        # 代码验证器
│   ├── __init__.py
│   ├── cli.py                  # CLI 入口
│   └── requirements.txt
├── .opencode/                   # OpenCode 配置
│   ├── config.json
│   ├── skills/zerocode/SKILL.md
│   └── agents/zerocode-builder.md
├── outputs/                     # 生成的应用（.gitignore）
├── zerocode.py                  # 主入口
├── zerocode_config.json.example # 配置示例
├── README.md
└── LICENSE

生成的应用结构

MyApp/
├── hvigorfile.ts              # 构建脚本
├── oh-package.json5           # 包管理配置
├── build-profile.json5        # 构建配置
├── app.json5                  # 应用元数据
└── entry/
    ├── hvigorfile.ts          # 模块构建脚本
    ├── oh-package.json5       # 模块包配置
    └── src/main/
        ├── ets/
        │   ├── App.ets                 # 根组件
        │   └── pages/Index.ets         # 主页面
        ├── ets/entryability/
        │   └── EntryAbility.ets        # 入口 Ability
        └── resources/
            └── base/
                ├── element/string.json # 字符串资源
                ├── color/color.json    # 颜色定义
                └── profile/main_pages.json # 页面路由

🤝 贡献

欢迎贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发环境设置

# 克隆仓库
git clone https://github.com/YOUR_USERNAME/ZeroCode.git
cd ZeroCode

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip3 install -r zerocode/requirements.txt

# 运行测试
python3 test_zerocode.py

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🔗 相关链接

• HarmonyOS 官方文档
• DevEco Studio 下载
• OpenCode 文档
• 通义千问 API

📬 联系方式

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions

🙏 致谢

感谢以下开源项目：

• OpenCode - AI 编码助手框架
• HarmonyOS - 鸿蒙操作系统
• Qwen - 通义千问大模型

---

如果这个项目对你有帮助，请给一个 ⭐️ Star 支持！

Made with ❤️ by ZeroCode Contributors