# harmoney-docs-py

**Repository Path**: null_717_7167/harmoney-docs-py

## Basic Information

- **Project Name**: harmoney-docs-py
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-17
- **Last Updated**: 2025-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HarmonyOS 开发规则生成器

## 📖 项目背景

HarmonyOS 作为新兴的移动操作系统，由于发展历史相对较短，主流 AI 模型在预训练阶段缺乏充足的 HarmonyOS 开发语料。这导致 Cursor 等 AI 开发工具在生成 HarmonyOS 相关代码时效果不佳，开发者难以获得准确的开发建议。

本项目旨在解决这一痛点，通过智能爬取华为官方 HarmonyOS 开发文档，自动提取最佳实践并生成符合 Cursor IDE 规范的开发规则文件，为开发者提供专业、准确的 HarmonyOS 开发指导。

详细讲解请阅读文章：https://mp.weixin.qq.com/s/gLgP7gGU0pmGc2x1hS-0UQ

## 🚀 核心功能

- **📋 智能文档爬取**: 自动爬取华为官方 HarmonyOS 最佳实践文档，支持 SPA 页面解析
- **📝 UI 开发规范生成**: 基于 Gemini AI 智能提取界面开发最佳实践，生成结构化的开发规范
- **🔧 ArkTS 迁移规则**: 自动提取 TypeScript 到 ArkTS 迁移过程中的 Lint 规则和语法约束

## 📁 harmony_cursor_rules 说明

项目运行后会生成 `harmony_cursor_rules` 目录，包含按模块分类的开发规范文件。具体涉及的模块配置可查看 `harmony_modules_config.json` 文件：

### 目录结构

```
harmony_cursor_rules/
├── component_encapsulation_reuse/    # 组件封装与复用
├── layout_dialog/                    # 布局与弹窗
├── animation_transition/             # 动画与转场
├── performance_optimization/         # 性能优化
├── ...                              # 其他模块
└── final_cursor_rules/              # 最终整合的规则文件
    ├── component_encapsulation_reuse.cursorrules.md
    ├── layout_dialog.cursorrules.md
    ├── arkts-lint-rules.md           # ArkTS迁移规则
    └── ...
```

> 💡 **快速使用**: 开发者只需将 `final_cursor_rules` 目录下的规则文件配置到 Cursor IDE 中即可获得专业的 HarmonyOS 开发提示。如果需要生成更多的规则文件，可在`harmony_modules_config.json`追加配置。

### 参考文档

生成的开发规则均基于华为官方权威文档：

- **界面开发最佳实践**: [HarmonyOS 最佳实践 - 界面开发](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-ui-dynamic-operations)
- **ArkTS 迁移指南**: [TypeScript 到 ArkTS 迁移指南](https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V14/typescript-to-arkts-migration-guide-V14)

## 🛠️ 使用方式

### 环境准备

### 先安装 python3.10 或以上版本

```bash
# 安装python3.10
brew install python3.10
```

```bash
# 安装依赖 playwright install
playwright install
```

```bash
# 检测 pip 是否安装
pip --version
```

1. **安装依赖**

```bash
pip install -r Requirements.txt
```

2. **配置 API 密钥**

```bash
# 设置Gemini API密钥
export GEMINI_API_KEY="your-gemini-api-key"

# 可选：设置自定义API端点（如使用代理或自定义服务）
export GEMINI_BASE_URL="https://your-custom-api-endpoint.com"
```

### 运行程序

```bash
# 标准运行
python main.py

# 调试模式（保存HTML文件）
python main.py --debug
```

### 使用生成的规则

1. 在你的 HarmonyOS 项目根目录创建 `.cursorrules` 文件
2. 将 `final_cursor_rules` 目录中相关 `.md` 文件的内容复制到 `.cursorrules` 文件中

## 📊 输出示例

生成的开发规则文件结构完整，包含：

- **核心原则**: HarmonyOS 开发的基础设计理念和架构原则
- **推荐做法**: 经过验证的最佳实践和标准代码模式
- **禁止做法**: 需要避免的错误写法和反模式
- **代码示例**: 正确与错误写法的对比演示
- **注意事项**: 关键的开发要点和性能优化建议

---

## 文档链接

[HarmonyOS 开发指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-dev-overview)

_本项目基于 AI 技术自动化提取华为官方权威文档，为 HarmonyOS 开发者提供专业、标准的开发规范指导_