Files
2026-11-16 17:26:44 -08:00

36 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Feature → Eddy 导出:卫星机 worker
`worker.py` 随 satellite bundle 分发,由 `satellite/src/eddy_export.ts` 在每个导出作业目录
(`$EDDY_EXPORT_ROOT/<exportId>/`,默认 `~/.streamline/eddy-exports`)里按阶段调用。整体流程、配置和排查见
[docs/eddy/feature-export.md](../../docs/eddy/feature-export.md)。
| 阶段 | 谁做 | 做什么 |
| --- | --- | --- |
| `checkout` | worker | 拉官方 Eddy runtime(`eddy/LATEST`,校验后只复制分发清单);独立 clone 产品仓,在分支名上检出固定提交(`git checkout -B <分支> <提交>`),源码包从这里出 |
| 固定共享检出 | `eddy_export.ts` | 把节点共享检出(`$AI_WORKSPACE/TikTok`)fetch 并清理(与验证任务同一个 `checkoutChangeCommit`),再在分支名上检出固定提交(`pinBranch`;`airb sync` 按分支名取提交) |
| 构建 | 智能体 | 按 DeviceSim 的 `Skill(airbuild)` 在共享检出上、用它已绑定的 airspace 远程构建(不 `airb init`、不 `airb release`),把产物拉到 `build/`,写 `airbuild-receipt.json`(`satellite/src/eddy_export_build.ts`) |
| `collect` | worker | 只认:独立 clone 和共享检出都在固定提交且无改动、`build/` 里恰好是声明的 `.app`、回执的产品与提交一致 |
| `packaging` | worker | 在作业自己的 `DEVICESIM_ROOT` 里装好 DeviceSim(.18 及以前的 runtime 用包里自带的;之后的 runtime 不带,从 DeviceSim 官方渠道下载最新 stable),用它(`cat-supervisor install --skip-tcc`)准备 App,打 App ZIP 与源码 ZIP,写入接力文档和来源 |
| `verifying` | worker | 在作业自己的 Eddy state 里安装 ZIP、启动并 smoke |
| `cleanup` | worker | 停掉 smoke 启动的 App |
这里**没有构建脚本**:怎么构建 TikTok / TikTokNotes / Whee 只写在 DeviceSim airbuild skill 的「工程专用」里,
和节点上修复/验证任务出包是同一份说明。构建什么(Eddy key、产物名、启动参数)由任务的 product profile 在
`shared/src/eddy_export.ts` 的 `EDDY_EXPORT_PRODUCTS` 里查到。
Eddy 与 cat-supervisor 默认使用机器级目录(`/Users/Shared/DeviceSim`、`~/iosapp`),节点自己的智能体也在用。
worker 把 `DEVICESIM_ROOT`、`EDDY_STATE_DIR` 和打包实例目录都指到作业目录里,导出不会切换或触碰它们。
## 测试
```bash
python3 -m unittest discover -s satellite/eddy-export -v
```
可选真实工具链测试(macOS):用一个最小扁平 Catalyst App 代替构建智能体,经官方 runtime 自带的 cat-supervisor
打包并导入 Eddy,不启动 App。`EDDY_EXPORT_TEST_RUNTIME` 指向解压后的官方 runtime(含 `MANIFEST.json` 的目录):
```bash
EDDY_EXPORT_TEST_RUNTIME=/path/to/eddy-runtime python3 -m unittest discover -s satellite/eddy-export -v
```