# Prompt_Util

**Repository Path**: demo_53_0/prompt_-util

## Basic Information

- **Project Name**: Prompt_Util
- **Description**: 实现指标抓取的提示词生成及测试
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-02
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Prompt Studio Pro (Prompt指标提取提示词生成小工具)

Prompt Studio Pro 是一款企业级提示词工程工具，专为从文档（如 PDF）中提取特定指标数据而设计。它能够帮助用户快速生成高质量的 Prompt（提示词），并提供内置的验证功能，直接测试 Prompt 在实际文档上的提取效果。

## ✨ 核心功能

*   **智能 Prompt 生成**：
    *   只需输入指标名称和定义，自动生成专业的提取 Prompt。
    *   支持设置别名（Aliases），提高召回率。
    *   **多模式支持**：支持单值提取（最新/最匹配）和多值提取（提取所有符合条件的数据）。
    *   **多格式输出**：支持 JSON、CSV、Markdown Table 等多种结构化输出格式。
    *   **双语支持**：支持中文和英文 Prompt 生成。
    *   **Lite 模式**：提供精简版 Prompt 模板，节省 Token。

*   **实时验证 (Playground)**：
    *   支持上传 PDF 文档（自动解析文本）。
    *   集成 LLM（如 DeepSeek, OpenAI 等）进行实时测试。
    *   直观展示提取结果，方便调试和优化 Prompt。

*   **现代化 UI**：
    *   基于 Streamlit 构建，界面简洁美观。
    *   分步式操作流程，用户体验流畅。

## 🛠️ 技术栈

*   **Python 3.10+**
*   **Streamlit**: Web 应用框架
*   **pdfplumber**: PDF 文本解析
*   **OpenAI SDK**: LLM 接口调用
*   **PyInstaller**: 桌面应用打包

## 🚀 快速开始

### 1. 环境准备

确保已安装 Python 3.8 或更高版本。

```bash
# 克隆仓库
git clone https://gitee.com/demo_53_0/prompt_-util.git
cd prompt_-util

# 安装依赖
pip install -r requirements.txt
```

### 2. 运行应用

**方式一：作为 Web 应用运行**

```bash
streamlit run app.py
```

**方式二：作为桌面应用运行**

双击 `Start_Tool.bat` 或运行：

```bash
python run_desktop.py
```

### 3. 配置模型

首次运行时，你需要在设置页面或生成的配置文件中配置 LLM API 信息：

*   **API Key**: 你的模型服务商 API Key
*   **Base URL**: 例如 `https://api.deepseek.com` (适配 DeepSeek) 或 `https://api.openai.com/v1`
*   **Model**: 模型名称 (e.g., `deepseek-chat`, `gpt-4`)

配置文件默认位于 `.app_config.json`。

## 📦 打包发布

如果你想将应用打包为独立的 `.exe` 可执行文件，请运行以下脚本：

```bash
# Windows
build_now.bat
```

或者手动运行 PyInstaller：

```bash
python -m PyInstaller PromptStudioPro.spec --clean --noconfirm
```

打包完成后，可执行文件将位于 `dist/PromptStudioPro/PromptStudioPro.exe`。

## 📝 使用指南

1.  **定义指标**：在左侧面板输入你想提取的指标名称（例如“营业收入”）及其业务定义。
2.  **生成 Prompt**：点击“生成 Prompt”按钮，右侧将显示生成的提示词。
3.  **验证效果**：
    *   点击“去验证”按钮进入第二步。
    *   上传包含相关数据的 PDF 文件。
    *   点击“运行验证”，查看模型提取的结果。
4.  **优化迭代**：根据提取结果调整定义或别名，重新生成直到满意。

## 📂 项目结构

```
PromptStudioPro/
├── src/                    # 源代码目录
│   ├── prompt_builder.py   # Prompt 生成逻辑
│   ├── pdf_utils.py        # PDF 处理工具
│   ├── llm_runner.py       # LLM 调用逻辑
│   └── ui_components.py    # UI 组件
├── tests/                  # 测试用例
├── app.py                  # Streamlit 主程序
├── run_desktop.py          # 桌面启动脚本
├── build_now.bat           # 一键打包脚本
├── requirements.txt        # 项目依赖
└── README.md               # 项目文档
```

## 📄 许可证

[MIT License](LICENSE)

---

**Powered by ShangYun AI Agent**