build_in_harmonyos:基于 OpenHarmony 的开源软件编译兼容性框架项目

Star0
0
代码
代码
Issues
Pull Requests
项目讨论
Wiki
分析
Star0
0

可用于将开源软件自动化编译、固化和分发到 OpenHarmony aarch64 平台。基于 Conan 包管理器，支持完整编译管线，内置错误匹配引擎和知识图谱系统

分支12Tags0
文件最后提交记录最后更新时间
.gitcode
feat(skill): SKILL_FEEDBACK 阶段 + .gitcode 规则刷新 1. 新增 ohc/feedback.py 模块 - cmd_feedback(): 收集全流程数据(manifest/notes/test-report/ci-result/submit-state) - 生成 feedback/SKILL_FEEDBACK_{secrets.token_hex(4)}.md (项目根, 与knowledge同级) - HANDOFF 强制: 残留(请填写)则emit HANDOFF(step_failed=feedback) - --resume: 读.feedback-state.json, 检查报告完整性 - 作者从 git config user.name/email 获取 2. submission.py: submit成功后自动调用cmd_feedback() - 两条成功路径(正常+resume)均传播 feedback_ret 3. cli.py: 新增 feedback 路由 4. .gitcode 三文件刷新: - PULL_REQUEST_TEMPLATE.md: +测试结论/已知限制/问题解决方案/验证命令 - code-style.md: +§七 PR与反馈规范(R22-R25) - review-memory.md: +§五 AI检视与反馈(R26-R30) 5. SKILL.md v11.5→v11.6 6. 新增 templates/skill-feedback.md 模板
1 个月前
archives
feat(bannergrab): 新增 3.5 conan recipe（网络服务 banner 抓取工具，Makefile 构建） feat(bannergrab): 新增 3.5 conan recipe（网络服务 banner 抓取工具，Makefile 构建）
1 个月前
ci
feat: tesseract 5.3.3 conan recipe (published) feat: tesseract 5.3.3 conan recipe (published) - OCR engine with leptonica dependency fix: patch format - remove diff header to start with --- (L0f compliance) fix: tesseract quality cleanup - real self.run(), fill MANIFEST.yml TODOs, fix patch filename, remove non-standard files, rewrite software-level README fix: update tesseract artifacts - add software-level manifest, update all files with latest CI results chore: add conandata.yml.orig to .gitignore (CI-generated backup file)
1 个月前
config
fix: principles.kv格式修复+杂项文件清理 principles.kv: - ID从P-AUTOTOOLS-001格式重编号为P001-P020 - 38个KV从scope反向恢复principles引用 - E078续行残留P-LINKAGE-001修复 杂项清理: - 5个文件从git移除: _migrate_batch1.sh, .zshrc, .mdp, 2个tarball - .gitignore补充防护规则 验证: graph validate 0 errors, W4 rc=0
2 个月前
docs
feat: SKILL 全量审计修复 + 新增 PR 管理工具 + W4 审计工作流 高优先级修复 (H1-H8): - H1: R8 #ifdef __OHOS__ 矛盾统一（允许使用但须有实质逻辑，禁止空壳stub） - H2: R39/R40 补入 SKILL.md 铁律摘要表（40条） - H3: frontmatter 版本号 10.3→11.1 - H4: finish 步骤计数统一为 9 步 - H5: W4 审计从 finish 内部拆出为独立步骤 - H6: .ci-local-passed 改为 .ci-result.json 防伪造 - H7: ADAPTATION_GUIDE.md Makefile 模板补 generate() (R33) - H8: troubleshooting.md 幽灵引用 5 处修复 中优先级修复 (M1-M8): - M1: W4/W5 重编号（审计=W4, 知识图谱=W5） - M2: conan-verify 缓存判断避免重复执行 - M3: compile-guide.md 版本引用更新 - M4: ADAPTATION_GUIDE.md 与 SKILL.md 工作流对齐 - M5: TEST_QUALITY_SPEC.md 补全 L0f-L0k + L1e + L2/L4/L5 - M6: ARCHIVE-SPEC.md 补 commands.json 定义 - M7: index.tsv 7 个条目 auto_fix/approach 占位符修复 - M8: 孤立模板 manifest-software.yaml/compatibility.md 添加引用 低优先级修复 (L1-L3): - L1: pre-scan-rules.yaml 补 7 条 kb_ref - L2: SKILL.md §2 引用 ohos-adaptation-patterns.md/release.md - L3: error-patterns.md 条目数/原则ID格式统一 新增工具: - scripts/gitcode_pr.py: GitCode PR 管理（创建/评论/CI状态/回复） - scripts/pre_pr_audit.py: W4 Pre-PR 独立审计 - templates/audit-prompt.md: 审计子任务 prompt 模板 SKILL.md v11.2
1 个月前
knowledge
feat(bannergrab): 新增 3.5 conan recipe（网络服务 banner 抓取工具，Makefile 构建） feat(bannergrab): 新增 3.5 conan recipe（网络服务 banner 抓取工具，Makefile 构建）
1 个月前
references
feat: SKILL 全量审计修复 + 新增 PR 管理工具 + W4 审计工作流 高优先级修复 (H1-H8): - H1: R8 #ifdef __OHOS__ 矛盾统一（允许使用但须有实质逻辑，禁止空壳stub） - H2: R39/R40 补入 SKILL.md 铁律摘要表（40条） - H3: frontmatter 版本号 10.3→11.1 - H4: finish 步骤计数统一为 9 步 - H5: W4 审计从 finish 内部拆出为独立步骤 - H6: .ci-local-passed 改为 .ci-result.json 防伪造 - H7: ADAPTATION_GUIDE.md Makefile 模板补 generate() (R33) - H8: troubleshooting.md 幽灵引用 5 处修复 中优先级修复 (M1-M8): - M1: W4/W5 重编号（审计=W4, 知识图谱=W5） - M2: conan-verify 缓存判断避免重复执行 - M3: compile-guide.md 版本引用更新 - M4: ADAPTATION_GUIDE.md 与 SKILL.md 工作流对齐 - M5: TEST_QUALITY_SPEC.md 补全 L0f-L0k + L1e + L2/L4/L5 - M6: ARCHIVE-SPEC.md 补 commands.json 定义 - M7: index.tsv 7 个条目 auto_fix/approach 占位符修复 - M8: 孤立模板 manifest-software.yaml/compatibility.md 添加引用 低优先级修复 (L1-L3): - L1: pre-scan-rules.yaml 补 7 条 kb_ref - L2: SKILL.md §2 引用 ohos-adaptation-patterns.md/release.md - L3: error-patterns.md 条目数/原则ID格式统一 新增工具: - scripts/gitcode_pr.py: GitCode PR 管理（创建/评论/CI状态/回复） - scripts/pre_pr_audit.py: W4 Pre-PR 独立审计 - templates/audit-prompt.md: 审计子任务 prompt 模板 SKILL.md v11.2
1 个月前
scripts
feat(skill): SKILL_FEEDBACK 阶段 + .gitcode 规则刷新 1. 新增 ohc/feedback.py 模块 - cmd_feedback(): 收集全流程数据(manifest/notes/test-report/ci-result/submit-state) - 生成 feedback/SKILL_FEEDBACK_{secrets.token_hex(4)}.md (项目根, 与knowledge同级) - HANDOFF 强制: 残留(请填写)则emit HANDOFF(step_failed=feedback) - --resume: 读.feedback-state.json, 检查报告完整性 - 作者从 git config user.name/email 获取 2. submission.py: submit成功后自动调用cmd_feedback() - 两条成功路径(正常+resume)均传播 feedback_ret 3. cli.py: 新增 feedback 路由 4. .gitcode 三文件刷新: - PULL_REQUEST_TEMPLATE.md: +测试结论/已知限制/问题解决方案/验证命令 - code-style.md: +§七 PR与反馈规范(R22-R25) - review-memory.md: +§五 AI检视与反馈(R26-R30) 5. SKILL.md v11.5→v11.6 6. 新增 templates/skill-feedback.md 模板
1 个月前
templates
feat(skill): SKILL_FEEDBACK 阶段 + .gitcode 规则刷新 1. 新增 ohc/feedback.py 模块 - cmd_feedback(): 收集全流程数据(manifest/notes/test-report/ci-result/submit-state) - 生成 feedback/SKILL_FEEDBACK_{secrets.token_hex(4)}.md (项目根, 与knowledge同级) - HANDOFF 强制: 残留(请填写)则emit HANDOFF(step_failed=feedback) - --resume: 读.feedback-state.json, 检查报告完整性 - 作者从 git config user.name/email 获取 2. submission.py: submit成功后自动调用cmd_feedback() - 两条成功路径(正常+resume)均传播 feedback_ret 3. cli.py: 新增 feedback 路由 4. .gitcode 三文件刷新: - PULL_REQUEST_TEMPLATE.md: +测试结论/已知限制/问题解决方案/验证命令 - code-style.md: +§七 PR与反馈规范(R22-R25) - review-memory.md: +§五 AI检视与反馈(R26-R30) 5. SKILL.md v11.5→v11.6 6. 新增 templates/skill-feedback.md 模板
1 个月前
.ci-result.json
feat: 规范编译 poppler 25.12.0 (pdftotext) feat: 规范编译 poppler 25.12.0 (pdftotext)
1 个月前
.gitignore
feat(libtar): add Conan recipe for libtar 1.2.20 feat(libtar): add Conan recipe for libtar 1.2.20
1 个月前
CONTRIBUTING.md
feat(ci): 制品仓迁移到无 channel 格式 (v10.0) 去掉所有 @ohpcd/stable 后缀, 统一使用 name/version 格式。 原因: 制品仓只有我们一个上传者, channel 是冗余信息; 无 channel 更简洁, 贡献者不需要记住后缀, AI 不需要检查。 改动范围 (107 个文件): - ci/conan/build_and_test.sh: 去掉 CONAN_USER/CONAN_CHANNEL, conan create/test 不再传 --user/--channel, L0i 门禁去掉 channel 检查改为统一无 channel 验证 - ci/conan/upload.sh: 上传引用改为 name/version - ci/artifacts/sign.sh: 同步去掉 channel - ci/scripts/preflight_check.sh: 去掉 @ohpcd/stable 检查逻辑 - scripts/ohc/conan_recipe.py: 依赖引用不再自动补全 @ohpcd/stable - SKILL.md v10.0: R27 更新为无 channel 格式, 决策树/示例同步 - references/iron-rules.md: R27 反转 (无 channel 为正确, 带 channel 为错误) - 14 个 conanfile.py: requires 去掉 @ohpcd/stable - 93 个 manifest.yaml/README.md/notes.md: 同步更新 注意: 制品仓中已有的 11 个 @ohpcd/stable 包需要重新用无 channel 格式上传 Generated with BitFun Co-Authored-By: BitFun
1 个月前
KNOW_YOUR_WHY.md
fix: 审查遗留问题修复 - finish.py: G0验证失败不再假设'平台限制已手动验证',改为提示手动检查 - check_env.py: _check_cmd异常时返回False而非True(不再误导工具可用) 审查结论: P0(4项)+P1(5项)+P2(7项)绝大多数在之前提交中已修复, 本次修复最后2个中等问题。全量审查120个发现,实际需修复的仅2个。
2 个月前
README.md
fix: 审查遗留问题修复 - finish.py: G0验证失败不再假设'平台限制已手动验证',改为提示手动检查 - check_env.py: _check_cmd异常时返回False而非True(不再误导工具可用) 审查结论: P0(4项)+P1(5项)+P2(7项)绝大多数在之前提交中已修复, 本次修复最后2个中等问题。全量审查120个发现,实际需修复的仅2个。
2 个月前
SKILL.md
feat(skill): SKILL_FEEDBACK 阶段 + .gitcode 规则刷新 1. 新增 ohc/feedback.py 模块 - cmd_feedback(): 收集全流程数据(manifest/notes/test-report/ci-result/submit-state) - 生成 feedback/SKILL_FEEDBACK_{secrets.token_hex(4)}.md (项目根, 与knowledge同级) - HANDOFF 强制: 残留(请填写)则emit HANDOFF(step_failed=feedback) - --resume: 读.feedback-state.json, 检查报告完整性 - 作者从 git config user.name/email 获取 2. submission.py: submit成功后自动调用cmd_feedback() - 两条成功路径(正常+resume)均传播 feedback_ret 3. cli.py: 新增 feedback 路由 4. .gitcode 三文件刷新: - PULL_REQUEST_TEMPLATE.md: +测试结论/已知限制/问题解决方案/验证命令 - code-style.md: +§七 PR与反馈规范(R22-R25) - review-memory.md: +§五 AI检视与反馈(R26-R30) 5. SKILL.md v11.5→v11.6 6. 新增 templates/skill-feedback.md 模板
1 个月前
SUMMARY.md
fix(skill): P0+P1 框架缺陷修复 P0 修复 (消除用户介入核心原因): - submission.py: git add 范围从 archives/ 收窄到 archives/{letter}/{software}/{version}/ + 暂存文件原子性验证 (W2) - submission.py: 增加 Gate 0 token 前置检查，在 git 操作前拦截 - submission.py: AI Review 检查改为 3 次重试x30s + returncode 检查，消除假通过 - 4 个 conanfile 模板: 添加 package_type=library + options/default_options(shared)，移除未使用的 import os，修正 R26 使用 shared option P1 修复 (提升健壮性): - submission.py: CI 监控超时改为阻塞 (return 1)，识别未找到 CI 评论为 QUEUED - submission.py: git push 失败时自动 git pull --rebase 重试 (2次) - submission.py: PR body 不再无条件覆盖已填写的文件 附带修复 (libiconv 适配过程中发现): - workflow_checks.py: bash->zsh, CI_PACKAGES 路径格式修正 - pre_pr_audit.py: git 使用绝对路径 (shutil.which)
1 个月前

OpenHarmony Compile Agent

鸿蒙 (OpenHarmony) 平台开源软件编译兼容性框架 版本: v8.7 (Conan 配方体系 · 知识图谱驱动 · 多 Agent 协作)

加入项目

邀请链接

快速部署引导：

wget https://gitcode.com/OpenHarmonyPCDeveloper/build_in_harmonyos/releases/download/init/setup_wizard.sh \
  && chmod 777 ./setup_wizard.sh && ./setup_wizard.sh

项目概述

自动化编译、固化和分发开源软件到 HarmonyOS (OpenHarmony) aarch64 平台。 基于 Conan 包管理器，支持从源码下载到 Conan 配方生成、验证、上传的完整编译管线，内置五阶段错误匹配引擎和知识图谱系统。

当前规模：已收录 427 款软件 / 490 个版本（详见 SUMMARY.md）

v8.7 核心特性

  • Conan 配方体系：conanfile.py + conandata.yml + test_package/ 三件套，conan create 验证 + conan upload 发布
  • 32 条编译铁律 (R1-R32)：覆盖参数/补丁/链接/源码/协作/打包/自检/Conan 配方/平台兼容
  • 知识图谱：211 错误模式条目 (E001-E211)，五阶段引擎匹配，草稿→审核→正式流转
  • 8 道验证门禁 (G0-G4 + L2/L4/L5)：预构建评估→配方完整性→conan create→系统同名库隔离→产物完整性→烟雾测试→安全扫描→基线对比
  • CI 流水线：纯 shell + conan，PR 校验不上传，合并 main 后自动上传 CNB 制品仓
  • 多 Agent 协作：协作者提交 PR → 主编审核 → 合并，支持多人并行编译
  • OHOS 平台适配：os=OHOS 枚举、aarch64-linux-ohos triplet、CMAKE_SYSTEM_NAME 映射

目录结构

scripts/
├── ohc-run.py              # 统一 CLI 入口
├── software-registry.yaml  # 软件元数据注册表
└── ohc/                    # Python 包

knowledge/
├── graph/                  # 知识图谱（index.tsv + E*.kv + drafts/）
├── operations/             # 运维知识（构建系统、依赖管理等）
├── ARCHIVE-SPEC.md         # 归档规范
└── error-patterns.md       # 错误模式浏览入口

archives/                   # 编译档案（427 款软件）
  {letter}/{name}/
  ├── manifest.yaml         # 软件级元数据
  ├── README.md             # 软件描述
  └── {version}/
      ├── conanfile.py       # Conan 配方【CI 输入】
      ├── conandata.yml      # 源码 + 补丁声明【CI 输入】
      ├── test_package/      # Conan 测试【CI 输入】
      ├── patches/           # 补丁文件【CI 输入】
      ├── manifest.yaml      # 编译元数据【AI 元数据】
      ├── notes.md           # 适配笔记【AI 元数据】
      └── reports/           # 验证报告【AI 元数据】

ci/                         # CI 脚本（纯 shell，无 AI）
├── conan/
│   ├── setup.sh            # 环境初始化 + profile + remote
│   ├── build_and_test.sh   # conan create + L4/L5 检查
│   ├── upload.sh           # conan upload（仅 release）
│   └── profiles/ohos-aarch64
└── artifacts/sign.sh       # GPG 签名

references/                 # 参考资料
templates/                  # 模板文件
docs/                       # 规范文档

CLI 命令一览

AI 工具（scripts/ohc-run.py）

子命令 用途
build 13 步编译驱动（含 Conan 配方生成+验证）★ 主入口
init-build 下载/解压/骨架/环境/依赖解析
conan-init 生成 conanfile.py + conandata.yml + test_package/
conan-verify conan create + G0-G4 + L2/L4/L5 + 知识图谱 + 草稿
finish 补丁+归档+conan-verify+校验+知识+摘要（6 步）
engine / graph add|update|validate 知识图谱查询/管理
resolve-deps [--install] 查询/安装预编译依赖
verify-build / refresh-patch 门禁复查 / 补丁管线
status / handoff / track-edit 状态恢复 / 源码追踪
search-url / submit / review URL 搜索 / PR 自检 / 主编审核

CI 脚本（ci/ 目录，纯 shell，无 AI）

脚本 用途
ci/conan/setup.sh Conan 环境初始化 + profile + remote
ci/conan/build_and_test.sh conan create + L4/L5 检查
ci/conan/upload.sh conan upload 到 CNB 制品仓（仅 release）
ci/artifacts/sign.sh GPG 签名（非阻塞）

快速开始

环境准备

# Python 安装
curl -fsSL https://gitcode.com/OpenHarmonyPCDeveloper/cmd-pkgs/releases/download/pkgs/install.sh | sh -s -- python 3.12.9

# pip 源配置（鸿蒙社区源）
pip3 config set global.index-url https://pypi.cnb.cool/OpenHarmonyPCDeveloper/pypi/-/packages/simple
pip3 config set global.trusted-host pypi.cnb.cool

# Conan 安装（OHOS 适配版）
pip3 install conan

模式 A：Conan 驱动（推荐，适合已有配方的软件）

python3 $SKILL_ROOT/scripts/ohc-run.py build <软件名> [<版本>]
# → 13 步全自动：init→patches→configure→make→install→conan-init→conan-verify→finish

模式 B：探索性编译（适合首次/复杂软件）

# Step 1: 初始化
python3 $SKILL_ROOT/scripts/ohc-run.py init-build <软件名> [<版本>] [--url=URL]

# Step 2: AI 手动编译
source .build-context-<name>-<ver> && cd $BUILD_SRC_DIR
./configure --prefix=$DEFAULT_PREFIX && make -j2 && make install DESTDIR=$TEST_PREFIX
make check

# Step 2.5-2.6: 生成并验证 Conan 配方
python3 $SKILL_ROOT/scripts/ohc-run.py conan-init <软件名> <版本>
python3 $SKILL_ROOT/scripts/ohc-run.py conan-verify <软件名> <版本>

# Step 3: 收尾
python3 $SKILL_ROOT/scripts/ohc-run.py finish <软件名> <版本> published|built|failed

依赖管理

# 查看缺少的依赖
python3 $SKILL_ROOT/scripts/ohc-run.py resolve-deps <软件名>

# 自动安装预编译包
python3 $SKILL_ROOT/scripts/ohc-run.py resolve-deps --install <软件名>

# 列出所有可用预编译包
python3 $SKILL_ROOT/scripts/ohc-run.py resolve-deps --list-available

预编译包安装

编译好的软件包通过 cmd-pkgs 仓库 分发：

curl -fsSL "https://gitcode.com/OpenHarmonyPCDeveloper/cmd-pkgs/releases/download/pkgs/install.sh" | sh -s -- <软件名> <版本>

相关文档

文档 说明
SKILL.md 主操作手册（v8.7），每次编译前必读
CONTRIBUTING.md 贡献指南
KNOW_YOUR_WHY.md 核心设计理念与约束
docs/ADAPTATION_GUIDE.md AI 适配操作手册（新库适配入口）
docs/TEST_QUALITY_SPEC.md 测试质量规范（5 层防御门禁）
references/iron-rules.md 32 条铁律详解
SUMMARY.md 软件兼容性总览（自动生成）

许可证

Copyright (c) 2024-2026 OpenHarmony PC Developer 社区

项目介绍

可用于将开源软件自动化编译、固化和分发到 OpenHarmony aarch64 平台。基于 Conan 包管理器，支持完整编译管线，内置错误匹配引擎和知识图谱系统

M4Sugar3.29 K提交数
定制我的领域
README
规则集