arcrun — AI workflow execution engine (clean history)
Self-hosted 開源:WASM 零件 + recipe + cypher-executor,跑在你自己的 Cloudflare。 此為重建的乾淨歷史起點(移除曾誤 commit 的 GCP SA 金鑰,舊歷史保留在 richblack/arcrun 與本地 backup 分支)。含: - acr init --self-hosted installer(建 KV/R2 + codeload 拉預編譯 wasm + wrangler deploy + seed recipe) - recipe push 把關(資料外流提醒 + 打通檢查) - 19 個正當零件預編譯 wasm(claude_api/km_writer/kbdb_upsert_block 排除:違反 DECISIONS §1) - CLI / cypher-executor / registry / 完整 SDD Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
# Skill: Migrate http_request → trigger_workflow
|
||||
|
||||
## 何時用這個 skill
|
||||
|
||||
你看到既有 workflow YAML 內有:
|
||||
|
||||
```yaml
|
||||
some_node:
|
||||
component: http_request
|
||||
url: "https://cypher.arcrun.dev/webhooks/named/another_workflow/trigger"
|
||||
# 或
|
||||
url: "https://arcrun-cypher-executor.uncle6-me.workers.dev/webhooks/named/X/trigger"
|
||||
```
|
||||
|
||||
這是 **錯誤 pattern** — CF Workers self-fetch 防護會擋掉,回 1042 / 522。
|
||||
**永遠改用 `trigger_workflow` 內建零件**。
|
||||
|
||||
## 為什麼會擋
|
||||
|
||||
Cloudflare Workers 有反同 zone 自循環防護:
|
||||
- 同 zone(`*.arcrun.dev`)Worker 互打容易死鎖
|
||||
- workers.dev 也擋(Worker → 自身 URL)
|
||||
|
||||
歷史背景:mira_feed_watcher 之前用 http_request 自打,怎麼設都失敗,最終加 `trigger_workflow` 內建零件繞掉(commit b8ecef0, 2026-05-16)。
|
||||
|
||||
## 怎麼遷移(3 行改動)
|
||||
|
||||
### Before
|
||||
```yaml
|
||||
trigger_synthesis:
|
||||
component: http_request
|
||||
url: "https://arcrun-cypher-executor.uncle6-me.workers.dev/webhooks/named/wiki_synthesis/trigger"
|
||||
method: POST
|
||||
headers:
|
||||
X-Arcrun-API-Key: "{{api_key}}"
|
||||
Content-Type: "application/json"
|
||||
body_json:
|
||||
api_key: "{{api_key}}"
|
||||
raw_block_id: "{{item.id}}"
|
||||
```
|
||||
|
||||
### After
|
||||
```yaml
|
||||
trigger_synthesis:
|
||||
component: trigger_workflow
|
||||
workflow_name: "wiki_synthesis"
|
||||
api_key: "{{api_key}}"
|
||||
input:
|
||||
api_key: "{{api_key}}"
|
||||
raw_block_id: "{{item.id}}"
|
||||
```
|
||||
|
||||
key 對應:
|
||||
- `url` → 拆 `workflow_name`
|
||||
- `headers.X-Arcrun-API-Key` → `api_key`
|
||||
- `body_json` → `input`
|
||||
- method / Content-Type → 不需要(in-process call)
|
||||
|
||||
## 行為差異
|
||||
|
||||
| 維度 | http_request 自打 | trigger_workflow |
|
||||
|---|---|---|
|
||||
| 走的路徑 | 外部 HTTP(被擋) | in-process call executeWebhookGraph |
|
||||
| latency | 一次 round-trip 50-200ms | < 1ms |
|
||||
| paused 狀態回報 | http 收 5xx 視為失敗 | status='paused_awaiting_resume' 算成功 |
|
||||
| auth 注入 | 手寫 header | 自動 |
|
||||
| 跨 zone | 會撞 self-fetch | 完全繞掉 |
|
||||
| 計量 | 算外部 fetch quota | 算同 Worker CPU |
|
||||
|
||||
## 例外:什麼時候真的需要 http_request
|
||||
|
||||
`trigger_workflow` 只能觸發**同一 arcrun 帳號**的 workflow(同 api_key namespace)。
|
||||
|
||||
跨帳號 / 跨環境 / 觸發其他平台需要 http_request:
|
||||
- 觸發另一個 arcrun 用戶的 webhook(少見場景)
|
||||
- 觸發外部 API(zapier / n8n / 自家別的 service)
|
||||
- 跨 Cloudflare account 的 worker
|
||||
|
||||
這些**不會** self-fetch 問題(因為目的地不是自己 Worker),http_request 仍適用。
|
||||
|
||||
## 部署前驗證
|
||||
|
||||
```
|
||||
arcrun_validate_yaml(yaml)
|
||||
arcrun_push_workflow(yaml)
|
||||
arcrun_run_workflow(your_watcher_name, {...})
|
||||
arcrun_list_recent_executions(workflow_name='your_watcher_name')
|
||||
```
|
||||
|
||||
確認 verdict='success' 且 duration_ms < 500ms(trigger_workflow 應該很快)。
|
||||
Reference in New Issue
Block a user