# HanBridge

**Repository Path**: fly542/han-bridge

## Basic Information

- **Project Name**: HanBridge
- **Description**: 简繁通即简体和繁体互相转换。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 繁简通 HanBridge

> 飞天工作室出品 · 让 PDF 与 Word 文档在繁简之间自由转换

**繁简通** 是一款专注文档格式保留的繁简转换工具。无论你是收到繁体版 PDF 需要转为简体阅读，还是手头有简体 Word 文档需输出繁体版，它都能一键完成转换，且**原版式、原格式、原字体风格**完整保留。

---

## ✨ 核心特性

- **双向转换**：繁体 → 简体 / 简体 → 繁体，任意切换
- **PDF 支持**：保留拼音/注音、颜色、字号、坐标、彩色校勘框、下划线、底纹、图形、图像
- **Word 支持**：保留完整格式（字体/颜色/加粗/表格/样式），覆盖正文、表格、文本框、页眉/页脚、脚注/尾注、批注
- **智能上下文转换**：基于 OpenCC 引擎，按阅读顺序做整段转换，准确处理一简对多繁等复杂情况
- **保护字机制**：指定某些字保持不变（如《周易》中的"乾"不会被转成"干"）
- **装饰字体修复**：修复封面标题中"编码是简体、字形是繁体"的显示问题
- **转换清单导出**：可生成 CSV 明细，逐处记录转换位置与原字

---

## 🚀 快速开始

### 免安装版（推荐）

从 [发行版页面](https://gitee.com/fly542/han-bridge/releases) 下载 `繁简互转工具.exe`，两种用法：

**方法一：拖拽**
直接把一个 PDF 或 Word 文件拖到 exe 图标上，程序自动载入。

**方法二：双击运行**
1. 打开程序
2. 选择转换方向（繁体→简体 / 简体→繁体）
3. 点击"选择文件"挑选 PDF 或 Word
4. 点击"开始转换"

转换结果默认保存为 `原文件名_简体.扩展名`（繁→简）或 `原文件名_繁体.扩展名`（简→繁），与原文件同目录，**原文件不会被改动**。

> 旧版 `.doc` 二进制格式请先在 Word 里另存为 `.docx`。

### 命令行版

需要 Python 环境：

```bash
pip install -r requirements.txt

# 繁→简
python cli.py 输入.pdf

# 简→繁
python cli.py 输入.docx -d s2t

# 带保护字和转换清单
python cli.py 输入.docx -o 输出.docx --protect 乾坤 --csv
```

**参数说明：**

| 参数 | 说明 |
|------|------|
| `-o / --output` | 指定输出路径 |
| `-d / --direction` | 转换方向：`t2s`（繁→简，默认）/ `s2t`（简→繁） |
| `--protect` | 保护字，逐字连写，如 `乾坤` |
| `--no-fix-trad` | [仅 PDF] 关闭装饰字体修复 |
| `--csv` | 导出转换清单 CSV |

---

## 🖥️ 界面选项详解

| 选项 | 说明 |
|------|------|
| **转换方向** | 繁体→简体 或 简体→繁体 |
| **保护字** | 需要保持不变的字符。例如古籍中"乾"是卦名，填入后不会被转成"干"；而未列入保护的"幹"仍会正常转换 |
| **修复装饰字体** | 仅繁→简时有效。修复封面标题中"编码是简体、字体画成繁体"的显示问题 |
| **导出转换清单** | 生成 CSV 文件，记录每一处转换的页码、原字、目标字、坐标 |

---

## 📋 适用场景

- **学术研究**：阅读繁体 PDF 论文，一键转为简体，保留原文标注与格式
- **跨地区办公**：简体 Word 文档输出繁体版给港澳台客户，格式一字不差
- **古籍整理**：处理《周易》《史记》等繁体重排本，保护关键专有名词不被误转
- **出版排版**：繁体 PDF 稿件转简体审核，保留版式与彩色校勘标记

---

## ⚙️ 系统要求

- **操作系统**：Windows 7 及以上
- **字体依赖**：自动使用系统自带楷体、宋体、黑体、隶书、华文行楷、仿宋
- **文件格式**：`.pdf`（带文字层）/ `.docx`（非二进制 `.doc`）

---

## 📄 许可

本项目源码托管于 [Gitee](https://gitee.com/fly542/han-bridge)，由飞天工作室开发维护。

> 开发者文档（编译、库调用、工作原理）请参见 [DEVELOPER.md](./DEVELOPER.md)。

---

## 🏷️ 版本历史

| 版本 | 内容 |
|------|------|
| **v1.1** | 新增简体→繁体转换功能（PDF + Word） |
| **v1.0** | 繁体→简体转换（PDF + Word） |