公开构建悟空(Wukong)：Next.js 的即插即用 AI 智能体库
日期： 2025年11月12日
状态： 开发中
开源协议： MIT（免费开源）
我在做什么
悟空（Wukong） - 一个为 Next.js 打造的即插即用 AI 智能体库。只需安装、提供 API 密钥、知识库和工具，5 分钟就能拥有一个可用的智能体。
npm install @wukong/agent
const agent = new WukongAgent({
llmKey: process.env.OPENAI_API_KEY,
knowledgeBase: './docs',
tools: './tools'
})
await agent.execute({
goal: "分析销售数据并生成报告"
})
就这么简单。无需学习复杂的框架，无需设计智能体架构。真正的即插即用。
为什么要做这个
1. 原生 Next.js 集成
如果你会写 Next.js，就能用悟空。没有新概念，没有新框架。它专门为想在应用中添加 AI 智能体能力的 Next.js 开发者设计。
2. 专注你的护城河，而非框架
别再浪费时间学习 LangChain/LlamaIndex 来构建智能体基础设施了。你的竞争优势在于知识库和工具，而不是智能体框架。
使用悟空：
- ❌ 不用再花几个月构建：多步推理、错误恢复、状态管理、token 优化
- ✅ 把时间花在：你的领域知识、你的工具、你的用户体验
3. 可信赖，而不只是聪明
这不是又一个做出不可预测行为的"聪明"智能体。悟空专为生产环境设计，具备：
- 可见性 - 实时进度，完全透明
- 可控性 - 随时停止，确认风险操作
- 可逆性 - 撤销/回滚任何操作
- Token 高效 - 通过 MCP 模式、懒加载和智能丢弃实现 98% 的节省
这是一个你真正可以在生产环境中信任的智能体。
4. 免费开源
MIT 开源协议。节省数月开发时间，零成本。你的 LLM 密钥，你的数据，你的控制权。
想看更多实战拆解？
AI、工程与实验，每月 1–2 封。
无垃圾邮件，随时取消。
核心技术创新：Token 效率
传统框架大量浪费 token：
- 每次工具调用 = 完整模式（数千 token）
- 加载 50 个技能 = 15 万 token
- 长任务 = 线性增长
悟空的解决方案：
- MCP schema缓存 - 在本地缓存schema，LLM 只发送工具名称 + 参数 → 节省 98%
- 懒加载 - 只加载匹配的技能文档 → 节省 98%
- 智能丢弃 - LLM 标记可丢弃的步骤 → 节省 60-80%
结果：处理数百个步骤而不会成本爆炸。
可信赖性功能：30 项原则的完整实现
从"聪明"到"可信赖"——这是 Wukong 的核心设计理念。我们实现了完整的 30 项可信赖性原则，确保智能体在生产环境中可靠运行。
完整功能清单
| # | 可信赖原则 | 核心库 | UI 组件包 | 完成度 |
|---|---|---|---|---|
| 启动阶段 | ||||
| 1 | 清晰列出能做什么/不能做什么 | ✅ getCapabilities() | ✅ <CapabilitiesPanel> | 100% |
| 2 | 技能树/标签展示 | ✅ Skills Registry | ✅ <SkillsTree> | 100% |
| 3 | 示例命令 | ✅ 配置选项 | ✅ <ExamplePrompts> | 100% |
| 4 | 新功能通知 | ✅ Version API | ✅ <UpdateBanner> | 100% |
| 5 | 标记信息来源 | ✅ 返回附带来源 | ✅ 自动标记 | 100% |
| 执行前 | ||||
| 6 | 生成草案 | ✅ onPlanReady | ✅ <PlanPreview> | 100% |
| 7 | 侧边栏/弹窗 | ✅ 事件系统 | ✅ <Sidebar> <Modal> | 100% |
| 8 | 接受/编辑选项 | ✅ 回调 | ✅ <ActionButtons> | 100% |
| 9 | 显示执行计划 | ✅ plan:generated | ✅ <ExecutionPlan> | 100% |
| 10 | 可展开的检查清单 | ✅ Todo List | ✅ <TodoList> | 100% |
| 11 | 实时大纲显示 | ✅ streaming | ✅ <ThinkingBox> | 100% |
| 执行中 | ||||
| 12 | 实时状态显示 | ✅ step:started | ✅ <StatusIndicator> | 100% |
| 13 | 进度条/计数器 | ✅ progress event | ✅ <ProgressBar> | 100% |
| 14 | 决策日志 | ✅ reasoning event | ✅ <DecisionLog> | 100% |
| 15 | 推理过程 | ✅ streaming | ✅ 自动显示 | 100% |
| 16 | 通知成本 | ✅ tokens:used | ✅ <CostIndicator> | 100% |
| 17 | 解释"为什么" | ✅ reasoning field | ✅ <WhyButton> | 100% |
| 出错后 | ||||
| 18 | 撤销功能 | ✅ undo() | ✅ <UndoButton> | 100% |
| 19 | 版本历史 | ✅ checkpoint | ✅ <VersionHistory> | 100% |
| 20 | 沙盒模拟 | ⚠️ Tool layer | ✅ <SandboxPreview> | 80% |
| 21 | 对比视图 | ✅ diff data | ✅ <DiffView> | 100% |
| 22 | 停止按钮 | ✅ stop() | ✅ <StopButton> | 100% |
| 23 | 人工确认 | ✅ 确认事件 | ✅ <ConfirmDialog> | 100% |
| 24 | 升级到人工 | ✅ 错误检测 | ✅ <EscalateButton> | 100% |
| 新循环 | ||||
| 25 | 长期记忆选择 | ✅ 配置选项 | ✅ <MemorySettings> | 100% |
| 26 | 一键重启 | ✅ redoStep() | ✅ <RetryButton> | 100% |
| 27 | 点赞/点踩反馈 | ✅ Feedback API | ✅ <FeedbackButtons> | 100% |
| 28 | 反馈表单 | ✅ Feedback API | ✅ <FeedbackForm> | 100% |
| 29 | 任务完成率 | ✅ Statistics API | ✅ <MetricsDashboard> | 100% |
| 30 | 信任指数 | ✅ Calculation API | ✅ <TrustScore> | 100% |
完整支持率：30/30 (100%) ✅
两个包协同工作
@wukong/agent - 核心引擎和 API
提供所有底层能力和事件系统：智能体控制器、会话管理、历史和检查点、事件发射器、工具执行、知识库。
@wukong/agent-ui - 即用型 React 组件
提供完整的 UI 组件：完整聊天界面、可组合的独立组件、React Hooks、主题系统、响应式设计。
详细了解可信赖性设计： 从"聪明"到"可信赖"：AI 智能体的管理指南
公开的内容
一切都在 GitHub 上：
/packages/中的所有代码/docs/design/中的完整设计文档- 详细步骤的实施计划
- 每个阶段的进度更新
参与进来
使用场景： 你会用它构建什么？
反馈： 缺少什么？有什么问题？
贡献： 这是开源项目——欢迎提交 PR
成功 = 开发者 5 分钟内集成，在生产环境中信任它，构建复杂的多步骤应用而不会 token 爆炸。
相关链接：
- GitHub: [https://github.com/Moonveil-AI/wukong]
- Twitter/X: [https://x.com/sv_cloud_expert]
- 作者网站: [https://shanhuang.net]
#公开构建 #AI智能体 #开源 #NextJS #TypeScript
新文章，直接发到你的邮箱。
AI、工程与实验，每月 1–2 封。
无垃圾邮件，随时取消。