fy-agent/fyagent

For You Agent——AI 时代的个人随身数字人格。把你的模型、AI 账号、技能、提示词和工作方式，带到每一个 AI 工具里。

FyAgent – 個人化AI代理控制中心

是什麼 – FyAgent（For You Agent 的簡稱）是一款跨平台桌面應用程式（Windows & macOS），讓您能管理已使用的各種AI工具的設定。它將通常分散在不同位置的元件——您想執行的模型／提供者、已安裝的技能／外掛程式、依賴的提示範本，以及外部服務的憑證——集中到一個本地儲存的使用者介面中。

為何重要 – 隨著AI助理、程式碼生成代理與「AI工作者」的普及，使用者不得不同時管理大量不同的設定檔、API金鑰與模型選擇。FyAgent使這些隱藏的設定變得可見、可編輯且可攜帶，降低設定錯誤的風險，並提供一致的方法，在所有支援的工具間切換模型或新增新功能。

核心功能（如README所述）

領域	可執行操作
AI軟體設定	掃描已安裝的AI相關應用程式（例如：QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code、OpenCode）。透過UI，您可以安裝、更新、啟動、認證並為每個支援的應用分配資源。
模型管理	查看並編輯每個應用使用的模型與提供者（模型主機服務）。變更在儲存前可預覽，儲存後應用會驗證結果。
技能管理	從本地來源或發現頁面安裝「技能」（外掛程式或工具整合），並指派給支援的應用程式。
MCP管理	新增、匯入並管理MCP（可能是模型控制平面或類似服務），然後將其綁定到支援的應用程式。
提示管理	編輯Grok Build、Codex、Claude Code、OpenCode、Gemini、OpenClaw與Hermes使用的提示範本。
記憶模組	編輯OpenClaw與Hermes的長期記憶檔案，以及OpenClaw的每日記憶檔案。

所有設定資料預設儲存在本地機器的 ~/.fyagent 目錄中，README連結至備份與檔案位置的詳細文件。

典型工作流程

安裝 – 從GitHub發行頁面下載適合的安裝程式（macOS用.dmg，Windows用.exe）。macOS版本已簽署並經過公证；Windows版本為NSIS安裝程式。
掃描 – 開啟AI軟體設定頁面；FyAgent會自動發現您已安裝的支援AI工具。
設定 – 選擇一個工具，然後使用側邊欄設定模型／提供者、附加技能、選擇MCP服務，並編輯提示或記憶檔案。預覽將準確顯示將發生的變更。
套用 – 儲存變更；FyAgent執行儲存後驗證，並在可能的情況下啟動目標應用或測試連線。
迭代 – 任何時候返回UI，即可切換模型、新增技能或微調提示，而無需深入每個工具的獨立設定檔。

安裝與開發說明

前置條件 – 從原始碼建置需要 mise 版本管理器（≥ 2026.8.6）。倉儲提供腳本（mise run bootstrap、mise run dev、mise run build 等），用於設定工具鏈、執行檢查並產生平台特定的二進位檔。
發行驗證 – 每個發行版本均附帶校驗和、signing-status.json 檔案與建置證明文件。建議在安裝前驗證這些內容。
授權 – 程式碼為源碼可見，但非OSI認可的開源。FyAgent自身元件採用 PolyForm Non-commercial License 1.0.0；從CC Switch專案繼承的第三方程式碼仍遵循MIT授權。商業用途需另行書面許可。

哪些人可能受惠？

運行多個AI程式碼助理或聊天代理的開發者與進階使用者，希望在一個地方切換模型、更新憑證或新增新外掛程式。
需要為每台工作站建立可重現、本地儲存設定，而不依賴僅雲端管理方案的團隊。
探索新興AI代理的熱衷者，希望在多個工具間實驗不同的提示範本、記憶檔案或技能組合。

如何取得協助

討論 – 倉儲的討論區提供問答、想法與「展示與分享」主題。
問題 – Bug回報需遵循提供的模板；維護者要求提供版本、作業系統與重現步驟。
文件 – 完整的使用者手冊以中文、英文與日文提供，涵蓋安裝、設定檔、常見問題與開發指南。

總結

FyAgent是一款真實、持續維護的桌面實用工具，將日益擴張的AI驅動開發工具生態中原本分散的設定集中管理。它本身不執行推論或訓練，但簡化了您連接與控制驅動這些工具的模型、提示與擴充的方式。