# 净文

**Repository Path**: deepin20/TextPurity

## Basic Information

- **Project Name**: 净文
- **Description**: TextPurity 净文是一款桌面端文本清洗工具，专门用于清除 AI 生成内容中的 Markdown 标记、多余空格、特殊字符等格式干扰，让内容更纯净。支持 DeepSeek、ChatGPT、Claude 等多种主流 AI 的预设规则，并提供批量处理、剪贴板监视、自定义规则等高级功能。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TextPurity 净文 – AI 文本净化器

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Linux-yellow)](https://www.linux.org/)

**TextPurity 净文** 是一款桌面端文本清洗工具，专门用于**清除 AI 生成内容中的 Markdown 标记、多余空格、特殊字符等格式干扰**，让内容更纯净。支持 DeepSeek、ChatGPT、Claude 等多种主流 AI 的预设规则，并提供批量处理、剪贴板监视、自定义规则等高级功能。

---

## ✨ 功能特性

- **一键清洗**：读取剪贴板内容，应用规则集清洗后直接写回，步骤简化。
- **实时预览**：不修改剪贴板，先预览清洗效果，放心使用。
- **多规则集**：内置 DeepSeek、ChatGPT、Claude 规则，可自由切换。
- **自定义规则**：通过图形编辑器增删改规则，支持正则测试。
- **批量处理**：同时清洗多个文本文件（.txt/.md），支持覆盖或添加后缀。
- **剪贴板监视**：后台自动检测剪贴板变化，即时清洗（支持系统托盘）。
- **历史记录**：自动保存每次清洗的原始与结果文本（为撤销功能预留）。
- **跨平台支持**：基于 Python + Tkinter，专为 Linux 桌面（统信 UOS）优化。
- **国际化框架**：界面文本已支持多语言，后续可轻松扩展。

---

## 🚀 快速开始

### 系统要求

- Python 3.8 或更高版本
- Linux 桌面环境（推荐统信 UOS、Ubuntu、Debian）
- 剪贴板工具：`xclip` 或 `xsel`

### 安装步骤

1. **克隆仓库**
   ```bash
   git clone https://github.com/your-username/textpurity.git
   cd textpurity
   ```

2. **安装 Python 依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **安装系统依赖（Linux）**
   ```bash
   sudo apt install xclip   # 或 xsel
   ```

4. **运行应用**
   ```bash
   python src/main.py
   ```

5. **（可选）打包为独立应用**
   ```bash
   pip install pyinstaller
   pyinstaller packaging/pyinstaller/textpurity.spec
   ```

---

## 🧰 使用说明

### 基本操作
1. 复制 AI 生成的文本内容。
2. 在顶部下拉菜单中选择对应来源（如 `deepseek`）。
3. 点击 **“预览”** 查看清洗效果，或点击 **“清洗并写回”** 直接写入剪贴板。
4. 清洗后剪贴板内容即被替换，可直接粘贴使用。

### 高级功能
- **批量处理**：点击“批量处理”按钮，添加文件后统一清洗。
- **自定义规则**：点击“自定义规则”进入编辑器，可新增、编辑、删除规则，并实时测试。
- **监视模式**：点击“监视模式”启动后台监控，主窗口自动隐藏到系统托盘，随时保持剪贴板纯净。

> 详细操作请参考 [用户手册](docs/user_guide.md)。

---

## 📁 项目结构

```
textpurity/
├── src/
│   ├── controller/       # 控制器（业务逻辑）
│   ├── core/             # 核心模块（清洗器、剪贴板、规则）
│   ├── models/           # 数据模型（历史记录）
│   ├── ui/               # 用户界面（主窗口、对话框、组件）
│   └── utils/            # 工具库（日志、配置、国际化、系统）
├── resources/            # 资源文件（图标、字体、翻译）
├── docs/                 # 文档（用户手册、开发指南、更新日志）
├── tests/                # 单元测试
├── packaging/            # 打包脚本（Deb、AppImage、PyInstaller）
├── requirements.txt      # Python 依赖
├── README.md             # 项目说明
└── LICENSE               # MIT 许可证
```

---

## 🛠️ 开发指南

### 添加新规则集
1. 在 `src/core/rules/` 目录下创建 `新规则名.json`，格式参考现有文件。
2. 重启应用，下拉菜单会自动检测到新文件。
3. 若需保留 `custom` 作为特殊规则集，不要删除该文件。

### 运行测试
```bash
python -m unittest discover tests
```

### 国际化支持
- 所有界面文本使用 `_()` 函数包裹（参考 `utils/i18n.py`）。
- 翻译文件放在 `resources/locales/<语言>/LC_MESSAGES/textpurity.po`。
- 使用 `msgfmt` 编译为 `.mo` 文件即可生效。

更多开发信息请参阅 [开发者指南](docs/developer_guide.md)。

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！请确保：
- 代码符合 PEP8 规范。
- 新功能附带单元测试。
- 更新相关文档。

---

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)，可自由使用、修改和分发。

---

## 📮 联系方式

如有问题或建议，请提交 [GitHub Issues](https://github.com/your-username/textpurity/issues) 或邮件至：`your-email@example.com`

---

**TextPurity 净文 – 让 AI 文本更纯净，让效率更出众。** 🌟