← 返回总览 / AI 智能问答系统 · Leon-AI-Chat 🏢 展示 📖 说明书 🕘 日志 技术架构说明
📐 Architecture

AI 智能问答系统 · Leon-AI-Chat

基于 MemKV 知识库的 AI 智能问答系统 · SSE 流式输出

📁 AI 智能服务 🌐 http://119.145.17.34:5004/ 🕑 更新于 2026-11-03
1

项目定位

Positioning
一句话定位

Leon-AI-Chat 是基于 MemKV 知识库的两阶段 AI 问答系统,先选知识节点再读原文生成回答,全程 SSE 流式输出,回答必带可点引用

点击查看全文 ⤢
研发方式

Flask 单体应用,后端 app.py 约 1166 行,前端 templates 加 static 纯静态,无构建步骤,venv 加 start.sh 即跑

点击查看全文 ⤢
服务边界

只读知识库,不写库、不改 OA 数据,写操作仅限设置页保存 settings.json

点击查看全文 ⤢
数据诚实边界

知识库缺失时按 strictMode 分支照抄代码行为,True 反而允许用自身知识补充,文档不按字面发挥

点击查看全文 ⤢
2

技术架构

Architecture
接入层Flask
app.run host 0.0.0.0 port 5004 threaded,start.sh 先 source venv 再 exec python app.py
点击查看全文 ⤢
检索编排层
get_knowledge_base_index 走 tree-editor,30 分钟缓存,KB 范围收敛为展示跳转 4 分组
点击查看全文 ⤢
模型调用层
deepseek_client 走中转站,ds_client 走官方,is_ds_mode 与 get_llm_client 在每次调用时决定
点击查看全文 ⤢
推送层SSE
generate 内按 status、thinking、chunk、sources、done 五事件推送,前端按 type 分发
点击查看全文 ⤢
3

模块组成

Modules
文件 / 目录类型说明
index.html 文件 16.7 KB
源码与素材清单
文件 / 目录类型说明
index.html 文件 16.7 KB
4

数据流转

Data Flow

尚未描述数据流转

projects/leon-ai-chat/ARCHITECTURE.md
5

接口与集成

API
问答流 POST api/chat/stream
入参 message 与 history,出参 SSE 五事件,缺 message 报 code 1
点击查看全文 ⤢
公共设置 GET api/public-settings
免密,仅返回 quickTags 与 navButtons
点击查看全文 ⤢
设置读写 GET加POST api/settings
需头 X-Settings-Password(口令向管理员索取),错则 403
点击查看全文 ⤢
原文代理 GET api/view
三参数透传 MemKV item/content,渲染 view.html
点击查看全文 ⤢
项目列表 GET api/projects
返回过滤后的知识库索引,供调试选节点
点击查看全文 ⤢
健康与首页 GET 斜杠
渲染 index.html 并注入 nav_buttons,after_request 统一加 no-cache 三头
点击查看全文 ⤢
6

部署形态

Deployment
运行位置 | TK-Server 192.168.11.70,Flask 直接监听 5004,公网 119.145.17.34:5004 穿透

运行位置 | TK-Server 192.168.11.70,Flask 直接监听 5004,公网 119.145.17.34:5004 穿透

点击查看全文 ⤢
启动 | cd 项目目录,source venv/bin/activate,exec python app.py,PYTHONUNBUFFERED=1

启动 | cd 项目目录,source venv/bin/activate,exec python app.py,PYTHONUNBUFFERED=1

点击查看全文 ⤢
重启纪律 | 改 app.py 或 templates 必须 kill 后 setsid nohup ./start.sh 重启,无 debug 热更新

重启纪律 | 改 app.py 或 templates 必须 kill 后 setsid nohup ./start.sh 重启,无 debug 热更新

点击查看全文 ⤢
口令管理 | 设置口令与 MemKV token 向管理员索取,文档不记录明文

口令管理 | 设置口令与 MemKV token 向管理员索取,文档不记录明文

点击查看全文 ⤢
© 2026 Leyon WorkStation · AI 智能问答系统 · Leon-AI-Chat 🏢 展示 📖 说明书 🕘 日志 ← 返回项目总览