WHAT IT DOES
它能幫你做什麼
小主腦不是雲端聊天工具;它是一個把任務、進度和產出都留在本機的最小 AI 任務 runtime。
LOCAL FILES
全在你本機
待辦、進度、結果都放在你看得到的資料夾裡,不是雲端 SaaS。你可以直接查檔案、備份、搬走。
MOCK MODE
開箱免費跑通
第一次安裝不需 API key、不需付費帳號、不需 Telegram,就能看完整「丟任務、跑起來、拿結果」。
TEXT FIRST
改文字檔就改個性
想改它的做事方式,就改幾個文字檔,不用先寫程式,也不用先接一堆服務。
OPTIONAL CHAT
可選接 Telegram
想用手機傳訊息丟任務、收結果就接;不想接也能只用瀏覽器。本體是純 Node.js 18+。
INSTALL
最快上手:讓 AI 幫你裝
兩步:clone 下來、把 prompt 貼給 Codex / Claude Code 這類 coding agent。跑完你會拿到一個可開的本機網址,預設是 http://127.0.0.1:3100。
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;先停下來回報錯誤與你已執行的命令。免費跑通 mock 模式 不用錢、不需 API key。只有要讓它真的叫 Claude 幫你做事時,才需要 付費的 Claude 訂閱;這件事我們裝之前就講清楚。
DOCS / GITHUB
想深入?看手冊與原始碼
安裝、使用、架構與支援入口都放在公開 repo;技術支援走 GitHub Issues,完整版或客製再找 zax.com.tw。
TRY FIRST
不想自己裝?先玩玩看
不確定合不合用、或懶得碰命令列,可以先到 LINE 主腦實驗室直接跟一個跑起來的主腦聊,體驗過再決定要不要自己裝。