# cut-pic

**Repository Path**: daiwenqi/cut-pic

## Basic Information

- **Project Name**: cut-pic
- **Description**: 这是一个用Electron写的一个截图桌面软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-31
- **Last Updated**: 2025-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cut Pic - 区域截图工具

> 一个基于 Electron、React 和 TypeScript 开发的现代化桌面区域截图应用

[![License](https://img.shields.io/badge/license-ISC-green.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/node.js-16+-blue.svg)](https://nodejs.org/)
[![Electron](https://img.shields.io/badge/electron-25+-blue.svg)](https://electronjs.org/)

## ✨ 功能特点

- 🎯 **精确区域截图**: 拖拽选择任意屏幕区域进行高质量截图
- 🚀 **快速截图**: 支持全局快捷键 `Ctrl+Shift+A` / `Cmd+Shift+A`
- 💾 **智能保存**: 自动保存到下载文件夹，同时复制到剪贴板
- 📷 **历史管理**: 完整的截图历史记录，支持预览、复制、重新保存
- 🔍 **图片预览**: 大图预览模式，支持ESC快速关闭
- ⚙️ **个性化设置**: 自定义快捷键和保存位置
- 🎨 **现代界面**: 简洁美观的用户界面，支持响应式设计
- 🔧 **跨平台**: 支持 Windows、macOS 和 Linux

## 🚀 快速开始

### 安装依赖
```bash
npm install
```

### 开发运行
```bash
# 开发模式
npm run dev

# 构建并启动
npm run build && npm start
```

### 打包发布
```bash
# 构建发布包
npm run dist

# 仅打包不安装
npm run pack
```

## 📖 使用指南

### 基本使用
1. **快捷键截图**（推荐）：按下 `Ctrl+Shift+A` / `Cmd+Shift+A`
2. **按钮截图**：打开应用，点击"开始截图"
3. **区域选择**：拖拽鼠标选择截图区域
4. **自动完成**：截图自动保存并复制到剪贴板

### 高级功能
- **历史预览**：点击 🔍 预览按钮查看大图
- **快速复制**：历史记录中一键复制到剪贴板
- **重新保存**：将历史截图保存到新位置
- **自定义设置**：修改快捷键和保存路径

## 📋 技术栈

| 技术 | 版本 | 用途 |
|------|------|------|
| **Electron** | 25+ | 跨平台桌面应用框架 |
| **React** | 18+ | 用户界面库 |
| **TypeScript** | 5+ | 静态类型语言 |
| **Webpack** | 5+ | 模块打包工具 |
| **CSS3** | - | 现代样式和动画 |

## 📁 项目结构

```
cut-pic/
├── src/                    # 源代码
│   ├── main/              # Electron 主进程
│   │   ├── main.ts        # 主进程入口
│   │   └── preload.ts     # 预加载脚本
│   └── renderer/          # React 渲染进程
│       ├── components/    # React 组件
│       ├── styles/        # 样式文件
│       ├── App.tsx        # 主应用组件
│       └── index.tsx      # 渲染进程入口
├── docs/                  # 📚 开发文档
├── dist/                  # 构建输出
├── release/               # 发布包
└── package.json           # 项目配置
```

## 📚 开发文档

| 文档 | 描述 |
|------|------|
| [功能介绍](docs/FEATURES.md) | 详细的功能说明和使用技巧 |
| [快捷键说明](docs/SHORTCUTS.md) | 快捷键配置和自定义指南 |
| [设置指南](docs/SETTINGS.md) | 应用设置和个性化配置 |
| [交互说明](docs/INTERACTION.md) | 用户界面交互和操作流程 |
| [bug修复记录](docs/BUGFIX.md) | 已修复的问题和解决方案 |
| [性能优化](docs/OPTIMIZATION.md) | 性能优化措施和技术细节 |

## 🤝 贡献

我们欢迎任何形式的贡献！

1. **提交问题**：发现bug或有新想法？请提交 [Issue](../../issues)
2. **代码贡献**：Fork 项目，提交 Pull Request
3. **文档改进**：帮助完善文档和使用指南
4. **功能建议**：分享你的创意和建议

## 📄 许可证

本项目采用 [ISC License](LICENSE) 许可证。

## 🎉 更新日志

### v1.2.0 (最新)
- ✨ 新增图片预览功能
- 🧹 移除窗口截图功能，专注区域截图
- 🎨 优化界面设计，提升用户体验
- 📝 重构文档结构，提供更好的开发指南
- 🐛 修复多项bug，提升稳定性

### v1.1.0
- ✨ 新增智能窗口截图功能
- ✨ 新增剪贴板复制功能
- ✨ 完善截图历史管理
- 🎨 优化用户界面布局

### v1.0.0
- 🎉 初始版本发布
- ✨ 基本区域截图功能
- ✨ 自动保存功能
- ✨ 截图历史记录

---

<div align="center">

**[⬆️ 回到顶部](#cut-pic---区域截图工具)**

Made with ❤️ by Cut Pic Team

</div>