# pt_studio

**Repository Path**: polewt/pt_studio

## Basic Information

- **Project Name**: pt_studio
- **Description**: PromptStudio 是一款面向开发者的 LLM 提示词测试与调优工具，支持多种 LLM Provider（OpenAI 兼容、vLLM 等），提供灵活的提示词编辑、多模态内容支持、详细的运行日志和完整的预设管理功能。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: release
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-21
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: JavaScript, React, Nodejs, TypeScript, prompt

## README

# PromptStudio

<div align="center">

**LLM 提示词测试与调优工具** — 多 Provider、多模态提示词工程平台

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
![React](https://img.shields.io/badge/React-19-61DAFB)
![Vite](https://img.shields.io/badge/Vite-8-646CFF)
![TypeScript](https://img.shields.io/badge/TypeScript-6-3178C6)
![Tailwind CSS](https://img.shields.io/badge/Tailwind-4-06B6D4)

[English](README.en.md) · 中文

</div>

---

## 📖 概述

PromptStudio 是一款面向开发者的 LLM 提示词测试与调优工具，支持多种 LLM Provider（OpenAI 兼容、vLLM 等），提供灵活的提示词编辑、多模态内容支持、详细的运行日志和完整的预设管理功能。

### 主要特性

- **多 Provider 支持** — 抽象 Provider 接口，支持 OpenAI 兼容 API、vLLM，可扩展
- **多模型管理** — 每个 Provider 可配置多个模型，模型级参数覆盖
- **动态提示词编辑器** — 支持 Text / Image / Video / Audio 多类型消息，拖拽排序
- **预处理系统** — 本地 Canvas 抽帧、音频编码、URL 抓取，支持透传模式
- **文件管理** — 上传文件至服务端，哈希去重，类型过滤，全屏预览
- **详细运行日志** — 每次请求的完整链路日志（URL、参数、流式块、耗时、Token 用量）
- **预设系统** — 保存/加载完整配置（Provider、模型、参数、提示词）
- **主题系统** — Light / Dark / System 主题切换
- **国际化** — 中文 / English
- **可拖拽界面** — 左右分栏可拖拽调整，侧栏可折叠

---

## 🚀 快速开始

### 环境要求

- Node.js >= 22
- Yarn 4+

### 安装

```bash
# 安装依赖
yarn install

# 启动开发模式（前端 + 后端）
yarn dev:all

# 或分别启动
yarn dev       # 终端 1：Vite 前端（:5173）
yarn server    # 终端 2：Express 后端（:3001）
```

### 生产构建

```bash
yarn build
yarn start     # Express 在 :3001 提供前端静态文件 + API
```

---

## 🏗 项目架构

```
prompt_tool/
├── src/
│   ├── components/       # UI 组件
│   │   └── ui/           # 基础 UI 组件库（Button/Input/Select/Card/Toggle...）
│   ├── pages/            # 页面（Chat / Providers / Presets / Logs / Files / Settings）
│   ├── store/            # Zustand 状态管理
│   ├── providers/        # LLM Provider 抽象层（OpenAI / vLLM）
│   ├── services/         # 存储服务（localStorage / Express API）
│   ├── utils/            # 工具函数（预处理、日志）
│   ├── i18n/             # 国际化（cn / en）
│   ├── types/            # TypeScript 类型定义
│   └── styles/           # SCSS 主题系统
├── server/               # Express 后端
│   ├── routes/           # API 路由（presets / logs / llm / preprocess / uploads）
│   └── db.ts             # SQLite 数据库
└── data/                 # SQLite 数据文件（自动生成）
```

---

## 🎨 界面

| 页面 | 功能 |
|---|---|
| **对话 (Chat)** | 提示词编辑、参数调整、发送请求、响应查看、运行日志 |
| **模型提供方 (Providers)** | 管理 Provider、模型、默认参数、测试连接 |
| **预设 (Presets)** | 保存/加载完整的对话配置 |
| **系统日志 (System Logs)** | 查看系统级日志，支持级别过滤 |
| **文件 (Files)** | 上传/管理文件，类型过滤，全屏预览 |
| **设置 (Settings)** | 语言、主题、后端服务配置 |

---

## ⚙️ Provider 配置

### 三层参数模型

```
Provider（持久化）
├── defaultParams         ← Provider 级默认参数
├── models[]
│   ├── gpt-4o            ← 继承 Provider 参数
│   └── gpt-4o-mini
│       └── paramsOverride ← 可选：模型级参数覆盖
└── Conversation（对话级）
    └── sessionOverrides  ← 临时调整，不影响保存配置
```

### 支持的 Provider

| 类型 | 说明 |
|---|---|
| `openai` | OpenAI 兼容 API（GPT、Claude、DeepSeek 等） |
| `vllm` | vLLM 推理引擎（额外支持 top_k、min_p、repetition_penalty） |

---

## 🖥️ 技术栈

| 技术 | 用途 |
|---|---|
| React 19 | UI 框架 |
| Vite 8 | 构建工具 |
| TypeScript 6 | 类型安全 |
| Tailwind CSS 4 | CSS 框架 |
| Zustand 5 | 状态管理 |
| React Router 7 | 路由 |
| i18next | 国际化 |
| Express 5 | 后端服务 |
| SQLite (better-sqlite3) | 数据持久化 |
| Sass | 主题系统 |

---

## 📄 开源协议

本项目基于 [MIT License](LICENSE) 开源。

Copyright (c) 2026 polewt