FyqyClaw · 飞扬企源 AI

English / 英文文档：README_EN.md · FAQ (English)

FyqyClaw · 飞扬企源 AI

全流程 AI 驱动开发工具 — IDE + AI Agent 双模式，从需求到代码一站式完成

核心特性 · 快速开始 · 项目架构 · 技术栈 · 常见问题 · 版本规划 · 许可证

💡 这是一款桌面 GUI 应用（Electron）。推荐直接下载安装包使用；npm 上发布的是源码包，供开发者阅读 / 二次构建，并非可双击运行的程序。运行方式见下方「快速开始」。

🌐 品牌与官网

本仓库由 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 维护，是飞虹智 klAI 开源生态的一部分。

🏠 官方网站：https://www.klai.top — 飞虹智 klAI · 泉州制造业 AI 服务商
📦 开源矩阵：https://www.klai.top/opensource.html
🤖 AI 编程智能体：https://github.com/wch887292/feihong-code — 飞虹 Code

📖 项目简介

FyqyClaw（飞扬企源AI） 是一款深度融合 AI 大模型能力的全流程开发工具，覆盖需求拆解、代码编写、项目理解、调试运行、代码审查、变更管理完整工程链路。

支持 传统 IDE 精细操控 与 AI 智能体全自动开发 双模式，适配个人开发与企业级工程迭代场景。

项目名称含义: "Fyqy" 来自"飞扬企源"（Feiyang Qiyuan）的拼音缩写，"Claw" 寓意像爪子一样精准抓取代码、捕获问题。整体寓意是"飞扬企源 AI 开发利器"。

与 Cursor / Windsurf / Trae 对比

对比项	FyqyClaw	Cursor / Windsurf / Trae
开发模式	IDE + SOLO 双模式，可随时切换	以 AI 辅助为主，无独立 AI Agent 模式
AI 自主性	SOLO 模式下 AI 可自主规划、编码、测试、审查	需要逐条指令交互
MCP 协议	原生支持，可扩展工具链	部分支持或需插件
安全体系	隐私模式 + 沙箱执行 + API Key 三重加密	基础加密
开源	✅ Apache-2.0 开源	❌ 闭源商业产品
本地部署	✅ 完全本地运行	部分依赖云端
费用	免费开源（仅需自备 API Key）	付费订阅 or 有限免费额度

✨ 核心特性

🎯 双重开发模式 — 按场景自由选择

模式	主导方	适用场景	特点
🖥️ IDE 模式	开发者主导	精细编码、调试、小规模修改	完整编辑器工具链，CUE 智能编码引擎，Git 管理，逐行控制
🤖 SOLO 模式	AI 智能体主导	新项目搭建、大规模重构、批量功能	AI 自主规划执行，自动生成+测试+审查，任务级控制

两种模式支持 随时一键切换（快捷键 Ctrl+Shift+M），互不干扰。

🤖 AI 全流程编程

多模型兼容基座 — 内置 8 大模型提供商，一键切换：

提供商	支持模型
OpenAI	GPT-4o、GPT-4o-mini、GPT-4-turbo、O1 系列
Anthropic	Claude Sonnet 4、Claude 3.5 Sonnet、Claude Opus 4
DeepSeek	DeepSeek V3、DeepSeek R1、DeepSeek Coder
智谱 AI	GLM-4-Plus、GLM-4-Air、GLM-4-Flash
通义千问	Qwen Plus、Qwen Turbo、Qwen Max、Qwen 2.5 Coder
Google Gemini	Gemini 2.5 Pro、Gemini 2.0 Flash
硅基流动	多种开源模型托管
自定义模型	兼容 OpenAI 接口的任意模型

CUE 智能编码引擎 — 链式补全、多行修改、依赖自动导入、引用批量重构，支持 Python / TypeScript / Golang 等主流语言。

AI 智能体全自动开发 — SOLO 模式下 AI 可自主完成：

📋 需求拆解 — 分析用户需求，拆解为可执行任务列表
🔧 技术选型 — 根据项目特点推荐技术和框架
📝 代码生成 — 自动生成完整项目或模块代码
✅ 自动化测试 — 生成测试策略，并在桌面端经加固沙箱真实运行测试命令
🔄 错误修复 — 发现错误后自动尝试修复
👁️ 代码审查 — 对生成的代码进行安全和质量审查
📊 变更汇总 — 生成变更摘要和 Commit 信息

全域上下文感知 — 文件、文件夹、Git 仓库、终端日志、业务文档、网页资料均可作为 AI 上下文，让 AI 完全理解项目全貌。

🔒 企业级安全体系

安全特性	说明
隐私模式	默认开启，所有代码、对话、生成内容不上传训练，全程本地留存
沙箱执行	隔离执行 AI 生成命令，拦截高危操作，限制文件访问权限，异常操作自动终止
API Key 本地加密	浏览器指纹 + 会话盐值混淆，禁止明文存储（当前为可逆混淆保护，后续版本将升级为系统密钥链 safeStorage 真加密）
日志遮蔽	日志输出自动遮蔽 API Key，只显示 `sk-**...**ab12` 格式
零数据收集	开源版不会收集任何用户数据，无需联网注册或登录

🔌 开放生态扩展

MCP 协议支持 — 对接 Git 操作、文件系统、GitHub、数据库等工具服务，AI 可直接调用外部工具
技能系统 — 可插拔 AI 辅助技能（代码审查、文档生成、测试生成、Commit 信息生成等）
插件系统 — 支持主题、语言包、功能扩展

🚀 快速开始

系统要求

平台	支持情况
Windows 10+	✅ 完全支持（CI 自动发布 NSIS 安装包）
macOS 12+	⚠️ 仅本地未签名构建可用（需 macOS 环境：`npm run build:mac`），CI 官方签名包待配置 Apple 开发者证书
Linux (Ubuntu 20.04+)	✅ 完全支持（CI 自动发布 AppImage + deb）
WSL 2	✅ 支持

安装

方式一：下载安装包

从 Releases 下载对应平台的安装包：

# Windows
FyqyClaw-Setup-x.x.x.exe

# macOS
FyqyClaw-x.x.x.dmg

# Linux
FyqyClaw-x.x.x.AppImage

方式二：从源码构建

📦 也可通过 npm 获取源码包（仅供阅读 / 二次构建，不含可运行程序）：
npm install fyqyclaw
cd node_modules/fyqyclaw   # 进入源码目录后按下方步骤构建

# 克隆仓库
git clone https://github.com/wch887292/FyqyClaw.git
cd FyqyClaw/fyqyclaw-app

# 安装依赖
npm install

# 启动开发服务器（Web 模式）
npm run dev

# 或启动 Electron 桌面应用
npm run electron:dev

方式三：从源码构建安装包

# 构建所有平台（当前平台将生成安装包）
npm run electron:build

# 或指定平台构建
npm run build:win      # Windows NSIS 安装包 (.exe)
npm run build:mac      # macOS DMG + ZIP（需 macOS 环境）
npm run build:linux    # Linux AppImage + deb（需 Linux 环境）

构建产物输出到 release/ 目录：

产物	平台	格式
`FyqyClaw-Setup-${version}-win-x64.exe`	Windows	NSIS 安装器（CI 发布）
`FyqyClaw-${version}-mac-x64.dmg`	macOS Intel	DMG 磁盘映像（仅本地构建）
`FyqyClaw-${version}-mac-arm64.dmg`	macOS Apple Silicon	DMG 磁盘映像（仅本地构建）
`FyqyClaw-${version}-linux-x86_64.AppImage`	Linux	AppImage 便携包（CI 发布）
`FyqyClaw-${version}-linux-amd64.deb`	Linux (Debian/Ubuntu)	deb 包（CI 发布）

首次使用

🚀 启动应用，进入 模型配置 面板（快捷键 Ctrl+Alt+M）
🤖 选择 AI 模型提供商，输入 API Key，点击 测试连接 验证
🔄 选择开发模式：IDE 模式 或 SOLO 模式
📂 创建或导入项目，开始开发！

快捷键速查

快捷键	功能
`Ctrl+Shift+M`	切换 IDE / SOLO 模式
`Ctrl+Alt+M`	打开模型配置面板
`Ctrl+Shift+P`	打开命令面板
`Ctrl+S`	保存当前文件
`Ctrl+Shift+F`	格式化代码
`Ctrl+Shift+E`	切换侧边栏显示
Ctrl+``	切换终端面板
`Ctrl+Shift+X`	打开扩展面板

🏗️ 项目架构

FyqyClaw/
├── electron/                 # Electron 主进程
│   ├── main.ts              # 主进程入口
│   └── preload.ts           # 预加载脚本
├── src/
│   ├── main/                # 前端应用主代码
│   │   ├── components/      # UI 组件
│   │   │   ├── config/      # 配置面板（模型/MCP/技能/设置）
│   │   │   ├── AppLayout.tsx
│   │   │   ├── EditorArea.tsx
│   │   │   ├── RightAIPanel.tsx
│   │   │   ├── SoloPanel.tsx
│   │   │   └── ...
│   │   ├── stores/          # 状态管理 (Zustand + Immer)
│   │   ├── pages/           # 页面（IDE / SOLO / 配置 / 登录）
│   │   ├── hooks/           # 自定义 Hooks
│   │   ├── utils/           # 工具函数（加密、Electron 桥接）
│   │   └── styles/          # 全局样式
│   ├── model-adapter/       # AI 模型适配器层
│   │   ├── adapters/        # 各模型提供商适配器
│   │   ├── manager.ts       # 适配器管理器
│   │   ├── presets.ts       # 模型预设配置
│   │   └── router.ts        # 模型路由
│   ├── orchestrator/        # AI 编排引擎
│   │   ├── agent/           # 智能体引擎
│   │   ├── planner/         # 任务规划器
│   │   ├── context/         # 上下文管理器
│   │   ├── review/          # 代码审查引擎
│   │   └── summary/         # 变更摘要
│   ├── sandbox/             # 沙箱安全执行引擎
│   │   ├── executor/        # 命令执行器
│   │   ├── monitor/         # 活动监控器
│   │   └── policy/          # 安全策略
│   ├── ide/                 # IDE 核心组件
│   │   ├── editor/          # Monaco 编辑器
│   │   ├── file-tree/       # 文件树
│   │   └── git/             # Git 集成
│   ├── cue-engine/          # CUE 智能编码引擎
│   ├── mcp/                 # MCP 协议管理
│   ├── plugin-system/       # 插件系统
│   └── skills/              # 技能系统
├── package.json
└── vite.config.ts

🛠️ 技术栈

类别	技术
前端框架	React 18 + TypeScript 5
构建工具	Vite 5
桌面框架	Electron 43
构建打包	electron-builder (NSIS / DMG / AppImage / deb)
代码编辑器	Monaco Editor 0.52
状态管理	Zustand 4 + Immer 10
终端	内置终端面板（自定义实现，非 Xterm.js）
AI 模型	OpenAI / Anthropic / DeepSeek / 智谱 / 通义千问 / Google Gemini
协议	Model Context Protocol (MCP)
安全	三重加密沙箱、隐私模式

📖 常见问题

完整 FAQ 请查阅 FAQ.md

分类	问题
基础	FyqyClaw 是什么？如何收费？支持哪些平台？
安装	如何安装？如何从源码构建？如何解决启动问题？
模型配置	支持哪些 AI 模型？如何配置 API Key？如何测试连接？
开发模式	IDE 和 SOLO 模式有什么区别？如何切换？
安全	代码会上传训练吗？API Key 安全吗？沙箱是什么？
功能	如何使用编辑器/终端/Git/搜索？快捷键有哪些？
故障排查	AI 回复慢怎么办？沙箱拦截命令怎么办？如何重置配置？

📊 版本规划

版本	状态	内容
V1.0.0	✅ 已发布 (2026-08-15)	正式版发布，全流程 AI 辅助开发闭环
V1.1.0	✅ 已发布 (2026-08-16)	可信化落地：沙箱生效、加密修复、Anthropic 真适配、Agent 真实写盘、配置页接真、MCP 真调用、插件系统、上下文真读、审查真代码、清理死依赖
V1.1.1	✅ 已发布 (2026-08-21)	终极优化：主进程 fs 越界校验、Agent 写盘路径约束、沙箱策略防绕过 + 隐私禁网、API Key 加密真实化、技能/测试能力诚实化、自定义模型适配器路由、配置页真实取数、审查去 mock、补齐安全边界测试（69 测试全绿）
V1.2.0	📅 规划中	团队协作、自定义智能体市场
V2.0.0	📅 规划中	架构升级、CI/CD 联动、企业私有化部署

🤝 参与贡献

我们欢迎所有形式的贡献！请阅读 CONTRIBUTING.md 中的贡献指南了解详情。

贡献步骤

Fork 本仓库
创建特性分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'feat: add amazing feature')
推送到分支 (git push origin feature/amazing-feature)
提交 Pull Request

行为准则

请遵守 Contributor Covenant 行为准则。

📄 许可证

本项目基于 Apache License 2.0（Apache-2.0） 开源 — 详见 LICENSE 文件。

📬 联系我们

官方网站: https://klai.top
技术支持: 361336873@qq.com
项目负责人: 吴赐虹（飞扬企源研发中心）

🌐 官方站点与关联开源项目

本仓库由 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 维护，是飞虹智 klAI 开源生态的一部分。

🏠 官方网站：https://klai.top — 飞虹智 klAI · 泉州制造业 AI 服务商
📦 开源矩阵：https://klai.top/opensource.html — 全部开源项目一览
📚 AI 知识库：https://kb.klai.top — 产品文档与智能问答（MaxKB 驱动）

关联项目：

项目	简介
GEO-SaaS	AI 驱动的全域 GEO 搜索优化平台
飞虹智·企业AI平台	中小制造企业 AI 原生一体化管理平台
FyqyClaw	全流程 AI 驱动开发工具（IDE + AI Agent）（本仓库）
星眠AI	睡眠健康管理微信小程序 + 私有部署后端

⭐ 如果这个项目对你有帮助，欢迎 Star 并分享，让更多人发现飞虹智开源生态！

📚 文档导航

文档	说明
README.md	项目介绍与快速入门（当前文档）
CONTRIBUTING.md	贡献指南
FAQ.md	常见问题解答
DEPLOYMENT.md	部署指南
DISCLAIMER.md	免责声明
LICENSE	Apache-2.0 开源许可证

_{如果你觉得这个项目有帮助，请 ⭐ Star 支持我们！}

组织与署名

公司：晋江市飞虹智科技企业管理有限公司中心：飞扬企源研发中心 负责人：吴赐虹

官网：https://www.klai.top
知识库：https://kb.klai.top
开源矩阵：https://github.com/wch887292
实体权威声明（机器可读）：https://www.klai.top/entity.jsonld

本项目版权归晋江市飞虹智科技企业管理有限公司所有，由飞扬企源研发中心研发交付。 Entity: https://www.klai.top/#organization · Author: https://www.klai.top/#person-wuchihong

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
build		build
dist-electron.bak		dist-electron.bak
docs		docs
electron		electron
scripts		scripts
src		src
test		test
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOYMENT.md		DEPLOYMENT.md
DISCLAIMER.md		DISCLAIMER.md
ENTITY.md		ENTITY.md
FAQ.md		FAQ.md
FAQ_EN.md		FAQ_EN.md
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
index.html		index.html
llms.txt		llms.txt
package.json		package.json
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts
使用说明书.md		使用说明书.md
技术说明书.md		技术说明书.md
能力清单.md		能力清单.md
能力边界说明书.md		能力边界说明书.md

Navigation Menu

Repository files navigation

FyqyClaw · 飞扬企源 AI

🌐 品牌与官网

📖 项目简介

与 Cursor / Windsurf / Trae 对比

✨ 核心特性

🎯 双重开发模式 — 按场景自由选择

🤖 AI 全流程编程

🔒 企业级安全体系

🔌 开放生态扩展

🚀 快速开始

系统要求

安装

方式一：下载安装包

方式二：从源码构建

方式三：从源码构建安装包

首次使用

快捷键速查

🏗️ 项目架构

🛠️ 技术栈

📖 常见问题

📊 版本规划

🤝 参与贡献

贡献步骤

行为准则

📄 许可证

📬 联系我们

🌐 官方站点与关联开源项目

📚 文档导航

组织与署名

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

FyqyClaw · 飞扬企源 AI

🌐 品牌与官网

📖 项目简介

与 Cursor / Windsurf / Trae 对比

✨ 核心特性

🎯 双重开发模式 — 按场景自由选择

🤖 AI 全流程编程

🔒 企业级安全体系

🔌 开放生态扩展

🚀 快速开始

系统要求

安装

方式一：下载安装包

方式二：从源码构建

方式三：从源码构建安装包

首次使用

快捷键速查

🏗️ 项目架构

🛠️ 技术栈

📖 常见问题

📊 版本规划

🤝 参与贡献

贡献步骤

行为准则

📄 许可证

📬 联系我们

🌐 官方站点与关联开源项目

📚 文档导航

组织与署名

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages