# eagleparser

**Repository Path**: toolkits_1/eagleparser

## Basic Information

- **Project Name**: eagleparser
- **Description**: 对eagle的文件系统进行分析，能够方便的改名字与查询
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Eagle Parser

当前版本：`0.2.0`

解析 Eagle 4.x 素材库，并提供一个用于在 Windows 视频目录与 Eagle 库之间同步内容的桌面工具。

## 功能

- 桌面窗口基于 `Flask + pywebview`。
- 默认视频目录为当前用户的 `Videos`。
- Eagle 库目录默认为 E:\workshop\我的坚果云\eagle。
- 导入成功或跳过重复项后，默认删除对应源文件并清理空子目录。
- 支持把各 Eagle 库 export 子目录中的素材导出到视频同名目录，并移入 Eagle 回收站。
- 固定使用 8 组一一映射：

| 视频目录 | Eagle 库 |
|---|---|
| tianbin | tianbin.library |
| 专业 | 专业.library |
| 健康 | 健康.library |
| 男女之间 | 男女之间.library |
| 投资 | 投资.library |
| 创业 | 创业.library |
| 娱乐 | 娱乐.library |
| 社会 | 社会.library |

`象棋`、`手机精品.library`、`snowboard.library` 不参与扫描和导入。

## 安装

不使用虚拟环境：

```powershell
python -m pip install -r requirements.txt
```

## 运行

桌面模式：

```powershell
python app.py
```

浏览器模式：

```powershell
python app.py --web
```

只启动 Web 服务：

```powershell
python app.py --web --no-browser
```

## 使用流程

1. 确认目录配置并保存。
2. 点击“初始化目录”。
3. 点击“导出并清理”，将 Eagle export 子目录内容导出到视频目录并移入回收站。
4. 确认后点击“开始导入”，应用会自动扫描视频目录，成功或跳过的源文件都会被清理。

导入通过 Eagle 本地 API 完成，不会直接修改 `.library` 内部文件。应用会切换到目标库、写入顶层 `export` 文件夹，最后恢复原库。

## 数据位置

配置和导入记录保存在：

```text
%LOCALAPPDATA%\EagleParser\eagleparser.db
```

## 主机配置

视频目录和 Eagle 目录按主机名保存在 SQLite 的 `host_configs` 表中。程序启动时会读取当前计算机对应的记录，因此同一份数据库切换到不同计算机时，会自动使用该计算机已保存的路径。

新计算机首次运行时，如果还没有对应记录，会使用 `config.py` 中的默认值创建初始配置；保存目录设置后会写入该主机专属记录。

## 安装程序

当前暂未提供独立安装程序，项目仍以 Python 源码方式运行。依赖安装和启动命令见上文。

## 项目结构

```text
app.py
config.py
eagleparser/
├── db.py
├── eagle_api.py
├── workflow.py
├── webapp.py
├── parser.py
└── web/
tests/
```

## 测试

```powershell
python -m unittest discover tests -v
```