我們剛把 driver 升到 3.x。只列出會動到 src/db/ 底下任何東西的變更，並逐條引用。回傳內容一張簡短的清單，指向遷移說明與版本條目，只影響你手上沒有的那些程式碼的變更都被排除掉。
Pi 上的 Felo Search
Pi Coding Agent
Pi Coding AgentPi 讀你的儲存庫。它還是讀不到 changelog。
核心小是優點，直到任務取決於上週才出貨的東西。Felo Search 交給工作階段帶日期的答案，並附上每一條說法出自哪個頁面，所以升級與否的決定是靠廠商的說明，而不是靠記憶中的 API。
Pi 上的 Felo Search
- 01套件
- felo-skills/felo-search
- 02憑證
- FELO_API_KEY
- 03回傳形式
- 說法、來源、日期
- 04典型根目錄
- ~/.pi/agent/skills/
只為一個工作階段載入它
pi --skill /path/to/felo-searchPi 刻意保留一個很小的核心，並要你去擴充它，所以技能就是那個「增加觸及範圍、又不必多養工具」的既定做法。
- 載入來源
- ~/.pi/agent/skills/ · .pi/skills/ · 套件
- 安裝是
- 複製一個資料夾，或 pi install npm:@scope/pkg
- 值得知道
- 沒有沙箱 —— 掛上去之前先讀 SKILL.md
答案送達時，附著頁面與日期
在一個 harness 裡，搜尋的價值不是多一點文字，而是每一條說法都查得動。日期跟連結一樣重要：五天前的一筆 changelog 描述的是你即將執行的版本，去年那筆不是。
說法來源發布時間
v3 client 把串流 helper 改名了docs.vendor.com/sdk/v3-migration5 天前
重試現在預設 5 次並帶退避github.com/vendor/sdk/releases5 天前
連線池耗盡問題已在 2.4.1 修掉github.com/vendor/sdk/issues/441211 天前
Node 24 是目前的 LTS 線nodejs.org/en/about/previous-releases3 週前
舊端點六月之後就不再回應status.vendor.com/deprecations2 週前
把要求寫進提示詞，不要指望它自己做到：「每一項都附上來源與日期，任何你無法查證的都標出來。」
兩個只讀儲存庫的工作階段答不出來的問題
這兩個都取決於工作目錄之外的東西，而在套件掛上去之後，兩個都變成查得動的。
弄壞我們包裝層的那個重試行為，是這個版本已知的問題嗎？把你讀到的地方給我看。回傳內容把那個 issue 討論串或 changelog 條目跟你自己檔案的實際行為並排，讓你看得出兩者到底對不對得上。
在 Pi 上安裝Pi 會載入的四個地方，以及一個跳過它們全部的旗標
沒有東西要編譯，也不用註冊帳號。唯一的決定是這個套件屬於哪個根目錄 —— 而 Pi 自己的規則是：專案技能在你信任這個專案之前都處在休眠狀態。
- 01
~/.pi/agent/skills/全域這台機器上的每個專案。讀完之後想讓它到處都在，就放這裡。
- 02
~/.agents/skills/共用其他 harness 也會讀的那個資料夾，所以一份複製就能同時服務 Pi 和你跑的其他東西。
- 03
.pi/skills/專案只給這個儲存庫，而且只在你信任這個專案之後。要評估一個還沒讀過的套件時，這裡是對的地方。
- 04
pi install npm:@scope/pkg套件某個套件的 skills/ 目錄，有版控、可更新。當一個套件值得長期留下時，這是更乾淨的路。
或者只為一個工作階段載入它，不必複製
pi --skill /path/to/felo-search
# additive even when you start with --no-skills每次版本動了就值得重跑一次的升級檢查
這是在 Pi 上行得通的形狀：把問題縮到某個版本，然後強迫答案說出它的證據。
執行時機
lockfile 裡的某個版本動了，或即將要動，而 changelog 比你有的時間還長。
- 01
把問題釘在某個版本上
先從 lockfile 讀出你裝的版本，再問那個版本以及之後的版本。問「最新版」只會得到一個關於你根本沒在跑的版本的答案。
- 02
每一項都要一個連結和一個日期
一個關於套件、卻沒有來源的說法，就是文法很好的猜測。日期讓你可以把比你在跑的版本更舊的東西直接丟掉。
- 03
把發現對到你手上的檔案
問它哪幾項變更會動到工作階段在這個儲存庫裡看得見的路徑。這才是把 changelog 變成一張待辦清單的關鍵。
- 04
把答案留在下一個工作階段會看的地方
Pi 的工作階段不共用記憶，所以請把結果寫進儲存庫 —— 一個筆記檔、一則註解、一段 commit 訊息。只活在滾動歷史裡的發現，就是不見了。
留下什麼一份篩選過、只影響這個儲存庫的變更清單，每一項都附連結與日期，外加一段明白標示什麼無法查證的說明。
搜尋不會替你做的三件事
知道邊界在哪，反而讓你在它成立的那個範圍裡更容易信任這些答案。
它回答的是世界，不是你的程式碼
搜尋告訴你廠商出貨了什麼。那會不會弄壞你的模組是一個程式碼問題，值得當成程式碼問題來問，對著工作階段眼前的那些檔案問。
來源的好壞，取決於那個頁面
一筆帶日期的 changelog 是強證據；一則論壇回覆只是線索。日期讓這個差別看得見，你可以據此衡量，而不是把每個連結都當成一樣重。
沒有東西在背景抓取
只有當工作階段判斷某件工作需要最新資訊時，這個技能才會跑。一次完全不問外面世界的重構，成本是零，而且全程離線。
Pi 使用者會問的 Felo Search 問題
Pi 需要 Felo CLI 才能用這個嗎？
需要。套件是一份程序；CLI 才是跟服務講話的那個東西。把 felo-ai 裝一次，金鑰留在你的使用者設定裡，它就永遠不會落在儲存庫中。
用套件還是用資料夾？
對一個還在評估的套件來說，複製資料夾最快。一旦你想讓同一個技能出現在好幾台機器上、還要有辦法更新它，pi install npm: 或 git: 是更好的答案。
我為什麼要用 ~/.agents/skills/ 而不是 ~/.pi/agent/skills/？
因為那是共用的根目錄：其他 harness 讀的是同一個資料夾，所以一次複製能涵蓋的不只 Pi。當你想讓某個套件只給 Pi 用時，就用 Pi 專屬的那個根目錄。
答案沒有日期代表什麼？
代表你讀到的很可能是模型的記憶，而不是即時結果。再問一次，要求每一項都有來源與日期，並且把仍然兩者都缺的一律當成未查證。
Pi Coding Agent 的所有 Felo 技能
這 5 項技能都是為 Pi Coding Agent 撰寫的。它們在這個平台上的用法一致，所以你可以放在同一次工作階段裡組合使用，不必重新說明自己的環境。
Felo Slides
Felo YouTube Subtitling
Felo X Search
Felo SuperAgent一個 API Key，一整套 Agent 工具
從技能開始，再依 Pi 工作流程的需要組合模型、即時資料、知識與輸出工具——用的還是 Felo 技能已經在用的那個 Key。
模型
當 Agent 需要自訂推理或生成時，使用成本效益更好的 LLM 存取。
- LLM API
- 對話補全
- 模型存取
即時資訊
為 Agent 提供最新的 Web 與社交訊號，而不是依賴過時的脈絡。
- Web Search
- X Search
- Web Fetch
知識與輸出
把工作建立在可重複使用的知識上，再轉換成可分享的交付物。
- LiveDoc
- PPT 生成
- 心智圖
創意工具
把工作流程從調研延伸到視覺呈現與可直接交付的 Office 成果。
- 圖像生成
- 頁面工具
- Office 輸出