Vela · 船帆座

把風借給你,
舵仍在你手上。

Vela 是南天的「船帆座」。古希臘人把星空裡最大的那艘船 Argo 拆成船底、船尾與船帆;帆,是推著它往前走的那一部分。

寫程式像一趟不知道終點的航行。我不想當一艘自己開走的無人船,只想做一面帆:力氣我出,方向你定。

嗨,
我是 Vela。

住在你電腦裡的 AI 編程夥伴。我在你的程式碼儲存庫裡讀、寫、執行,而每一步,你都看得見。

往下捲,出港
Vela 是什麼

Vela 是一款桌面應用程式,讓 AI Agent 在你電腦上的程式碼儲存庫裡工作:理解專案、拆分任務、修改並執行程式碼。過程收成一行,幫手各有一頁,每一步都留下軌跡。

緊湊一串工具呼叫,收成一行
並行子代理分頭行動
可回溯每一步都有出處
本機資料留在你的電腦
對話、檔案與變更,並排而坐 右邊是工作面板 模式、權限、模型都在輸入框旁
Vela 主介面 · 截圖為簡體中文介面,另有繁體中文、英文、日文與韓文
招牌 1 / 3 · 預設開啟

緊湊過程

好的助手不會一直說話。過程退後,事情才浮得出來。

收成一行行過程線讀了哪些檔案、改了哪幾行、跑了什麼指令;連續呼叫自動合併成摘要。
要細節,點開就是點檔名在右側預覽,diff 與指令輸出都在原地展開。
做完了,只留結論整輪過程可以收起。喜歡逐張卡片的話,設定裡可以換。
三個檔案,一行帶過 最後只留結論
招牌 2 / 3 · SubAgents

子代理小隊

大任務來了,我先拆開,再分給幾位幫手同時動手。

各走各的,互通消息有人查路由、有人修登入、有人挑剔地審邊界;幫手也能再帶自己的小隊。
點名字就能看點 /root/auth 這樣的路徑,每位幫手想了什麼、做了什麼,在右側各有一頁。
分工,不失控explore 只讀不動檔案;能動手的成員,照你為這次對話設下的權限行事。
三位幫手同時開工 每位各有一頁
招牌 3 / 3 · 軌跡

軌跡回放

不用相信我,翻航海日誌就好。每一步都有出處。

依時間排開每次思考、工具呼叫與回傳,一行一行看得見;可依時長、輪次或模型呼叫檢視。
沒有藏起來的東西首個 Token 的等待、生成耗時、Token 用量、快取命中,連最初的系統提示詞都在。
回到第一次偏離的地方出了錯,順著航跡往回找:選一個節點,看它的參數、結果與計時。
整輪過程的時間軸 點一步,看原始結果

三張截圖由 Vela 的真實介面元件搭配範例資料算繪,並非真實任務紀錄或效能基準。

行囊

出發時,已經備好的東西

一項功能一張色紙,一句白話。有幾張可以直接玩:拖一拖、點一點。

檢查點改壞了?一鍵回到上一刻。每一輪開始與結束,我都記下工作區的檔案狀態。
↩ 回到這一輪
收件匣要你拿主意的事集中一處:審批、提問、後台任務的結果。
審批pnpm db:migrate
提問舊路由要保留嗎?
結果每日回顧已完成
常駐 Agent關了視窗,也替你顧著。只處理你交代的事,沒有新事件就不呼叫模型。
互動式介面計算器、對比表、圖表直接長在回答裡。它們是宣告式資料,由 Vela 自己的元件畫出來;模型寫的 HTML 或腳本不會被執行。

一年下來是 87 小時,約 11 個工作天

記憶兩份 Markdown:一份記你的偏好,一份記專案的約定。看得見、改得了、刪得掉。
回答用繁體中文。
提交前先跑 pnpm test。
還想讓我注意什麼,寫在這裡…
三種節奏同一個輸入框,三種做事的方式。

日常動手:讀檔、改檔、跑指令,一邊做一邊跟你說。

先擬方案:只讀不寫,交出完整計畫;你批准了,才在目前或全新的上下文裡動工。

盯著長目標:圍繞多步驟目標持續推進,記錄進度與驗證。

Skills一個含 SKILL.md 的資料夾,就教會我一項新手藝。Codex 或 Claude Code 裡的 Skills 也能搬過來,原檔會留著。
---
name: pdf-tools
description: 從 PDF 擷取文字與表格。
---
MCP 與整合連接本機或遠端的 MCP 工具,需要時才去找。Notion 這類內建應用一鍵連上,不必填 URL 或 Token。
Notion本機 MCP遠端 MCP專案需確認信任
定時任務一次、每天、每週,或一個 Cron。每次執行都在綁定工作區開一個新對話。
0 22 * * *每天 22:00 · Asia/Taipei
任務配方把反覆做的事寫成範本,填幾個參數、看過預覽,就能再來一次。
修復 {{bug}} · {{workspace.name}}
工作區與 worktree直接在你的專案裡做,或開一個獨立的 Git worktree。右側面板放檔案預覽、變更與終端機。
vela/wt-login-redirect
瀏覽器面板對話裡的連結在右側打開;我也能在同一個頁面上點擊、填寫、截圖,幫你驗證剛改好的畫面。
Pull Request 中心你開的、等你審的、提到你的 PR,檢查狀態與留言一頁看完。
一趟任務的航程

從出港到靠岸

以「修復登入後的重新導向」為例,一件事在 Vela 裡是這樣走完的。

1交代任務在輸入框說出想完成的事,挑一種節奏、一檔權限、一個模型。
修好登入後丟失目標頁面的問題,補上安全檢查和測試。
Agent幫我批准高
2先看計畫事情大的話切到 Plan:我只讀不寫,把方案完整交出來,你批准才動手。
✓找出回呼裡丟掉參數的地方
✓共用一份網址檢查
補八個重新導向測試
3小隊分工我把任務拆成三路,同時開工;彼此用訊息交換發現。
/root/routing查閱
/root/auth執行
/root/review查閱
4你來把關有風險的操作會停下來等你。不在這個對話?它會出現在收件匣。
git push origin fix/redirect
5逐條驗收驗收面板把每條需求對上修改與驗證證據。我說「做完了」不算數,紀錄才算。
✓保留站內目標通過
✓拒絕外部網址通過
文件更新待確認
6打包交接交接包整理目標、決策、改過的檔案與沒做完的事,帶進新對話接著做。
修改檔案
3
實際驗證
8 / 8
未完成
1
靠岸。下一趟,從交接包出發。
② 這次帶了新東西

新到港!

1.1.3

Vela 1.1.3 帶來全新的插畫歡迎介紹、八步設定流程,以及離線可讀的多語言版本亮點。

全新的歡迎介紹透過插畫認識 Vela,再搭配應用程式截圖了解子代理並行、執行軌跡與緊湊對話。
八步完成啟航準備依序選擇語言、外觀、資訊欄配置、技能、模型、權限、記憶與指令,以及背景行為。可選步驟可以略過,未完成的設定會從上次停下的頁面繼續。
在應用程式裡查看新到港歡迎介紹與更新後的首次啟動會顯示安裝包內的版本亮點。無需連網,且只顯示與目前應用程式版本一致的說明。
隨時重看介紹在「設定 → 關於與更新」重新查看介紹與目前版本亮點,不會改變已儲存的偏好。

1.0.6 之後的版本會在背景自動下載這次更新,下載完提示重新啟動。

調校 1 / 4 · 執行權限

舵,握在你手上

我能自己做多少,由你說了算。每個對話都能在輸入框旁換一檔。

執行終端機指令前先請你批准;要寫入所選工作區以外的位置時,也會先問。

由這個對話選用的模型判斷風險。低風險的事我直接做;有風險,或判斷不出來時,才停下來問你。

略過逐項確認,放手讓我做。適合你信得過的專案與任務。

先把話說在前頭:這是互動式的審批策略,不是作業系統層級的沙箱。目前只在本機工作區或 Git worktree 裡執行,遠端與隔離環境還沒做。
調校 2 / 4 · 模型

帆張多大,就想多深

登入一家模型服務、填 API 金鑰,或接上你自己的相容介面與本機模型。憑證保存在本機。

AAnthropic
OOpenAI
GGoogle
OOpenRouter
DDeepSeek
GGitHub Copilot
+自訂介面
預設推理強度只顯示所選模型支援的選項

每次對話都能在輸入框旁臨時調整;定時任務和任務配方也能各自指定模型與強度。

調校 3 / 4 · 外觀

選個順眼的樣子

五種介面語言,淺色與深色各有幾套配色,可以跟著系統切換。點一個試試,右邊會跟著換。

介面語言
配色淺色、深色各選一個
即時預覽
調校 4 / 4 · 本機資料

東西放在哪,你都找得到

我在你的電腦上執行。對話、帳號、權限與軌跡都放在 ~/.vela,不是哪一台陌生的伺服器。

航海清單保存在本機

對話與訊息
~/.vela/sessions
執行軌跡
~/.vela/traces
全域記憶
~/.vela/MEMORY.md
專案記憶
<project>/.vela/MEMORY.md
Skills
~/.vela/skills
Git worktree
~/.vela/worktrees
檔案檢查點
~/.vela/checkpoints
整合的憑證
系統安全儲存空間加密
誠實一點說:你交給模型的內容,會送到你所連接的模型服務。其餘的,留在這台電腦。
準備好了

升帆,
啟航!

開源、免費,Apache-2.0 授權。裝好之後連上一家模型服務,就能出發。

下載 Vela 1.1.3 →

macOS · Apple Silicon .dmg 安裝檔 .zip 應用程式封裝

三步出港
1連上模型在「模型與帳號」登入一家供應商,或新增自訂模型介面。
2選個資料夾打開電腦上的專案,或開一個 Git worktree。
3說出任務挑 Agent、Plan 或 Goal,告訴我你想完成什麼。

或從原始碼啟動複製

git clone https://github.com/KryptonGao/VelaHarness
cd VelaHarness
pnpm install
pnpm dev

需要 Node.js 22.19 以上與 pnpm 11.24.0。開發版使用獨立的 ~/.vela-dev,可以和安裝版同時執行。

快速鍵macOS

新增對話
⌘N
左側欄
⌘B
右側工作面板
⌘J
面板開新分頁
⌘T
設定
⌘,
換行
⇧Enter
安裝檔尚未經過 Apple 公證。若 macOS 擋下第一次開啟,請到「系統設定 → 隱私權與安全性」選擇「仍要打開」。
出港前的幾個問題

想問的,
大概是這些

沒找到答案?到 GitHub 開一個 Issue,或直接翻文件。

閱讀文件 ↗
Vela 要錢嗎?

不用。Vela 以 Apache-2.0 授權開源,應用程式本身免費。模型的用量由你連接的供應商依它們的方案計費。

支援哪些平台?

目前提供 macOS(Apple Silicon)的安裝檔。也可以從原始碼啟動,需要 Node.js 22.19 以上與 pnpm 11.24.0。

我的程式碼會被傳到哪裡?

Vela 在你的電腦上執行,對話、帳號與執行軌跡保存在 ~/.vela。你請 Agent 處理的內容,會送到你自己連接的模型服務與工具;Vela 沒有另外的伺服器來收這些內容。

權限設定算是沙箱嗎?

不算。三檔權限是互動式的審批策略,不是作業系統層級的沙箱;遠端與隔離的執行環境目前還沒實作。

改壞了可以回去嗎?

可以。修改某一則訊息並重新傳送,會撤回該輪之後的對話,並從檢查點還原工作區檔案;傳送前就有的未提交變更會保留。回退範圍不包含 Git 索引與提交、被忽略的相依套件與建置資料夾、工作區以外的檔案,以及對外部服務做過的操作。

可以用哪些模型?

在「模型與帳號」登入供應商帳號或填 API 金鑰,也能新增自訂的模型介面。每個對話、定時任務與任務配方都能各自選模型與推理強度。

之後怎麼更新?

安裝版會在背景檢查 GitHub Release,驗過 Ed25519 簽章與 SHA-256 校驗值才安裝,下載完成後提示你重新啟動。不想自動更新,設定裡可以關掉。

Vela 底下用的是什麼?

以 Pi Agent 為執行階段,透過 TypeScript SDK 嵌進桌面應用程式;介面是 Electron、React 與 TypeScript。Pi 負責模型介面、會話與工具,Vela 在上面做桌面介面、任務模式、權限審批與 Git 工作區整合。