Metadata-Version: 2.4
Name: daochu
Version: 0.2.0
Summary: 微信聊天记录截图导出 — Export WeChat conversations via screenshots + OCR
Author-email: DaoChu Contributors <daochu@example.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/CodeOfMe/DaoChu
Project-URL: Repository, https://github.com/CodeOfMe/DaoChu
Keywords: wechat,export,chat,html,markdown,screenshot,ocr
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# DaoChu（导出）

[![PyPI version](https://img.shields.io/pypi/v/daochu.svg)](https://pypi.org/project/daochu/)
[![Python](https://img.shields.io/pypi/pyversions/daochu.svg)](https://pypi.org/project/daochu/)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://github.com/CodeOfMe/DaoChu/blob/main/LICENSE)

**DaoChu**（导出）是一个 Python 命令行工具，能将微信聊天记录导出为精美的 **HTML** 页面或 **Markdown** 文件。

> 通过截屏 + OCR 零侵入导出微信聊天记录。不碰任何微信数据文件。

---

## ✨ 特性

- 📸 **截图 OCR 导出** — 零数据侵入，自动截屏+中文 OCR
- 🎨 **精美 HTML 输出** — 仿微信气泡样式，带日期分组、响应式设计
- 📝 **Markdown 输出** — 纯文本，适合归档或导入笔记工具
- 🖼️ **自动去重** — 相邻截图重叠内容智能合并

---

## 📦 安装

```bash
pip install daochu
```

要求 Python ≥ 3.10。

---

## 🚀 快速开始

### 1. 准备

- macOS 系统（依赖 `screencapture` / `osascript` 自带）
- 安装 Tesseract OCR：`brew install tesseract`
- 中文语言包（脚本首次运行会自动下载）

### 2. 导出聊天记录

```bash
# 打开微信，进入目标聊天窗口，滚动到对话最顶部
# 然后运行：
python tools/screenshot_export.py -o 聊天记录.html

# 英文系统微信
python tools/screenshot_export.py -w "WeChat" -o chat.md -f md

# 限制最大截图数
python tools/screenshot_export.py -n 30
```

**原理**：AppleScript 控制微信窗口 → 逐页截屏 → Tesseract OCR 识别中文 → 智能去重 → 导出 HTML/Markdown。

### 3. 输出效果

- 仿微信气泡样式 HTML（自己的消息靠右绿色，对方靠左白色）
- 纯文本 Markdown（适合归档、笔记软件导入）
- 自动按发送者分组，连续消息合并在同一气泡

---

## 🖥️ 命令行参考

```
Usage: python tools/screenshot_export.py [OPTIONS]

选项:
  -w, --window TEXT          微信窗口标题 (默认: 微信)
  -o, --output PATH          输出文件路径
  -f, --format [html|md]     输出格式 (默认: html)
  -n, --max-screenshots INT  最大截图数 (默认: 50)
  --chat-area-top-offset INT 聊天区距窗口顶部偏移 (默认: 80px)
  --dry-run                  仅截图不 OCR（调试用）
```

---

## 🖼️ 效果预览

HTML 输出效果：

- 顶部：联系人名称、日期范围、消息总数
- 每一条消息：微信风格气泡，自己的消息靠右显示为绿色
- 日期分组：按天自动插入日期分隔线
- 移动端适配：响应式设计，手机上也能流畅阅读

---

## 📄 License

GPL-3.0-or-later © DaoChu Contributors
