# 灵犀

**Repository Path**: deepin20/lingrenamer

## Basic Information

- **Project Name**: 灵犀
- **Description**: 灵犀 LingRenamer

批量重命名与智能整理工具，专为统信UOS优化。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 🦊 灵犀 (LingRenamer)

> 专为统信 UOS 打造的智能批量重命名与文件整理工具。

---

## 📖 简介

**灵犀** 是一款功能强大、界面优雅的批量重命名软件，旨在帮助您快速、灵活地整理海量文件。它提供了 **14 种命名规则**，支持拖拽排序、实时预览、图像/音频元数据提取、正则替换等高级功能，并深度集成统信 UOS 桌面环境（右键菜单、深色主题等），让文件管理变得轻松高效。

**“心有灵犀，万名井然”** —— 无论您是摄影师、音视频创作者、文档管理员，还是普通用户，灵犀都能精准理解您的命名需求，一键完成批量重命名。

---

## ✨ 核心功能

| 分类 | 规则 | 说明 |
|------|------|------|
| **基础命名** | 修改名称/添加序号 | 自定义基础名称，添加带前导零的序号 |
| | 查找替换 | 支持普通文本和正则表达式，可区分大小写、仅替换首个 |
| | 添加分隔符 | 在指定位置插入分隔符（`-`、`.`、`_`、空格、顿号） |
| | 添加字符 | 在开头、末尾或指定位置插入任意文本 |
| **字符操作** | 删除字符 | 预设删除类型（字母/数字/特殊符号/标点/序号/单位/箭头/绘表符号），支持自定义正则和区间限定 |
| | 移动字符 | 移动任意位置的字符片段到目标位置 |
| | 大小写转换 | 全大写/全小写/单词首字母大写/仅首字符大写 |
| | 全角半角转换 | 全角↔半角，可分别针对字母数字或所有字符 |
| **元数据提取** | 添加图像参数 | 从 EXIF 提取时间、分辨率、相机型号，可多选、拖拽排序 |
| | 添加音频参数 | 从 ID3 标签提取艺术家、歌名、专辑、时间、类型 |
| | 添加日期&时间 | 从文件创建/修改时间或当前时间提取年/月/日/小时/分钟，自由组合 |
| **上下文关联** | 添加文件夹名 | 将父文件夹名添加到名称前/后，可自定义分隔符 |
| | 基于 CSV 重命名 | 读取 CSV 映射表，批量替换文件名 |
| **语言转换** | 繁简体转换 | 繁体→简体 / 简体→繁体（香港/台湾） |

---

> **实时预览**：添加规则后，底部表格立刻显示新旧名称对比，冲突一目了然。  
> **拖拽排序**：规则列表随意拖动，执行顺序实时调整。  
> **一键执行**：自动处理重名冲突（添加 `(1)`、`(2)` 等），操作安全可靠。  
> **右键集成**：在深度文件管理器中直接右键点击文件/文件夹，选择“灵犀重命名”即可快速启动。

---

## 🖥️ 系统要求

- 操作系统：**统信 UOS 20+**（亦支持其他 Linux 发行版）
- Python 3.8 或更高版本
- 桌面环境：DDE（深度桌面环境）推荐，其他桌面环境也可运行（部分集成功能受限）

---

## 📦 安装

### 方法一：使用 deb 包（推荐）

从 [发布页面](#) 下载 `lingrenamer_2.0.0-1_all.deb`，然后执行：

```bash
sudo dpkg -i lingrenamer_2.0.0-1_all.deb
```

如果提示依赖缺失，运行：

```bash
sudo apt install -f
```

### 方法二：从源码运行

1. 克隆或下载本项目源码。
2. 安装 Python 依赖：

```bash
pip3 install PyQt5 Pillow mutagen opencc-python-reimplemented
```

> **注意**：在统信 UOS 上，若使用系统 Python 并遇到 `externally-managed-environment` 错误，请使用虚拟环境或添加 `--break-system-packages` 参数（仅限测试环境）。

3. 进入项目根目录，执行：

```bash
python3 src/lingrenamer/app.py
```

### 方法三：使用一键脚本（开发模式）

项目提供 `scripts/` 目录下的脚本，可快速构建 deb 包或安装桌面快捷方式。

---

## 🚀 快速上手

### 1. 启动软件
- 从启动器点击“灵犀 LingRenamer”图标，或
- 在终端执行 `lingrenamer`（若已安装 deb 包）

### 2. 添加文件
点击 **“添加文件”** 或 **“添加文件夹”**，或直接从文件管理器拖拽文件到窗口。

### 3. 添加规则
点击 **“添加规则”**，从列表中选择需要的规则，弹出配置窗口后设置参数，点击确定即可。

### 4. 调整规则顺序
在右侧规则列表中，上下拖拽规则卡片调整执行顺序。

### 5. 预览效果
底部表格实时显示每个文件的原名称和新名称，冲突项会高亮提醒。

### 6. 执行重命名
确认预览无误后，点击 **“执行重命名”**，二次确认后即可完成批量重命名。

---

## 🛠️ 高级功能

### 右键菜单集成
安装 deb 包后，在深度文件管理器中选中任意文件或文件夹，右键菜单会出现 **“灵犀重命名”** 选项，点击后自动加载所选项目。

### 命令行参数
您可以直接从终端传递文件或文件夹路径：

```bash
lingrenamer /path/to/file1 /path/to/folder
```

软件启动后会自动加载这些路径。

### 自定义规则组合
您可以将常用的规则链保存为“剧本”（后续版本支持），一键复用。

---

## 📂 项目结构

```
LingRenamer/
├── src/lingrenamer/       # 主要 Python 源码
│   ├── app.py             # 应用入口
│   ├── ui/                # 界面相关（主窗口、控件、对话框）
│   ├── core/              # 核心逻辑（引擎、文件管理、历史记录）
│   ├── rules/             # 所有命名规则实现
│   ├── ai/                # AI 相关（预留，暂未启用）
│   ├── scenarios/         # 剧本系统（预留）
│   ├── utils/             # 通用工具（配置、日志、系统集成）
│   └── resources/         # 图标、字体等资源
├── tests/                 # 单元测试
├── scripts/               # 辅助脚本（构建、安装、打包）
├── debian/                # Debian 打包控制文件
└── docs/                  # 文档
```

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！如果您希望添加新的命名规则或改进功能，请参考 `src/lingrenamer/rules/base.py` 了解规则接口。

---

## 📄 许可证

本项目采用 **GNU General Public License v3.0** 授权。详情请参阅 [LICENSE](LICENSE) 文件。

---

## 🙏 致谢

- [PyQt5](https://www.riverbankcomputing.com/software/pyqt/) – 跨平台 GUI 框架
- [Pillow](https://python-pillow.org/) – 图像处理与 EXIF 读取
- [mutagen](https://mutagen.readthedocs.io/) – 音频标签解析
- [opencc-python-reimplemented](https://github.com/tsroten/opencc-python-reimplemented) – 繁简体转换
- 统信 UOS 团队 – 提供优秀的国产操作系统

---

**祝您使用愉快！** 🌟  
如有任何问题，请提交 [Issue](#) 或联系维护者。