# psd2html

**Repository Path**: tangbin9977/psd2html

## Basic Information

- **Project Name**: psd2html
- **Description**: Photoshop psd  1. 转 html， 2.以截图的方式转axure文档。 使用 photoshop2018脚本、js库，Python库解析PSD
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-23
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PSD to HTML Converter

将 PSD 文件精确转换为静态 HTML 的工具，支持批量处理、断点续传，无需安装 Adobe Photoshop。

## 简介

PSD to HTML Converter 是一个高精度的 PSD 设计稿转 HTML 工具，能够实现 1:1 像素级还原。工具采用 Python 实现，使用 psd-tools 库解析 PSD 文件，无需依赖 Adobe Photoshop 即可运行。支持多种输出格式，包括标准 HTML、Axure 原型等，并提供截图模式、对比验证、AI 增强解析等高级功能。

## 快速开始

### 安装依赖

```bash
cd python
pip install -r requirements.txt
```

### 处理单个文件

```bash
cd python
python main.py --file "path/to/your/file.psd"
```

### 批量处理所有文件

```bash
cd python
python main.py --all
```

## 输出目录结构

```
output/                        # 统一输出目录（项目根目录）
├── html/                      # HTML 格式输出
├── axure/                     # Axure 格式输出
├── penpot/                    # Penpot 格式输出
├── archive/                   # 归档目录
└── logs/                      # 日志文件
```

## 功能特点

- **1:1 精确还原** - 完整还原 PSD 设计的每个像素，保持图层位置、样式、效果
- **批量处理** - 支持批量处理整个目录的 PSD 文件，自动导出图片资源
- **无需 Photoshop** - 使用 psd-tools 解析，无需安装 Adobe Photoshop
- **断点续传** - 处理进度自动保存，中断后可继续处理
- **多种输出格式** - 支持纯静态 HTML、Axure 原型、**Penpot 设计文件**
- **Penpot 自动图片引用** - ⭐ 新功能：生成的 Penpot 文件图片自动显示！
- **高级功能** - 提供截图对比、AI 智能解析（GLM-4.7）、图层验证等增强功能

## 文档导航

- 📘 [用户手册](docs/USER_GUIDE.md) - 完整使用说明
- 🔧 [开发者指南](docs/DEVELOPER_GUIDE.md) - 架构与扩展
- ⚡ [高级功能](docs/ADVANCED.md) - Axure、截图、对比
- 🎨 [Penpot 指南](docs/PENPOT_USER_GUIDE.md) - Penpot 输出使用指南
- 🔬 [Penpot 技术文档](docs/PENPOT_AUTO_IMAGE_REFERENCE.md) - 图片自动引用实现
- 📦 [Node.js 版本](docs/NODEJS_VERSION.md) - 需 Photoshop 的历史版本

## 环境要求

- Python 3.8+
- 依赖库：
  - psd-tools >= 1.9.31（PSD 文件解析）
  - Pillow >= 10.0.0（图像处理）
  - numpy >= 1.24.0（数值计算）
  - scikit-image >= 0.21.0（图像分析）
  - jinja2 >= 3.1.0（模板引擎）

## 许可证

MIT License