🤖 关于 Ping

🚀 系统定位

Ping 02 是基于 RAG 技术的个人知识库智能系统。通过 RAG 混合检索（关键词 LIKE + 向量语义）和 Function Calling 智能体架构，实现从"规则匹配"到"智能检索"的能力跃迁，让 AI 能够真正理解并回答知识类问题。

📊 能力概览

✨ v2.0 优势亮点

🏗️ 技术架构

💡 技术创新

• RAG 混合检索机制 突破传统向量检索的局限，采用关键词精确匹配（LIKE）和向量语义理解的双重策略。关键词检索擅长专有名词精确匹配，向量检索擅长语义理解，两者结合确保检索准确率 > 95%。这是 v2.0 最核心的创新，让 AI 能够真正理解并回答知识类问题。
• 2000+ 篇个人知识库 覆盖 AI 技术（ASR/TTS/Function Calling）、语音识别实验、潮汐系统开发、国保数据库建设等个人技术历程。这些笔记经过精心结构化整理，通过向量化技术实现语义检索，让 AI 能够回答"你是怎么搭这个网站的"、"ASR 用什么模型好"等知识问题。
• RAG 二次综合机制 笔记检索工具返回的是"参考资料片段"，不是最终回答。v2.0 通过 TOOLS_NEED_SYNTHESIS 机制，自动识别哪些工具需要 LLM 二次综合。拿到检索结果后，重新调用 LLM 让它用自然语言综合输出，确保回答质量，而不是简单堆砌检索结果。
• 工具模块独立可测试 每个工具（潮汐/台风/国保/笔记）都是独立 Python 文件，导出 SCHEMA + 可调用函数。开发者可以单独测试每个工具，无需启动整个系统。这种设计模式符合"单一职责原则"，是软件工程的最佳实践。
• 细化工具粒度 系统拥有 9 个细粒度工具。台风查询拆分为 4 个独立工具（列表/搜索/详情/统计），国保查询拆分为 3 个（搜索/详情/统计）。细化工具让 LLM 决策更精准，避免"大工具小用"。
• 零侵入扩展 新增工具只需 3 步：① 创建工具文件 ② 导出 SCHEMA + 函数 ③ 在 TOOL_REGISTRY 注册。无需修改 PingRouter02.py 核心代码，完全符合"开闭原则"（对扩展开放，对修改封闭）。
• 智能体架构 采用 OpenAI Function Calling 标准协议（tools schema + tool_choice），兼容所有支持该协议的 LLM（OpenAI、DeepSeek、智谱等）。未来如果想切换到其他模型，只需修改配置，无需改动代码。

📖 工作流程

1️⃣ 知识入库阶段

笔记文件 → Markdown 解析 → 文本分块 → 向量化（DashScope） → 存储到 SQLite

2️⃣ 用户提问

用户输入自然语言问题，如"2024年有哪些台风？"或"BYP 怎么搭这个网站的？"

3️⃣ 智能路由决策

系统根据问题类型自动选择：

• 数据查询类：潮汐/台风/国保 → 调用对应工具，返回精确结果
• 知识问答类：笔记检索 → 混合检索（关键词+向量）→ RAG 二次综合

4️⃣ 工具执行

从 TOOL_REGISTRY 找到真实函数，执行查询，返回 markdown 格式结果

5️⃣ RAG 二次综合（仅笔记检索）

如果工具在 TOOLS_NEED_SYNTHESIS 集合中（如 search_notes），重新调用 LLM 综合结果，生成自然语言回答

6️⃣ 返回最终回答

工具结果直接返回（数据查询类）或 LLM 综合后返回（RAG 类），呈现给用户

🛠️ 技术栈

🔗 Ping 智能助手演进历程

💡 Ping 02 是在 v1.0 基础上的 Function Calling 智能体引擎升级，ping_03 是面向企业客服的垂直应用

🧰 工具清单（9 个）

📊 性能指标

🚀 未来规划

• 多轮对话支持 添加会话历史管理，支持"它"、"这个"等代词指代，实现真正的多轮交互
• 工具链组合调用 支持 LLM 连续调用多个工具（如先查台风列表，再查某个台风详情），实现复杂任务自动化
• 流式响应 支持 SSE 流式输出，用户无需等待完整回答，提升交互体验
• 工具执行日志 记录每次工具调用的参数、结果、耗时，方便调试和性能优化
• 动态工具加载 支持运行时动态注册/注销工具，无需重启服务
• 多模型兼容 支持 OpenAI、智谱、Kimi 等多个 LLM，根据成本/性能自动切换
• 工具缓存机制 对频繁查询的数据（如台风列表）添加缓存，减少 API 调用和数据库查询

ℹ️ 项目信息

开发者：白毅平（BYP）

项目类型：个人研究项目（基于 RAG 技术的个人知识库智能系统）

技术方向：RAG 检索、向量语义、智能体（Agent）、Function Calling

知识覆盖：2000+ 篇学习笔记（AI 技术/语音识别/潮汐系统/国保数据库等）

架构模式：混合检索（关键词+向量）+ 智能体工具集 + RAG 二次综合

部署方式：Docker 容器化部署（与 v1.0 独立）

🗄️ 数据存储

Ping 02 使用 SQLite 单文件数据库（ping.db），实现轻量级、易部署的数据存储方案。