開源 · MIT · 全在你本機

幫自己裝一台 本機任務引擎

把一件事丟給它，它會在你電腦裡跑，做完把結果交回來；你也能用瀏覽器看進度。待辦、進度和結果是你電腦上的檔。你可以打開、備份、搬走。

引擎。預設 mock，不叫任何模型。要真的跑，設 ENABLE_REAL_CLAUDE_WORKER=1。這版用 CLAUDE_CMD 啟動 Claude CLI，參數帶 --print。另外有一條 OpenAI 相容端點，預設關閉，沒有工具，只把回覆寫成檔。Gemini 與 Codex 在 README 寫成以後再加。這版沒把它們接成 worker。

預設 mock 不需要 API key。要叫 Claude CLI 真的跑，要用你自己的 Claude 帳號。

看怎麼裝（兩條路）先讀安裝手冊
WHAT IT DOES

它能幫你做什麼

待辦、進度和結果在你看得到的資料夾裡。你可以打開那些檔。

LOCAL FILES

全在你本機

待辦、進度和結果在你看得到的資料夾裡。你可以打開那些檔。

MOCK MODE

預設 mock 不需要 API key

要叫 Claude CLI 真的跑，要用你自己的 Claude 帳號。

TEXT FIRST

改文字檔就改個性

想改它的做事方式，就改幾個文字檔，不用先寫程式，也不用先接一堆服務。

OPTIONAL CHAT

可選接 Telegram

想用手機傳訊息丟任務、收結果就接；不想接也能只用瀏覽器。本體是純 Node.js 18+。

INSTALL

開始裝：兩條路，挑一條

硬需求只有兩個：Node.js 18 以上、git。裝完你會拿到一個可開的本機網址，預設是 http://127.0.0.1:3100。有 coding agent 就走路線 A 讓它代勞； 手邊沒有、或想自己看著每一步跑，走路線 B 把命令貼進終端機。兩條路跑完是同一個結果，B 不是簡化版。

MIT 開源，可先審再跑零外部相依 · 純 Node.js 18+看原始碼 repo
路線 A · 讓 AI 幫你裝

把 prompt 貼給 coding agent

手邊有 Codex、Claude Code 這類 coding agent 的話，兩步就好：clone 下來， 然後把下面那段 prompt 整段貼給它。

git clone https://github.com/zaxardery8011-design/aiwff-runtime
cd aiwff-runtime
# 對你的 AI coding agent 說：「照 INSTALL_AI.md 幫我裝好」
展開看它會請 AI 做哪些步驟，包含失敗時怎麼處理
你是我的本機 coding agent。請幫我安裝並驗證 aiwff-runtime。

目標：
- clone 官方 repo 到本機工作資料夾
- 只跑 mock demo
- 不接 Telegram、LINE、Claude OAuth、Task Scheduler
- 不讀取、上傳或修改我的私人檔案
- 安裝完成後啟動 WebUI，並回報可開啟的 localhost URL

步驟：
1. git clone https://github.com/zaxardery8011-design/aiwff-runtime
2. cd aiwff-runtime
3. 檢查 Node.js 與 npm：node --version；npm --version。Node.js 必須 >= 18。
4. npm install
5. npm run doctor
6. MOCK_WORKER=1 npm run demo
7. npm run verify-demo
8. npm run web
9. 回報：demo task id / artifact path / verifier verdict / localhost URL

如果任何一步失敗，不要亂改系統、不要接 Telegram/OAuth、不要改 Task Scheduler；先停下來回報錯誤與你已執行的命令。

路線 B · 自己貼命令

會開終端機就夠，不用有 AI

整段照抄就會跑完。這幾行跟 官方安裝手冊 §2 是同一套，不是另外寫的簡版。

git clone https://github.com/zaxardery8011-design/aiwff-runtime
cd aiwff-runtime

# 確認 Node 版本,要 >= v18
node --version

# 建 .env(Windows PowerShell)
Copy-Item .env.example .env
# bash / macOS / Linux 用 cp .env.example .env

# 可選,本專案零外部相依
npm install

# 自檢
npm run doctor

# 跑一次完整任務
npm run demo

# 驗證產出
npm run verify-demo

# 開 http://127.0.0.1:3100
npm run web

複製出來的 .env 不用改任何一行，MOCK_WORKER=1 已經是預設值。 跑到 demo 那步就算成功了：它會印出 Task ID 與 Artifact 路徑，那個檔案就在你電腦上，打開看得到內容。npm run verify-demo 是拿它去對驗，不是我說跑完了。

預設 mock 不需要 API key。要叫 Claude CLI 真的跑，要用你自己的 Claude 帳號。

DOCS / GITHUB

想深入？看手冊與原始碼

安裝、使用、架構與支援入口都放在公開 repo；技術支援走 GitHub Issues，完整版或客製再找 zax.com.tw。

安裝手冊 install.md

一步步把它裝起來、跑通第一次。預設 mock 不需要 API key。要叫 Claude CLI 真的跑，要用你自己的 Claude 帳號。

開啟連結 →

使用手冊 usage.md

學會怎麼用、產出在哪、怎麼調個性。

開啟連結 →

GitHub repo

想看細節、設定欄位和架構，就看原始碼。

開啟連結 →

GitHub Issues

卡住請到 GitHub Issues 留問題，我們在那邊追。

開啟連結 →
TRY FIRST

不想自己裝？先玩玩看

不確定合不合用、或懶得碰命令列，可以先到 LINE 實驗室，跟一個跑起來的 LINE 分身聊，體驗過再決定要不要自己裝。

加 LINE 實驗室
FULL AIWFF / CUSTOM

想要完整版 / 客製化？

本機任務引擎是開源最小版本。若你要多台機器一起跑、要規則控管、要接進你自己的流程，或想要有人幫你導入客製，聊聊。

聯絡 zax.com.tw

訂閱實作紀錄:這週改了什麼、哪裡踩坑、哪個做法你可以直接抄回去用。

目前寄出 0 期。沒做出東西的那週就不寄。