Magician 助手pro · 简洁AI桌面客户端

为桌面而生的 AI 工作台

从流式对话到自定义联网，从沙箱安全到插件扩展，一切恰到好处。

基础聊天 · 流式输出

打字机效果，完善 Markdown 渲染，DeepSeek-R1 思考过程独立展示，支持停止、重新生成与编辑历史。

联网搜索 · 自定义

不再依赖不稳定爬虫，完美支持 Function Calling。可接入 Tavily、博查、SearXNG，填好 URL 与 Key 即用。

多模态 · 视觉支持

拖拽、粘贴或选择图片发送，适配 GPT-4o / Qwen-VL 等视觉模型，自动压缩节省 Token。

会话管理 · 多标签

自动生成首句标题，本地 JSON 持久化，支持消息固定与对话分支，轻量高效。

界面与主题 · 纯代码图标

明暗双主题切换，自定义字体字号，图标全部由代码绘制，无需外部图片资源。

模型支持 · 全兼容

内置 OpenAI、DeepSeek、通义千问、Moonshot、Ollama，支持自定义 API 及 HTTP 代理，一键检测本地模型。

系统集成 · 全局快捷键

关闭最小化到系统托盘，Ctrl+Alt+Space 快速呼出，回复完成系统通知。

AI 沙箱 · 安全可控

安全类操作直接执行，敏感类弹窗确认，危险 Shell 默认关闭。附带备份与回收站机制。

快速开始

只需几步，即可在自己的桌面运行 Magician 助手pro。

安装依赖：pip install PySide6 cryptography
运行应用：python run.py
点击左下角设置，填入对话模型 API Key
在「联网搜索配置」中选择 Tavily，填入 Key，保存后即可聊天

项目模块化拆分：main_window、dialogs、workers、sandbox 等 10 个独立模块，解决多线程卡顿。

# 克隆仓库

git clone https://gitee.com/magicianswand/Magicianpro.git

# 安装依赖并运行

pip install PySide6 cryptography

python run.py

模块化架构 & 插件生态

底层重构，彻底告别面条代码。支持自定义 Python 插件扩展。

MagicianAI/ ├── run.py # 启动入口 ├── app.py # 应用初始化 ├── config.py # 全局配置与主题 ├── crypto_utils.py # 本地加密 ├── dialogs.py # 设置与对话框 ├── icon_factory.py # 纯代码绘制图标 ├── main_window.py # 主窗口与业务逻辑 ├── markdown_render.py # Markdown 渲染器 ├── sandbox.py # AI 沙箱工具 ├── search_tools.py # 联网搜索封装 ├── sound.py # 按键音效 ├── widgets.py # 聊天组件与弹窗 └── workers.py # 后台流式请求线程

插件示例

# ai_plugins/hello.py
def register(main_window):
    def hello():
        from PySide6.QtWidgets import QMessageBox
        QMessageBox.information(main_window, "插件", "Hello!")
    main_window.register_plugin_command("/hello", "示例命令", hello)