設定

點擊頂欄中的齒輪圖示開啟設定（Settings，頂欄按鈕提示為「設定」，對話框標題為「設定」）。左側列出各分組及其分頁，右側顯示所選分頁。有些分頁會在你修改時自動儲存，有些則有自己的 Save（儲存）按鈕。

分組可以摺疊，HagiCode 會記住你讓哪些保持展開。

分組	分頁
Common（常用）	General Settings（一般設定）
Project（專案）	Project Icon（專案圖示）
Process & Interaction（流程與互動）	Comments（註解）、Notifications（通知）、Quick Actions（快速操作）、Kanban Right Panel（看板右側面板）、Proposal Creation（提案建立）、Planning Direction（規劃方向）、Proposal Stage Diagram（提案階段圖）、Mermaid Appearance（Mermaid 圖表外觀）、Session List（工作階段清單）、Confirm Prompts（確認提示）、Common Requirements（常用需求）、Error Retry（錯誤重試）、AgentCLI Interactive Control（AgentCLI 互動控制）、Chat View（聊天檢視）、Standard Phrases（標準用詞）、Haginput
Integration（整合）	Break Reminder（休息提醒）、Salary Tracker（時薪掛機）、GitHub、Git、OmniRoute、TokenMonitor、Code Server、Status Bar Scroll（狀態列捲動）
Game（遊戲）	Achievements（成就）
System（系統）	Data Management（資料管理）、Danger Zone（危險區域）、About（關於）
Debug（除錯）	Debug（除錯）

有些控制項只有在啟用 TurboEngine DLC 後才可用，未啟用時會顯示為鎖定狀態。

Common（常用）

General Settings（一般設定）

General Settings 分頁，包含品牌自訂與回到頂部按鈕的位置

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

Project（專案）

Project Icon（專案圖示）

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

Process & Interaction（流程與互動）

這一組控制工作階段、提案和看板的行為。

Comments（註解）

Comments 分頁，包含行註解和檔案註解兩個範本清單

儲存你常用的註解範本，分為兩個清單：Line Comments（行註解）和 File Comments（檔案註解）。用 Add Comment（新增註解）建立範本，用 Save 儲存修改。

Notifications（通知）

Notifications 分頁，包含通知管道與狀態規則表格

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

Quick Actions（快速操作）

Quick Actions 分頁，指令清單和執行歷史均為空

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

Kanban Right Panel（看板右側面板）

Kanban Right Panel 分頁，包含顯示模式選項與預覽

選擇工作階段看板右側顯示什麼：Hidden（隱藏）、GitHub Discussion，或帶有快捷操作和儲存庫狀態的 Quick Operations Panel（快速操作面板，預設值）。即時的 Preview（預覽效果）會顯示設定後的樣子。

Proposal Creation（提案建立）

Proposal Creation 分頁，包含最近儲存庫位數量

設定提案儲存庫選擇器頂部顯示多少張最近儲存庫卡片。選擇 0 可隱藏這一列。

Planning Direction（規劃方向）

Planning Direction 分頁，依 Agent CLI 列出規劃方向的矩陣

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

Proposal Stage Diagram（提案階段圖）

Proposal Stage Diagram 分頁，包含 Full 和 Compact 兩種顯示模式及即時預覽

設定提案抽屜中階段清單的詳細程度：Full（完整）顯示階段標籤和說明，Compact（精簡）只顯示標籤。這只影響抽屜的側邊欄，不影響主流程圖。

Mermaid Appearance（Mermaid 圖表外觀）

Mermaid Appearance 分頁，包含 Default 和 Archify-inspired 兩種預設

選擇 Mermaid 圖表的外觀：Default（預設）或 Archify-inspired（Archify 風格）。此選擇只儲存在目前的瀏覽器中，只改變視覺效果。

Session List（工作階段清單）

Session List 分頁，包含專案範圍、排序模式與顯示選項

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

Confirm Prompts（確認提示）

Confirm Prompts 分頁，每個確認對話框對應一個開關

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

Common Requirements（常用需求）

Common Requirements 分頁，包含可重複使用的提案需求

可重複使用的需求片段，可一鍵加入提案需求中，例如 No docs / tests（不含文件測試）、Self commit（自行提交）、Output English（輸出中文，隨介面語言變化）、Ask before edit（編輯前詢問）和 No backward compatibility（不相容舊版）。只會列出目前介面語言對應的需求。用 Add Common Requirement（新增常用需求）建立你自己的需求，並用編輯和刪除按鈕管理它們。

Error Retry（錯誤重試）

Error Retry 分頁，包含預設重試策略與依 CLI 的覆寫項

失敗執行的自動重試。Default Policy（預設策略）設定最大重試次數和每次重試前的延遲，後續嘗試使用末尾延遲。預設的重試間隔依序為 30、30、30、60 秒。CLI Overrides（CLI 覆寫項）讓每個 Agent CLI 可以沿用預設策略，或使用自己的間隔。

AgentCLI Interactive Control（AgentCLI 互動控制）

AgentCLI Interactive Control 分頁，每個 Agent CLI 對應一個開關

每個 Agent CLI 一個開關，決定產生的 OpenSpec 和 HagiTask 提示詞是否仍然告知 Agent 本次執行是非互動的。開關關閉時（預設）會包含這條提示。這只會改變產生提示詞的措辭。

Chat View（聊天檢視）

Chat View 分頁，包含聊天模式、除錯中繼資料和長訊息選項

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

Standard Phrases（標準用詞）

Standard Phrases 分頁，包含分類可見性、路徑來源與自訂分組

管理訊息框中可重複使用的 @ 用詞標記。選擇哪些分類和路徑來源（專案、Vault、提案工作階段、最近專案、自訂路徑）出現在 @ 選擇器中，並用 Add Group（新增分組）建立自訂用詞分組。

Haginput

Haginput 分頁，包含輸入模式與遠端模式設定

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

Integration（整合）

Break Reminder（休息提醒）

Break Reminder 分頁，包含計時器狀態與提醒主題

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

Salary Tracker（時薪掛機）

一個有趣的按分鐘計算收入的計數器。填寫 Daily salary（日薪）和 Work hours per day（每日工時）；每分鐘收益等於日薪除以（工時 × 60），日薪為 0 時關閉計算。從 20 個單位 emoji 中選一個，並選擇狀態列是否顯示該指示器。

GitHub

GitHub 分頁，顯示已連線的本地 gh CLI 工作階段與設定說明

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

Git

Git 分頁，包含 Git Profile、狀態監控與超級提交預設值

Git Profiles（Git Profile）儲存超級提交可以使用的作者身分。開始超級提交之前請至少建立一個，這樣提示詞總能寫明明確的作者。
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。

OmniRoute

OmniRoute 分頁，包含整合開關、API 端點、執行狀態與模型目錄

啟用共享的 OmniRoute 整合。設定 API endpoint（API 端點）和可選的 API key（API 金鑰），使用 Test connection（測試連線），並選擇哪些 Agent CLI 使用 OmniRoute 的模型目錄。右側顯示執行狀態和已快取的模型目錄。整合關閉時，模型管理會回退到最初的系統預設值。安裝方法參見 OmniRoute。

TokenMonitor

TokenMonitor 分頁，包含狀態列開關與 HostHub 欄位

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

Code Server

Code Server 分頁，顯示解析後的設定與執行狀態

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

Status Bar Scroll（狀態列捲動）

Status Bar Scroll 分頁，包含顯示開關與目前推廣清單

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

Game（遊戲）

Achievements（成就）

Achievements 分頁，包含每日進度彈出提示的開關

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

System（系統）

Data Management（資料管理）

Data Management 分頁，包含資料庫目錄、存檔目錄與資料清理

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

Danger Zone（危險區域）

Danger Zone 分頁，包含 Reset system data 按鈕

Reset system data（重設系統資料）會重設持久化狀態，並刪除目前存檔的主資料庫記錄和訊息分片。圖片、外掛、儲存庫和其他存檔不受影響。應用程式會繼續執行，之後建議重新啟動。此操作無法復原。

About（關於）

About 分頁，顯示 HagiCode 平台版本與社群資源

顯示版本和建置日期，並連結到包含完整社群清單的官方「關於」頁面。

Debug（除錯）

Debug 分頁，包含 SignalR 日誌、HagiPower 調整與 DLC 選項

面向開發建置的工具：

SignalR Log（SignalR 日誌）會把 SignalR 事件和訊息即時列印到主控台。
HagiPower Adjustment（HagiPower 調整）在開發環境中直接編輯共享的公共池。它不會改變正常的生產環境計算。
Enable DLC（啟用 DLC）透過後端設定明確地讓 TurboEngine DLC 啟用或停用，因為本地開發環境沒有內部的啟用開關。

正常使用時不需要這個分頁。

外觀、主題與語言

頂欄中的兩個按鈕無需開啟設定就能改變 HagiCode 的外觀。

Choose theme 對話框，包含淺色和深色變體的主題系列以及自動切換面板

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

Select Language 對話框，選取了 English，並列出其他九種介面語言

Language（語言）開啟語言對話框（Select Language，選擇語言）。選擇一種語言並點擊 Confirm（確認）。HagiCode 支援 English、簡體中文、繁體中文、日本語、한국어、Deutsch、Français、Español、Português (Brasil) 和 Русский。

狀態列與進度休息提醒、日薪計數器和 token 用量顯示在哪裡。

AgentsAgent CLI、模型和執行場景。

OmniRoute安裝並驗證 OmniRoute 閘道。