安裝 Yenpo，開啟第一個儲存庫

App 介面目前提供英文和簡體中文。本指南以英文介面的按鈕與選單名稱說明操作。

不連線模型也能用 Yenpo 讀程式碼：瀏覽檔案、搜尋和語言服務導覽都在本機完成。等你想就程式碼向 AI Reader 提問時，再設定模型服務商。

確認 Mac 是否支援

目前早期預覽版同時支援 Apple silicon 和 Intel 晶片的 Mac，系統需要 macOS 14 或更新版本，兩種 Mac 下載同一個安裝檔即可。系統版本可以在「關於本機」裡檢視。

每個預覽版安裝檔都有固定的到期日期，顯示在下載按鈕旁邊。日期在打包時就定了，晚點下載或重新安裝都不會延後。請在到期前換成新版本。

安裝

1. 從首頁下載 .dmg 檔案。
2. 開啟磁碟映像，把 Yenpo 拖進「應用程式」資料夾。
3. 從「應用程式」啟動 Yenpo，然後推出磁碟映像。

核對安裝的版本

在選單欄選擇 Yenpo → About Yenpo，把版本號與下載按鈕旁邊的版本對照。這個視窗也會顯示目前安裝檔的 EAP 到期時間，按 Mac 的本機時區顯示；網站上的日期使用 UTC。

如果剛更新完，看到的卻還是舊版本，先退出 Yenpo，再從「應用程式」開啟。替換步驟見在預覽版到期前更新。

開啟專案

開啟要讀的專案資料夾，最好選儲存庫根目錄，也就是放著 README、建置檔案和 .git 的那一層。只開啟某個子目錄的話，儲存庫裡其他位置的測試和設定就不在專案裡了。

按 Command-P（Go to File…），輸入檔名或路徑的一部分，開啟一個你認識的檔案。README 或相關測試可以開在另一個標籤頁裡。要讀另一個專案，就在新視窗裡開啟它。

確定存在的檔案卻找不到？先確認它在你開啟的資料夾裡，再看看是不是隱藏檔案或被 Git 忽略的檔案沒有顯示。詳見查詢檔案、跟隨符號。

先做一個小任務

挑一個結果容易核對的任務，比如找到某個設定項在哪裡被讀取：

1. 用全文搜尋查詢完整的設定名，或一段有辨識度的輸出文字。
2. 開啟匹配的函式，看它從哪裡拿到輸入。
3. 有語言伺服器時，用Go to Definition或Find References；沒有的話，直接按文字搜尋這個符號。
4. 讀一讀提供輸入的呼叫方或測試。

做到這裡就夠了：一個入口、一個要追的值，還有一處能說明它怎麼用的呼叫方或測試。不用先把整個架構弄懂。

問問 AI Reader（可選）

按連線模型服務商設定好服務商，然後開啟 AI Reader，就剛才讀的程式碼提問。可以把檔案、資料夾或選區加進去作為起點，也可以直接描述現象，讓它在專案裡找相關程式碼。

例如：

從預設值開始，追蹤這個設定怎麼傳到請求處理函式。哪些地方能覆蓋它？告訴我需要核對的分支。

點選回答裡的原始碼引用，會在Quick Look裡顯示對應程式碼；點Open File可以把它留在標籤頁裡。先核對一個結論，再問更大的問題。

AI Reader 預設唯讀，可以按輪允許它修改檔案。具體怎麼授權、哪些內容會發給模型，見資料去向與編輯權限。

在預覽版到期前更新

1. 檢視首頁下載按鈕旁邊的版本和到期日期。有新版本時，再下載新的 .dmg。
2. 儲存尚未儲存的檔案，然後退出 Yenpo。開啟新磁碟映像，把 Yenpo 拖進「應用程式」；Finder 詢問時，替換原來的應用。
3. 從「應用程式」啟動，再到 Yenpo → About Yenpo 核對版本，最後推出磁碟映像。

重新下載或安裝同一版本不會延長有效期。如果手上的版本已到期，而首頁仍提供同一版本，請等待新版釋出。

遇到問題時

現象	先檢查
找不到檔案	專案根目錄、檔案路徑、隱藏檔案和 Git 忽略檔案設定
跳至定義沒反應	語言伺服器是否安裝，能否理解這個專案
AI Reader 答不出來	目前服務商、API 型別、端點、模型 ID、API Key
看到的程式碼和預期不同	標籤頁裡是 Git 歷史版本，還是目前檔案

記錄問題時，保留 Yenpo 和 macOS 版本、預期結果、實際結果和重現步驟。公開分享前去掉私有程式碼和 API Key。

接下來做什麼

繼續閱讀查詢檔案、跟隨符號與核對原始碼引用。先從檔案搜尋開始，有對應語言伺服器時再使用符號導覽。也可以比較提交和分支，這些都不需要模型帳號。

想就程式碼向 AI Reader 提問時，再連線模型服務商。傳送問題前，先了解哪些程式碼會發給服務商，以及服務商的收費方式。