AI 智能对话伴侣应用开发

一、项目概述

本项目是一个基于 Streamlit 轻量级 Web 框架和 DeepSeek 大语言模型 API 构建的智能聊天机器人应用，旨在为用户提供一个界面友好、功能完整的 AI 对话平台。

主要目标

• 实现流畅、自然的实时人机对话
• 支持用户自定义 AI 助手的昵称与性格，打造个性化交互体验
• 提供完整的会话管理功能（新建、加载、删除、自动保存）
• 采用流式响应技术，提升对话的实时感与舒适度

适用场景

• 个人日常智能助理
• 团队内部知识问答与头脑风暴
• 教育场景下的模拟对话练习
• 快速原型验证与 AI 应用演示

二、技术架构

层级	技术方案	说明
前端界面	Streamlit	纯 Python 构建，无需编写 HTML/CSS/JavaScript
后端逻辑	Python 3.8+	封装业务逻辑与 API 调用
AI 引擎	DeepSeek API（模型：deepseek-v4-pro）	高性能国产大模型，支持流式输出
数据持久化	本地 JSON 文件（sessions/ 目录）	轻量存储，便于备份与迁移
安全配置	系统环境变量	API 密钥不写入代码，保障安全

三、功能模块详解

3.1 对话交互模块

用户通过底部输入框发送消息，消息以气泡形式显示在聊天区域。

• 使用 st.chat_message 区分用户和 AI 角色，界面清晰。
• 历史消息保存在 st.session_state.messages 中，页面刷新或切换会话后仍可恢复。

3.2 AI 个性化配置模块

侧边栏提供“昵称”和“性格”两个输入项。

系统根据用户配置动态构造系统提示词：

“你是{昵称}，性格{性格}，能够回答各种问题，提供帮助和建议。”

该提示词在每次 API 调用时生效，使 AI 回复符合用户期望的人格特征。

3.3 会话管理模块

• 新建会话：点击按钮保存当前会话并生成新会话（以时间戳命名）。
• 加载会话：侧边栏按时间倒序列出所有历史会话，点击即可切换。
• 删除会话：每个会话旁附带“删除”按钮，支持单个清理。
• 自动保存：每次 AI 回复完成后，自动将当前会话（含配置与消息）写入对应的 JSON 文件。

会话文件内容示例：

---

四、工作流程

用户发送消息流程

用户输入消息 → 界面立即显示用户气泡。

将用户消息追加到 session_state.messages。

构造完整请求：系统提示词 + 全部历史消息。

调用 DeepSeek API（流式模式）。

逐块接收回复并实时更新界面。

完整回复追加到消息列表，并自动保存会话至文件。

会话切换流程

用户点击侧边栏中的历史会话名称。

程序读取对应的 JSON 文件，恢复 nick_name、nature 和 messages。

刷新页面，界面立即展示该会话的完整对话记录。

用户可继续在该会话下发送新消息，后续内容将追加并保存。

五、项目特色

• 低代码快速构建：整个应用仅一个 Python 文件，依托 Streamlit 的强大组件，代码简洁且易于维护。
• 个性化交互：AI 的角色可随用户喜好调整，使对话更亲切、有趣。
• 数据本地化：所有对话历史存储在用户本地，无云端泄露风险，保护隐私。
• 响应式体验：流式输出让 AI 回复如同真人即时输入，提升使用愉悦感。
• 轻量级存储：JSON 格式便于阅读和手动编辑，无需额外数据库，部署门槛极低。

六、部署与运行

环境准备

• Python 3.8 及以上版本
• 有效的 DeepSeek API 密钥（可从 DeepSeek 官网获取）

代码仓库

https://github.com/mmt-hub/AI-local-deploymnet/tree/main

安装依赖

pip install streamlit openai
# Linux / macOS
export DEEPSEEK_API_KEY="your_api_key_here"

# Windows (CMD)
set DEEPSEEK_API_KEY=your_api_key_here

项目根目录/
├── 2.0ai_partner.py        # 主程序
├── resources/
│   └── logo.png            # 应用 Logo（可选）
└── sessions/               # 自动生成，存放所有会话 JSON

七、总结与展望

本项目以极少的代码量实现了一个功能完备、体验良好的智能对话应用。它不仅展示了 Streamlit 与 DeepSeek API 结合的高效性，也提供了会话持久化、个性化配置等实用功能，适合个人或小团队快速搭建专属 AI 助手。

后续可扩展方向

• 接入更多大模型（如 GPT、Claude、文心一言等），提供模型切换能力。
• 增加联网搜索功能，使 AI 能够获取实时信息。
• 支持文件上传（PDF、Word 等），实现基于文档的智能问答。
• 部署至云服务器（如 Streamlit Cloud、阿里云等），支持多用户并发访问。
• 升级存储为 SQLite 或 PostgreSQL，提升数据管理效率和查询能力。