Bennettxai/FounderOS-DEMO

An open-source, single-operator business command center: run a one-person operated company as AI-assisted departments (comms, funnel, social, finances, agents, and a knowledge graph) from one live dashboard.

Founder OS – 一个 AI 增强型个人操作系统演示

是什么 – Founder OS 是一个基于 Next.js 的 Web 应用，它模拟在单个屏幕上运行一位独立创业者的所有业务。UI 被划分为“部门”（通信、销售漏斗、社交增长、财务、知识图谱等），每个部门都由一个小型 LLM 驱动的代理 支持，这些代理可以运行代码、查询知识库，并更新结构化记忆层。

为何重要 – 它展示了如何将 20 多个连接器（邮件、Slack、Stripe、Notion、CRM、社交 API 等）和混合知识系统（基于 Markdown 的 G-Brain + 受控的“Optimal Engine”记忆）整合起来，使自主代理能够获取最新数据并拥有可信的记忆。该仓库是一个 完全可运行的演示：种子数据已加载到本地 SQLite 数据库中，因此无需任何外部密钥即可探索每个页面。

核心概念

概念	作用
代理	具有 `run()` 方法的小型 TypeScript 类，调用 Vercel AI SDK（LLM），并与连接器和知识层交互。
连接器	20 多个集成模块（邮件/IMAP、Slack、Stripe、Notion、日历、CRM、社交）。每个返回一个类型化的 `ConnectorStatus`（`connected`、`not_configured`、`error`）。
G-Brain	Markdown 文件被分块、嵌入并存储在向量存储中。支持关键词和语义搜索；当向量服务宕机时，会回退到本地 grep。
Optimal Engine	一种“受控记忆”，将原始信号 → 主张 → 已验证的事实 → 持久记忆。代理可以写入信号/主张，但只有经过审核的事实才会成为 OS 可信状态的一部分。
仓库层	所有数据库访问都通过类型化的仓库（`agents`、`departments`、`social` 等）进行，因此将种子 SQLite 替换为生产数据库只需更改 `lib/data.ts` 中的配置即可。

主要 UI 路由（演示）

/ – 操作员控制台（脉搏、连接状态、代理名单、知识核心）
/comms – 统一收件箱，聚合邮件、Slack、WhatsApp、语音输入
/funnel – 可视化客户旅程流程（线性和径向视图）
/social – 粉丝图表、受众占比、发布节奏
/content – 内容管道与日历
/finances – 收入/支出图表及分类分解
/agents – AI 代理列表，显示实时 run() 状态
/tasks – 由代理输出填充的任务看板
/brain – 交互式知识图谱视图
/workflows – 多步骤工具工作流
/integrations – 所有连接器的状态仪表板
以及多个管理员/路线图页面。

技术栈（如仓库中列出）

框架：Next.js 14（App Router）与服务器组件
语言：TypeScript
样式：Tailwind CSS（5 个内置主题，默认为“Monolith”）
数据库：演示使用 better-sqlite3；生产环境预期支持任何托管数据库
验证：在每个数据库/API 边界使用 Zod 模式
LLM 调用：Vercel AI SDK
图谱：使用 d3-force 实现知识图谱可视化
测试：Vitest + 内存中 SQLite
部署目标（演示）：Railway（或任何 Node 主机）——生产环境会为 G-Brain 和 Optimal Engine 添加独立服务。

快速开始（来自 README）

# 前提条件：Node 18+
npm install
cp .env.example .env.local   # 可选 – 仅在使用真实连接器时需要
npm run dev   # http://localhost:4100

首次运行会创建一个种子 SQLite 数据库，因此无需任何 API 密钥即可在所有页面看到真实感的占位数据。还提供了生产构建、测试、类型检查和重新播种的命令（npm run build && npm start、npm test、npm run typecheck、npm run seed）。

预期使用场景

希望通过 AI 代理自动化日常业务任务的 独立创业者。
寻找以下参考实现的 开发者：
- 可即插即用的连接器架构，带有诚实的状态报告
- 混合 Markdown-向量知识存储
- 将原始信号与已验证事实分离的受控记忆模型（Optimal Engine）
教授构建 AI 增强 SaaS 产品的 教育者 / 培训营 – 该仓库是 Founder OS 学员项目中使用的“参考实现”。

许可证

MIT – 详见 LICENSE。

总结 – Founder OS 是一个具体、开源的 AI 驱动型个人业务操作系统演示。它集成了 Next.js UI、一组 LLM 支持的代理、丰富的连接器库以及两层知识/记忆系统，所有内容均可在种子数据下本地运行。对于希望探索独立企业 AI 增强工作流的任何人来说，这是一个坚实的起点。