FyAgent
在一个本地桌面应用中管理你的模型、技能、MCP、提示词与 AI 软件配置。
按维度查看评分与理由
安全策略清楚描述本地数据、远程数据、导入、同步、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 开源许可；商业使用需另行书面授权，并应逐项确认混合许可边界。
这个 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 有哪些优点和局限？
- 把模型、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？
运行环境为 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 与同类方案有什么区别？
当前 FyAgent 桌面应用由 CC Switch 演进而来，并保留继承代码的原作者版权和 MIT 许可声明；FyAgent 自有部分则采用 PolyForm Noncommercial License 1.0.0。现有材料没有提供两者逐项功能对比，因此无法据此判断迁移兼容性或功能覆盖差异。