# promptOptimiser

**Repository Path**: xthintain/prompt-optimiser

## Basic Information

- **Project Name**: promptOptimiser
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-08
- **Last Updated**: 2025-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek 提示词优化器 (Windows 桌面版)

本项目是一个简洁、高效的桌面悬浮窗应用，专用于调用 **DeepSeek** 的大语言模型来优化您的提示词（Prompt）。

## ✨ 功能特性

- **悬浮窗设计**：以无边框窗口的形式存在，方便您在任何工作界面上随时调用。
- **专注高效**：专为DeepSeek模型优化，无多余选项。
- **流式响应**：优化结果将以打字机的效果实时显示。
- **异步处理**：API请求在后台进行，确保用户界面流畅不卡顿。
- **美观UI**：基于PySide6和现代化的深色主题。

## 🚀 快速开始 (Windows 环境)

### 1. 安装 Python

如果您的电脑上还没有Python，请先从 [Python官方网站](https://www.python.org/downloads/windows/) 下载并安装最新稳定版的Python。
> **重要提示**：在安装过程中，请务必勾选 **"Add Python to PATH"** 选项。

### 2. 下载项目

使用 `git` 克隆本项目 (如果您没有git，也可以直接下载ZIP压缩包并解压):
```powershell
git clone <your-repo-url>
cd promptOptim
```

### 3. 创建并激活虚拟环境

打开CMD或PowerShell，进入项目目录，然后执行以下命令：
```powershell
# 创建虚拟环境
python -m venv .venv

# 激活虚拟环境
.venv\Scripts\activate
```
激活成功后，您会看到命令行前面出现 `(.venv)` 的字样。

### 4. 安装依赖库

继续在同一个命令行窗口中，执行：
```powershell
pip install -r requirements.txt
```

### 5. 配置API密钥

在项目文件夹中，创建一个名为 `.env` 的文本文件。您可以通过右键 -> 新建 -> 文本文档，然后将其重命名为 `.env` (注意删除 `.txt` 后缀)。

打开这个 `.env` 文件，填入您的DeepSeek API密钥：
```dotenv
# .env
DEEPSEEK_API_KEY="dk-..."
```

### 6. 运行应用

一切就绪！运行以下命令来启动悬浮窗应用：
```powershell
python main_window.py
```
一个简洁的悬浮窗将会出现在您的屏幕上。

---

## 💡 使用技巧

### 中文输入

在Windows环境下，您可以直接使用系统自带的中文输入法。按下 `Win徽标键` + `空格键` 即可切换输入法，在应用内自由输入中文。

### 窗口置顶

要将悬浮窗 **“始终保持在最前”**，强烈推荐使用微软官方的免费工具集 **PowerToys**。
1.  从 **Microsoft Store** 或其 [GitHub页面](https://github.com/microsoft/PowerToys/releases/latest) 安装 PowerToys。
2.  在PowerToys设置中，启用 **“始终保持在最前”** 功能。
3.  点击我们的悬浮窗应用，然后按下快捷键 **`Win + Ctrl + T`**，即可将其锁定在屏幕最顶层。 
> - **Windows / WSLg 用户**: 强烈推荐使用微软官方的 **PowerToys**。安装后，使用快捷键 `Win + Ctrl + T` 即可将当前窗口“始终保持在最前”。