Leo/Arcrun

Files

T

uncle6me-web 922a57fe34 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>

2026-06-03 15:52:38 +08:00

2.7 KiB

Raw Blame History

Skill: Migrate http_request → trigger_workflow

何時用這個 skill

你看到既有 workflow 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

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

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 應該很快）。

2.7 KiB Raw Blame History Unescape Escape