FyAgent

For You Agent——AI 时代的个人随身数字人格。

把你的模型、AI 账号、技能、提示词和工作方式，带到每一个 AI 工具里。

English · 日本語

下载最新版 · 使用手册 · 讨论区 · 参与贡献

AI 时代的个人智能控制中心

FyAgent 面向正在使用 AI Agent、AI Worker 和智能助手的人。它把模型从哪里来、能连接哪些工具、会哪些技能、遵循什么指令、保存怎样的配置，集中到一个本地桌面应用里。

你不需要先弄懂 Provider、MCP 或 Prompt 这些术语。对用户来说，它们分别是 AI 的大脑来源、工具连接和行为指令。FyAgent 要做的，是把原本散落、隐蔽、容易改错的选择变得可见、可改，也能跟着你走。

今天，FyAgent 先从最具体、也最容易失控的配置层做起，支持 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes。

WorkBuddy 另有独立的顶层配置入口；它不属于上述目标工具或 Provider 域，不能从这份工具清单推断其能力范围。

发布状态： FyAgent 仍在持续开发。升级前请备份重要配置，并在安装前阅读当次发布的可信度说明。

愿景：成为 AI 时代的随身数字人格

这里的“数字人格”不是一个模仿你说话的虚拟头像，而是你怎样选择、塑造和管理 AI 的长期载体：它用什么模型、能调用什么工具、会哪些技能、按照什么方式工作，又应该记住什么。

• 愿景： 成为 AI 时代每个人的随身数字人格。
• 使命： 让强大的 AI 变得可控、可信、可陪伴。
• 产品价值： 成为 AI 时代的方向盘，让人始终知道自己的 AI 从哪里获得能力、怎样行动，以及控制权在谁手中。

AI 越强，人越容易担心权限交给了谁、配置为什么失效、换一个工具后 AI 为什么又从头开始。FyAgent 希望把这些选择留在人这一侧：不是给所有人复制同一个机器人，而是帮助每个人逐步拥有、培养和管理自己的 AI。

长期记忆与可延续的数字人格是产品继续建设的方向；下面列出的才是当前版本已经提供的能力。

今天已经能做什么

用户看到的能力	当前功能
AI 大脑	管理模型供应商与模型选择，使用预设或自定义兼容接口，一键切换
工具连接	集中管理 MCP 服务，并同步到支持的 AI 工具
AI 技能	维护 Skills，让常用能力不必在每个工具里重复安装和配置
行为指令	管理可复用的 Prompts，把常用工作方法带到不同工具中
调度与恢复	通过本地代理转发请求，设置故障转移，并检查模型是否可用
使用账本	汇总 token 用量和预估费用，方便核对日常开销
工作延续	从会话和工作区继续此前工作，并备份、同步配置

FyAgent 的工作数据默认保存在本机 ~/.fyagent。配置更新使用 SQLite 和原子写入；通过 fyagent:// 导入配置时，应用会先展示变更内容，再决定是否写入。

架构概览

React/Vite 渲染层通过 Tauri IPC 调用 Rust commands/services；Rust 本地层负责 SQLite 状态、目标 AI 工具的配置写入和本地代理。各层的维护入口与验证边界见开发文档。

快速开始

1. 从 GitHub Releases 下载适合当前系统的安装包。
2. 打开“供应商”，添加你正在使用的服务；预设会填好常用字段。
3. 选中供应商并点击“应用”，确认 FyAgent 即将写入的配置。
4. 在目标 AI 工具里发送一条简单请求。基础连接正常后，再添加工具连接、Skills 或行为指令。

完整说明见简体中文手册，也提供 English 和 日本語。

下载与发布可信度

发布文件名如下：

• macOS：FyAgent-X.Y.Z-macOS.dmg、FyAgent-X.Y.Z-macOS.zip
• Windows：FyAgent-X.Y.Z-Windows-x64-setup.exe、FyAgent-X.Y.Z-Windows-arm64-setup.exe
• Linux x64：FyAgent-X.Y.Z-Linux-x86_64.AppImage、FyAgent-X.Y.Z-Linux-x86_64.deb、FyAgent-X.Y.Z-Linux-x86_64.rpm
• Linux arm64：FyAgent-X.Y.Z-Linux-arm64.AppImage、FyAgent-X.Y.Z-Linux-arm64.deb、FyAgent-X.Y.Z-Linux-arm64.rpm

Windows 当前只提供 NSIS 安装程序，不提供 MSI 或便携 ZIP。macOS 构建使用 ad-hoc 签名，未使用 Apple Developer ID 签名，也未经 Apple 公证。Flatpak 仅供自行构建，不属于官方发布产物。

安装前请阅读发布说明，并核对校验和、signing-status.json 和构建证明。NotSigned 只是签名状态，不能单独证明文件安全。各系统的具体步骤见安装说明，版本记录见发布说明索引。

常见问题

FyAgent 会把数据保存在哪里？

默认保存在本机 ~/.fyagent。具体配置位置和备份方法见配置文件说明。

遇到安装或配置问题，应该去哪里提问？

先查看常见问题手册，再到 Q&A 讨论区描述版本、系统、相关工具和已经尝试过的步骤。可稳定复现的软件缺陷请提交 Bug Report。

FyAgent 已经具备长期记忆和完整数字人格了吗？

还没有。当前版本先解决模型、工具连接、Skills、行为指令、配置与使用记录的统一管理。长期记忆和跨工具延续的数字人格属于产品愿景，只有在真实功能完成并经过验证后，才会列为现有能力。

FyAgent 是开源软件吗？

FyAgent 是源码可用软件，不是 OSI 定义的开源软件。FyAgent 自有组件和修改采用 PolyForm Noncommercial License 1.0.0；继承自 CC Switch 的部分继续使用 MIT 许可证。详见授权说明。

参与社区

• 使用问题与排查：Q&A
• 尚未成形的功能想法：Ideas
• 分享你的 AI 配置与工作方式：Show and tell
• 可复现缺陷与明确任务：Issues

社区行为准则、支持范围和贡献流程见 CODE_OF_CONDUCT.md、SUPPORT.md 与 CONTRIBUTING.md。

参与开发

首次 checkout 需要全局安装 mise >= 2026.8.0。检查仓库配置后，按以下顺序进入交互开发：

mise trust
mise run bootstrap
mise run system:check
mise run dev

构建当前宿主是与交互启动分开的可选步骤：

mise run build

验证证据按范围分层：

• mise run check 是完整的当前宿主门禁，不证明原生窗口或安装器 HIL，也不证明签名或公证。
• 精确 PR head 上成功的 CI / Required 是远程合并门禁；其他 SHA 或单个子任务不能替代它。
• 正式 Release 需要独立的精确源 SHA、前置 CI、annotated tag、正式 Release workflow 与已发布资产证据；本地构建和 PR 检查不能替代这条链路。

工具链与小范围检查命令见开发文档。

项目沿革与授权

FyAgent 的前身 VibeKey 曾设想把 AI 配置和操作权装进一块可以随身携带的实体键盘。项目继续推进后，我们发现真正需要随身带走的不是一块硬件，而是每个人自己的 AI 选择、习惯和工作方式。于是产品从硬件控制器转向跨平台桌面软件，也把名字改成了 FyAgent（For You Agent）。

当前桌面应用基于 CC Switch 演进，并继续保留继承代码的原作者版权和许可证声明。FyAgent 产品名称、当前开发与新增部分由 FyAgent 项目维护。

FyAgent 自有组件和修改采用 PolyForm Noncommercial License 1.0.0，商业使用须另行取得书面授权。详见 LICENSE、LICENSING.md 和 THIRD_PARTY_NOTICES.md。