🧠 ShadowMind

智能剪贴板助手 - AI 自动解释内容、回答问题、翻译英文

✨ 特性

• 🔍 自动监控剪贴板 - 后台运行,无需手动触发
• 🤖 AI 智能分析 - 自动判断内容类型,提供解释或回答,支持 DeepSeek / OpenAI / Claude / Gemini
• 🎯 多类型识别 - 问题、代码、网址、错误信息、英文、普通文本
• 📚 历史记录管理 - 自动保存分析记录(最多100条),支持搜索、导出、清空
• ⚡ 快捷键控制 - Ctrl+T 开关分析,Ctrl+Q 退出
• 🪟 弹窗显示结果 - 美观的 GUI 窗口展示分析结果
• 🖱️ 系统托盘运行 - 双击查看历史,右键菜单快捷控制
• 🛠️ 模块化设计 - 清晰的代码结构,易于扩展

🚀 快速开始

安装依赖

pip install -r requirements.txt

配置 API

编辑 shadowmind/api_config.py,填入你的 API Key:

DEEPSEEK_API_KEY = "sk-your-api-key-here"

运行程序

python main.py

📖 使用方法

1. 启动监控 - 运行 python main.py,程序最小化到系统托盘
2. 复制内容 - 使用 Ctrl+C 复制任何内容
3. 自动分析 - AI 自动判断内容类型并进行分析
4. 查看结果 - 弹窗显示 AI 分析结果,自动保存到历史记录
5. 查看历史 - 双击托盘图标打开历史查看器

快捷键

• Ctrl+T - 切换 AI 分析开关
• Ctrl+Q - 退出程序

系统托盘功能

• 双击图标 - 快速打开分析历史查看器
• 右键菜单 - 查看状态、历史记录、关于信息、退出程序
• 后台运行 - 最小化后在托盘继续工作

分析历史功能

• 自动保存 - 每次分析自动保存到历史记录(最多保留 100 条)
• 搜索过滤 - 支持关键词搜索历史记录
• 详细查看 - 查看每条记录的完整信息(类型、原文、AI分析、时间)
• 导出功能 - 导出历史记录为文本文件
• 一键清空 - 清空所有历史记录

🎨 功能示例

1. 问题回答

复制: Python 如何读取 JSON 文件?
AI 分析: 💡 使用 json.load(f) 读取文件对象,或 json.loads(s) 解析字符串

2. 代码解释

复制:

def factorial(n):
    return 1 if n == 0 else n * factorial(n-1)

AI 分析: 💻 这是一个递归函数,用于计算阶乘。当 n=0 时返回 1(基准情况),否则返回 n × factorial(n-1)

3. 网址解释

复制: https://github.com
AI 分析: 🔗 这是 GitHub 网站,全球最大的代码托管平台,用于版本控制和协作开发

4. 错误诊断

复制: ValueError: invalid literal for int() with base 10
AI 分析: 🚑 问题:试图将非数字字符串转为整数 | 解决:使用 str.isdigit() 验证或 try-except 捕获异常

5. 英文翻译

复制: Machine learning is transforming technology
AI 分析: 📖 翻译:机器学习正在改变技术

📁 项目结构

ai剪贴/
├── main.py                    # 程序入口
├── requirements.txt           # 依赖列表
├── README.md                  # 项目说明
├── USAGE.md                   # 使用指南
├── shadowmind/                # 核心模块
│   ├── __init__.py
│   ├── config.py              # 全局配置
│   ├── api_config.py          # API 配置
│   ├── prompts.py             # 提示词模板
│   ├── ai_analyzer.py         # AI 分析器
│   ├── clipboard_monitor.py   # 剪贴板监控
│   ├── tray_icon.py           # 系统托盘图标
│   ├── history_manager.py     # 历史记录管理
│   └── history_viewer.py      # 历史查看窗口
├── shadowmind_output/         # 输出目录
    └── history.json           # 历史记录文件

⚙️ 配置说明

API 配置 (api_config.py)

支持多个 AI 服务商:

• DeepSeek (推荐,性价比高)
• OpenAI (GPT-4/GPT-3.5)
• Claude (Anthropic)
• Gemini (Google)

设置 PREFERRED_API 选择默认服务商。

监控配置 (config.py)

CHECK_INTERVAL = 0.5          # 剪贴板检查间隔(秒)
MIN_CONTENT_LENGTH = 1        # 最小内容长度
OUTPUT_DIR = "shadowmind_output"  # 输出目录
MAX_HISTORY_RECORDS = 100     # 历史记录最大数量

🔧 技术栈

• Python 3.13+ - 核心运行环境
• pyperclip - 跨平台剪贴板访问
• openai - API 调用(兼容多家服务商)
• pystray - 系统托盘图标
• Pillow - 图标图像生成
• keyboard - 全局快捷键(需要管理员权限)
• tkinter - GUI 窗口(弹窗和历史查看器)

---

提示: 首次使用建议用 Ctrl+T 关闭 AI 分析,测试剪贴板监控是否正常工作,再开启 AI 功能。