ByteRover

• 在開始任何任務之前 — 執行 brv query 以找出相關規則、偏好設定與過去的決策，然後再讓您的 agent 動到任何檔案。
• 在實作有意義的變更之後 — 執行 brv curate 以保存新的模式、架構選擇或決策，讓未來的工作階段能繼承這些知識。
• 在團隊專案中 — 使用雲端同步（brv push / brv pull），讓每位 agent 或開發者共享相同的精選知識庫。
• 當 agent 需要回顧過去的操作或能力時 — 查詢儲存的記憶，而非依賴可能已滾出範圍的上下文視窗歷史紀錄。

• 您所需的資訊已存在於目前的上下文視窗中——請跳過 brv query，以避免多餘的 LLM 呼叫。
• 該事實是暫時性的、特定於任務的，或屬於一般世界知識——請勿使用 brv curate 將短暫性資料污染知識庫。

所有知識都以 Markdown 檔案的形式儲存於專案目錄中的 .brv/context-tree/ 資料夾內。這些檔案完全可供人類閱讀、支援差異比對（diff），並可與程式碼一同提交至版本控制系統。

內建的 ByteRover 提供者可直接驅動 brv query 和 brv curate，開箱即用 — 只需執行 brv providers connect byterover。您也可以使用自己的 API 金鑰，切換至 OpenAI、Anthropic、Google 或其他提供者。

brv query 利用 LLM 從已儲存的 Markdown 內容中綜合生成答案。brv curate 能對新知識進行分類與結構化處理——包括來自最多 5 個來源檔案的內容——並將其寫回知識庫。

每次執行 brv curate 都會產生一筆具有唯一 ID 的日誌條目。您可以使用 brv curate view 來檢視最近的策劃記錄、依時間或狀態進行篩選，或查看任何過去條目的完整檔案操作詳情。

使用 ByteRover API 金鑰進行驗證，即可將您的知識庫推送至共享雲端空間或從中提取。團隊可將知識整理至團隊內的具名空間，切換空間時系統會自動提取相關的情境內容。

除非您明確執行 brv push，否則不會有任何資料傳送至 ByteRover 伺服器。所有查詢與整理操作均在本地進行——只有您所設定的 LLM 供應商會接收內容以進行處理。

在代理撰寫任何程式碼之前，先執行 brv query "What are the authentication patterns in this project?"。先前整理好的架構決策會立即浮現，防止代理重新發明或違背已建立的模式。

將 REST 遷移至 GraphQL 後，執行 brv curate "GraphQL is now the API layer; REST endpoints deprecated" -f src/api/schema.ts，讓未來每個代理工作階段都能自動繼承該背景脈絡。

連接共享的 ByteRover 雲端空間，推送精心整理的慣例（命名規則、部署步驟、程式碼風格決策），讓每位團隊成員的代理程式在開始工作前都能取用相同的知識庫。

使用 brv curate view --since 7d --status completed 來檢視一週內的整理記錄、驗證準確性，並在低品質條目影響代理程式未來行為之前將其找出。