設定
點擊頂欄中的齒輪圖示開啟設定(Settings,頂欄按鈕提示為「設定」,對話框標題為「設定」)。左側列出各分組及其分頁,右側顯示所選分頁。有些分頁會在你修改時自動儲存,有些則有自己的 Save(儲存)按鈕。
分組可以摺疊,HagiCode 會記住你讓哪些保持展開。
| 分組 | 分頁 |
|---|---|
| General(一般) | General Settings(一般設定)、Notifications(通知)、Confirm Prompts(確認提示)、About(關於) |
| Appearance and interface(外觀與介面) | Startup Splash(啟動畫面)、Status Bar Scroll(狀態列捲動)、TokenMonitor、Mermaid Appearance(Mermaid 圖表外觀)、Kanban Right Panel(看板右側面板) |
| Sessions and conversation(工作階段與對話) | Session List(工作階段清單)、Chat View(聊天檢視)、AgentCLI Interactive Control(AgentCLI 互動控制)、Agent resource limits(Agent 資源上限)、Error Retry(錯誤重試)、Post-state actions(工作階段狀態後動作) |
| Proposals and planning(提案與規劃) | Proposal Creation(提案建立)、Planning Direction(規劃方向)、Proposal Stage Diagram(提案階段圖) |
| Input and efficiency(輸入與效率) | Haginput、Common Phrases(常用片語)、Quick Actions(快速操作)、Comments(註解) |
| Projects and integrations(專案與整合) | Project Icon(專案圖示)、GitHub、Git、Code Server、OmniRoute |
| Lifestyle and wellbeing(生活與健康) | Achievements(成就)、Break Reminder(休息提醒)、Salary Tracker(時薪掛機) |
| System(系統) | Data Management(資料管理)、Debug(除錯)、Danger Zone(危險區域) |
有些控制項只有在啟用 TurboEngine DLC 後才可用,未啟用時會顯示為鎖定狀態。
General(一般)
General Settings(一般設定)

- Brand Customization(品牌自訂)用於設定自訂的頂欄 Logo、應用程式標題、品牌跳轉連結和瀏覽器標題,並即時預覽效果。這些控制項可以預覽,但在 TurboEngine DLC 啟用之前處於鎖定狀態。
- Back to Top Button Settings(回到頂部按鈕設定)選擇「回到頂部」按鈕在工作階段中的位置,例如 Bottom Right(右下角)。
Notifications(通知)

先開啟通知,再選擇管道:Toast notifications(Toast 通知)、Browser notifications(瀏覽器通知,瀏覽器必須允許)、Speech synthesis(語音合成)和 Sound Settings(音效設定)。Status rules(狀態規則)表格讓你為每種工作階段狀態(例如 New(新建)、Drafted(已起草)、Executing(執行中)、Waiting for Reply(等待回覆)、Execution Complete(執行完成)或 Archived(已封存))選擇觸發哪些管道以及播放哪個聲音。播放按鈕可以試聽聲音。
Confirm Prompts(確認提示)

一個總開關,加上每個確認對話框各一個開關:超級提交全部之前;產生提案、將其移到待執行、立即執行或封存之前;以及封存或刪除所選工作階段之前。關閉提示可以少點幾次,但出錯的代價會更高。Reset to Default(恢復預設設定)會恢復預設值。
About(關於)

顯示版本和建置日期,並連結到包含完整社群清單的官方「關於」頁面。
Appearance and interface(外觀與介面)
Startup Splash(啟動畫面)

決定 HagiCode 啟動時顯示哪張畫面。Changes apply the next time HagiCode starts.(修改在下次啟動時生效)
- Show startup splash image(顯示啟動畫面圖片)關閉後,啟動時只顯示品牌名稱、版本和載入指示。
- Image selection(圖片選擇方式)有三種:Random on every startup(每次啟動隨機)、Random once per day(每天隨機一張,當天首次啟動時選定,之後保持不變)和 Fixed image(固定圖片)。
- 選擇 Fixed image 後,下方的選擇器會列出可用的啟動畫面,點一張就會在每次啟動時顯示它。
這些控制項可以預覽,但在 TurboEngine DLC 啟用之前處於鎖定狀態,就像截圖裡顯示的那樣。
Status Bar Scroll(狀態列捲動)

選擇狀態列是否捲動,以及使用哪些來源:Tips(提示)和 Promotions(推廣)。關閉捲動或推廣需要有效的 TurboEngine 訂閱。此分頁會列出目前的推廣內容。
TokenMonitor

在狀態列中顯示來自 TokenMonitor 桌面應用程式的今日 token 用量和費用。開關關閉時不會讀取任何內容。要獲得近即時更新,請同時填寫 HostHub address(HostHub 位址)和 HostHub secret(HostHub 金鑰);任一留空,則改為讀取 TokenMonitor 的本地資料檔案。
Mermaid Appearance(Mermaid 圖表外觀)

選擇 Mermaid 圖表的外觀:Default(預設)或 Archify-inspired(Archify 風格)。此選擇只儲存在目前的瀏覽器中,只改變視覺效果。
Kanban Right Panel(看板右側面板)

選擇工作階段看板右側顯示什麼:Hidden(隱藏)、GitHub Discussion,或帶有快捷操作和儲存庫狀態的 Quick Operations Panel(快速操作面板,預設值)。即時的 Preview(預覽效果)會顯示設定後的樣子。
Sessions and conversation(工作階段與對話)
Session List(工作階段清單)

- Project Scope(專案範圍)選擇哪些專案進入 All Sessions 看板:All Projects(全部專案)或 Custom Selection(自訂選擇)。點擊 Save 套用。
- Session Sorting(工作階段排序)可選 Smart Sorting(智慧排序,依執行狀態和最近活動排序)或 Custom Sorting(自訂排序,使用你自己的優先順序規則)。
- Session Display Settings(工作階段顯示設定)包括已封存的工作階段是否繼續顯示在清單中。
Chat View(聊天檢視)

- Default to Edit Mode for Normal Chats(一般工作階段預設為編輯模式)決定新建的一般工作階段是以編輯模式(Agent 可以修改檔案)開始,還是以唯讀模式開始。
- Show debug metadata entry points(顯示除錯中繼資料入口)會在聊天訊息中增加除錯入口。
- Auto-collapse long messages(自動摺疊超長訊息)會把較長的歷史訊息顯示為預覽,並帶有展開控制項。
- Simplified historical tool calls(簡化歷史工具呼叫)會把較早的工具呼叫摺疊為一段簡短摘要,附在下一則可見訊息上。
AgentCLI Interactive Control(AgentCLI 互動控制)

每個 Agent CLI 一個開關,決定產生的 OpenSpec 和 HagiTask prompt 是否仍然告知 Agent 本次執行是非互動的。開關關閉時(預設)會包含這條提示。這只會改變產生 prompt 的措辭。
Agent resource limits(Agent 資源上限)

限制每個 Agent CLI 以及它執行的指令最多能用多少記憶體和 CPU。**修改後的上限只對之後啟動的 Agent 生效。**分頁分為 Memory 和 CPU 兩組。
- Limit memory per agent(限制每個 Agent 的記憶體):開啟後,每次新的 Agent 執行連同它啟動的所有處理程序,都受下面的上限約束。
- Limit per agent(每個 Agent 的上限):從下拉選單裡選擇上限,預設 4 GB。說明文字會列出對應的軟限制、Node.js 堆積大小、交換分割區和工作數上限。Hagicode 會在 systemd 使用者範圍(user scope)裡啟動 Agent 來實現這個限制。
- Limit CPU per agent(限制每個 Agent 的 CPU):開啟後,每次新的 Agent 執行連同它啟動的所有處理程序,共用下面設定的 CPU 時間。
- Virtual CPU cores per agent(每個 Agent 的虛擬 CPU 核心數):以虛擬核心數(本機回報的邏輯處理器)計,預設 1。說明文字會顯示所選核心數佔本機總核心數的比例。
如果目前系統不支援其中某項能力(例如不是 Linux、沒有 systemd-run、沒有 systemd 使用者範圍,或沒有委派 cpu 控制器),分頁會顯示原因,對應的開關無法使用,Agent 會在沒有該限制的情況下啟動。
Error Retry(錯誤重試)

失敗執行的自動重試。Default Policy(預設策略)設定最大重試次數和每次重試前的延遲,後續嘗試使用末尾延遲。預設的重試間隔依序為 30、30、30、60 秒。CLI Overrides(CLI 覆寫項)讓每個 Agent CLI 可以沿用預設策略,或使用自己的間隔。
Post-state actions(工作階段狀態後動作)

決定某類工作階段進入某個狀態之後,HagiCode 自動做什麼。規則按列出的順序執行。目前內建的規則針對 Super Commit sessions(由超級提交訊息產生啟動的工作階段):
- Enabled(啟用):開啟後,規則生效。
- When the session reaches(當工作階段達到):觸發規則的狀態,例如 Execution completed(執行完成)。
- Then(然後):要執行的動作,例如 Archive session(封存工作階段)。
預設的規則會在超級提交工作階段執行完成後自動封存它們,讓它們離開工作階段清單。
Proposals and planning(提案與規劃)
Proposal Creation(提案建立)

設定提案儲存庫選擇器頂部顯示多少張最近儲存庫卡片。選擇 0 可隱藏這一列。
Planning Direction(規劃方向)

這是一個矩陣,列出提案流程預設為每個 Agent CLI 提出的規劃方向:探索模式、變更地圖、互動流程、原型、架構、API 時序,以及可編輯和僅參考的儲存庫範圍。單一 Agent 可以覆寫這些預設值。
Proposal Stage Diagram(提案階段圖)

設定提案抽屜中階段清單的詳細程度:Full(完整)顯示階段標籤和說明,Compact(精簡)只顯示標籤。這只影響抽屜的側邊欄,不影響主流程圖。
Input and efficiency(輸入與效率)
Haginput

智慧輸入。可選擇 Disabled(已關閉)、Doubao Local Voice(豆包本地語音)或 Haginput Remote Mode(Haginput 遠端模式),後者可以在不開啟本地麥克風的情況下,從手機或第二台裝置轉送文字。此分頁顯示模式狀態、自動連線選項、收到文字時的提示音和一個測試框。
Common Phrases(常用片語)

這個分頁合併了原來的 Standard Phrases(標準用詞)和 Common Requirements(常用需求),分為兩部分。
片語:管理訊息框中可重複使用的 @ 片語標記。選擇哪些分類和路徑來源(專案、Vault、提案工作階段、最近專案、自訂路徑)出現在 @ 選擇器中,並用 Add Group(新增分組)建立自訂片語分組。
常用需求:

可重複使用的需求片段,可一鍵加入提案需求中,例如 No docs / tests(不含文件測試)、Self commit(自行提交)、Output English(輸出中文,隨介面語言變化)、Ask before edit(編輯前詢問)和 No backward compatibility(不相容舊版)。只會列出目前介面語言對應的需求。用 Add Common Requirement(新增常用需求)建立你自己的需求,並用編輯和刪除按鈕管理它們;內建的系統預設可以用 Restore missing system presets(恢復缺失的系統預設)找回。
Quick Actions(快速操作)

Configured Commands(已設定指令)列出你用 Add Command(新增指令)加入的自訂指令。Execution History(執行歷史)記錄它們的執行時間。
Comments(註解)

儲存你常用的註解範本,分為兩個清單:Line Comments(行註解)和 File Comments(檔案註解)。用 Add Comment(新增註解)建立範本,用 Save 儲存修改。
Projects and integrations(專案與整合)
Project Icon(專案圖示)

- Project Icon Mode(專案圖示模式)設定新專案的預設樣式:Game Icon(遊戲圖示,隨機的彩色圖示,為預設值)或 Text Abbreviation(文字縮寫,取專案名稱的首字母)。單一專案可以在專案詳情中覆寫它。
- Icon Collection(圖示集合)控制哪些圖示可以被選取。可以使用 Show All(顯示全部)、Enable All(全部啟用)、Disable All(全部停用)、Random 50(隨機 50 個)和 Refresh(重新整理),也可以點擊某個圖示來切換它。
GitHub

使用你本地的 GitHub CLI(gh)工作階段來同步工作階段並匯入 GitHub 資料。此分頁顯示連線狀態和已授予的權限範圍,並提供 Refresh status(重新整理狀態)和 Copy login command(複製登入指令)。權杖只在目前頁面工作階段期間保留在記憶體中,從不寫入本地儲存。如果 gh 尚未登入,請依照分頁上顯示的 Local gh setup(本地 gh 設定步驟)操作。
Git

- Git Profiles儲存超級提交可以使用的作者身分。開始超級提交之前請至少建立一個,這樣 prompt 總能寫明明確的作者。
- Automatically refresh and monitor Git status(自動重新整理並監控 Git 狀態)會定期檢查活躍專案。這可能增加磁碟活動,尤其是在 Windows 上或儲存庫很多時。Maximum monitored Git repositories(最大監控 Git 儲存庫數)限制同時監視的數量(預設 15)。
- Super Commit default behavior(超級提交按鈕預設行為)決定主超級提交按鈕的動作:先 Open confirmation panel(開啟確認面板),或使用已儲存的 Profile 和預設值 Commit immediately(立即提交)。其他選項設定提交後預設是否推送或 rebase。
Code Server

唯讀展示解析後的 Code Server 設定(主機、連接埠、認證模式、來源)和最新的執行時快照。這裡不支援編輯 Code Server 設定。
OmniRoute

啟用共享的 OmniRoute 整合。設定 API endpoint和可選的 API key(API 金鑰),使用 Test connection(測試連線),並選擇哪些 Agent CLI 使用 OmniRoute 的模型目錄。右側顯示執行狀態和已快取的模型目錄。整合關閉時,模型管理會回退到最初的系統預設值。安裝方法參見 OmniRoute。
Lifestyle and wellbeing(生活與健康)
Achievements(成就)

用於開關狀態列中每日成就進度的彈出提示。無論是否開啟,全域里程碑通知和資料同步都保持啟用。參見狀態列與進度。
Break Reminder(休息提醒)

一個提醒你喝水、伸展或站起來活動的計時器。它顯示上一次和下一次提醒以及今天的循環次數,並可選擇提醒主題,例如 Basic(基礎樣式)。提醒會顯示在狀態列中。
Salary Tracker(時薪掛機)

一個有趣的按分鐘計算收入的計數器。填寫 Daily salary(日薪)和 Work hours per day(每日工時);每分鐘收益等於日薪除以(工時 × 60),日薪為 0 時關閉計算。從 20 個單位 emoji 中選一個,並選擇狀態列是否顯示該指示器。
System(系統)
Data Management(資料管理)

顯示目前的存檔及其資料資料夾(存檔根目錄、設定目錄、資料目錄)。Save Catalog(存檔目錄)列出存檔,並讓你安全地啟用一個就緒的存檔。Workspace(工作區)切換器可在 Primary Database(主資料庫)、Message Database(Message 資料庫)和 Image Storage(圖片儲存)工具之間切換。Data Cleanup(資料清理)顯示資料庫資訊,並清理已封存的工作階段訊息資料以釋放儲存空間。
Debug(除錯)

面向開發建置的工具:
- SignalR Log(SignalR 日誌)會把 SignalR 事件和訊息即時列印到主控台。
- HagiPower Adjustment(HagiPower 調整)在開發環境中直接編輯共享的公共池。它不會改變正常的生產環境計算。
- Enable DLC(啟用 DLC)透過後端設定明確地讓 TurboEngine DLC 啟用或停用,因為本地開發環境沒有內部的啟用開關。
正常使用時不需要這個分頁。
Danger Zone(危險區域)

Reset system data(重設系統資料)會重設持久化狀態,並刪除目前存檔的主資料庫記錄和訊息分片。圖片、外掛、儲存庫和其他存檔不受影響。應用程式會繼續執行,之後建議重新啟動。此操作無法復原。
外觀、主題與語言
頂欄中的兩個按鈕無需開啟設定就能改變 HagiCode 的外觀。

Theme(主題)開啟主題選擇器(Choose theme,選擇主題)。每個主題系列都有 Light(亮色)和 Dark(暗色)兩種變體,並立即生效。系列包括 Standard(標準)、Spring(春季)、Summer(夏季)、Vacation(暑假)、Autumn(秋季)、Winter(冬季)、Lunar New Year(新年)、Soccer(足球)、Cyberpunk(賽博)、School(學校)和 Space Travel(星際)。Auto-switch(自動切換)會依 1 到 240 分鐘的固定間隔在淺色或深色主題之間輪換。

Language(語言)開啟語言對話框(Select Language,選擇語言)。選擇一種語言並點擊 Confirm(確認)。HagiCode 支援 English、簡體中文、繁體中文、日本語、한국어、Deutsch、Français、Español、Português (Brasil) 和 Русский。
HagiCode
HagiCode 是面向專案開發的 AI 編碼工作台:豐富、便利的介面互動讓規劃、Agent 執行與專案工作更容易上手和跟進,帶來更投入的開發體驗。
透過豐富、便利的介面互動,讓規劃、Agent 執行與專案工作更容易上手和跟進。
- 智慧OpenSpec 工作流程將意圖轉化為從提案、設計、任務到交付的可執行路徑。
- 高效多 Agent 並行推進研究、實作與審查,並支援多儲存庫變更與你熟悉的 Agent CLI。
- 有趣豐富、便利的介面互動讓規劃、Agent 執行與專案工作更容易上手和跟進,帶來更投入的開發體驗。
下載 Windows 版
分享 HagiCode
讓想法化為交付成果。
HagiCode 是面向專案開發的 AI 編碼工作台:以 OpenSpec 工作流程規劃變更,多 Agent 並行執行,再由 Hero Scenario 讓進度一目了然,將想法化為交付成果。
- 智慧
- OpenSpec 工作流程將意圖轉化為從提案到交付的可執行路徑。
- 高效
- 多 Agent 並行推進研究、實作與審查。
- 有趣
- 豐富、便利的介面互動,讓規劃、Agent 執行與專案工作更容易跟進。
© 2026 HagiCode | Powered By hagilight-starlight@0.21.0 | Branch: main | Commit: f73f810 | Built:

