Knowledge Chat

Knowledge Chat 知识库对话助手 - 支持连接外部知识库、语义搜索、上下文对话、图片/附件理解。具备思考进度提示、Markdown渲染、后续建议、向量索引构建等功能。

franksteinwen007-git@franksteinwen007-git

Install

openclaw skills install @franksteinwen007-git/knowledge-chat

Knowledge Chat 知识库对话助手 v1.0.2

📋 版本更新

v1.0.2 新增功能 (2026-04-13)

✅ 向量索引构建 - 知识库管理界面新增"索引"按钮，手动构建向量索引
✅ PDF 内容解析 - pdf-parse v1.1.1 正确解析 PDF 内容
✅ 语义搜索优化 - 检索数量从 5→10，阈值从 0.3→0.25，内容更全面
✅ 回复更详细 - 更新 system prompt，回复更详细完整，包含引用原文
✅ 嵌入 API 修复 - 批次大小改为 10，符合 Dashscope API 限制

v1.1.0 新增功能 (2026-04-13)

✅ 思考进度条 - 发送消息时显示"正在思考中..."动画，实时反馈
✅ Markdown 正确渲染 - 表格、列表、引用块、代码块完美显示
✅ 后续建议 - AI 自动生成 2-3 个相关追问，引导深入探索
✅ 图片/附件支持 - 发送图片和文档，AI 自动理解内容
✅ 紧凑 UI 布局 - 100% 缩放即可查看完整界面，无需拖动

🎯 功能概述

Knowledge Chat 是一个专业的知识库对话助手，具备以下核心能力：

功能模块	说明
知识库连接	连接外部知识库 API，支持多种认证方式
语义搜索	基于 RAG 的智能检索，比关键词搜索更精准
上下文对话	多轮问答，记住对话历史
多模态理解	支持图片、文档附件，AI 自动分析内容
来源标注	回答末尾标注信息来源（文件名/网页链接）

🚀 使用场景

企业知识库接入
智能问答系统
文档检索助手
RAG (检索增强生成) 应用
多模态内容分析

📁 项目结构

text

knowledge-chat-skill/
├── SKILL.md              # 技能说明文档
├── README.md             # 项目简介
├── references/           # 参考资料
│   └── kb_connector.py   # 知识库连接示例
├── scripts/              # 脚本文件
│   └── setup.sh          # 安装脚本

🔧 核心技术栈

技术	用途
Next.js 14	前端框架
TypeScript	类型安全
Tailwind CSS	UI 样式
Dashscope API	AI 模型（qwen-plus, qwen-vl-max）
SQLite + better-sqlite3	本地数据库
react-markdown	Markdown 渲染
remark-gfm	GitHub Flavored Markdown

💡 API 端点

聊天相关

POST /api/chat/messages - 发送消息（支持附件）
GET /api/chat/sessions - 获取会话列表
GET /api/chat/sessions/:id/messages - 获取历史消息
POST /api/chat/upload - 上传图片/文件
GET /api/chat/files/:fileId - 获取文件

知识库相关

GET /api/knowledge - 知识库列表
POST /api/knowledge/:id/upload - 上传知识文档
POST /api/knowledge/:id/ingest - 解析知识内容

🎨 UI 功能详解

1. 思考进度条 (ThinkingIndicator)

发送消息后，显示三个弹跳圆点动画 + "小新正在思考中..." 提示，让用户知道 AI 正在处理。

2. Markdown 渲染器 (MarkdownRenderer)

自动转换 <br> 为换行
表格：带边框、悬停高亮
列表：每项独立一行，带图标
代码块：语法高亮背景
引用块：左侧彩色边框

3. 后续建议 (FollowUpQuestions)

AI 在回答末尾生成 2-3 个相关问题，用户点击可直接发送，无需手动输入。

4. 文件上传 (FileUpload)

图片：支持 JPG/PNG/GIF，显示预览
文档：txt/md/pdf 等，自动读取内容
限制：单文件最大 10MB

🔐 安全说明

所有文件上传需登录验证
文件大小限制 10MB
图片支持格式：JPG, PNG, GIF, WEBP
文档支持格式：TXT, MD, PDF, DOC, DOCX

📊 数据库表

表名	说明
`chat_sessions`	对话会话
`chat_messages`	对话消息
`chat_files`	上传的文件附件
`knowledge_base`	知识库配置
`knowledge_files`	知识库文档

📝 示例对话

用户: 如何进行 Salesforce 数据备份？

小新: