- 确保已安装Python 3.8或更高版本
- 安装依赖包:
pip install -r requirements.txt
- 在
.env文件中配置API密钥:api_key=your_api_key_here
- 双击
启动gui.bat运行程序 - 在输入框中输入消息,按回车或点击发送按钮
- 使用设置选项卡配置API密钥和其他选项
- 点击帮助选项卡查看使用说明
- 最小化窗口时,程序会显示为悬浮球
- 右键点击系统托盘图标可以显示/退出程序
- 确保网络连接正常
- API密钥需要正确配置
- 建议定期查看任务摘要了解执行情况
- 顶部状态栏:显示Token计数、当前工具和时间
- 聊天区域:显示对话内容,支持Markdown格式
- 输入框:输入消息并发送
- 设置选项卡:配置API密钥和其他选项
- 帮助选项卡:查看使用说明
- 任务摘要:查看任务执行历史
- 工具选择器:快速切换不同的功能工具
- 语音控制:支持语音输入和输出(仅完整版本)
- 系统托盘:最小化时显示为悬浮球,支持快速操作
- 主题切换:支持深色/浅色主题切换
- 字体设置:可调整字体大小和样式
- 快捷键提示:显示当前可用的快捷键操作
- Enter:发送消息
- Ctrl+Q:退出程序
- Ctrl+H:显示/隐藏窗口
基于DeepSeek大语言模型的智能助手系统,提供多种功能,包括文本交互、语音识别与合成、代码生成、邮件管理、天气查询等。
DeepSeek-PC实现了一套严格的任务验证机制,确保用户请求被真正执行而非仅停留在计划阶段:
-
计划与执行严格区分
- 系统能够明确区分"计划做什么"和"已经做了什么"
- 仅将有明确工具调用证据的步骤视为已完成
- 防止大模型将任务描述误认为已执行操作
-
证据驱动的完成判断
- 任务完成状态基于实际工具调用记录而非模型自我评估
- 为每个关键步骤收集执行证据,包括工具名称、目的和结果
- 自动计算成功执行的工具调用比例,作为任务完成度的客观指标
-
幻觉风险评估
- 实时监控并评估模型将计划误认为执行的风险
- 对高风险幻觉场景进行明确警告和强制纠正
- 通过执行差距分析,揭示计划与实际执行间的差异
-
递进式验证机制
- 在执行前、执行过程中和执行后进行多层次验证
- 追踪任务进度变化,及时发现进度停滞或倒退的情况
- 支持多次验证尝试,确保验证结果的可靠性
-
智能任务状态识别
- 清晰标记任务状态为[完成]/[失败]/[继续],明确任务执行结果
- 自动识别任务失败情况,提供详细的失败原因和可能的解决方案
- 检测部分完成但已达到可接受状态的任务,支持灵活的完成判断
- 进度监控系统,自动检测连续多次无进展的执行,避免无效循环
-
动态任务规划能力
- 在每次迭代中重新评估任务进展并动态调整计划
- 不再机械地按初始计划执行,而是根据实际情况灵活调整
- 评估当前任务进展百分比,为用户提供清晰的进度反馈
- 主动识别执行障碍并提出调整方案,增强解决问题的能力
-
深度验证与虚假成功检测
- 智能检测"看似成功但实际未完成"的情况(如无变更推送、空操作)
- 分析工具调用输出中的可疑模式,自动识别常见错误信号
- 对任务完成声明进行严格的二次验证,确认每个步骤都真正达到了预期效果
- 针对可疑执行结果,提供具体的纠正指导,引导智能体继续完成任务
-
用户确认机制
- 在任务可能失败时主动询问用户是否继续尝试
- 不再由AI单方面决定任务失败,而是将决策权交还给用户
- 支持开放式用户输入,用户可以提供补充信息或新的解决思路
- 即使AI认为任务无法完成,也会根据用户意愿尝试新的解决方案
- 提供全新思路和创新方案,避免过早放弃复杂任务
此验证系统大幅提高了任务执行的可靠性,确保用户请求被真正执行完成,而非仅仅获得一个未实际执行的计划或描述。
- 文本对话:与大语言模型实时交互
- 语音识别与合成:支持语音输入和输出(仅完整版本)
- 自主任务规划:AI自动分解复杂任务并执行
- 智能任务验证:严格区分计划与执行,通过工具调用证据验证任务完成度
- 动态任务调整:根据实际执行情况实时调整后续步骤,不机械遵循初始计划
- 幻觉防护机制:实时评估和防止模型将计划误认为已执行的操作
- 错误处理与修复:自动检测执行错误并尝试修复
- 上下文理解:保持对话上下文连续性
- 任务状态管理:清晰区分任务完成、失败或继续执行的状态
- 自动突破困境:检测到任务卡壳时自动尝试创新解决方案
- 用户决策参与:在任务可能失败时询问用户意见,支持开放式输入,用户可提供补充信息或新思路
- 文件操作:创建、读取、修改文件 (
code_generator.py) - 代码生成器:编写、验证和管理代码文件 (
code_generator.py) - 系统命令执行:
- PowerShell命令:通过PowerShell控制系统 (
powershell_command) - CMD命令:通过命令提示符执行DOS命令 (
cmd_command)
- PowerShell命令:通过PowerShell控制系统 (
- 邮件收发:检查邮箱和发送邮件 (
send_email.py) - 天气查询:获取城市实时天气信息 (
get_weather) - SSH控制:管理远程服务器 (
ssh_controller.py) - 深度思考:使用R1优化器解决复杂问题 (
R1_opt) - Web搜索:基于Bing搜索引擎的网页搜索和内容爬取功能 (
web_search_tool.py)- 支持关键词搜索和内容提取
- 智能筛选搜索结果
- 提取网页关键信息
- 专为AI agent优化的结构化数据输出
- AI增强搜索【新增】:使用博查AI Search提供更丰富的结构化信息卡片和AI生成答案
- 语义排序【新增】:使用语义相关性为文档排序,确保最相关内容优先展示
本项目现已集成了强大的代码增强工具套件,包括代码搜索、编辑和审验功能,帮助AI代理更精确地理解、修改和验证代码。
这些工具是新增的,用于精确查找和定位代码:
-
search_code - 智能搜索代码内容,支持多种搜索模式
# 语义搜索(默认) search_code("example.py", "读取用户配置") # 函数搜索 search_code("example.py", "save_data", "function") # 正则表达式搜索 search_code("example.py", "def get_\\w+\\(", "regex")
-
locate_code_section - 定位代码文件中的指定行范围
# 定位第10-20行代码 locate_code_section("example.py", 10, 20)
-
get_code_context - 获取代码行的上下文环境
# 获取第15行周围5行的上下文 get_code_context("example.py", 15, 5)
这些是已有工具,现已增强功能:
-
write_code - 增强版的代码文件写入工具
- 代码质量自动验证
- 潜在问题警告
- 代码结构分析
- 自动备份功能
-
verify_code - 增强版的代码验证工具
- 全面的语法检查
- 逻辑问题分析
- 未使用导入/变量检测
- 潜在无限循环检测
- 代码质量评分
-
append_code - 增强版的代码追加工具
- 追加后的完整性检查
- 自动备份功能
- 代码结构验证
-
read_code - 增强版的代码读取工具
- 代码复杂度分析
- 函数和类统计
- 代码质量指标
- 潜在问题识别
-
create_module - 增强版的模块创建工具
- 依赖模块可用性检查
- 代码质量评估
- 更完善的模块结构生成
- 使用
search_code查找需要修改的代码 - 使用
locate_code_section获取精确位置 - 使用
read_code查看完整代码 - 使用
write_code或append_code修改代码 - 使用
verify_code验证修改是否正确
- 搜索 -> 定位 -> 编辑:使用搜索工具找到相关代码,再精确定位,最后编辑
- 先验证后写入:在写入或修改代码前,先使用
verify_code验证代码是否有问题 - 利用上下文:使用
get_code_context了解代码的上下文环境,更准确地修改代码 - 关注代码质量:注意查看工具返回的代码质量评分和改进建议
- 代码修改:先搜索需要修改的函数,获取定位,然后进行精确修改
- bug修复:定位错误发生的代码行,获取上下文,理解问题并修复
- 代码理解:快速搜索和理解大型代码库中的功能实现
- 代码重构:查找相似结构,实现代码重构
- 操作系统: Windows 10/11
- Python: 3.8+
- 主要依赖:
openai- OpenAI API客户端edge-tts- 文本转语音python-dotenv- 环境变量管理pyaudio- 音频处理tiktoken- Token计数- 完整列表见
requirements.txt
python deepseekAPI.pypython aaaa.py或双击start_voice_mode.bat
- 基础版本: 仅支持文字输入/输出
- 完整版本: 支持语音输入(连续1.5秒静音自动结束)和语音输出(自动将回复转为语音)
本项目集成了代码生成和管理工具,无需使用PowerShell命令即可操作代码文件:
-
write_code【增强版】 - 将代码写入文件并进行自动验证
{ "file_name": "example.py", # 文件路径和名称 "code": "print('Hello World')", # 代码内容 "with_analysis": true, # 可选,是否返回代码分析结果 "create_backup": true # 可选,是否创建备份 } -
verify_code【增强版】 - 全面验证Python代码
{ "code": "def example(): return 42", # 要验证的Python代码 "verbose": true, # 可选,是否返回详细验证结果 "check_best_practices": true # 可选,是否检查最佳实践 } -
append_code【增强版】 - 向文件追加代码并验证完整性
{ "file_name": "example.py", # 要追加的文件 "content": "\ndef new_function():\n pass", # 要追加的内容 "verify_after": true, # 可选,追加后是否验证 "create_backup": true # 可选,是否创建备份 } -
read_code【增强版】 - 读取文件内容并提供深度分析
{ "file_name": "example.py", # 要读取的文件 "with_analysis": true, # 可选,是否返回代码分析 "complexity_check": true # 可选,是否分析代码复杂度 } -
create_module【增强版】 - 创建Python模块并验证其有效性
{ "module_name": "utils", # 模块名称(不含.py) "functions_json": '[{"name": "add", "params": "a, b", "body": "return a + b", "docstring": "Add two numbers"}]', # 函数定义JSON "verify_imports": true, # 可选,是否验证导入 "create_tests": true # 可选,是否创建测试代码 } -
search_code【新增】 - 智能搜索代码内容
{ "file_name": "example.py", # 要搜索的文件 "query": "用户验证函数", # 搜索查询 "search_type": "semantic" # 可选,搜索类型:semantic(默认)、exact、regex、function、class } -
locate_code_section【新增】 - 定位代码文件中的指定行范围
{ "file_name": "example.py", # 目标文件 "start_line": 10, # 起始行 "end_line": 20 # 结束行 } -
get_code_context【新增】 - 获取代码行的上下文环境
{ "file_name": "example.py", # 目标文件 "line_number": 15, # 目标行号 "context_lines": 5 # 可选,上下文行数(默认为5) }
可以运行代码生成器示例:
python -c "import code_tools; print(code_tools.write_code('hello_world.py', 'print(\"Hello, AI generated World!\")\n'))"或双击code_generator_demo.bat
-
PyAudio安装失败:
- Windows: 下载预编译wheel文件安装
- Linux: 安装系统依赖
sudo apt-get install python3-pyaudio portaudio19-dev - macOS: 使用Homebrew安装
brew install portaudio
-
API密钥配置:
- 确保.env文件中的API密钥已正确配置
- DeepSeek API密钥需要在DeepSeek官网申请
-
语音功能不工作:
- 检查麦克风和扬声器设置
- 确保pyaudio和edge-tts正确安装
- 语音识别需要网络连接
-
依赖安装问题:
- 尝试使用国内镜像源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- 尝试使用国内镜像源:
├── README.md
├── aaaa.py # 完整版本(含语音功能)
├── deepseekAPI.py # 基础版本(仅文本功能)
├── tool_registry.py # 集中式工具定义模块
├── system_utils.py # 系统工具和命令执行功能
├── code_generator.py # 代码生成工具
├── code_tools.py # 代码操作工具集
├── file_utils.py # 文件操作工具集
├── send_email.py # 邮件发送功能
├── ssh_controller.py # SSH远程控制
├── error_utils.py # 错误处理工具
├── message_utils.py # 消息处理工具
└── requirements.txt # 依赖列表
-
用户确认任务失败机制
- 新增智能体任务失败前的用户确认步骤
- 当AI认为任务无法完成时,会询问用户是否继续尝试
- 用户可以提供开放式输入,补充说明或提供额外信息
- 无需局限于简单的"继续/终止"选择,可以直接描述新思路或确认方向
- 默认继续尝试而非放弃,增强解决复杂问题的能力
-
错误处理机制优化
- 更精细的错误分类和处理策略
- 在用户选择继续尝试后,自动分析失败原因并制定新方案
- 多样化突破思路,包括问题拆解和替代方案探索
- 增强系统韧性,减少过早放弃复杂任务的情况
-
任务复杂度自适应验证
- 引入任务复杂度识别系统,自动区分简单命令和复杂任务
- 对git操作、文件列表等简单任务减少验证次数
- 自动识别成功信号,对简单任务执行快速验证
- 显著提高了常见命令操作的响应速度
-
控制台输出智能处理
- 优化命令输出结果处理逻辑,根据文本量自动调整返回方式
- 当输出少于5000字符时,直接返回完整原始输出
- 当输出超过5000字符时,自动调用LLM生成简洁摘要
当智能体遇到无法解决的任务时,系统会询问用户:
智能体认为任务无法完成。您是否希望继续尝试,或者有其他建议?
(输入您的想法或指示,不限于简单的继续/终止选择)
用户可以提供开放式回复,例如:
- "继续尝试,但尝试使用另一种方法"
- "你尝试帮我解决一下网络问题吧"
- "改用Python 3.8版本试试看"
- "查看日志文件了解更多错误信息"
系统会根据用户的具体输入调整解决方案,而不仅限于继续或终止的二元选择。
-
通用任务成功检测机制
- 实现了更通用的任务成功检测系统,不再依赖特定工具类型
- 使用通用成功信号和错误信号列表,适用于所有工具执行结果
- 当检测到成功信号且不存在错误信号时,由模型评估任务完成状态
- 确认完成后立即生成简洁总结并结束任务,大幅减少Token消耗
- 优化了任务执行流程,避免不必要的验证步骤,提高响应速度
-
增强的任务验证系统
- 增强了智能验证机制,防止虚假任务完成报告
- 添加了对多种可疑输出模式的自动识别
- 对任务完成声明进行二次深度验证
- 系统能够检测"看似完成但实际未完成"的情况
-
提高智能体韧性
- 增加了任务执行的最大尝试次数(从5次到7次)
- 放宽了进度停滞的判断条件(从3次到5次)
- 添加了"突破困境"功能,在任务卡壳时提供新思路
- 更谨慎的任务失败判断,引导智能体多尝试不同解决方案
-
CMD命令工具
- 新增CMD命令工具,用于执行传统DOS命令和批处理文件
- 自动设置UTF-8编码,更好地支持中文显示
- 智能响应确认提示,无需手动添加/Y等参数
- 与PowerShell工具相同的自动交互能力和结果摘要
-
工具注册模块改进
- 集中式工具注册模块,减少代码重复
- 更详细的工具描述和用法说明
- 统一的参数验证和错误处理
-
任务执行机制优化
- 更严格的前置任务依赖检查
- 智能分析工具调用结果,而非仅检查命令执行
- 动态生成任务执行计划,不再机械按初始计划执行
- 递增式任务验证,确保每个步骤都真正完成
本项目采用MIT许可证。详情请参阅LICENSE文件。
如有问题或建议,请通过以下方式联系我们:
- 邮箱: 1792491376@qq.com
- GitHub: https://github.com/Dingye233
感谢使用DeepSeek-PC-Manager!希望它能成为您的得力助手。
项目支持打包为单独的可执行文件(EXE),便于在没有Python环境的电脑上运行。
- 安装依赖
pip install -r requirements.txt
- 运行打包脚本
python package_exe.py
- 打包完成后,可执行文件将位于
dist/DeepSeek-PC-Manager目录中
软件的用户数据文件(user_information.txt)将存储在用户的Documents目录下:
%USERPROFILE%\Documents\DeepSeek-PC-Manager\user_information.txt
用户可以根据需要自由编辑此文件,软件会自动读取最新的内容。首次运行时会自动创建此文件。