FyAgent
在一个本地桌面应用中管理你的模型、技能、MCP、提示词与 AI 软件配置。
- Star 数
- ★ 219
- 最近更新
- 6 天前
- License
- NOASSERTION
- 主语言
- Rust
- FA 评分
- 84/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Codex、Claude Code 和 OpenCode 的个人用户，希望从一个桌面界面统一检查和修改各工具的模型、Skills、MCP 与提示词配置。
- 不适合
- 需要 Linux 桌面环境的用户，官方仅支持 Windows 与 macOS
- 需要 MSI 或便携 ZIP 安装包的 Windows 用户，目前只有 NSIS 安装程序
- 要求 OSI 认证开源许可或商业使用的团队，自有组件采用非商业许可
- 源码审查
- 84/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
FyAgent 是面向 Windows 和 macOS 的本地桌面应用，用来集中管理个人使用的 AI 软件及其配置。它可以扫描 QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code 和 OpenCode，并在相应软件支持时提供安装、更新、启动、认证及资源分配入口。应用还管理模型与 Provider 设置、Skills、MCP 服务、提示词，以及 OpenClaw 和 Hermes 的记忆文件。配置修改会在写入前显示预览，并在保存后执行结果检查；工作数据默认保存在本机 ~/.fyagent。它不是托管式 Agent 执行平台，主要交付物是对本地 AI 工具配置和记忆文件的可视化管理与写入。
FyAgent 首先扫描本机安装的 QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code 和 OpenCode，然后为检测到的软件显示可用的安装、更新、启动、认证或资源分配入口。用户可以查看或修改模型与 Provider 设置，从本地或发现页安装 Skills 并分配给受支持的软件，也可以添加、导入、管理和分配 MCP 服务。提示词管理覆盖 Grok Build、Codex、Claude Code、OpenCode、Gemini、OpenClaw 和 Hermes；记忆模块可以编辑 OpenClaw 与 Hermes 的长期记忆文件以及 OpenClaw 的每日记忆。写入配置前，应用展示变更范围；保存后，它会检查结果，并可按页面提供的入口测试连接。产生的配置和工作数据保存在本机，默认目录为 ~/.fyagent。
- 同时使用 Codex、Claude Code 和 OpenCode 的个人用户，希望从一个桌面界面统一检查和修改各工具的模型、Skills、MCP 与提示词配置。
- 不熟悉 Provider、MCP 或提示词配置文件的用户，需要通过可视化界面完成设置，并在写入前审阅具体变更。
- 需要在多款受支持 AI 软件之间分配同一批 Skills 或 MCP 服务的用户，希望减少逐个工具手工配置的工作。
- 使用 OpenClaw 或 Hermes 的用户，需要直接维护长期记忆文件，或管理 OpenClaw 的每日记忆。
- 重视本地数据控制的用户，希望把工作配置默认保存在 ~/.fyagent，而不是交给一个托管式控制台。
如何安装或部署这个 Agent？
运行环境为 Windows 或 macOS。从 GitHub Releases 下载当前系统对应的安装包：macOS 使用 FyAgent-X.Y.Z-macOS.dmg；Windows x64 使用 FyAgent-X.Y.Z-Windows-x64-setup.exe，Windows ARM64 使用 FyAgent-X.Y.Z-Windows-arm64-setup.exe。Windows 仅提供 NSIS 安装程序，没有 MSI 或便携 ZIP；macOS 构建使用 Apple Developer ID 签名并经过 Apple 公证。安装前应阅读该版本的可信度说明，并核对校验和、signing-status.json 和构建证明。普通安装没有文档化的命令行步骤或统一凭据要求；具体 AI 软件的认证应通过 FyAgent 在支持时提供的认证入口完成。
如何使用这个 Agent？
启动 FyAgent 后打开“AI 软件配置”，扫描本机已经安装的 AI 软件。选择检测到的软件并进入配置页，再按需要设置模型与 Provider、安装和分配 Skills、添加或导入 MCP 服务、管理提示词，或配置认证。保存前检查预览所列的修改范围；保存后按照页面提示确认配置结果或测试连接。OpenClaw 和 Hermes 用户还可以进入记忆模块编辑长期记忆，OpenClaw 用户可另外维护每日记忆。升级 FyAgent 前应备份重要配置。
这个 Agent 有哪些优点和局限？
- 把模型、Provider、Skills、MCP、提示词和记忆管理集中在同一个本地桌面界面，而不是要求用户分别编辑多款 AI 软件的隐藏配置。
- 配置写入前提供变更预览，保存后再检查结果，有助于降低误改配置的风险。
- 明确覆盖 Codex、Claude Code、OpenCode、Gemini、OpenClaw、Hermes 等多个工具或配置目标，不绑定单一模型提供商。
- 工作数据默认保存在本机 ~/.fyagent，并提供配置备份和写入位置说明。
- 同时提供 Windows x64、Windows ARM64 和经过签名、公证的 macOS 安装包。
- 项目仍在持续开发，升级前需要备份重要配置并审阅每次发布的可信度说明。
- 不同 AI 软件支持的能力存在差异；安装、更新、启动、认证和资源分配入口只会在相应软件支持时出现。
- 仅明确支持 Windows 和 macOS，没有提供 Linux 安装方式。
- Windows 不提供 MSI 或便携 ZIP，只提供 NSIS 安装程序。
- FyAgent 是源码可用软件而非 OSI 定义的开源软件；自有组件和修改采用 PolyForm Noncommercial License 1.0.0，商业使用需要另行取得书面授权。
这个 Agent 与同类方案有什么区别？
当前 FyAgent 桌面应用由 CC Switch 演进而来，并保留继承代码的原作者版权和 MIT 许可声明；FyAgent 自有部分则采用 PolyForm Noncommercial License 1.0.0。现有材料没有提供两者逐项功能对比，因此无法据此判断迁移兼容性或功能覆盖差异。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| FyAgent 当前 | 84 · 表现良好 | 桌面应用免费 | ★ 219 | 6 天前 | Rust | — |
| ClawX 桌面端 | 45 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 7.6k | 3 天前 | TypeScript | Codex · OpenAI API |
| AionUi Cowork | 43 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 34k | 3 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| TencentDB Agent Memory | 41 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 30k | 今天 | TypeScript | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
安全策略清楚描述本地数据、远程数据、导入、同步、deeplink、代理请求及凭据的数据路径；CI 权限只读、凭据不持久化，第三方 Actions 固定到提交，且安排 CodeQL。README 要求写入前预览、保存后检查，安全策略也要求对导入的可执行集成取得明确知情同意。扣分在于应用继承当前用户的文件权限，本地代理可绑定非 loopback，且所给源码没有展示所有确认界面、密钥存储实现或网络访问控制。备份与恢复文档被引用但未提供正文，因此回滚仅算充分但不完整。项目沿革、CC Switch 来源、作者和第三方许可归属清楚，来源署名可得满分。
README、包配置、安全策略、CI 和测试对产品名称、平台、工具链和架构的描述一致；CI 包含版本契约、类型检查、格式、单元、浏览器、Rust、原生凭据及架构检查。依赖管理有固定 pnpm、锁定安装和工具链核验，但多个 npm 依赖仍使用范围约束，且构建依赖外部下载、mise、Rust、uv 和托管 Python，降低可用性分。CI 会汇总步骤结果，但实际用户侧错误信息与恢复指引的实现未包含在材料中，故 failure_messages 不给满分。
材料明确面向 AI Agent、Worker 和助手用户，并用非专业语言解释 Provider、MCP 与 Prompt；功能矩阵具体列出各 AI 软件在模型、Skills、MCP、提示词和记忆方面的支持差异。安全策略对可信边界、范围内外及失效条件划分尤其完整。Windows x64/ARM64 与 macOS 的安装、构建和检查路径清楚。扣分主要在 trigger_precision：扫描、导入、保存、deeplink 和代理等触发场景虽被说明，但缺少相关实现代码，无法确认所有自动行为都被精确限制。
README 的导航、快速开始、功能表、FAQ、社区入口、开发命令和多语言手册链接形成清晰的信息架构；命名和 FyAgent/VibeKey 演变也有解释。许可文件明确区分 PolyForm Noncommercial、CC Switch MIT、第三方内容和商业授权，足以支持满分。局限与发布状态被明确披露，包括仅支持最新版、Windows 无 MSI/便携包及代理边界。扣分在于完整 FAQ、安装手册和发布说明正文未提供；维护渠道和安全响应时限明确，但发布者身份未经注册表核验且责任主体主要表现为单一账号，没有更完整的组织或继任信息。
README 给出可操作的安装、扫描、配置、预览和验证流程，界面截图与功能矩阵表明输出能够直接用于管理多个 AI 工具。将模型、Skills、MCP、提示词和记忆集中管理具有明确增量价值，但材料主要是产品声明，未提供用户研究或对比结果。成本方面有本地存储、无项目云后端和统一管理的优势，但非商业许可、复杂开发工具链、外部服务依赖及升级前备份负担使 cost_benefit 不能满分。
关键声明大量指向具体文件、配置项、源码位置、版本 v3.18.0、哈希和测试契约；README、安全策略、package 配置、CI 与架构测试相互呼应。安全策略还明确区分可核验事实、范围划定决定和失效条件，因此事实与推断分离处理充分。此评估未执行项目，CI 和测试只证明仓库声明了检查机制，不证明本修订实际通过。
- 本地 HTTP 代理可配置为绑定非 loopback 地址；启用前应限制监听接口、端口和网络访问，并把所有入站请求视为不可信。
- 该应用会修改其他 AI 工具的配置并可能导入可执行 MCP、脚本或 deeplink 内容；每次保存或启用前都应完整核对命令、参数、环境变量和差异预览。
- API Key、令牌、WebDAV/S3 同步数据及共享配置可能跨越信任边界；材料未完整展示密钥存储、日志脱敏与同步加密实现。
- 项目仍在开发且只有最新版获得安全更新；升级前备份 ~/.fyagent，并核验校验和、签名状态和构建证明。
- 自有代码采用 PolyForm Noncommercial 而非 OSI 开源许可；商业使用需另行书面授权，并应逐项确认混合许可边界。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
FyAgent v0.4.14 This is a transitional pre-release after 0.4.12. It includes the follow-up fixes merged in #366 and the native compaction fix in #367. Version 0.4.13 was published separately as a pre-release; this release proceeds directly to 0.4.14. Version 0.4.10 remains the latest stable release. Changes - Skills. Confirm the update-all list before updating skills. Fixes - macOS notarization. Retry ticket stapling with backoff for transient failures (#371). …在 GitHub 查看 ↗ -
v0.4.10 FyAgent v0.4.10
发布说明摘录
FyAgent v0.4.10 A fix release after 0.4.9 focused on Windows installation and detection. The issues were found during the v0.4.9 virtual machine installer smoke runs. Fixes - Claude Code and Grok Build status on the Windows directory page. Both use the shared current-user helper. During parallel scans, a later request now waits in line for up to 30 seconds. Previously the request that lost the race showed "currently unavailable" and hid the install button. - When the helper cannot run. If the helper stays busy past the wait, …在 GitHub 查看 ↗ -
v0.4.9 FyAgent v0.4.9
发布说明摘录
FyAgent v0.4.9 This is the first published release since 0.4.5. It includes the changes prepared as 0.4.6, 0.4.7 and 0.4.8, which were not published as separate releases. The v0.4.8 tag exists, but its release was stopped before publication because its English release notes (docs/release-notes/v0.4.8-en.md) were missing; 0.4.9 ships the same product changes. Highlights - Session Center. Export the final text of a session as a package, preview it on another device, check target compatibility, and keep local restore …在 GitHub 查看 ↗