📐 Architecture
AI 智能问答系统 · Leon-AI-Chat
基于 MemKV 知识库的 AI 智能问答系统 · SSE 流式输出
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 向管理员索取,文档不记录明文
点击查看全文 ⤢