fyagent

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

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

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

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

当前功能

区域	可以做什么
AI 软件配置	扫描 QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code 和 OpenCode；在支持时提供安装、更新、启动、认证和资源分配入口
运行状态	检查软件安装、配置和连接状态，并进入对应的处理入口
账号与认证	添加官方账号、管理软件连接，并选择 Codex 请求来源
模型管理	为上述软件查看或修改模型与 Provider 设置；写入前预览变更，并在保存后检查结果
Skills 管理	从本地或发现页安装 Skills，并分配给支持的软件
MCP 管理	添加、导入和管理 MCP 服务，并分配给支持的软件
提示词管理	管理 Grok Build、Codex、Claude Code、OpenCode、Gemini、OpenClaw 和 Hermes 的提示词
记忆模块	编辑 OpenClaw 与 Hermes 的长期记忆文件，以及 OpenClaw 的每日记忆

工作数据默认保存在本机 ~/.fyagent。具体写入位置、备份方法和各软件的支持差异见使用手册。

界面预览

以下截图使用简体中文。左侧导航提供软件配置、运行状态、账号、模型、Skills、MCP、提示词和记忆入口。

快速开始

1. 从 GitHub Releases 下载适合当前系统的安装包。
2. 打开“AI 软件配置”，扫描本机已安装的软件。
3. 选择一个软件并进入配置页。根据页面提供的入口设置模型、Skills、MCP、提示词或认证。
4. 保存前检查预览中的修改范围；保存后按页面提示确认配置或测试连接。

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

下载与发布验证

发布文件名如下：

• macOS：FyAgent-X.Y.Z-macOS.dmg
• Windows：FyAgent-X.Y.Z-Windows-x64-setup.exe、FyAgent-X.Y.Z-Windows-arm64-setup.exe

Windows 当前提供 NSIS 安装程序，不提供 MSI 或便携 ZIP。macOS 构建使用 Apple Developer ID 签名，并经过 Apple 公证。

安装前请阅读发布说明，并核对校验和、signing-status.json 和构建证明。NotSigned 只表示签名状态，不能单独证明文件安全；若安装包被 Windows 拦截，见拦截处理说明。各系统的步骤见安装说明，版本记录见发布说明索引。

常见问题

目前 Windows 安装包尚未包含 Authenticode 签名，在 Release 页面显示为 NotSigned。遇到系统拦截时，请坚持「先校验、后放行」：

1. 先用 PowerShell Get-FileHash 核对 SHA-256（与 Release 页面一致，不一致请立即删除且切勿运行），可选 gh attestation verify 验证构建证明。
2. SmartScreen 提示「Windows 已保护你的电脑」时，点击「更多信息」并确认文件名后点击「仍要运行」。
3. 若文件被标记为来自网络，在安装包「属性 → 常规」底部勾选「解除锁定」。
4. 遇到 Windows 11 智能应用控制（Smart App Control）或安全软件误报等情况，详见Windows 安装包被拦截时的完整处理步骤。

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

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

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

社区与贡献

• 使用问题与排查：Q&A
• 功能想法：Ideas
• 配置与使用经验：Show and tell
• 可复现缺陷与明确任务：Issues

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

本地开发

首次 checkout 需要全局安装 mise >= 2026.8.6：

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

构建当前系统版本：

mise run build

提交前运行 mise run check。完整工具链、分层检查和发布要求见开发文档。

Star History

项目来源与授权

FyAgent 的前身 VibeKey 是一个实体键盘与配套驱动的产品构想。项目后来转为跨平台桌面软件，重点改为 AI 软件配置与本地数据管理，并更名为 FyAgent（For You Agent）。

当前桌面应用基于 CC Switch 演进，并保留继承代码的原作者版权和许可证声明。FyAgent 自有组件和修改采用 PolyForm Noncommercial License 1.0.0，商业使用须另行取得书面授权。详见 LICENSE、LICENSING.md 和 THIRD_PARTY_NOTICES.md。