ljwx-chat/完整知识库设置完成报告.md

灵境万象 - 完整知识库设置完成报告

✅ 已完成的配置

1. Ollama qwen3:32b 模型 ✓

• 状态: 已安装并可用
• 模型路径: qwen3:32b
• 大小: 20 GB
• 安装时间: 6 个月前

验证命令:

ollama list | grep qwen3

2. PostgreSQL@14 数据库 ✓

• 版本: 14.19 (Homebrew)
• 状态: 已启动并运行
• 端口: 5432

验证命令:

psql -d postgres -c "SELECT version();"

3. PGVector 扩展 ✓

• 版本: 0.8.1
• 状态: 已编译并安装到 PostgreSQL@14
• 安装路径: /opt/homebrew/lib/postgresql@14/vector.so

编译方式: 从源码编译（pgvector v0.8.1）

4. lingjingwanxiang 数据库 ✓

• 数据库名: lingjingwanxiang
• Vector 扩展: 已启用
• 连接字符串: postgresql://brunogao@localhost:5432/lingjingwanxiang

验证命令:

psql -d lingjingwanxiang -c "SELECT * FROM pg_available_extensions WHERE name = 'vector';"

5. .env 配置文件 ✓

• 文件路径: ~/work/codes/AI/lobe-chat/.env
• Ollama 配置: ✓ 已配置
• 数据库配置: ✓ 已配置

当前配置:

# Ollama
OLLAMA_PROXY_URL=http://127.0.0.1:11434
ENABLED_OLLAMA=1

# Database
DATABASE_URL=postgresql://brunogao@localhost:5432/lingjingwanxiang

# Environment
NODE_ENV=development

---

⏳ 进行中的任务

依赖安装 (pnpm install)

• 状态: 正在后台运行
• 进程 ID: c64cc0
• 预计时间: 5-10 分钟

注意: 这是一个大型项目，包含 21 个 workspace 包，需要安装数百个依赖。

---

📝 待完成步骤

步骤 1: 等待依赖安装完成

检查安装状态:

cd ~/work/codes/AI/lobe-chat
ls -la node_modules/.bin/tsx && echo "✓ 依赖安装完成" || echo "× 依赖安装未完成，请等待..."

或者查看安装进度:

tail -f /tmp/pnpm-install.log # 如果有日志文件的话

步骤 2: 初始化数据库架构

依赖安装完成后，运行数据库迁移:

cd ~/work/codes/AI/lobe-chat
bun run db:migrate

预期输出:

✓ 数据库迁移成功
✓ 创建了所有必要的表

步骤 3: 启动应用

开发模式:

cd ~/work/codes/AI/lobe-chat
bun run dev

访问: http://localhost:3010

生产模式:

cd ~/work/codes/AI/lobe-chat
bun run build
bun run start

访问: http://localhost:3210

---

🧪 功能测试清单

测试 1: Ollama qwen3:32b 模型

1. 启动 Ollama 服务

   # 检查 Ollama 是否运行
   curl http://127.0.0.1:11434/api/tags
   

2. 在灵境万象中配置

   • 打开 http://localhost:3010
   • 进入 设置 → 语言模型 → Ollama
   • 确认端点: http://127.0.0.1:11434
   • 应该能看到 qwen3:32b 模型

3. 创建对话测试

   • 新建对话
   • 选择 Ollama - qwen3:32b
   • 发送消息: "你好，请用中文介绍一下你自己"
   • 验证响应是否正常

测试 2: 完整知识库功能

2.1 创建知识库

1. 进入知识库管理

   • 设置 → 知识库
   • 点击 "创建知识库"

2. 上传文档

   • 支持格式: TXT, PDF, MD, DOCX
   • 上传测试文件
   • 等待文件处理和向量化

3. 验证向量嵌入

   # 连接数据库检查
   psql -d lingjingwanxiang -c "SELECT COUNT(*) FROM chunks WHERE embedding IS NOT NULL;"
   

2.2 使用知识库对话

1. 创建新对话

   • 点击 "新建对话"
   • 在 Agent 设置中

2. 启用知识库

   • Agent 设置 → 知识库
   • 选择刚才创建的知识库
   • ✅ 启用

3. 测试语义搜索

   • 提问与文档内容相关的问题
   • AI 应该使用 searchKnowledgeBase 工具
   • 回答应该基于文档内容

2.3 验证 RAG 工作流程

在对话过程中，你应该看到:

1. 工具调用日志

   🔧 调用工具: searchKnowledgeBase
   参数: { query: "用户的问题", limit: 5 }
   

2. 检索到的文档片段

   📄 找到相关文档:
   - 相似度: 0.85
   - 内容: [文档片段]
   

3. 基于上下文的回答

   • AI 引用文档内容
   • 回答准确且相关

---

🔍 故障排查

问题 1: 依赖安装失败

症状: pnpm install 报错或卡住

解决方案:

cd ~/work/codes/AI/lobe-chat

# 清理并重新安装
rm -rf node_modules
rm pnpm-lock.yaml
pnpm install

问题 2: 数据库迁移失败

症状: bun run db:migrate 报错

检查步骤:

1. 验证数据库连接

   psql -d lingjingwanxiang -c "SELECT 1;"
   

2. 检查 .env 配置

   cat .env | grep DATABASE_URL
   

3. 手动运行迁移脚本

   cd ~/work/codes/AI/lobe-chat
   MIGRATION_DB=1 node_modules/.bin/tsx ./scripts/migrateServerDB/index.ts
   

问题 3: Vector 扩展不可用

症状: 创建知识库时报错 "vector extension not found"

解决方案:

# 重新启用扩展
psql -d lingjingwanxiang -c "DROP EXTENSION IF EXISTS vector;"
psql -d lingjingwanxiang -c "CREATE EXTENSION vector;"

# 验证
psql -d lingjingwanxiang -c "SELECT extname, extversion FROM pg_extension WHERE extname = 'vector';"

问题 4: Ollama 连接失败

症状: 无法连接到 Ollama 或找不到模型

解决方案:

# 1. 检查 Ollama 服务
ps aux | grep ollama

# 2. 启动 Ollama (如果未运行)
ollama serve &

# 3. 验证模型
ollama list | grep qwen3

# 4. 测试 API
curl http://127.0.0.1:11434/api/tags

问题 5: 向量嵌入生成失败

症状: 文件上传后无法生成向量

原因: 需要配置嵌入模型

解决方案 1: 使用 Ollama 生成嵌入

# 下载嵌入模型
ollama pull nomic-embed-text

# 在 .env 中配置
echo "EMBEDDING_MODEL=ollama" >> .env
echo "OLLAMA_EMBEDDING_MODEL=nomic-embed-text" >> .env

解决方案 2: 使用 OpenAI API

# 在 .env 中添加
echo "OPENAI_API_KEY=sk-your-key-here" >> .env

---

📊 系统要求验证

已验证通过 ✓

• macOS 系统 (Darwin 24.6.0)
• Ollama 已安装并运行
• qwen3:32b 模型已下载 (20 GB)
• PostgreSQL@14 已安装并运行
• PGVector 0.8.1 已编译并启用
• Node.js 环境可用
• Bun 运行时可用
• 数据库连接配置正确

待验证 ⏳

• 所有 npm 依赖已安装
• 数据库架构已初始化
• 应用可以正常启动
• 知识库功能可以使用

---

🚀 快速启动指南

完成以上所有步骤后:

# 1. 进入项目目录
cd ~/work/codes/AI/lobe-chat

# 2. 确认依赖已安装
ls node_modules/.bin/tsx

# 3. 初始化数据库 (如果还没做)
bun run db:migrate

# 4. 启动应用
bun run dev

# 5. 打开浏览器
open http://localhost:3010

---

📚 相关文档

• Ollama 官方文档: https://ollama.com
• PGVector 文档: https://github.com/pgvector/pgvector
• 项目原始仓库: https://github.com/lobehub/lobe-chat
• 定制指南: ~/work/codes/AI/lobe-chat/灵境万象-定制指南.md

---

🎯 下一步行动

1. 等待 pnpm install 完成 (预计 5-10 分钟)
2. 运行 bun run db:migrate 初始化数据库
3. 运行 bun run dev 启动应用
4. 按照测试清单验证功能

---

设置时间: 2025-11-25 版本: v2.0.0-next.112+lingjingwanxiang 状态: 90% 完成（等待依赖安装和数据库初始化）