ohos-devloop 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. ohos_devloop/__init__.py +2 -0
  2. ohos_devloop/_version.py +24 -0
  3. ohos_devloop/agents/skills/collab-delegate/SKILL.md +79 -0
  4. ohos_devloop/agents/skills/loop-iterate/SKILL.md +54 -0
  5. ohos_devloop/agents/skills/openharmony-ci/SKILL.md +71 -0
  6. ohos_devloop/agents/skills/openharmony-ci/agents/openai.yaml +4 -0
  7. ohos_devloop/agents/skills/openharmony-ci/scripts/openharmony_ci.py +520 -0
  8. ohos_devloop/agents/skills/pool-status/SKILL.md +47 -0
  9. ohos_devloop/config/e2e-cases.yaml +31 -0
  10. ohos_devloop/config/e2e-hap.yaml +54 -0
  11. ohos_devloop/config/inventory-template.yaml +35 -0
  12. ohos_devloop/config/inventory.yaml +68 -0
  13. ohos_devloop/config/report-templates/analysis-report.md +48 -0
  14. ohos_devloop/config/report-templates/impl-report.md +47 -0
  15. ohos_devloop/config/task-template.md +21 -0
  16. ohos_devloop/config/tdd-board.yaml +31 -0
  17. ohos_devloop/config/tdd-coverage.yaml +47 -0
  18. ohos_devloop/config/tdd-emulator.yaml +36 -0
  19. ohos_devloop/config/tdd-host.yaml +26 -0
  20. ohos_devloop/config/tdd-suites.yaml +34 -0
  21. ohos_devloop/config/templates/agents-user.md +11 -0
  22. ohos_devloop/config/templates/quickstart.md +82 -0
  23. ohos_devloop/config/verify.yaml +45 -0
  24. ohos_devloop/examples/anchor-e2e.yaml +55 -0
  25. ohos_devloop/examples/assert-smoke.yaml +33 -0
  26. ohos_devloop/examples/diffcov-fixture/cov.json +6688 -0
  27. ohos_devloop/examples/diffcov-fixture/diff.txt +24 -0
  28. ohos_devloop/examples/diffcov-smoke.yaml +32 -0
  29. ohos_devloop/examples/e2e-emu-smoke.yaml +45 -0
  30. ohos_devloop/examples/layout-fixture.norm.json +1 -0
  31. ohos_devloop/examples/smoke.yaml +27 -0
  32. ohos_devloop/ohos_cli.py +131 -0
  33. ohos_devloop/scripts/agent-run-v3.sh +149 -0
  34. ohos_devloop/scripts/apply.py +1448 -0
  35. ohos_devloop/scripts/check_env.py +284 -0
  36. ohos_devloop/scripts/collab.py +303 -0
  37. ohos_devloop/scripts/diffcov.py +211 -0
  38. ohos_devloop/scripts/flash.py +511 -0
  39. ohos_devloop/scripts/mount_ws.py +192 -0
  40. ohos_devloop/scripts/release.py +2645 -0
  41. ohos_devloop/scripts/release_audit.py +260 -0
  42. ohos_devloop/scripts/release_metadata.py +397 -0
  43. ohos_devloop/scripts/release_smoke.py +287 -0
  44. ohos_devloop/scripts/report_draft.py +234 -0
  45. ohos_devloop/scripts/server_init.py +310 -0
  46. ohos_devloop/scripts/sgrep.py +82 -0
  47. ohos_devloop/scripts/sign_hap.py +256 -0
  48. ohos_devloop/scripts/telemetry.py +260 -0
  49. ohos_devloop/scripts/ui_probe.py +396 -0
  50. ohos_devloop/scripts/verify_frame_diff.py +138 -0
  51. ohos_devloop/scripts/ws_init.py +131 -0
  52. ohos_devloop/scripts/wsroot.py +192 -0
  53. ohos_devloop-0.1.2.dist-info/METADATA +177 -0
  54. ohos_devloop-0.1.2.dist-info/RECORD +58 -0
  55. ohos_devloop-0.1.2.dist-info/WHEEL +5 -0
  56. ohos_devloop-0.1.2.dist-info/entry_points.txt +2 -0
  57. ohos_devloop-0.1.2.dist-info/licenses/LICENSE +202 -0
  58. ohos_devloop-0.1.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,35 @@
1
+ # ============================================================================
2
+ # 资源清单 —— 你的服务器 / 开发板 / 本机参数(唯一事实来源)
3
+ # 由 ohos-devloop init 生成。填完先跑:ohos-devloop server init(部署验收,会自动跑 smoke)
4
+ # 字段语义与工具仓 config/inventory.yaml 完全一致;扩容 = 加条目,不改代码。
5
+ # ============================================================================
6
+
7
+ servers:
8
+ build-1: # 条目名与 examples/smoke.yaml 引用一致,勿改
9
+ host: <你的构建服务器IP或主机名>
10
+ port: 22
11
+ user: root
12
+ # 大仓快照 glob:sync-repo 之后按此匹配;ohos_root=latest 时取字典序最新
13
+ ohos_root_glob: /srv/workspace/openharmony_master_default_*/code
14
+ run_dir: /root/collab/e2e # 服务器侧运行目录(构建日志/完成标记)
15
+ cores: 48
16
+
17
+ boards:
18
+ rk3568-01: # 条目名与 examples/smoke.yaml 引用一致,勿改
19
+ product: rk3568 # 构建目标(build.sh --product-name)
20
+ transport: hdc
21
+ attached_to: local # 板子插在本机
22
+ hdc_target: "" # 留空=自动取唯一设备;多设备时 `hdc list targets` 查序列号填入
23
+ software_version: "7.1.0.25" # 期望板上 const.product.software.version 包含的串(推板预检;
24
+ # 换固件后改这里——勿信 const.product.name,它会谎报)
25
+ build_layout: packages/phone/system
26
+ device_root: /system
27
+ remount_cmd: mount -o remount,rw /
28
+ backup_dir: <你的推库备份目录> # 推库备份长期目录(铁律:先备份再推)
29
+
30
+ local:
31
+ hdc: C:/Program Files/oh_toolchain/toolchains/hdc.exe # DevEco SDK toolchains 下的 hdc.exe
32
+ download_dir: <你的固件下载目录> # 固件包目录(ohos-devloop flash fetch/extract 用)
33
+ images_dir: <你的固件解压目录>
34
+ board_backup: <你的推库备份目录> # 板上文件推送前备份的长期目录(铁律 1;check_env 探测)
35
+ sign_dir: <你的签名材料目录> # 测试应用离线签名材料目录(sign_hap.py;也可 SIGN_DIR 环境变量)
@@ -0,0 +1,68 @@
1
+ # ============================================================================
2
+ # 资源清单 —— 服务器 / 开发板 / 本机参数的唯一事实来源(single source of truth)
3
+ #
4
+ # 这是**包内占位缺省**(公网可见形态):全部坐标为 <你的...> 占位,不含任何真实环境。
5
+ # 你的真实参数不要改本文件——走**文件级整文件覆写**(inventory_path() 先命中即整文件胜出):
6
+ # - 用户形态:ohos-devloop init 生成的工作区 config/inventory.yaml(填真实值);
7
+ # - 维护者源码仓形态:仓根 config/inventory.yaml(gitignored 覆写位,见 RUNBOOK
8
+ # 「资源清单与调度器」节)。
9
+ # 字段语义与 inventory-template.yaml 完全一致;扩容 = 加条目,不改代码。
10
+ # 消费者:apply.py(调度器)、flash.py 直接读取本文件;
11
+ # 临时覆盖走环境变量(RK3568_SYNC_*、RK3568_*_DIR)。
12
+ # ============================================================================
13
+
14
+ servers:
15
+ build-1:
16
+ host: <你的构建服务器IP或主机名>
17
+ port: 22
18
+ user: root
19
+ # 大仓快照多份并存;job params.ohos_root=latest 时按 glob 字典序取最新
20
+ # (与 flash.py sync-repo 的自动探测逻辑一致)
21
+ ohos_root_glob: /srv/workspace/openharmony_master_default_*/code
22
+ # 服务器侧运行目录:构建日志、完成标记、变更检测基准等
23
+ run_dir: /root/collab/e2e
24
+ cores: 48
25
+
26
+ boards:
27
+ rk3568-01:
28
+ product: rk3568 # OHOS 构建目标(build.sh --product-name)
29
+ transport: hdc # 预留:hdc | ssh
30
+ attached_to: local # 板子插在哪:local(本机桌面)| <servers 条目名>(预留多机)
31
+ hdc_target: "" # 留空=自动取唯一设备;多设备时 `hdc list targets` 查序列号填入
32
+ software_version: "7.1.0.25" # 期望 `param get const.product.software.version` 包含的串
33
+ # 推板前预检,不匹配即中止(禁止混基线;勿用 const.product.name,它谎报 3.2)
34
+ build_layout: packages/phone/system # 构建产物子树,与设备 device_root 同构:<rel> → /system/<rel>
35
+ device_root: /system
36
+ remount_cmd: mount -o remount,rw / # 根分区即 /(单 ext4 分区)时这样写;不同布局改这里
37
+ backup_dir: <你的推库备份目录> # 推库铁律:板上文件推送前必须先备份(长期留档目录)
38
+
39
+ x86-emu-01: # 服务器上的 x86_64_virt QEMU 模拟器(配方见 RUNBOOK「x86 模拟器大循环」)
40
+ product: x86_64_virt # 同工作区构建 → 产物即模拟器基线(代码与设备同源,无混基线问题)
41
+ transport: hdc
42
+ attached_to: build-1 # 实例跑在服务器;本机经 SSH 隧道访问(emulators 节 tunnel_local_port)
43
+ hdc_target: "127.0.0.1:15555" # 隧道落点;隧道未起时本条目不可用(先 ssh -N -L,见 RUNBOOK)
44
+ software_version: "7.1.0.25" # 镜像基线(与 rk3568-01 同版本列车)
45
+ build_layout: packages/phone/system
46
+ device_root: /system
47
+ tdd_lib_path: /system/lib64/platformsdk:/system/lib64:/lib:/usr/lib # x86_64 lib64 布局(tdd_board 步骤消费)
48
+ remount_cmd: mount -o remount,rw /system # 模拟器推库走 qcow2 overlay 更稳,见 RUNBOOK 坑位
49
+ backup_dir: <你的推库备份目录>/x86-emu-01
50
+
51
+ emulators: # 模拟器实例运维参数(启动/停止配方见 RUNBOOK「x86 模拟器大循环」)
52
+ x86-emu-01:
53
+ server: build-1
54
+ images_dir: <你的模拟器镜像目录> # 服务器上 x86_64_virt 工作区 out/…/packages/phone/images
55
+ profile: <你的QEMU profile 路径> # 原版改 cpu=Skylake-Client + memory 8192(QEMU ≥10 必须,勿回退 6.2)
56
+ qemu_binary: <你的QEMU 二进制路径> # 需源码自编(apt 6.2 TCG 跑不了 openhitls AVX2 产物)
57
+ instance: "00" # hdc=127.0.0.1:5555 / vnc=5921(服务器本地)
58
+ tunnel_local_port: 15555 # 本机 hdc tconn 127.0.0.1:<port>;VNC 同隧道 15921→5921
59
+
60
+
61
+ local:
62
+ # 本机(桌面)参数:调度器运行地、板卡物理宿主
63
+ hdc: C:/Program Files/oh_toolchain/toolchains/hdc.exe
64
+ # 备用 hdc:C:/Program Files/Huawei/DevEco Studio/sdk/default/openharmony/toolchains/hdc.exe
65
+ download_dir: <你的固件下载目录> # 固件包目录(= flash.py 的 RK3568_DOWNLOAD_DIR 缺省)
66
+ images_dir: <你的固件解压目录> # 固件解压目录(= flash.py 的 RK3568_IMAGES_DIR 缺省)
67
+ board_backup: <你的推库备份目录> # 板上文件推送前备份的长期目录(铁律 1)
68
+ sign_dir: <你的签名材料目录> # 测试应用离线签名材料目录(= sign_hap.py 的 SIGN_DIR 缺省)
@@ -0,0 +1,48 @@
1
+ # 问题分析报告:{{TASK_ID}}
2
+
3
+ > 自动汇编 draft(`collab.py close` → report_draft.py),机器填充「事实」节,
4
+ > `<TODO>` 标记处由主 Agent 复核润色后定稿。定稿改名 `report-final.md`。
5
+
6
+ - 任务:{{GOAL}}
7
+ - 状态:{{COLLAB_STATUS}}|迭代 {{ITERATIONS}} 轮|{{DEVICE_VERIFIED}}
8
+ - 分支/提交:{{BRANCH_COMMITS}}
9
+ - 日期:{{DATE}}
10
+
11
+ ## 1. 现象与复现
12
+
13
+ {{SYMPTOM}}
14
+
15
+ 复现步骤:{{REPRO}}
16
+
17
+ ## 2. 根因分析
18
+
19
+ <TODO:主 Agent 填写——定位链路(证据 → 怀疑点 → 排除/确认)、代码层根因、
20
+ 为什么会漏到现网(测试缺口 or 语义边界)>
21
+
22
+ ## 3. 修复方案
23
+
24
+ <TODO:主 Agent 填写——方案选择与理由(若有多方案写取舍)、改动面说明>
25
+
26
+ 改动文件:
27
+
28
+ {{FILES}}
29
+
30
+ ## 4. 验证结果(地面真值)
31
+
32
+ {{VERIFICATION}}
33
+
34
+ ## 5. 证据包
35
+
36
+ {{EVIDENCE}}
37
+
38
+ ## 6. 影响面与兼容性
39
+
40
+ <TODO:主 Agent 填写——受影响组件/API、ABI/行为兼容性、回归风险点>
41
+
42
+ ## 7. 遗留与后续
43
+
44
+ <TODO:遗留问题、后续工作项(issue/PR 链接)>
45
+
46
+ ## 参考
47
+
48
+ {{REFERENCES}}
@@ -0,0 +1,47 @@
1
+ # 功能实现报告:{{TASK_ID}}
2
+
3
+ > 自动汇编 draft(`collab.py close` → report_draft.py),机器填充「事实」节,
4
+ > `<TODO>` 标记处由主 Agent 复核润色后定稿。定稿改名 `report-final.md`。
5
+
6
+ - 任务:{{GOAL}}
7
+ - 状态:{{COLLAB_STATUS}}|迭代 {{ITERATIONS}} 轮|{{DEVICE_VERIFIED}}
8
+ - 分支/提交:{{BRANCH_COMMITS}}
9
+ - 日期:{{DATE}}
10
+
11
+ ## 1. 需求与验收标准
12
+
13
+ {{REQUIREMENT}}
14
+
15
+ ## 2. 方案设计
16
+
17
+ <TODO:主 Agent 填写——技术方案、关键设计决策与理由、与既有机制的关系>
18
+
19
+ ## 3. 实现内容
20
+
21
+ 改动文件:
22
+
23
+ {{FILES}}
24
+
25
+ Worker 执行报告(服务器侧细节):{{WORKER_REPORT_LINK}}
26
+
27
+ ## 4. 验证结果(地面真值)
28
+
29
+ {{VERIFICATION}}
30
+
31
+ ## 5. 证据包
32
+
33
+ {{EVIDENCE}}
34
+
35
+ ## 6. 交付物清单
36
+
37
+ - 交付代码:{{BRANCH_COMMITS}}(服务器工作区;推 fork / PR 为设备验证后的独立步骤)
38
+ - 部署产物清单:{{DEPLOY_ARTIFACTS}}
39
+ - 测试资产:{{TEST_ASSETS}}
40
+
41
+ ## 7. 遗留与后续
42
+
43
+ <TODO:已知限制、后续工作项(issue/PR 链接)>
44
+
45
+ ## 参考
46
+
47
+ {{REFERENCES}}
@@ -0,0 +1,21 @@
1
+ id: TASK_ID
2
+ repo: REPO_PATH_PLACEHOLDER
3
+ goal: <一句话目标>
4
+ budget: 5
5
+ build_targets: <部署产物构建 target,空格分隔(如 arkui_grid arkui_water_flow);纯分析/只读任务整行留空>
6
+ tdd_targets: <设备版 UT target(如 grid_test_ng;target 名查 test/<域>/BUILD.gn 的 ace_unittest 名);不改代码与用例则留空>
7
+
8
+ ## 现象(实测)
9
+ <设备侧观察到的错误行为>
10
+
11
+ ## 预期
12
+ <正确行为>
13
+
14
+ ## 复现步骤
15
+ <设备侧如何触发>
16
+
17
+ ## 证据
18
+ <context/ 下文件清单及各自说明>
19
+
20
+ ## 约束(可选)
21
+ <不许动的文件、兼容性要求、只读任务在此标注"只读分析,不改代码">
@@ -0,0 +1,31 @@
1
+ # ============================================================================
2
+ # 大循环 TDD 门 job spec(ROADMAP M2,铁律 8 机制化):rk3568 设备版 TDD 推板直跑全过
3
+ #
4
+ # 用法:
5
+ # python scripts/apply.py config/tdd-board.yaml plan --params tdd_targets=list_test_ng
6
+ # python scripts/apply.py config/tdd-board.yaml run --params tdd_targets=list_test_ng \
7
+ # ohos_root=/srv/workspace/<WS>/code # 全量(当前树 list_test_ng 全二进制 3662 例)
8
+ # python scripts/apply.py config/tdd-board.yaml run --params tdd_targets=list_test_ng \
9
+ # gtest_filter=ListScrollPlaceholderTestNg.* "expected_tests={list_test_ng: 24}" # 子套件 + 钉数
10
+ # expected_tests 语义 = 钉「本轮实际应跑过」的用例数(配 gtest_filter 时 = 过滤后计数),防子集跑绿。
11
+ # 占位家族已知子套件(RUNBOOK):ListScrollPlaceholderTestNg=24 / GridScrollPlaceholderTestNg=14 /
12
+ # WaterFlowScrollPlaceholderTestNg=10
13
+ # ============================================================================
14
+
15
+ job: tdd-board
16
+ description: 铁律 8 TDD 门——设备版构建 → stripped 产物 md5 校验推板 → 直跑全过判定
17
+
18
+ resources:
19
+ server: build-1
20
+ board: rk3568-01
21
+
22
+ params:
23
+ tdd_targets: []
24
+ ohos_root: latest
25
+ expected_tests: {} # {target: 全量用例数};不填则只要求 FAILED=0 且 PASSED>0
26
+
27
+ steps:
28
+ - name: tdd-board
29
+ type: tdd_board
30
+ build_timeout_min: 40 # rk3568 设备版单 target 增量 ~15 分钟,留余量
31
+ run_timeout_min: 15
@@ -0,0 +1,47 @@
1
+ # ============================================================================
2
+ # 小循环差分覆盖率 job spec(diffcov-20261111 落地):tdd_host coverage 模式的常开包装。
3
+ #
4
+ # 用途:worker 改码(大仓子仓)后,红绿灯之外回答「新增/修改分支是否被 TDD 用例实际踏到」。
5
+ # 全链:插桩构建(--gn-args use_clang_coverage=true)→ 跑套件(.gcda 随对象树落盘)
6
+ # → gcovr 转换(按改动目录收敛搜索路径)→ diffcov 差分(新增行 × 覆盖)→ 行级阈值判据。
7
+ #
8
+ # 用法:
9
+ # python scripts/apply.py config/tdd-coverage.yaml plan --params tdd_targets=ph-list ohos_root=/srv/workspace/<WS>/code
10
+ # python scripts/apply.py config/tdd-coverage.yaml run --params tdd_targets=ph-list ohos_root=/srv/workspace/<WS>/code
11
+ # # 提交过改动的(worker fix 分支):diff_base 传基线(快照点 sha 或分支名),git diff <base> 含已提交+未提交
12
+ # python scripts/apply.py config/tdd-coverage.yaml run --params tdd_targets=ph-list \
13
+ # ohos_root=/srv/workspace/<WS>/code diff_base=3dd622a666b
14
+ #
15
+ # 判据(细节与坑位见 RUNBOOK「TDD 差分覆盖率」节):
16
+ # - 行级是硬门(line_min,默认 100 = 新增可执行行零未覆盖);分支方向级仅参考
17
+ # (`if (cond) {X}` 无 else 时 guard false 方向不被踏 ≠ 缺陷,合成 A/B 判别力实测定稿)
18
+ # - 与红绿灯并集生效:套件挂照报覆盖(不拦报告),覆盖挂照出红绿灯
19
+ # - 服务器需 gcovr(pip3 install gcovr,实测 8.8);clang --coverage 大仓原生支持
20
+ # (build/config/coverage/BUILD.gn,旗标 -mllvm -limited-coverage-experimental 实测 clang 15.0.4 接受)
21
+ #
22
+ # 注意:
23
+ # - 插桩构建与非插桩构建来回切会触发对应 flag 集的增量重编(ccache 各自缓存,二轮起恢复增量速度)
24
+ # - gtest_filter 子集跑得到的覆盖只反映子集——差分覆盖建议全量跑(不带 filter)
25
+ # - 纯新增行跑前会自动删 obj 目录下旧 .gcda(.gcno 结构变更后合并写会 corrupt arc tag)
26
+ # ============================================================================
27
+
28
+ job: tdd-coverage
29
+ description: 小循环差分覆盖率——插桩构建 + host 跑套件 + 新增行差分覆盖判据(红绿灯并集)
30
+
31
+ resources:
32
+ server: build-1
33
+
34
+ params:
35
+ tdd_targets: [] # 套件别名(tdd-suites.yaml,如 ph-list)或裸 target 名
36
+ ohos_root: latest # = 验证目标工作区(/srv/workspace/<WS>/code)
37
+ expected_tests: {} # 钉数防子集跑绿(同 tdd-host.yaml 语义)
38
+ coverage: true # 本 job 常开(要关就跑 config/tdd-host.yaml)
39
+ diff_base: HEAD # git diff 基线:HEAD=未提交改动;worker 已提交改动传快照点 sha/分支名
40
+ diff_repos: [foundation/arkui/ace_engine] # 参与差分的子仓(可逗号分隔)
41
+ line_min: 100 # 行级覆盖阈值(100 = 新增可执行行零未覆盖;0 = 只报告不判据)
42
+
43
+ steps:
44
+ - name: tdd-host-cov
45
+ type: tdd_host
46
+ build_timeout_min: 45 # 插桩冷构建显著慢于普通增量(实测 ~24min 冷 / 44s 增量)
47
+ run_timeout_min: 15
@@ -0,0 +1,36 @@
1
+ # ============================================================================
2
+ # 大循环(模拟器通道)job spec(2026-11-16):x86_64_virt 设备版 TDD 推模拟器直跑全过
3
+ #
4
+ # 定位:铁律 8 板端门之前的**快速预验通道**——构建/推送/直跑全程在服务器内闭环
5
+ # (不经本机 scp、不占真板),模拟器绿后仍须过 tdd-board 板端门(地面真值)。
6
+ #
7
+ # 用法:
8
+ # python scripts/apply.py config/tdd-emulator.yaml plan --params tdd_targets=grid_test_ng
9
+ # python scripts/apply.py config/tdd-emulator.yaml run --params tdd_targets=grid_test_ng \
10
+ # gtest_filter=GridScrollPlaceholderTestNg.* "expected_tests={grid_test_ng: 14}"
11
+ #
12
+ # 前置(缺一不可,详见 RUNBOOK「x86 模拟器大循环」):
13
+ # 1) 服务器模拟器实例 00 已启动(qemu_run / qemu_launcher,QEMU 10.0.2 + tcg profile)
14
+ # 2) 本机隧道已起:ssh -N -L 15555:127.0.0.1:5555 -p <端口> root@<你的构建服务器IP或主机名>
15
+ # (端口/主机取 inventory servers.build-1;hdc list targets 应见 127.0.0.1:15555)
16
+ # 坑位:模拟器长时间挂机后可能被内存管理 SIGKILL 连锁至 reboot panic(4GB 实测 ~3h,
17
+ # 已调 8GB)——任务前建议 stop 后 -f 全新启动(顺带清 overlay 保证可复现)。
18
+ # ============================================================================
19
+
20
+ job: tdd-emulator
21
+ description: 大循环(模拟器通道)——x86_64_virt 设备版 TDD 推模拟器直跑全过判定(板端门前的快速预验)
22
+
23
+ resources:
24
+ server: build-1
25
+ board: x86-emu-01
26
+
27
+ params:
28
+ tdd_targets: []
29
+ ohos_root: latest # 按板 product=x86_64_virt 过滤快照(apply.py 2026-11-16 起支持);换快照时也可显式传
30
+ expected_tests: {} # {target: 全量用例数};不填则只要求 FAILED=0 且 PASSED>0
31
+
32
+ steps:
33
+ - name: tdd-emulator
34
+ type: tdd_board
35
+ build_timeout_min: 40 # 48 核首编全量 ~15 分钟;增量更快
36
+ run_timeout_min: 15
@@ -0,0 +1,26 @@
1
+ # ============================================================================
2
+ # 小循环 job spec(ROADMAP M2):host_product TDD 快反馈
3
+ #
4
+ # 用法(target 名查 test/<域>/BUILD.gn 的 ace_unittest 名;工作区路径来自 pool 占用登记):
5
+ # python scripts/apply.py config/tdd-host.yaml plan --params tdd_targets=grid_test_ng
6
+ # python scripts/apply.py config/tdd-host.yaml run --params tdd_targets=grid_test_ng \
7
+ # ohos_root=/srv/workspace/<WS>/code "expected_tests={grid_test_ng: 14}" # 可选:钉套件全量数
8
+ # 注意:宿主机绿不豁免板端门(铁律 8);大循环见 tdd-board.yaml。
9
+ # ============================================================================
10
+
11
+ job: tdd-host
12
+ description: 小循环——服务器 host_product 构建 + 直跑 TDD 套件,红绿判定(快反馈)
13
+
14
+ resources:
15
+ server: build-1
16
+
17
+ params:
18
+ tdd_targets: [] # 如 [grid_test_ng] 或空格分隔字符串
19
+ ohos_root: latest # 验证已提交代码时填工作区绝对路径(/srv/workspace/<WS>/code)
20
+ expected_tests: {} # 可选:{target: 全量用例数},防子集跑绿
21
+
22
+ steps:
23
+ - name: tdd-host
24
+ type: tdd_host
25
+ build_timeout_min: 30
26
+ run_timeout_min: 15
@@ -0,0 +1,34 @@
1
+ # ============================================================================
2
+ # TDD 套件注册表(ROADMAP M3)—— target/套件/用例数 按名引用,换套件不再现查 BUILD.gn
3
+ #
4
+ # apply.py 的 tdd_host / tdd_board 步骤按别名展开:
5
+ # python scripts/apply.py config/tdd-board.yaml run --params tdd_targets=ph-list
6
+ # → target=list_test_ng + gtest_filter=ListScrollPlaceholderTestNg.* + expected_tests=24
7
+ # 显式给定的 step/params 级 gtest_filter / expected_tests 优先于注册表。
8
+ #
9
+ # 字段:target(构建 target 名)、gtest_filter(子套件过滤,空=全量)、
10
+ # expected_tests(配 filter 时的应跑用例数)、notes。
11
+ # 新套件 = 加条目,不改代码(全量用例数随树演进,勿在此钉全量数)。
12
+ # ============================================================================
13
+
14
+ suites:
15
+ ph-list:
16
+ target: list_test_ng
17
+ gtest_filter: ListScrollPlaceholderTestNg.*
18
+ expected_tests: 24 # ListScrollPlaceholderTestNg(RUNBOOK 板端实测)
19
+ notes: List 占位家族;全二进制 3662 例(随树演进,仅参考)
20
+ ph-grid:
21
+ target: grid_test_ng
22
+ gtest_filter: GridScrollPlaceholderTestNg.*
23
+ expected_tests: 14 # GridScrollPlaceholderTestNg
24
+ notes: Grid 占位家族(ScrollingSet-GridAndGridItem)
25
+ ph-waterflow:
26
+ target: water_flow_test_original
27
+ gtest_filter: WaterFlowScrollPlaceholderTestNg.*
28
+ expected_tests: 10 # WaterFlowScrollPlaceholderTestNg
29
+ notes: WaterFlow 占位家族(ScrollingSet-Scroll)
30
+ scrollph-manager:
31
+ target: scroll_placeholder_manager_test_ng
32
+ gtest_filter: ""
33
+ expected_tests: 0 # 全量跑(数量随树演进,不钉)
34
+ notes: 占位管理器单测(ScrollingSet-ScrollPlaceholder,tdd-boundary-20261109 任务用)
@@ -0,0 +1,11 @@
1
+ # AGENTS.md
2
+
3
+ OpenHarmony DevLoop(简称 **DevLoop**)用户工作区(`ohos-devloop init` 生成)。任何 Coding Agent(Claude / Codex / opencode …)在本工作区协作时遵守以下约定:
4
+
5
+ - **CLI 即契约**:一切能力走 `ohos-devloop` 命令(`apply` / `collab` / `flash` / `server` / `check-env` / `report` / `sign` …),不要读写工具正本仓的内部文件;`ohos-devloop version` 可查工具版本。agent 技能副本已随 `init` 展开到 `~/.agents/skills/`(正本在包内 `ohos_devloop/agents/skills/`;手动刷新 = 删用户副本重跑 `ohos-devloop init`,`--no-skills` 可跳过展开)。
6
+ - **改码单一通道**:代码修改一律组任务契约交远端 code-worker——`ohos-devloop collab new <tid>` → 编辑 task.md → `push` → `run`(异步,`status` 轮询)→ `fetch` 回收。worker 禁一切 git push;推 fork 是设备验证通过后的人工步骤。
7
+ - **本机职责**:取证 / 推板 / 板端 TDD / 判定 / PR 操作,全部经 `ohos-devloop apply <spec> run`(每步结果落 `runs/<id>/results.json`)。
8
+ - **不绕过调度器**:推板保护链(基线预检 → 全量备份 → md5 校验)已固化在 push 步骤,不要用裸 hdc 手工推库。
9
+ - **留档即证据**:`tasks/<tid>/`(任务契约与回收产物)、`runs/<id>/`(执行档案);报告由 close 自动汇编,run 头行带工具版本戳。
10
+
11
+ 事故级铁律速查(细节见 QUICKSTART.md):hdc 退出码不可信,以产物 md5/bm dump 校验为准 | 不混基线(software_version 预检不匹配即中止)| 板上无 RTC,e2e 前跑 board_preflight 自动校时 | 改码/改 TDD 必过板端 TDD 门(宿主机跑绿不豁免)。
@@ -0,0 +1,82 @@
1
+ # OpenHarmony DevLoop QUICKSTART —— 从零到 smoke 绿(约半天)
2
+
3
+ **面向 OpenHarmony 的 Agent 驱动设备开发与验证闭环。** 从任务到真机验证,自动闭环。
4
+
5
+ ## 0. 安装工具(一次性)
6
+
7
+ ```bash
8
+ pipx install --editable <工具仓路径> # 独立 venv;普通源码变更可在工具仓 git pull 后生效
9
+ ohos-devloop version # 应输出包版本或 git describe
10
+ ```
11
+
12
+ 入口、包元数据、依赖或工具仓路径变化时须重新执行 `pipx install --editable <工具仓路径> --force`,不能只靠 `git pull`。
13
+
14
+ ### 从旧版 ohos-cowork 迁移
15
+
16
+ ```bash
17
+ pipx uninstall ohos-cowork
18
+ pipx install --editable <ohos-devloop 工具仓路径>
19
+ ohos-devloop version
20
+ ```
21
+
22
+ 旧 `ohos` 命令已退役,不提供兼容别名。已有 `ohos-workspace.yaml` 和 `OHOS_WS` 继续有效,无需重建工作区;已有工作区文档中的旧命令请改用 `ohos-devloop`。
23
+
24
+ ## 1. 生成并填写工作区(本目录)
25
+
26
+ `ohos-devloop init` 已生成骨架。编辑 `config/inventory.yaml`:
27
+
28
+ - `servers.build-1`:你的构建服务器 IP / 端口 / 用户(须已配 ssh 免密)
29
+ - `boards.rk3568-01`:`hdc list targets` 查序列号填 `hdc_target`;`software_version` 填板上实际基线
30
+ - `local.hdc`:本机 hdc.exe 路径(DevEco SDK toolchains 下)
31
+
32
+ **agent 技能**:`ohos-devloop init` 已把包内 agent 技能(collab-delegate / loop-iterate / openharmony-ci / pool-status)逐字复制到用户级 `~/.agents/skills/`——agent 框架(Claude / Codex / opencode …)天然发现,无需手工安装。正本在包内(`ohos_devloop/agents/skills/`);手动刷新 = 删除用户副本后重跑 `ohos-devloop init`(init 不覆盖已改副本,`--force` 也不覆盖);`--no-skills` 可跳过展开。
33
+
34
+ ## 2. 环境门禁
35
+
36
+ ```bash
37
+ ohos-devloop check-env # 逐项 PASS/WARN/FAIL;FAIL 清零再继续
38
+ ```
39
+
40
+ ## 3. 部署验收(服务器)
41
+
42
+ ```bash
43
+ ohos-devloop server init # 体检 → 部署 worker(md5 回验 + VERSION 戳)→ smoke 自动跑绿
44
+ ```
45
+
46
+ ## 4. 大仓工作区(改码任务前置,需先刷好基线固件)
47
+
48
+ ```bash
49
+ ohos-devloop flash fetch && ohos-devloop flash extract && ohos-devloop flash sync-repo <task-id>
50
+ ```
51
+
52
+ ## 5. 一轮标准迭代
53
+
54
+ ```bash
55
+ ohos-devloop collab new <tid> # 建任务契约(task.md 模板已就位)
56
+ # 编辑 task.md:goal/现象/预期/复现/证据/约束 + 头字段 build_targets/tdd_targets;证据放 context/
57
+ ohos-devloop collab push <tid> && ohos-devloop collab run <tid> # 异步;ohos-devloop collab status <tid> 轮询
58
+ ohos-devloop collab fetch <tid> # 回收 report/status/artifacts
59
+
60
+ # 验证链(小循环 → 大循环)
61
+ ohos-devloop apply config/tdd-host.yaml run --params tdd_targets=<别名> # host 快反馈
62
+ ohos-devloop apply config/tdd-board.yaml run --params tdd_targets=<别名> # 板端 TDD 门(必过)
63
+ ohos-devloop collab close <tid> # 释放工作区 + 自动汇编报告 draft
64
+ ```
65
+
66
+ > job spec 缺省在工具包里(config/*.yaml),工作区 `config/` 放同名文件即覆盖;TDD 套件别名见包内 `config/tdd-suites.yaml`(中央注册表随包分发,工作区同名可加条目/改钉数)。
67
+
68
+ ## 排查
69
+
70
+ - 每步结果落盘:`runs/<id>/results.json`(含工具版本戳,报障时附上 run 目录)
71
+ - 部署对账:服务器 `~/collab/bin/VERSION`
72
+ - 常见坑(校时/重签/基线)已固化进步骤,原理与排障见工具仓 RUNBOOK.md
73
+
74
+ ## 使用遥测(可选,beta 期建议开启)
75
+
76
+ ```bash
77
+ ohos-devloop telemetry on # opt-in 默认关;开启即打印收集范围
78
+ ohos-devloop telemetry push # 增量上报本地积压事件(失败保留、可重试)
79
+ ohos-devloop telemetry status # 看开关/积压/端点
80
+ ```
81
+
82
+ 只收命令名/退出码/耗时、job 与步骤结果(PASS/FAIL/错误类别)、任务收敛轮数、check_env 汇总计数、工具版本;**不收**代码、任务内容、命令参数值、日志正文、路径。数据用于 beta 期定位共性卡点(onboarding 漏斗/失败 TopN),GA 前修复优先级由它决定。可随时 `telemetry off`。
@@ -0,0 +1,45 @@
1
+ # ============================================================================
2
+ # 缺省 job spec:一轮「构建 → 识别变更产物 → 取回 → 推板 → 采集验证证据」
3
+ #
4
+ # resources 引用 inventory.yaml 的条目名;步骤按序执行,每步结构化结果
5
+ # 写 runs/<run-id>/results.json(每步落盘,可被外部轮询)。
6
+ # 判定(vision judge / 断言 DSL)为后续演进;当前 verify 步骤只做证据采集。
7
+ # ============================================================================
8
+
9
+ job: e2e-push
10
+ description: 全量构建大仓 → 找出新产物(.so/.abc) → 取回本机 → 推板(备份→写入→md5校验) → 截图/hilog 取证
11
+
12
+ resources:
13
+ server: build-1
14
+ board: rk3568-01
15
+
16
+ params:
17
+ ohos_root: latest # latest = 按 server.ohos_root_glob 探测最新快照;或填服务器绝对路径
18
+ build_command: "" # 空 = 用 steps.build.command;可整条覆盖(如增量 ninja 定向构建)
19
+ artifacts: [] # build_layout 相对路径列表(如 lib/platformsdk/libace_napi.z.so),
20
+ # 或指向清单 txt(一行一个相对路径,# 注释);空 = 由 detect-changed 自动生成
21
+ reboot_after_push: true # 推库后重启验证系统健康 + 校时(板上无 RTC,重启后时钟回 2017)
22
+ marker: "" # 预留:验证阶段在 hilog 中 grep 的标记串(当前未使用)
23
+
24
+ steps:
25
+ - name: build
26
+ type: build
27
+ command: ./build.sh --product-name rk3568 --ccache
28
+ mode: detach # detach = 服务器 nohup + 轮询(断 ssh 不死);block = 同步等待
29
+ timeout_min: 300
30
+
31
+ - name: detect-changed
32
+ type: detect_changed # 以 build 开始前的服务器时间戳为基准,找新增/更新的产物
33
+ patterns: ["*.so", "*.abc"]
34
+
35
+ - name: fetch
36
+ type: fetch # 从服务器取产物到 <run>/fetch/<rel>
37
+
38
+ - name: push
39
+ type: push # 推库铁律固化在此:基线预检 → 全量备份 → remount → 写入 → md5 校验 → chmod/sync
40
+
41
+ - name: verify
42
+ type: capture # 证据采集到 <run>/evidence/(判定由人或后续 vision judge 做)
43
+ shots: 2
44
+ shot_interval_s: 3
45
+ hilog: true
@@ -0,0 +1,55 @@
1
+ # 锚定类缺陷复验配方(M4 实战沉淀,2026-11-11 grid-mvcp round-4 首用即全绿)
2
+ # 用法:python scripts/apply.py examples/anchor-e2e.yaml run
3
+ # 适配其他用例改 restart-app 的 bundle/ability 与断言的 selector/expect 即可
4
+ resources:
5
+ board: rk3568-01
6
+ steps:
7
+ - name: restart-app
8
+ type: shell
9
+ where: board
10
+ command: aa force-stop com.ohoscowork.gridmvcp; sleep 1; aa start -a EntryAbility -b com.ohoscowork.gridmvcp
11
+ - name: wait-launch
12
+ type: shell
13
+ where: local
14
+ command: sleep 12
15
+ - name: base-evidence
16
+ type: capture
17
+ shots: 1
18
+ hilog: false
19
+ layout: true # layout_0.json 基线树
20
+ - name: keep-base-shot
21
+ type: shell
22
+ where: local
23
+ command: cp {run_dir}/evidence/shot_0.jpeg {run_dir}/evidence/shot_base.jpeg
24
+ - name: prepend-1
25
+ type: ui_click
26
+ selector: { text_re: "^Prepend" }
27
+ settle_s: 2
28
+ - name: assert-first-click
29
+ type: assert
30
+ assertions:
31
+ - { kind: node, layout: "evidence/layout_last.json",
32
+ selector: { type: GridItem, region: [0, 200, 720, 1280] },
33
+ fact: text, expect: "^item-0-" } # 锚定:首项仍是 item-0 行
34
+ - { kind: node, layout: "evidence/layout_last.json",
35
+ selector: { type: GridItem, region: [0, 200, 720, 1280] },
36
+ fact: top_y, op: le, expect: 260 } # 几何:未跳顶(new-x 行在 y=200 顶部)
37
+ - name: prepend-2
38
+ type: ui_click
39
+ selector: { text_re: "^Prepend" }
40
+ settle_s: 2
41
+ - name: assert-second-click
42
+ type: assert
43
+ assertions:
44
+ - { kind: node, layout: "evidence/layout_last.json",
45
+ selector: { type: GridItem, region: [0, 200, 720, 1280] },
46
+ fact: text, expect: "^item-0-" } # 连续第二次点击仍锚定(用户手工测试场景)
47
+ - name: after-evidence
48
+ type: capture
49
+ shots: 1
50
+ hilog: true
51
+ - name: assert-render
52
+ type: assert
53
+ assertions:
54
+ - { kind: frame_diff, shot_a: "shot_base.jpeg", shot_b: "shot_0.jpeg",
55
+ max_diff_ratio: 0.02, tolerance: 12 } # 渲染层:除顶部计数文字外应近乎一致
@@ -0,0 +1,33 @@
1
+ # ============================================================================
2
+ # assert 步骤自测(ROADMAP M1/M4):不连任何机器,验证本地断言种类与判定语义。
3
+ # 用法:python scripts/apply.py examples/assert-smoke.yaml run
4
+ # node 断言用提交内 fixture(examples/layout-fixture.norm.json 标准形)。
5
+ # ============================================================================
6
+
7
+ job: assert-smoke
8
+ description: assert 判定步骤自测(纯本地:file_exists / text / node 组件树正反例)
9
+
10
+ resources: {} # 无 server / 无 board
11
+
12
+ params: {}
13
+
14
+ steps:
15
+ - name: assert-local
16
+ type: assert
17
+ assertions:
18
+ # run_dir 在 runs/<id>/ 下,仓库根相对路径为 ../../
19
+ - { kind: file_exists, path: "../../README.md", expect: present }
20
+ - { kind: file_exists, path: "../../不存在文件.xyz", expect: absent }
21
+ - { kind: text, path: "../../RUNBOOK.md", pattern: "铁律", expect: match }
22
+ - { kind: text, path: "../../RUNBOOK.md", pattern: "绝不匹配的串zzz999", expect: no_match }
23
+ # node:UI 树断言(fixture 标准形;rollup 定位 GridItem 后代 Text)
24
+ - { kind: node, layout: "../../examples/layout-fixture.norm.json",
25
+ selector: { type: GridItem, region: [0, 200, 720, 1280] },
26
+ fact: text, expect: "^item-0-" }
27
+ - { kind: node, layout: "../../examples/layout-fixture.norm.json",
28
+ selector: { type: GridItem }, fact: count, expect: 3 }
29
+ - { kind: node, layout: "../../examples/layout-fixture.norm.json",
30
+ selector: { type: GridItem }, fact: top_y, op: le, expect: 200 }
31
+ # 反例:不存在的选择器命中 0 个(count=0 语义本身是合法断言)
32
+ - { kind: node, layout: "../../examples/layout-fixture.norm.json",
33
+ selector: { text_re: "^zzz-none" }, fact: count, expect: 0 }