KenKaiii/gg-framework

项目介绍

GG Coder 是一个桌面编码智能体，支持接入你已有的 AI 订阅或 API Key，包括 Claude、ChatGPT、Gemini、Grok、Kimi 和本地模型。仓库同时发布了一组 TypeScript 包，方便不安装桌面端的人自行构建智能体：@kenkaiiii/gg-ai 负责连接模型服务商并流式接收回复，@kenkaiiii/gg-agent 用于构建能调用工具、推进任务的智能体，@kenkaiiii/gg-core 处理模型选择、认证和本地模型发现，@kenkaiiii/ggcoder 则是桌面端和 CLI 背后的编码智能体、会话与工具 (20)。

除写代码外，应用还包含 GG Goals（把整项目标交给一组 worker 智能体执行）、Chat 会话和 GG Motion（把想法转成视频）。作者重点强调两项能力：Agent Steroids 在本机搜索真实开源代码，不依赖限流的 MCP 服务；Ken Autopilot 持续执行直到结果通过验证。

快速使用

从最新发布页安装桌面端：Apple Silicon macOS 打开 .dmg，Windows 运行 .exe 安装器，Linux x86_64 安装 .deb 或 .rpm (16)(4)。打开应用后连接 AI 服务商，选择 Code、Chat 或 Motion 模式即可开始 (19)。

若要从源码运行，先装好 Node.js、pnpm 和 Tauri 依赖，然后执行：

git clone https://github.com/KenKaiii/gg-framework.git
cd gg-framework
pnpm install
pnpm build
pnpm --filter gg-app tauri dev

想在自己的项目里用这套引擎，可从 npm install @kenkaiiii/gg-ai @kenkaiiii/gg-agent 开始，各包的 README 说明了安装与用法 (25)(21)(22)。

使用约束

• macOS 构建面向 Apple Silicon，Linux 构建面向 x86_64。
• 从源码构建时，除 Node.js 和 pnpm 外还需要 Tauri 工具链 (17)。
• 桌面端和框架都通过你自己的账号使用 AI 服务商，因此需要先具备可用的服务商访问权限。
• 项目采用 AGPL-3.0：分发修改版或以网络服务方式运行时，需以同一许可证公开源码 (20)。
• 性能结论（20 个智能体中最快最省，单轮套件 102 秒、花费 $0.014，基于 Claude Haiku 5.5）来自维护者 2026 年 11 月 4 日自行组织的一次对比，7 个任务各跑 5 次，并非独立测量 (14)。

HotRepo 点评

2026 年 11 月 5 日，该项目以当天新增 27 Star、总计 191 Star 的成绩进入 TypeScript 日榜第 6 名。这只是单条快照，不足以说明持续走势，全部语言日榜名次也未见记录。对比表列出了 20 个具体工具、每次运行的成本与耗时，并交代了模型和任务集，这让性能主张可以被逐项核查，而不至于停留在口号层面，尽管测试由维护者自己执行。桌面产品与可独立安装的包分开交付，读者可以只评估引擎，而不必接受整个应用。