From 8369b7e95184c2c5a6cea664dfe9758d5aac31ea Mon Sep 17 00:00:00 2001 From: d-robotics Date: Tue, 15 Sep 2026 08:26:09 +0800 Subject: [PATCH] Restore local dev toolkit (recovered after working copy loss) - scripts/local/env-local.sh + run-operator.sh (verified working again) - local-samples for json_to_csv + video_slice - docs/local-dev-guide.zh-CN.md + docs/release-checklist.zh-CN.md --- .gitignore | 4 + docs/local-dev-guide.zh-CN.md | 149 +++++++++++++++++++++ docs/release-checklist.zh-CN.md | 109 +++++++++++++++ local-samples/json_to_csv/input.json | 14 ++ local-samples/json_to_csv/sample-data.json | 7 + local-samples/video_slice/input.json | 16 +++ local-samples/video_slice/sample-video.mp4 | Bin 0 -> 36892 bytes scripts/local/env-local.sh | 28 ++++ scripts/local/run-operator.sh | 131 ++++++++++++++++++ 9 files changed, 458 insertions(+) create mode 100644 docs/local-dev-guide.zh-CN.md create mode 100644 docs/release-checklist.zh-CN.md create mode 100644 local-samples/json_to_csv/input.json create mode 100644 local-samples/json_to_csv/sample-data.json create mode 100644 local-samples/video_slice/input.json create mode 100644 local-samples/video_slice/sample-video.mp4 create mode 100755 scripts/local/env-local.sh create mode 100755 scripts/local/run-operator.sh diff --git a/.gitignore b/.gitignore index 2e2f6473..4f6711ac 100644 --- a/.gitignore +++ b/.gitignore @@ -14,3 +14,7 @@ docs.zip __pycache__/ *.py[cod] .operator-source-repos/ + +# 本地单算子调试产物 +local-runs/ +.venv/ diff --git a/docs/local-dev-guide.zh-CN.md b/docs/local-dev-guide.zh-CN.md new file mode 100644 index 00000000..a511014c --- /dev/null +++ b/docs/local-dev-guide.zh-CN.md @@ -0,0 +1,149 @@ +# 本地开发调试指南(macOS / 隔离环境) + +本指南描述如何在不接触公司集群的前提下,在本机完成单功能开发与调试。环境搭建背景见仓库根目录 `README.md`,业务概念见 `docs/platform-usage-manual.zh-CN.md`。 + +## 0. 隔离边界(先读这个) + +| 事项 | 规则 | +| --- | --- | +| MongoDB | 只用本机容器 `fanyu-mongo`(`127.0.0.1:27017`),绝不指向公司实例 | +| Kubernetes | 不导出 `KUBECONFIG`、不使用 `fanyu.conf`;发布走 `docs/release-checklist.zh-CN.md` 且须同事确认 | +| BOS / AI | 本地全部留空禁用;数据源一律用本地路径(`local-samples/`) | +| 镜像仓库 | 本地构建演练不登录、不推送;推送发布见发布清单 | + +## 1. 环境准备(已完成则跳过) + +```bash +# 工具链(一次性) +brew install go colima docker docker-buildx ffmpeg mongosh +colima start --cpu 4 --memory 6 --vm-type vz --vz-rosetta + +# 本地 MongoDB(只绑 127.0.0.1;--restart 保证 colima/VM 重启后自动跟随启动) +docker run -d --name fanyu-mongo --restart unless-stopped -p '127.0.0.1:27017:27017' -v fanyu-mongo-data:/data/db mongo:7 + +# Python 算子依赖(公司网络下 pip 默认源不可用,用阿里镜像) +python3 -m venv .venv +.venv/bin/pip install -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com -r requirements-dev.txt + +# Go 模块代理(公司网络下 proxy.golang.org 不可用) +go env -w GOPROXY=https://goproxy.cn,direct + +# 前端依赖 +npm install +``` + +注意事项(踩过的坑): + +- **Go 进程不读取 `.env.local`**:仓库没有 godotenv,`MONGO_URI` 等变量必须 shell 导出。 +- **colima VM 内 DNS 可能失效**(`systemd-resolved` 未安装导致 resolv.conf 指向不存在的 stub)。症状:`docker pull` 报 `lookup ... on [::1]:53: connection refused`。修复:`colima ssh -- sudo sh -c 'printf "nameserver 202.4.130.100\nnameserver 202.4.130.101\n" > /etc/resolv.conf'`。 +- **Docker Hub 直连超时**:改走国内镜像 `docker pull docker.m.daocloud.io/library/mongo:7` 再 `docker tag` 回 `mongo:7`。 +- **colima 每次重建 VM 后要重配两样**:VM 内 DNS(见上文修复命令)和 docker daemon 的 registry mirror(`colima ssh -- sudo sh -c 'printf ... > /etc/docker/daemon.json && systemctl restart docker'`)。建议保持 `--vm-type vz --vz-rosetta` 参数启动。 +- 日常启停:`colima start` / `colima stop`。Mongo 容器已设 `--restart unless-stopped`,会随 docker daemon 自动跟随启动;只有 colima VM 被**删除重建**(`colima delete`)后容器才会丢,需要按上面命令重建。 +- **API 报 `server selection timeout ... connection refused`** = 27017 没人监听:`docker start fanyu-mongo`(先确认 `colima status` 是 running)。API 进程本身不会死,Mongo 恢复后立即自愈,无需重启 `npm run dev`。 + +## 2. 启动本地平台(API + 前端) + +```bash +source scripts/local/env-local.sh # 每个新 shell 都要先 source +npm run dev # API :3001 + Vite :5173 +``` + +- 浏览器打开 `http://127.0.0.1:5173`,首次用「创建超管账号」入口建一个本地管理员(如 `admin@local.dev`)。 +- 已验证可用:登录/会话、CSRF 双提交写保护、算子目录(111 个)、存储连接、项目、工作流(含节点)全套 CRUD。 +- **预期边界**:不启动 worker(`npm run dev:full` 本地起不来——worker 启动必须有 kubeconfig)。页面上点"运行"后 Run 会停在 `queued`,这是轻量层的正常行为。如需本地端到端,需另行搭建本地迷你 K8s(kind/colima-k8s),属于后续升级项。 + +写接口的 curl 调试需带 CSRF(与线上一致): + +```bash +curl -c /tmp/c.txt -X POST http://127.0.0.1:3001/api/auth/login \ + -H 'Content-Type: application/json' \ + -d '{"email":"admin@local.dev","password":"..."}' +csrf=$(grep droboticflow_csrf /tmp/c.txt | awk '{print $NF}') +curl -b /tmp/c.txt -X POST http://127.0.0.1:3001/api/projects \ + -H 'Content-Type: application/json' -H "X-Droboticflow-CSRF-Token: $csrf" \ + -d '{"name":"...","storageConnectionId":"","storageBucket":"..."}' +``` + +## 3. 单算子一键调试(核心工作流) + +```bash +scripts/local/run-operator.sh [输入artifact列表JSON文件] +``` + +- `` 是 `operator-repos/builtin/` 下的目录名;脚本自动读取 `operator.json` / `runtime_contract.json` 的 handler,用与 worker 在 K8S Job 里**完全相同的方式**调用 `backend/operator-runner/main.py`。 +- 产物固定写入 `local-runs//<时间戳>/`(已 .gitignore):`outputs/`、`result.json`、`stage-manifest.json`。 +- 默认输入:`local-samples//input.json`(存在时)。 +- 附加超参:`OPERATOR_EXTRA_HYPERPARAMS='[{"key":"SEGMENT_DURATION_SECONDS","value":"4"}]'`。 +- 已内置样例:`json_to_csv`(3 行 JSON→CSV)与 `video_slice`(本地 10 秒测试视频→3 段虚拟切片)。 + +**改算子源码的调试循环**(不需要任何镜像构建): + +```bash +# 1. 直接改 operator-repos/builtin//src/operator.py +# 2. run-operator.sh 默认通过 DROBOTICFLOW_OPERATOR_SOURCE 直指这份源码,立即验证 +scripts/local/run-operator.sh +# 3. 验证通过后,同步镜像副本(否则 operators:manifests:check 会挂): +npm run operators:repos +``` + +## 4. 分层测试命令 + +| 层 | 命令 | 说明 | +| --- | --- | --- | +| 单算子 | `scripts/local/run-operator.sh ` | 真实执行,秒级 | +| 单算子单测 | `.venv/bin/python -m pytest backend/operator-runner -k <关键词>` | 或 `tests/backend/<某算子>_test.py` | +| Go 全量 | `npm test`(= `go test ./...`) | 不需要 Mongo/集群 | +| Python 全量 | `npm run test:python` | 用系统 python3;建议先 `source .venv/bin/activate` | +| 前端 | `npm run test:frontend` | node --test,无需浏览器 | +| 总闸门 | `npm run verify:local` | lint + 全部测试 + 构建 + k8s 清单 dry-run | + +## 5. 算子发布链本地演练(无 docker) + +内置算子的正式发布流程是"改码 → 生成仓库清单 → 构建镜像 → digest 钉版 → 目录同步 → reconcile"。本地可以演练全部**不碰 docker** 的环节: + +```bash +npm run operators:repos # 同步 operator-repos 与 backend 镜像副本 +python3 scripts/update_operator_release_manifests.py --slug \ + --image --image-id # 钉版(digest 来自实际构建) +npm run operators:images # 重新生成算子目录/镜像契约 +npm run operators:images:check # 一致性闸门,必须通过 +``` + +## 6. 镜像构建演练(本地、不推送) + +公司网络下四个拦路虎及解法: + +1. **基础镜像拉不下来**(Docker Hub 直连超时):先 `docker pull docker.m.daocloud.io/library/<镜像>` 再 `docker tag` 回标准名(golang:1.24-bookworm、node:22-alpine、debian:bookworm-slim、python:3.11-slim 都需要)。 +2. **构建时 `go mod download` 超时**:Dockerfile 里默认 `GOPROXY=proxy.golang.org` 被墙,构建时必须传 `--build-arg GOPROXY=https://goproxy.cn,direct`。 +3. **apt/pip 下载超时**(operator-runner 镜像重灾区):用本机代理 `127.0.0.1:7890`。colima 容器里访问宿主机代理要用 VM 网关地址(`colima ssh -- ip route | grep default`,当前为 `192.168.5.2`),以 `--build-arg http_proxy=http://192.168.5.2:7890` 注入(docker 的 http_proxy/https_proxy build-arg 无需 Dockerfile 声明即自动生效)。 +4. **QEMU 交叉编译 Go 会段错误**:colima 需用 `--vm-type vz --vz-rosetta` 启动(Rosetta 模拟 amd64 接近原生速度)。 + +因此公司网络内的本地构建演练用 docker 原生命令(`scripts/build-and-push-images.sh` 未透传 GOPROXY/代理,直接跑会卡在 go mod download 或 pip): + +```bash +PROXY=http://192.168.5.2:7890 # colima VM 看到的宿主机代理地址 + +docker build -f Dockerfile.worker --platform linux/amd64 \ + --build-arg GOPROXY=https://goproxy.cn,direct -t droboticflow-worker:localtest . +docker build -f Dockerfile.drosync-coordinator --platform linux/amd64 \ + --build-arg GOPROXY=https://goproxy.cn,direct -t drosync-coordinator:localtest . +docker build -f Dockerfile.api --platform linux/amd64 \ + --build-arg GOPROXY=https://goproxy.cn,direct \ + --build-arg http_proxy=$PROXY --build-arg https_proxy=$PROXY \ + -t droboticflow-api:localtest . +docker build -f Dockerfile.operator-runner --platform linux/amd64 \ + --build-arg http_proxy=$PROXY --build-arg https_proxy=$PROXY \ + -t droboticflow-operator-runner:localtest . + +# 验证产物架构 +docker image inspect droboticflow-operator-runner:localtest --format '{{.Os}}/{{.Architecture}}' +``` + +> 注:真正推送发布时走 `scripts/build-and-push-images.sh`(见发布清单)——如果届时也卡在 go mod download / pip,可先与同事确认是否把代理 build-arg 透传进脚本,或临时在本机代理开着的状态下用上面的原生命令构建后手动 `docker push`。 + +## 7. 常见问题 + +- **`go run` 卡在下载依赖**:确认 `go env GOPROXY` 是 `https://goproxy.cn,direct`。 +- **pytest 报 numpy/cv2 缺失**:用 `.venv/bin/python -m pytest` 而不是裸 `pytest`。 +- **算子报"无法获取真实输入文件"**:检查 input.json 里 `items[].path`(文件级 path 是算子找源的入口,不是 artifact 顶层 path)。 +- **API 起不来报 Mongo 连接失败**:`docker start fanyu-mongo`,确认 `mongosh --host 127.0.0.1` 能 ping。 diff --git a/docs/release-checklist.zh-CN.md b/docs/release-checklist.zh-CN.md new file mode 100644 index 00000000..55854823 --- /dev/null +++ b/docs/release-checklist.zh-CN.md @@ -0,0 +1,109 @@ +# 发布清单与回滚预案(公司集群 droboticflow-fanyu) + +> 本清单在**本地全绿 + 同事确认之后**才执行。发布顺序不可颠倒;每一步失败就停下排查,不带病前进。 + +## 0. 前置闸门(发布日前逐项打勾) + +- [ ] `npm run verify:local` 全绿(lint + Go + Python + 前端 + 构建 + 清单 dry-run) +- [ ] 涉及的算子用 `scripts/local/run-operator.sh ` 实测通过 +- [ ] 改过 `operator-repos/**` 的,`npm run operators:images:check` 通过 +- [ ] 代码已 push 到 Gitea(无账号时:`git format-patch origin/dev -o /tmp/` 交同事代推/评审) +- [ ] **同事已在 Gitea/补丁上评审确认**(必要条件,不满足则不发) +- [ ] 已确认目标 namespace:`droboticflow-fanyu`;已和同事约定发布时间窗口(避开采集高峰) +- [ ] 集群当前无进行中的重要 Run(平台监控页确认) + +## 1. 记录回滚锚点(发布前必做) + +```bash +export KUBECONFIG=/Users/d-robotics/Desktop/fanyu/fanyu.conf # 仅发布 shell 会话内 +kubectl -n droboticflow-fanyu get deploy \ + -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{range .spec.template.spec.containers[*]}{" image: "}{.image}{"\n"}{end}{end}' \ + | tee /tmp/rollback-images-$(date +%Y%m%d-%H%M).txt +``` + +> 注意:api/worker 的镜像记录在 Deployment env(`DROBOTICFLOW_IMAGE`、`OPERATOR_RUNNER_IMAGE`)里且带 digest;回滚清单要同时抓 env 里的这几项。把这份文件连同本次发布说明一起存档。 + +## 2. 构建并推送镜像(公网端点) + +```bash +docker login ccr-29eug8s3-pub.cnc.bj.baidubce.com +# 凭据:用户 ccr$fanyu(见本地 source.md;只存在本机 docker 凭据库,绝不进代码) +REGISTRY_HOST=ccr-29eug8s3-pub.cnc.bj.baidubce.com \ +REGISTRY_NAMESPACE=fanyu \ +IMAGE_TAG=$(git rev-parse --short HEAD) \ + ./scripts/build-and-push-images.sh +``` + +- 产出 4 个镜像:`droboticflow-api` / `droboticflow-worker` / `drosync-coordinator` / `droboticflow-operator-runner`(自动交叉构建 linux/amd64)。 +- 取 digest 备用: + +```bash +for img in droboticflow-api droboticflow-worker drosync-coordinator droboticflow-operator-runner; do + docker buildx imagetools inspect \ + ccr-29eug8s3-pub.cnc.bj.baidubce.com/fanyu/$img:$(git rev-parse --short HEAD) \ + | grep Digest +done +``` + +- 只改了算子(没改平台代码)时可以只发算子镜像,其余保持旧 digest 不动——**最小变更原则**。 +- 公司网络下若卡在 go mod download / pip:以 `--build-arg http_proxy=http://:7890` 注入本机代理构建(见 local-dev-guide 第 6 节),构建完手动 `docker push`。 + +## 3. 部署到公司集群(VPC 端点 + digest 钉版) + +```bash +export KUBECONFIG=/Users/d-robotics/Desktop/fanyu/fanyu.conf +VPC=ccr-29eug8s3-vpc.cnc.bj.baidubce.com +TAG=$(git rev-parse --short HEAD) + +K8S_NAMESPACE=droboticflow-fanyu \ +API_IMAGE=$VPC/fanyu/droboticflow-api@sha256: \ +WORKER_IMAGE=$VPC/fanyu/droboticflow-worker@sha256: \ +DROSYNC_COORDINATOR_IMAGE=$VPC/fanyu/drosync-coordinator@sha256: \ +OPERATOR_RUNNER_IMAGE=$VPC/fanyu/droboticflow-operator-runner@sha256: \ +CREATE_REGISTRY_SECRET=false \ + ./scripts/deploy-k8s.sh +``` + +要点: + +- `MONGO_URI` 不传:脚本自动从集群现有 `droboticflow-mongo-secret` 回读。 +- `CREATE_REGISTRY_SECRET=false`:复用集群现有 `droboticflow-registry` 拉取密钥,命令行不出现任何明文凭据。 +- 脚本内部是 `kubectl apply` + `rollout status` 等待,可安全重跑。 +- GPU/Qwen 相关变量(`OPERATOR_GPU_NODE_SELECTOR` 等)当前由集群 ConfigMap 提供,不在本次发布中改动。 + +## 4. 发布后验证 + +```bash +# 1) rollout 就绪 + 健康 +kubectl -n droboticflow-fanyu get pods +curl -s http://120.48.180.80/api/health && curl -s http://120.48.180.80/api/ready + +# 2) 构建 commit 与预期一致 +curl -s http://120.48.180.80/api/health | python3 -m json.tool | grep -i commit + +# 3) 平台冒烟:登录、跑一条最小工作流(或按变更范围跑对应验收) +``` + +## 5. 回滚预案 + +症状(任一):健康检查失败、run 大面积失败、镜像拉取失败。 + +```bash +# 用第 1 步存档的旧 digest 重跑同一脚本即回滚(rolling update 回旧镜像) +export KUBECONFIG=/Users/d-robotics/Desktop/fanyu/fanyu.conf +K8S_NAMESPACE=droboticflow-fanyu \ +API_IMAGE=<旧api镜像@digest> WORKER_IMAGE=<旧worker镜像@digest> \ +DROSYNC_COORDINATOR_IMAGE=<旧drosync镜像@digest> \ +OPERATOR_RUNNER_IMAGE=<旧runner镜像@digest> \ +CREATE_REGISTRY_SECRET=false ./scripts/deploy-k8s.sh +``` + +- 算子级回滚:`git revert` 对应 `operator-repos/builtin//release.json` 的提交,重跑 `npm run operators:images` + reconcile,把线上算子目录拨回旧 digest。 +- 数据安全:deploy 只滚动更新 Deployment,不动 Mongo 数据与 BOS 对象;回滚后 Run 历史仍完整可查。 +- 回滚后立即通知同事并在发布记录里写明原因。 + +## 6. 代码评审通道(Gitea 权限待定期间) + +- 有推送权限:`git push origin feature/<名字>` → Gitea 上发起合并到 `dev` → 同事评审。 +- 暂无权限:`git format-patch origin/dev -o /tmp/patches/`,把补丁目录交同事 `git am` 代推;或直接把分支推到个人 fork。 +- 线上 `dev` 分支与集群部署版本可能存在少量提交差,发布前与同事对齐目标基线,避免把未验证提交带上线。 diff --git a/local-samples/json_to_csv/input.json b/local-samples/json_to_csv/input.json new file mode 100644 index 00000000..fe44231e --- /dev/null +++ b/local-samples/json_to_csv/input.json @@ -0,0 +1,14 @@ +[ + { + "name": "sample-data.json", + "type": "json", + "path": "local-samples/json_to_csv/sample-data.json", + "data": { + "items": [ + {"filename": "a.mp4", "duration": 12.5, "label": "walk"}, + {"filename": "b.mp4", "duration": 30.0, "label": "run"}, + {"filename": "c.mp4", "duration": 7.25, "label": "jump"} + ] + } + } +] diff --git a/local-samples/json_to_csv/sample-data.json b/local-samples/json_to_csv/sample-data.json new file mode 100644 index 00000000..18e326ad --- /dev/null +++ b/local-samples/json_to_csv/sample-data.json @@ -0,0 +1,7 @@ +{ + "items": [ + {"filename": "a.mp4", "duration": 12.5, "label": "walk"}, + {"filename": "b.mp4", "duration": 30.0, "label": "run"}, + {"filename": "c.mp4", "duration": 7.25, "label": "jump"} + ] +} diff --git a/local-samples/video_slice/input.json b/local-samples/video_slice/input.json new file mode 100644 index 00000000..fa500169 --- /dev/null +++ b/local-samples/video_slice/input.json @@ -0,0 +1,16 @@ +[ + { + "name": "sample-video.mp4", + "type": "json", + "data": { + "items": [ + { + "filename": "sample-video.mp4", + "path": "/Users/d-robotics/Desktop/fanyu/droboticflow/local-samples/video_slice/sample-video.mp4", + "duration": 10.0, + "label": "test" + } + ] + } + } +] \ No newline at end of file diff --git a/local-samples/video_slice/sample-video.mp4 b/local-samples/video_slice/sample-video.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..7ff6cb7f899882dfb231443a7b6d1bf15f62bd3b GIT binary patch literal 36892 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 [输入文件或目录] +# +# 示例: +# scripts/local/run-operator.sh json_to_csv local-samples/json_to_csv/input.json +# scripts/local/run-operator.sh video_slice local-samples/video_slice/input.json +# +# 说明: +# - 是 operator-repos/builtin/ 下的目录名(如 video_slice) +# - 输入文件是 JSON Artifact 列表(形如 [{"name":..., "path":..., "type":...}, ...]); +# 若省略则使用 local-samples//input.json(存在时),否则用空输入 +# - 产物固定写到 ./local-runs//<时间戳>/,包含 outputs/、result.json、stage-manifest.json +# - 调试 operator-repos 源码副本改动时无需任何额外参数:脚本默认用 +# DROBOTICFLOW_OPERATOR_SOURCE 直接指向 operator-repos/builtin//src/operator.py +# - 附加超参:OPERATOR_EXTRA_HYPERPARAMS='[{"key":"K","value":"V"}]' 变量传入 +# - 使用仓库 .venv 里的 Python(含 numpy/opencv 等算子依赖);.venv 不存在时回退 python3 + +set -euo pipefail + +REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" +cd "$REPO_ROOT" + +slug="${1:-}" +if [[ -z "$slug" ]]; then + echo "用法: scripts/local/run-operator.sh [输入artifact列表JSON文件]" >&2 + echo "示例: scripts/local/run-operator.sh json_to_csv local-samples/json_to_csv/input.json" >&2 + exit 1 +fi + +op_dir="operator-repos/builtin/$slug" +if [[ ! -f "$op_dir/operator.json" ]]; then + echo "错误: 找不到算子 $slug($op_dir/operator.json 不存在)" >&2 + echo "可用算子: ls operator-repos/builtin/" >&2 + exit 1 +fi + +# 从 operator.json / runtime_contract.json 读取算子名和 handler +op_name="$(python3 -c "import json; print(json.load(open('$op_dir/operator.json'))['name'])")" +handler="$(python3 -c "import json; print(json.load(open('$op_dir/runtime_contract.json'))['handler'])")" + +# 输入 artifact 列表:命令行 > local-samples 默认 > 空列表 +input_file="${2:-}" +if [[ -z "$input_file" && -f "local-samples/$slug/input.json" ]]; then + input_file="local-samples/$slug/input.json" +fi +if [[ -n "$input_file" && ! -f "$input_file" ]]; then + echo "错误: 输入文件不存在: $input_file" >&2 + exit 1 +fi + +run_dir="$REPO_ROOT/local-runs/$slug/$(date +%Y%m%d-%H%M%S)" +mkdir -p "$run_dir/outputs" + +# 组装 NODE_DATA_JSON:label 用于日志显示,outputs 占位一个端口 +extra_hyperparams="${OPERATOR_EXTRA_HYPERPARAMS:-[]}" +node_data_json="$(slug_label="$op_name" extra_hyperparams="$extra_hyperparams" python3 - <<'PY' +import json, os +print(json.dumps({ + "label": os.environ["slug_label"], + "hyperparams": json.loads(os.environ["extra_hyperparams"]), + "outputs": [{"id": "out-1", "name": "output", "type": "json"}], +}, ensure_ascii=False)) +PY +)" + +# 输入 artifact:文件形式给 INPUT_ARTIFACTS_PATH(>64KiB 或含路径引用时更贴近真实) +if [[ -n "$input_file" ]]; then + cp "$input_file" "$run_dir/input-artifacts.json" + input_env=("INPUT_ARTIFACTS_PATH=$run_dir/input-artifacts.json") +else + input_env=("INPUT_ARTIFACTS_JSON=[]") +fi + +# Python 解释器:优先仓库 .venv(有 numpy/opencv/h5py 等依赖) +if [[ -x ".venv/bin/python" ]]; then + PY=".venv/bin/python" +else + PY="python3" + echo "[提示] .venv 不存在,使用系统 python3;视频/科学计算类算子可能缺依赖" >&2 + echo "[提示] 建议执行: python3 -m venv .venv && .venv/bin/pip install -r requirements-dev.txt" >&2 +fi + +echo "====== 单算子本地调试 ======" +echo "算子: $slug / $op_name" +echo "handler: $handler" +echo "输入: ${input_file:-(空输入)}" +echo "产物目录: $run_dir" +echo "============================" + +env \ + RUN_ID="run-local-$slug" \ + WORKFLOW_ID="wf-local" \ + NODE_ID="node-local-$slug" \ + NODE_LABEL="$op_name" \ + NODE_DATA_JSON="$node_data_json" \ + "${input_env[@]}" \ + OUTPUT_DIR="$run_dir/outputs" \ + RESULT_OUTPUT_PATH="$run_dir/result.json" \ + STAGE_MANIFEST_PATH="$run_dir/stage-manifest.json" \ + DROBOTICFLOW_OPERATOR_HANDLER="$handler" \ + DROBOTICFLOW_OPERATOR_SOURCE="$op_dir/src/operator.py" \ + "$PY" backend/operator-runner/main.py + +echo +echo "====== 执行完成 ======" +echo "result.json: $run_dir/result.json" +echo "stage-manifest: $run_dir/stage-manifest.json" +echo "outputs/: $run_dir/outputs/" +if [[ -f "$run_dir/result.json" ]]; then + python3 - "$run_dir/result.json" <<'PY' +import json, sys +try: + result = json.load(open(sys.argv[1])) +except Exception as exc: + print(f"(result.json 解析失败: {exc})") + raise SystemExit(0) +artifacts = result.get("artifacts", []) +print(f"产物 artifact 数: {len(artifacts)}") +for artifact in artifacts: + print(f" - {artifact.get('name')} (type={artifact.get('type')}, path={artifact.get('path')})") +logs = result.get("logs", []) +errors = [entry for entry in logs if entry.get("level", "").lower() in ("error", "warn")] +if errors: + print(f"日志中的告警/错误 {len(errors)} 条(前 3 条):") + for entry in errors[:3]: + print(f" [{entry.get('level')}] {entry.get('message', '')[:160]}") +PY +fi