KunSpace
返回作品
KunSpace AI 助手（小 Kun）
AI AgentRAGNext.jsDeepSeek

KunSpace AI 助手（小 Kun）

嵌入 KunSpace 的智能向导：站内检索、访客洞察、博客与免费外部工具，支持 Agent 多轮工具调用与执行日志。

2026年7月5日

项目简介

KunSpace AI 助手「小 Kun」是跑在个人网站上的 可演示 Agent：公开页右下角可聊，管理后台 /admin/assistant 还能看访客洞察与工具执行日志。它把博客系列里讲的轻量 RAG、Skills、多轮工具调用，做成了真正能点开用的功能。

搭建全过程见博客：在 KunSpace 里从零搭建 AI 助手「小 Kun」。

一句话说清楚怎么工作：

轻量检索（站内 Markdown）+ Agent 工具 + 大模型通用能力
组成部分 干什么
轻量检索 需要时从本站文档、博客里现搜相关段落（不是把全文塞进模型）
Agent 工具 查文档、看访客、列博客、天气/百科等——调真实数据或免费接口
大模型 常识、闲聊等不查站的问题，直接由兼容 OpenAI 的模型回答

能问什么

  • 「国内服务器怎么更新？」「Redis 怎么配？」→ search_docs 检索部署文档
  • 「最近有多少访客？热门页是哪些？」→ 站长侧 get_analytics_summary
  • 「有哪些博客？」→ list_blog_posts
  • 天气、百科、汇率等 → 公开外部工具（按问题路由）
  • 闲聊、人名常识等 → 模型直接答，或走本地秒回 / 快速查库路径

架构

用户提问
  →（公开）本地寒暄 / 人名快路径（可跳过 LLM）
  → Agent 循环（多轮 Function Calling）
  → search_docs / analytics / list_blog_posts / 外部工具…
  → 大模型组织回答 + 可展开的执行日志（站长侧）

访问：

  • 公开：站点任意页右下角「小 Kun」
  • 站长：/admin/assistant（需 ADMIN_PASSWORD）

技术栈

Next.js 15 · TypeScript · DeepSeek / 硅基流动等 OpenAI 兼容 API · Upstash Redis · 现有 analytics / markdown 模块

配置

在 .env.local 配置 LLM_API_KEY、LLM_BASE_URL、LLM_MODEL 后重启 npm run dev。详见 .env.example。

和 KunClaw 的区别

小 Kun（本项目） KunClaw
形态 嵌在 KunSpace 网站里的产品助手 独立 Python Agent 框架 + CLI
数据 紧绑本站文档、访客、博客 通用记忆 / 工具 / 规划器
目标 演示 + 站长运维问答 可复用到其他业务（客服等）
KunSpace AI 助手（小 Kun） — KunSpace · KunSpace