FDE Workbench Vibe 项目

项目简介

FDE Workbench 是面向 Forward Deployed Engineer（前置部署工程师）团队的开源项目工作台，一站式覆盖项目管理、任务协作、客户调研、AI 机会挖掘、方案设计、交付文档、文件管理、用户与角色权限、Skills、插件和模型配置。仓库 README 明确声明"本项目以 vibe coding（AI 辅助快速开发）方式构建"，是一个典型的用 AI 辅助快速开发出来的真实生产工具。整个系统由 Electron 桌面端与 Flask API 组成，业务数据保存在部署者自己的 MySQL、Redis 和文件存储中，不依赖任何厂商云，适合对数据主权有要求的交付型团队私有化部署。

核心功能

1. 项目协作：项目、成员、任务、甘特关系和阶段管理一应俱全，内置项目负责人、FDE 工程师、查看者等角色权限体系，谁能看到什么、能改什么由管理员精确控制。
2. 调研与交付：提供调研对象、调研表、备忘录、AI 机会识别和方案设计的完整链路，配套文档模板、交付文档、版本管理和项目文件管理，从摸底客户到交付验收在一个工作台里闭环。
3. AI 与扩展：支持配置多个 AI 模型服务、安装 Skills 与插件、接入 AI Server、微信与 ClawBot 集成；管理员在"系统配置"和"AI 与扩展"中统一管理模型 API、扩展市场、对象存储与 ClamAV 病毒扫描。
4. 数据自主：业务数据全部落在部署者自己的 MySQL 8、Redis 7 和文件存储（本地目录或兼容阿里云 OSS 的对象存储）中，开源发行版不包含生产数据库、客户资料、访问凭据或安装包。

技术实现

桌面端采用 Electron + React + TypeScript + electron-vite 构建，通过受限 IPC 调用后端 API，杜绝渲染进程直连数据库；后端 API 使用 Python 3.12/3.13 + Flask + SQLAlchemy + Alembic，负责认证、权限和全部业务接口，数据库迁移由 Alembic 版本化管理，升级前需备份 MySQL 与文件存储，迁移文件只增不改。数据层用 MySQL 8 存主数据、Redis 7 跑任务队列与调度；文件处理、异步任务与自动化由 Flask CLI worker 和 scheduler 后台进程承担。AI 能力做了分层设计：基础功能（项目、任务、调研记录、文件等）无需任何 AI Key 即可使用，模型与外部集成由管理员分别配置，密钥在后端加密保存且界面上不回显。生产部署要求 Gunicorn 承载 WSGI、API 只能暴露在 HTTPS 反向代理之后、MySQL/Redis/OSS 使用独立最小权限账号，并提供 /health/live 与 /health/ready 健康检查端点。桌面平台目前提供 macOS Apple Silicon（arm64）DMG 构建配置，Windows x64 NSIS 构建由社区贡献，尚未完成发行验收。

快速上手

1. 准备依赖：Node.js 22+ 与 npm 10+、Python 3.12 或 3.13、MySQL 8.0+、Redis 7+（可用 docker compose up -d mysql redis 快速拉起），可选 Docker、ClamAV 与 LibreOffice；
2. 在仓库根目录执行 npm install，创建 Python 虚拟环境并安装依赖，复制 .env.example 为 server/.env，用 python3 -c 'import secrets; ...' 生成独立随机的 FDE_JWT_SECRET；
3. 执行 alembic upgrade head 完成数据库迁移，再运行 flask --app fde_api.app:create_app bootstrap-open-source 初始化（可重复执行、不覆盖已有数据，空库会创建 admin 账号，首次登录强制改密）；
4. 分三个终端启动 API、worker、scheduler，再 npm run dev 启动桌面端，登录后在"系统配置"中配置模型 API、存储与安全扫描（初始凭据仅用于空库首次进入，切勿用于生产）。

适用人群

前置部署工程师与 AI 交付团队、需要项目+调研+交付文档一体化管理的小型技术服务商、要求私有化部署与数据自主的企业 IT 部门，以及想参考 vibe coding 实战案例学习"Electron + Flask 全栈"的开发者。

出品方与更新动态

由 gxfde 团队开源，MIT-22a06b 许可，当前版本 v0.1.0。桌面平台徽章显示 macOS arm64 与 Windows x64 双端构建配置，Windows 支持来自社区 PR #1，贡献者报告在 Windows 11 x64 上构建安装成功。README 附有明确的商用前独立核验警告：开源发布不等于已完成安全审计、合规评估或生产级验收。

官方链接

https://github.com/gxfde/fde-workbench