快速開始

FiboCode 在程式碼編輯器中，以原始碼、文件與圖譜建構一套與原始碼精確聯動、可隨原始碼持續成長的程式碼知識庫。這份共享上下文也會提供給你選擇的 Agent CLI，讓人與 Agent 能夠共同理解、定位和修改程式碼。

理解，與程式碼一同成長。

日常使用主要分成兩種方式——一種用來撰寫，另一種用來閱讀：

兩條路的起點相同：安裝應用程式、開啟工作區、設定模型。

下載與安裝

從 FiboCode Releases 頁面取得最新安裝程式：

• macOS：開啟 .dmg，將 FiboCode 拖曳到 Applications。
• Windows：執行 .exe 安裝程式並依照提示操作。

首頁的 Download 按鈕會自動指向最新版本，因此不必再尋找版本號碼。

開始之前

1. 開啟工作區。 在工作區面板按一下「Open Folder」並選擇程式碼庫，或直接將資料夾拖曳到面板。不支援拖曳 .zip 檔案；之後可透過「Recently Opened」切換工作區。FiboCode 以整個儲存庫，而非單一檔案，作為理解單位。

2. 設定模型。 前往 System Config → Model Config → Add Provider，填入 Provider Name、Interface Type（OpenAI 相容）、Base URL、API Key 與 Model Name；儲存後勾選 Main Model。將低延遲供應商標示為 Fast Model，讓對延遲敏感的呼叫優先使用它。Advanced Settings 可設定並行數、逾時與最大輸出 token 數。

模型就緒後，三項能力便會啟用：

• Diff 摘要——在原始碼控制面板將滑鼠移到檔案或目錄上，即可立即取得變更摘要，並在提交前一鍵產生 commit message。
• 程式碼補全——編輯器中的 AI 建議面板，可逐項接受或拒絕建議。
• 程式碼分析——分析整個儲存庫，產生目錄級、檔案級說明文件與概念圖。

3. 為 Agent 安裝 Fibo Skills（選用，建議）。 Fibo Skills 會為終端機中的 Agent CLI 加入 spec → plan → execute → sync 工作流程，並指導 Agent 將規格、計畫與變更記錄寫入 .fibo/ 文件系統。FiboCode 本身不會自動記錄專案的演進歷史；如需由 Agent 持續維護這些記錄，建議安裝並使用 Fibo Skills。安裝方式請參閱 Fibo Skills。

使用方式 1：強化終端機工作流程

繼續使用你已信任的 Agent CLI，不必改變習慣——FiboCode 只補上周邊的上下文與審查。

1. 切換到 CLI 模式並開始撰寫。 將聊天面板切換到 CLI 模式，開啟終端機並執行 Claude Code、Codex 或你偏好的 Agent CLI。
2. 切回聊天模式整理變更。 工作階段結束後切回，FiboCode 會統計期間碰過的每個檔案，列在 changed files card 上——不必再靠記憶或 git status 重建代理究竟做了什麼。
3. 快速審查。 在卡片上按 Review，逐 hunk 閱讀 diff，接受或拒絕每個區塊，也可一次處理整個檔案。快照可將檔案回復到較早狀態。
4. 提交。 開啟 Source Control，stage 變更，產生或撰寫 commit message，然後提交。

使用方式 2：分析與理解程式碼

閱讀儲存庫不是從頭到尾開啟每個檔案，而是讓程式碼說明自己的結構。

1. 設定範圍與範本。 前往 System Config → Code Analysis：
   • Directory Blacklist——目錄名稱採完全比對；符合的目錄及其所有內容都會排除（node_modules、dist、…）。
   • Extension Whitelist——只分析符合程式碼或設定副檔名白名單的檔案。
   • Analysis Templates——Directory、Code File、Configuration File 範本可分別編輯，用來決定產生說明的結構；每一項都能重設為原始內容。
2. 開始分析。 回到工作區面板，按一下 Analyze 執行全儲存庫分析。目錄與檔案會並行分析，並受模型設定的並行數限制；你可隨時中止，完成時會收到通知。
3. 閱讀說明。 按一下任一目錄或檔案，右側 Document 檢視會顯示其說明；切換到 Graph 檢視可查看該位置的概念圖。目錄級說明回答「這一層做什麼」，檔案級說明回答「這個檔案如何做到」。
4. 跟隨標籤。 說明中的 code / text / graph 標籤都是可點擊的錨點：code 跳到原始碼檔案與行範圍，text 跳到連結文件，graph 跳到對應概念圖。無論讀到哪裡，都能在程式碼與說明之間往返。

接下來去哪裡

• Fibo Skills——查看技能指南，了解各技能功能與安裝方式。
• Forum——在 GitHub Discussions 提問並分享工作流程。
• Bug Report——到 issue tracker 回報問題。