# 文件路径提取工具_WIN_MAC_LINUX

**Repository Path**: hackingboos/path

## Basic Information

- **Project Name**: 文件路径提取工具_WIN_MAC_LINUX
- **Description**: 文件路径提取工具是一款轻量级图形界面应用程序，专为需要批量处理文件路径的用户设计。该工具采用简洁直观的图形界面，让用户能够轻松提取指定目录下的文件和文件夹路径。
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![输入图片说明](%E6%88%AA%E5%9B%BE.jpg)

# 文件路径提取工具（pathdic）

基于 C# .NET 6 + Avalonia UI 11 开发的现代化跨平台文件路径提取 / 路径字典制作工具，一套代码可同时编译支持 Windows / Linux / macOS 三大桌面平台。五种提取范围精细控制、目录优先排序，可一键导出为 Web 扫描工具的路径字典（`/` 开头的相对路径格式，支持 `*language:` 语言声明），也可作为项目文件清单 / 目录结构快照使用。配置统一保存于 `config.json`，开箱即用。

---

## 主要功能

### 路径提取（五种范围）
- **仅提取目录**：当前目录下的直接子目录（不递归）
- **仅提取文件**：当前目录下的直接文件（不递归）
- **目录+文件**：当前目录下的直接子目录和直接文件
- **目录+子目录**：递归所有层级的子目录（不含文件）
- **目录+子目录+文件**：递归所有子目录和文件（默认）

### 输出格式
- **相对 / 绝对路径**一键切换，分隔符统一为 `/`
- **目录优先排序**：所有目录项排在前、文件项排在后，各自按名称升序
- **语言声明**：在报告首行添加 `*language: 内容`（自动转大写），可直接作为 Web 扫描工具字典的声明头
- **时间戳报告头**：输出生成时间、源目录、提取选项、项目总数

### 排除列表
- 分号分隔的排除扩展名列表（默认内置常见图片 / 音频 / 视频 / 临时文件类型）
- 「排除」选项卡可视化编辑，保存到 config.json
- 一键恢复默认

### 预览与保存
- 实时预览 / 一键清空
- 提取后自动弹出保存对话框，默认文件名 = 源文件夹名 `.txt`
- 输出编码 UTF-8（无 BOM）

### 界面与体验
- 顶部广告轮播（API 拉取，2 秒切换，点击跳转）+ Gitee 仓库 / 零日防线超链接 + 二维码弹窗
- 全部控件中文右键菜单（剪切 / 复制 / 粘贴 / 删除 / 全选）
- 选项卡内置底图（内嵌资源、60% 透明、居中显示、聚焦不消失）与程序图标（内嵌，不依赖外部文件）
- 跨平台全局样式统一（字体回退链、浅色主题、按钮独立配色）
- 帮助 / 关于窗口（等宽字体排版）

---

## 各平台可执行文件

下载对应平台的发布包，解压后运行即可。确保可执行文件与原生库文件在同一目录。

| 平台 | 运行文件 | 说明 |
|---|---|---|
| Windows x64 | `pathdic.exe` | 双击运行 |
| Linux x64 | `pathdic` | 终端 `./pathdic` |
| macOS Intel / Apple Silicon | `pathdic` | 终端 `./pathdic`，ARM64 需原生发布 |

---

## 运行要求

### Windows
1. 下载安装 [.NET 6 Desktop Runtime x64](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
2. 确保 `pathdic.exe` 与同目录下的 `.dll` 文件完整（SkiaSharp 等原生库）
3. 双击运行

### Linux / macOS
安装 .NET 6 Runtime 后，终端执行：

```bash
chmod +x pathdic
./pathdic
```

---

## 常见问题

### 1. 提示 "You must install .NET to run this application."
系统缺少 .NET 6 Runtime，安装后重新运行即可。

**Linux (Ubuntu/Debian):**

```bash
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 6.0 --runtime dotnet
```

**Windows:** 直接下载 [.NET 6 Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) 安装。

### 2. 中文显示为方框或乱码
系统缺少中文字体：

```bash
# Ubuntu/Debian
sudo apt install fonts-noto-cjk
# Fedora/CentOS/RHEL
sudo dnf install google-noto-sans-cjk-sc-fonts
```

### 3. 提取结果里缺少某些文件
- 检查「排除」选项卡中是否包含该文件的扩展名（排除列表需点击「保存排除列表」后生效）
- 检查提取范围是否为「目录+子目录+文件」（默认递归全量）

### 4. 配置保存在哪里？
所有配置统一保存在可执行文件同目录的 `config.json` 中（首次运行自动生成），删除该文件即可恢复默认配置。