# 稿定

**Repository Path**: deepin20/DraftDone

## Basic Information

- **Project Name**: 稿定
- **Description**: 稿定 · DraftDone是一款专为DeepSeek、ChatGPT等AI生成内容**设计的桌面排版工具。它解决了将Markdown格式的AI输出复制到Word时格式崩盘、表格错乱、公式乱码、代码缩进丢失等痛点，让您告别半小时的手动调整，一次导出即得标准Word文档。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-05
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 📄 稿定 · DraftDone

> **专治AI排版焦虑，一键搞定Word文档**

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![PyQt6](https://img.shields.io/badge/PyQt-6.5+-green.svg)](https://www.riverbankcomputing.com/software/pyqt/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

---

## 🎯 项目简介

**稿定 · DraftDone** 是一款专为**DeepSeek、ChatGPT等AI生成内容**设计的桌面排版工具。它解决了将Markdown格式的AI输出复制到Word时**格式崩盘、表格错乱、公式乱码、代码缩进丢失**等痛点，让您**告别半小时的手动调整，一次导出即得标准Word文档**。

- 🔥 **零成本入门**：无需学习任何命令，全图形界面，开箱即用
- 🔒 **隐私至上**：默认离线模式，所有数据在本地处理，不上传外网
- 🎨 **智能排版**：内置“基础办公 / 学术论文 / 技术方案”三种模板，一键切换
- 🧮 **公式三态**：支持原生公式（需pandoc）、截图渲染（内置）、保留LaTeX源码
- 📂 **批量监听**：自动监控文件夹，拖入即转，解放双手

---

## ✨ 核心功能

### 1. 所见即所得的双栏预览
左侧编辑Markdown，右侧**实时渲染**最终排版效果（字体、行距、边框完全匹配导出样式），告别“盲调”。

### 2. 三种模板一键切换
- **基础办公**：等线字体，常规页边距
- **学术论文**：宋体，1.5倍行距，严格页边距
- **技术方案**：微软雅黑，窄边距，代码块暗色背景

### 3. 公式处理三模式
| 模式 | 说明 | 依赖 |
|------|------|------|
| A. 原生公式 | 转换为Word可编辑公式（OMML） | 需安装 `pandoc` + `pypandoc` |
| B. 截图渲染 | 将LaTeX渲染为高清透明背景图片 | 需安装 `matplotlib` |
| C. 保留文本 | 保留原始LaTeX代码，并以等宽字体突出显示 | 无需额外依赖 |

### 4. 后台服务
- 📋 **剪贴板监听**：自动感知复制内容，提示一键导入
- 📁 **文件夹监听**：监控指定文件夹，新Markdown文件自动加载（默认：`~/Desktop/待转换`）
- 🕒 **历史记录**：本地SQLite存储，可回溯最近导出记录

### 5. 完全离线运行
默认开启“离线模式”，所有处理在本地完成，**绝不联网**，保障数据隐私安全。

---

## 📦 安装与运行

### 系统要求
- Python 3.8 及以上
- Linux（Deepin/UOS/Ubuntu等，支持X11）、Windows、macOS

### 快速开始（Linux / macOS / Windows）

```bash
# 1. 克隆或下载本项目
git clone https://github.com/yourname/稿定-DraftDone.git
cd 稿定-DraftDone

# 2. 创建并激活虚拟环境（强烈推荐）
python3 -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate

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

# 4. 安装可选组件（如需公式截图或原生）
#    - 截图模式：pip install matplotlib
#    - 原生模式：pip install pypandoc && sudo apt install pandoc (Linux) 或从 https://pandoc.org 下载

# 5. 运行
python run.py
```

> 💡 如遇 `qt.qpa.plugin` 错误，请安装系统图形库：  
> `sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xfixes0 libxcb-xkb1 libxkbcommon-x11-0`

---

## 🖥️ 使用指南

1. **打开软件**：双击 `run.sh`（Linux）或直接运行 `python run.py`
2. **输入内容**：
   - 直接粘贴DeepSeek等AI生成的Markdown
   - 通过「打开」按钮加载 `.md` 文件
   - 将 `.md` 文件拖拽至底部状态栏
   - 将文件放入 `~/Desktop/待转换` 文件夹（自动加载）
3. **调整样式**：在工具栏选择模板，在控制栏切换公式模式
4. **导出Word**：点击「导出Word」按钮，保存 `.docx` 文件
5. **查看历史**：点击「历史记录」浏览之前导出的文档

---

## 🧪 测试

项目提供了 `test_quick.py`，用于在无GUI环境下测试核心转换引擎、模板加载和数据库功能：

```bash
python test_quick.py
```

输出“全部通过”即表示核心功能正常。

---

## 📁 项目结构

```
稿定-DraftDone/
├── src/gaoding/               # 主程序包
│   ├── core/                  # 核心引擎（Markdown解析→Word生成）
│   ├── gui/                   # PyQt6图形界面（主窗口、组件、对话框）
│   ├── services/              # 后台服务（剪贴板、文件夹监听、历史记录）
│   ├── templates/             # YAML排版模板
│   ├── resources/             # 图标、样式表（暗色/亮色）
│   └── utils/                 # 工具函数
├── build.py                   # PyInstaller打包脚本
├── run.py                     # 程序入口
├── test_quick.py              # 快速功能测试
├── requirements.txt           # 依赖清单
└── README.md                  # 本文档
```

---

## 🤝 贡献指南

欢迎提交Issue和Pull Request！请确保：
- 代码风格遵循 PEP8
- 新功能或修复需包含测试用例（如适用）
- 提交前运行 `python test_quick.py` 确认无回归

---

## 📄 许可证

本项目基于 **MIT License** 开源，您可以自由使用、修改和分发，但需保留原版权声明。

---

## 🙏 致谢

- [PyQt6](https://www.riverbankcomputing.com/software/pyqt/) - 强大跨平台GUI框架
- [python-docx](https://python-docx.readthedocs.io/) - Word文档生成
- [markdown](https://python-markdown.github.io/) - Markdown解析
- [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/) - HTML解析

---

## 📧 联系方式

如有问题，请通过 [GitHub Issues](https://github.com/yourname/稿定-DraftDone/issues) 反馈。

**稿定 · DraftDone** —— 让AI写作的最后一公里更轻松 🚀
```

---

将上述内容保存为项目根目录下的 `README.md` 文件。您可以根据实际情况调整：
- GitHub仓库地址（替换 `yourname/稿定-DraftDone`）
- 添加真实截图（将占位的截图说明替换为实际图片链接）
- 补充更详细的常见问题解答