Skip to content

forge-ui/forge-agent

Repository files navigation

🤖 Forge Agent

你的专属 AI 团队,开箱即用。

为开发者、研究员、写作者打造的 AI Agent 工作站 —— 多 App 切换、对话历史、知识库、长期记忆,一套壳容下所有专业 agent。

🚀 在线体验 · Forge UI Kit · forge-starter

Forge Agent screenshot


它是什么

一个 AI Agent 平台壳站。 后端是你自己的 agent(Claude Code / GPT / 自研),前端是这个壳。每个 agent 一个 App,互相隔离,对话历史、知识库、记忆全部按 App 维度管理。

你不用再写:

  • ❌ 一遍又一遍的 chat 页面(消息气泡、思考折叠、工具调用、来源引用、流式响应、附件、follow-up)
  • ❌ 一遍又一遍的 sidebar(新对话按钮、对话列表分组、App 切换器)
  • ❌ 一遍又一遍的「输入框三件套」(多行 + 附件 + 模式开关)

你只需要写:

  • ✅ 你的 agent 逻辑

内置场景(4 个 App,按需扩展)

App 定位 适合
🟣 Code Studio 代码搭子,盯 PR、揪 bug、给重构建议 研发
🔵 Research Lab 调研助手,搜索整合多源资料,每条带引用 调研 / 产品
🟢 Writing Desk 写作教练,砍冗余、理逻辑、润语气 内容创作者
🟡 Data Console 数据助手,自动清洗、建模、可视化 分析师

App 列表是壳层 mock,自己加几行 app/_mock/apps.tsx 就能新增一个 App 入口。


你能直接用到的

Chat 工作区

  • 欢迎语 + 大输入框(深度思考 / 联网搜索 / 上传文件 toggle,一键打开模式)
  • 多模态消息:文字、语音波形、PDF / 文档卡片、单图、多图网格(自动 +N 蒙层)
  • 思考过程 / 工具调用 / 来源引用:行内一句话简介 → 点击右侧抽屉看详情,主答永远干净
  • Follow-up 建议:每条 AI 回复后挂 3 条引导问题,新手不再面对空白
  • Markdown 全家桶:粗体、行内 code、围栏代码块、列表

Sidebar

  • App 切换器(Forge Agent 风格的 dropdown,副标题展示 App tagline)
  • + 新对话 按钮(紫色显眼)
  • 对话历史(今天 / 昨天 / 更早 自动分组)
  • 底部菜单:知识库 / 设置(Memory 设计上并入 Settings)
  • 沉浸模式:page header 可隐藏,chat 区上下贯通

整套体系

  • 🎨 Forge UI Kit@forge-ui-official/core)—— ChatInputBar / FileTypeIcon / AppLayout / 完整 token 体系
  • 🌗 浅色为主,紫色 #7C3AED 单一 accent,克制、像真产品
  • ⌨️ 键盘友好:Cmd+Enter 发送、Esc 关抽屉
  • 🌐 中文界面优先,英文混排自然

本地跑

# 1. clone
git clone https://github.com/forge-ui/forge-agent.git
cd forge-agent

# 2. 配 GitHub Packages token(@forge-ui-official/core 是私有包)
cp .env.example .env.local
# 在 .env.local 填 GITHUB_TOKEN=your_pat(需要 read:packages 权限)

# 3. 装包
GITHUB_TOKEN=$(cat .env.local | grep GITHUB_TOKEN | cut -d= -f2) pnpm install

# 4. 起服务
pnpm dev
# 打开 http://localhost:3000/code-studio/chat

装不下 @forge-ui-official/core?是 GitHub Packages 鉴权问题,确认 PAT 有 read:packages 权限。


自己定制

改什么 改哪里
App 列表(名称 / icon / tagline) app/_mock/apps.tsx
每个 App 的 suggestion / 历史对话 mock app/_mock/apps.tsxsuggestions[] / conversations[]
用户名 / 头像 config/menu.tsxprofile
Chat empty state 视觉 app/_components/chat-empty-state.tsx
Chat thread 渲染(思考 / 工具 / 来源 / followUps) app/_components/chat-thread.tsx
Sidebar app/_components/chat-sidebar.tsx
路由 app/[appId]/{chat,knowledge,settings}/page.tsx

接真实后端时只需要把 MOCK_MESSAGES 换成 SSE / WebSocket 流,组件全部已经按结构化数据驱动。


技术栈

  • Next.js 16(App Router · Turbopack · static export)
  • React 19
  • Tailwind CSS v4@theme inline token + @source 扫 forge dist)
  • @forge-ui-official/core ^0.1.9(ChatInputBar / AppLayout / FileTypeIcon / DataTable / 完整 token)
  • solar-icon-set v2(图标)
  • TypeScript strict

License

MIT

About

ToB 可商用的Agent UI,开箱即用 — 面向私有定制的Agent后端服务,多 App 切换、对话历史、知识库、记忆系统全套 UI 页面。

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors