Explore Better

更好地探索

为人类和 AI 打造的 Windows 文件管理器：快速双窗格、每个标签页独立的终端、本地 MCP 服务、事务性文件操作、可撤销的 Explorer 集成，以及可视化磁盘空间分析器。

访问 Explore Better 网站 | 查看 MCP 证明 | 下载最新 Windows 版本 | 阅读用户手册 | 跟踪分发准备情况 | 报告问题

Explore Better 的诞生缘由

Windows Explorer 虽然熟悉，但繁重的文件工作很快就会超出它的能力范围。大型文件夹可能响应迟缓，多文件夹操作需要打开太多窗口，破坏性操作提供的恢复信息有限，而磁盘分析、同步、重复文件查找、索引和自动化等高级任务通常需要借助单独的应用。

Explore Better 旨在提供一个专注的 Windows 工作空间，能够：

• 在超大型文件夹中保持响应迅速；
• 同时显示源和目标窗格；
• 将复制、移动、覆盖、同步和删除操作作为可检查的任务处理；
• 将日常浏览与磁盘分析、搜索、索引、预览和自动化相结合；
• 日常浏览时以当前用户身份运行，无需管理员权限；
• 可按需与 Explorer 集成，同时让集成保持可选且可撤销。

我们的目标是打造一款功能深入的 Explorer 替代品，同时不牺牲速度、易理解的控件，也能在文件操作中断时进行恢复。

在 Windows 上安装

要求

• Windows 10 或 Windows 11，x64
• 普通 Windows 用户帐户
• 仅当 Windows 本身要求访问受保护位置时，才需要管理员批准

推荐安装方式

1. 打开最新版本。
2. 下载 ExploreBetter-<version>-x64-setup.exe。
3. 从同一版本下载 SHA256SUMS.txt。
4. 在 PowerShell 中验证安装程序校验和：

Get-FileHash .\ExploreBetter-*-x64-setup.exe -Algorithm SHA256

5. 将结果与 SHA256SUMS.txt 中的安装程序条目进行比较。
6. 运行安装程序，并选择所需的安装文件夹和快捷方式。

默认情况下，安装程序仅为当前用户安装。日常浏览、本机文件系统助手、Disk Map、索引、预览和文件操作都不要求以管理员身份运行主应用。

Windows SmartScreen 提示

当前公开预览版尚未经过 Authenticode 签名，因为目前还没有可信的生产证书。Windows SmartScreen 会将其识别为来自未知发布者的未识别应用。

请仅从官方 GitHub 发布页面下载，然后在决定是否继续之前验证安装程序：

Get-FileHash .\ExploreBetter-*-x64-setup.exe -Algorithm SHA256

将结果与同一发布版本中的 SHA256SUMS.txt 进行比较。请勿全局禁用 SmartScreen，也不要安装不受信任的根证书。项目网站会在同一处列出当前文件名、校验和以及预期的首次运行警告。

由仓库发布工作流生成的带标签构建版本还会获得 GitHub 构建来源证明。来源证明会将构件与其源工作流和提交关联起来；它能提升可追溯性，但不能替代 Authenticode，也不会消除 Windows 警告。

Explorer 集成

Explorer 替代功能默认不启用。首次启动打包版本时，Explore Better 会询问是否将其设为当前用户打开普通文件系统文件夹和驱动器的默认处理程序。选择 使用 Explore Better 会备份现有 Shell 值的确切内容，安装文件夹、驱动器、文件夹背景以及 在 Explore Better 中打开文件位置 处理程序，并保留 Windows Explorer。

之后，你可以通过 集成 > 设为默认 进行相同更改，添加可选的 Win+E 登录助手，或选择 恢复之前的设置，将备份的处理程序原样还原。通常请求 Windows 打开文件夹的应用可以使用 Explore Better；显式执行 explorer.exe 的应用则将目标硬编码为 Windows Explorer，无法安全重定向。Explore Better 也可以作为独立文件管理器使用，而无需更改任何默认设置。

如果较旧版本的 Explore Better 已接管文件夹/驱动器默认处理程序，当前打包版本会自动将其旧版 PowerShell 命令替换为已安装的 Explore Better.exe，同时保留该默认设置。如果默认处理程序归其他应用所有，Explore Better 只会修复自身现有的上下文菜单命令，不会重新接管默认处理程序。

功能模块

双窗格文件浏览器

• 独立的左、右窗格，支持标签页、标签页历史记录、锁定标签页以及重新打开/循环切换快捷键。
• 详细、紧凑和平铺视图，支持可配置列和图片缩略图。
• 可编辑路径栏、可点击面包屑导航、别名、最近路径和文件夹建议。
• 文本、类型和标签筛选，以及类似 Explorer 的键盘选择和键入即查找。
• 垂直、水平和单窗格布局；Navigator、窗格分隔条、预览、列和命令停靠栏均可调整大小。
• 联动窗格、自动刷新、隐藏/系统项目控制以及可重复使用的文件夹格式。

高性能大文件夹

• 渐进式首次绘制，无需等待整个目录完成加载。
• 虚拟化文件列表，仅将少量可见行保留在 DOM 中。
• 对匹配的窗格共享列表任务、缓存元数据、限制预取范围，并在后台加载。
• 自动前台活动协调器会在导航、搜索、分析、文件操作期间或应用隐藏时暂停并中止推测性工作，之后恢复工作，且不会重复发起已缓存的请求。
• 本地文件夹使用原生 Win32 枚举；对于不受支持的路径和平台，则回退到 Node。
• 支持用于重复搜索的持久化速度索引和后台索引选项。

当前包含 100,000 个条目的验收测试夹具记录的首次可见窗口中位数为 101.5 ms、完整加载中位数为 616.7 ms，渲染行数为 47。

事务性文件操作

• 复制、移动、重命名、批量重命名、传输、同步、归档、回收、移入应用回收站和永久删除。
• 更改文件前预览冲突，并提供重命名、覆盖和跳过策略。
• 在目标卷暂存，并备份被覆盖的文件，以便在提交后恢复。
• 操作队列显示进度、传输速率、预计剩余时间，并支持暂停、继续、取消、重试和撤销元数据。
• 有界的按时间顺序排列的时间线记录排队、各阶段、进度里程碑、取消、重试、撤销、恢复和完成情况；相关操作双向关联。
• 启动时协调中断的操作，以及等待移除源文件的跨卷移动操作。
• 防止删除驱动器根目录或应用状态、源和目标递归错误，以及使用过期的破坏性操作预览。

磁盘映射与大小分析器

• 全窗口层级矩形树图，帮助了解磁盘空间的使用情况。
• 嵌套的文件夹和文件矩形，支持逐层深入、面包屑导航，以及“根目录”“向上”“聚焦”和“打开”操作。
• 逻辑大小和已分配大小模式，并清晰标注准确性信息。
• 按文件类型或稳定的顶层文件夹分支着色。
• 顶层文件夹、文件、扩展名和类型类别汇总。
• 热扫描缓存、取消、操作失效处理和键盘导航。
• 通过 GetCompressedFileSizeW 和卷几何信息获取精确的本地 Windows 分配数据。

搜索、索引与清理

• 有界的递归文件名和文本内容搜索。
• 按类型、大小、时间戳和 Windows 属性筛选。
• 在已保存的后台索引根目录中进行热缓存搜索。
• 平面视图将递归文件夹呈现为一个虚拟窗格。
• 重复项查找器按相同大小分组，并可选择使用 SHA-256 确认。
• 使用 SHA-256、SHA-1 或 MD5 创建和验证校验和清单。
• 可直接在常规文件窗格中计算文件夹大小。

比较与同步

• 比较左右文件夹，并显示仅左侧、仅右侧、较新、不同和类型不匹配等状态。
• 支持比较顶层内容或递归比较。
• 明确的从左到右和从右到左同步计划。
• 可复用的同步配置文件，用于设置文件夹对和策略。
• 可选通过移入可恢复的应用回收站来清理镜像中的多余文件。
• 预览令牌会在规划后文件系统发生变化时拒绝应用操作。

整理与工作区

• 紧凑的“已固定”区域将收藏夹和路径别名一起呈现，但保留各自独立的持久化模型；其后依次是主文件夹树、有意义的已连接设备、快速访问、驱动器，以及最多八个最近位置，并提供明确的“显示全部”控件。
• 命名布局可还原窗格、标签页、筛选器、排序、视图模式和面板大小。
• 文件夹标签页组、文件集合、选择集和窗格快照。
• 文件篮可从多个位置收集路径，以便批量操作。
• 颜色标签和备注会跟随应用管理的重命名、复制和移动操作。
• 文件夹格式、显示预设和筛选器预设。
• 可导出配置备份，以保存工作区和自动化设置。

预览、查看器与快速编辑

• 内置预览支持文件夹、文本、图像、PDF、音频、视频、STL 网格和 STEP/STP CAD 模型。
• 交互式本地 3D 查看，支持环绕、平移、滚轮或按钮缩放、适应窗口、等轴测图／前视图／顶视图、边线、尺寸、网格数量和三角形数量。STEP 曲面网格化由专用的本地 OpenCascade 工作进程执行，绝不上传模型数据。
• 更大的查看器，支持浏览相邻文件和胶片栏。
• 快速编辑小型文本文件，并可撤销保存操作。
• 属性和路径健康状况视图，显示大小、时间戳、哈希值、驱动器信息和有界诊断信息。
• 需要时可交接至 Windows 原生“属性”和“在文件资源管理器中显示”功能。

命令中心与自动化

• 支持模糊匹配的可搜索命令面板，包含固定项、历史记录和快捷键徽标。
• 每条命令都会说明它是在 Explore Better 中执行、请求文件资源管理器、启动外部应用，还是打开 Windows 对话框，并解释预期结果。
• Electron 标题栏在 390 至 1920 px 的宽度范围内始终保持在一行 44 px 高的区域；测得溢出时，会折叠标签，并按 Focus、Operations、Disk Map 的顺序将其移入可通过键盘访问的 More 菜单，优先保留 Search 和 Command。
• 为常用操作创建自定义命令停靠栏配置文件。
• 保存受信任的 PowerShell 或 Command Prompt 工具，并捕获其输出。
• 保存使用受限文件管理 API 的受信任脚本。
• 为内置操作、工具和脚本自定义应用级快捷键。
• Open With 预设和按扩展名匹配的快速启动器。

每个标签页集成终端

• 每个文件标签页对应一个按需创建的 ConPTY 终端，使用 xterm.js 渲染在其窗格下方的可调整大小抽屉中。
• 左右两侧的终端相互独立，会保持运行并保留输出；只要应用仍打开，切回对应标签页时终端也会恢复。
• 自动检测 PowerShell 7，并在不可用时回退到 Windows PowerShell 和 Command Prompt。
• 新终端从标签页所在文件夹启动；当 Shell 空闲时，还可跟随窗格后续的导航位置。
• 支持搜索、清除、重启、配置文件选择、外部启动、拖放路径引用，以及明确的 在窗格中打开终端文件夹 操作。
• 支持深色、浅色和高对比度主题，并可配置字体大小、光标和回滚缓冲区。
• 可通过范围受限的单会话 UAC 代理使用管理员终端；主应用和本地后端始终以非提升权限运行。

AI 桥接与 MCP 自动化

• 内置 ExploreBetterMcp.exe 标准输入/输出服务，可供 Codex、Claude Desktop、Cursor、VS Code、兼容 ChatGPT 的客户端和通用 MCP 主机使用。
• 提供实时结构化上下文，包括活动窗格、稳定的标签页 ID、可见选区、焦点项目、布局和单调递增的上下文版本号。
• 提供类型化工具，支持受限列表、索引搜索、路径检查、文本读取、校验和、磁盘分析、重复项检测、文件夹比较、集合、标签和操作恢复。
• 由渲染器管理的语义 UI 注册表通过 list_ui_actions 和 invoke_ui_action 提供范围受限、无需选择器的导航和表单操作；wait_for_ui 和 MCP 资源订阅可提供可取消的事件驱动观察，无需轮询。
• 增量式 v1 契约包含 32 个工具、6 个资源、4 个提示词和 43 个受控视图，包括 Devices 和 Health。现有配置文件保留已保存的权限；只有新建的配置文件会采用新的安全默认值。
• 持久化后台任务，支持进度显示、取消、分页结果，并限制超大文件夹的输出范围。
• 默认使用只读配置文件，可按客户端分别撤销权限，并明确指定授权文件夹和单项工具权限。
• 每次写入都使用规划器和一次性 120 秒应用令牌；令牌绑定到客户端会话、路径、计划摘要、冲突策略和文件系统签名。
• 仅支持本地标准输入/输出和同一用户的随机命名管道：不提供远程监听、任意 Shell 执行、终端控制、注册表更改或由 AI 驱动的权限提升。
• 一键设置 Codex、Claude Desktop、Cursor 和 VS Code；可逐字节备份配置，并保留其他 MCP 服务。
• 提供独立的 Windows MCPB 版本，使用官方 Registry 标识 io.github.terrorproforma/explore-better。

MCP 在这里真的有用吗？

有，对于文件操作中那些终端权限过大或过于依赖文本的部分尤其有用。公开的 MCP 证据页面和机器可读的基准测试使用真实的 Electron 主机和捆绑的 Go stdio 辅助进程，针对同一确定性测试样本运行，并与等效的 PowerShell 脚本进行比较。

当前证据表明：

• 3 个共用的搜索、重复项查找和磁盘分析工作流均通过两种接口返回正确的已知结果；
• 7 项 MCP 专属控制全部通过，包括架构发现、有界分页、实时窗格导航、语义 UI 操作与等待关联、拒绝未授权根目录、降低只读能力，以及标注分配大小数据；
• 在所测测试样本中，与等效的新启动 PowerShell 进程相比，MCP 记录的文件名搜索中位延迟低 148.3 倍、磁盘分析低 4.7 倍、重复项查找低 5.3 倍；
• 对比结果明确说明，PowerShell 计时包含新进程启动时间，并未声称 MCP 一定比持久运行的热 Shell 更快。

MCP 是终端的补充。任意命令和系统管理请使用终端。当 AI 需要使用 Explore Better 的实时窗格、选择内容、索引、Analyzer、客户端专属文件夹权限，或由事务日志支持的预览／应用操作时，请使用 MCP。

在 Windows 上复现这项专项验证：

npm run verify:mcp-value

设备、运行状况和 Windows 集成

• 支持能力感知的“设备与 Windows 位置”仪表板，可分别显示已连接设备、驱动器、映射的网络位置、库和 Windows 虚拟位置。初始加载不会等待较慢的 Network 提供程序。
• 设备操作会明确说明是在 Explore Better 中浏览、在活动窗格中打开，还是请求 Windows 文件资源管理器；不支持的操作不会显示。
• “运行状况与诊断”会报告渲染器、后端、本机辅助程序、MCP 桥接程序、Shell 提供程序、缓存、索引、队列、更新程序、软件包和自适应调度程序的状态。默认情况下，流式支持包会对路径进行脱敏，绝不包含文件或终端内容及机密，大小上限为 10 MB。
• 资源管理器替代功能和 Windows 集成均为可选，并可由每位用户撤销。
• 可将 ZIP 作为只读虚拟文件夹浏览，无需先解压；还可通过右键单击 Extract Here，在 ZIP 旁创建以压缩包命名的安全同级文件夹。
• 与资源管理器和桌面互通的 Windows 文件剪贴板及拖放功能。
• 回收站浏览和本机还原支持。
• 首次启动时选择启用，并支持当前用户范围内的文件夹、驱动器、文件夹背景和文件位置处理程序。
• 可选快捷方式、启动行为和 Win+E 辅助程序。
• 可在一个中心完成精确的集成备份、状态报告、启动测试、回滚和清理。

Windows 本机文件系统提供程序

• 捆绑的 Go x64 辅助程序，使用带版本号的 NDJSON 协议。
• 请求 ID、进度消息、取消操作和结构化的 Windows 错误。
• 快速目录枚举、目录树扫描、卷信息和分配大小查询。
• 受监督的辅助程序生命周期，确保辅助程序故障不会导致桌面应用崩溃。
• 对 UNC 路径、不支持的文件系统、非 Windows 开发环境或辅助程序故障使用 Node 回退方案。

安全与恢复

• 仅限回环连接的后端，并为每次启动生成随机 API 权限令牌。
• 在路由分发前验证 Host、Origin、fetch 元数据、方法和 JSON 修改请求。
• 严格限制 Electron 导航和权限。
• 一次性破坏性应用令牌与规范化路径、策略和文件系统签名绑定。
• 持久化操作日志、备份记录和确定性的恢复选项。
• 默认以普通用户身份运行，仅在处理剩余受保护任务时使用范围有限的提权软件包。

首次运行工作流

1. 从“开始”菜单或桌面快捷方式启动 Explore Better。
2. 选择是否让普通的 Windows 文件夹和驱动器打开操作使用 Explore Better。之后可在 集成 中更改此设置。
3. 在一个窗格中打开源文件夹，在另一个窗格中打开目标文件夹。
4. 双击文件夹进行导航，或使用 Enter、面包屑、历史记录和路径栏。
5. 使用 F5 将当前选中项复制到对侧窗格，或使用 F6 将其移动到对侧窗格。
6. 打开 操作 查看进度、重试剩余任务、恢复中断的操作，或撤销受支持的操作。
7. 打开 磁盘映射 扫描当前文件夹，并深入查看其中最大的分支。
8. 选择任一窗格中的终端图标，或按 Ctrl+Backquote，即可在当前文件夹中打开该标签页的 Shell。
9. 打开 命令 或按 Ctrl+P，即可查找所有操作，而无需在工具栏中显示所有控件。

用户手册涵盖所有主要控件、键盘工作流、每标签页终端、调整大小、文件操作、磁盘映射、脚本编写、恢复和资源管理器集成。

项目架构

区域	位置	职责
Electron 桌面外壳	electron-main.mjs	原生窗口、后端监督、单实例路由、更新器桥接和外部 URL 策略
渲染器桥接	electron-preload.cjs	向本地 UI 暴露有限的桌面功能
终端服务	terminal-service.mjs	每标签页的 ConPTY 管理、Shell 发现、文件夹同步、IPC 隔离和提权会话代理
MCP 自动化门面	mcp/automation-service.mjs	配置文件、根目录授权、受限工具、作业、规划器、审计记录和共享文件系统策略
AI Bridge 管道主机	mcp-bridge-service.mjs	同一用户身份验证的命名管道传输、生命周期、取消和渲染器上下文转发
MCP stdio 辅助服务	native/mcpserver/	官方 Go MCP SDK 适配器，将协议流量保留在 stdout，并将类型化调用转发给 Explore Better
本地后端	server.mjs	文件系统提供程序、操作、恢复、索引、搜索、分析器、Shell 集成和 API 安全
用户界面	public/	双窗格工作区、对话框、磁盘映射、命令系统和虚拟化列表
公共落地页	site/	通过 GitHub Pages 部署的静态产品网站
发布溯源信息	.github/workflows/release.yml	草稿版发布构建、SHA-256 清单和 GitHub 工件证明
原生文件系统辅助程序	native/fshelper/	Go Win32 枚举、分配数据、树扫描、进度和取消
验证工具集	scripts/	安全、操作、性能、打包、更新器、Shell、布局和验收检查

桌面应用会在私有的随机回环端口上启动后端，并在加载渲染器前验证其身份。开发模式也可直接在浏览器中运行界面。

从源代码构建

前置条件

• Node.js 20 或更高版本
• npm
• MCP 辅助服务需要 Go 1.25.12；原生 Windows 辅助程序需要 Go 1.23 或更高版本
• 桌面安装包和 Win32 验证需要 Windows 10 或 Windows 11

克隆并运行桌面应用

git clone https://github.com/terrorproforma/explore-better.git
cd explore-better
npm ci
npm run build:native-helper
npm run build:mcp-server
npm run desktop

运行浏览器开发版本

npm start

然后打开 http://127.0.0.1:4627。

构建 Windows 安装包

npm run build:icon
npm run package:dir
npm run package:win
npm run package:installer

生成的安装包会写入 dist/。

桌面端更新

已安装的桌面应用会在启动后不久，以及应用保持打开期间每六小时检查一次公开的 GitHub 发布渠道。发现有较新版本时，Explore Better 会在应用内显示一张可关闭的卡片，其中包含版本号、发行说明链接和由用户控制的下载操作。下载会在后台进行；验证通过后，卡片会变为 Restart to update。下载的更新也会在下次正常退出应用时安装。

随时可从命令面板（Ctrl+P）运行 Check for updates。最小化 Explore Better 时，Windows 也可能会针对检测到的新版本显示系统通知。

在添加此更新界面之前发布的版本，需要最后一次从 GitHub Releases 手动升级安装程序。完成此次引导升级后发布的版本，可在应用内通知用户并进行更新。

验证

按顺序运行发布关键检查：

npm run verify:all

运行完整验证套件：

npm run verify:all:full

一些实用的专项检查包括：

npm run verify:security-boundary
npm run verify:transactional-operations
npm run verify:native-helper
npm run verify:mcp-contract
npm run verify:mcp-security
npm run verify:mcp-context
npm run verify:mcp-operations
npm run verify:mcp-semantic-ui
npm run verify:mcp-operation-wait
npm run verify:packaged-mcp
npm run verify:mcp-value
npm run verify:health-devices-support
npm run verify:navigator-product-ui
npm run verify:seo-discovery
npm run verify:layout
npm run verify:speed-health
npm run verify:release-readiness

整合验证器会将证据加上时间戳并保存到 artifacts/acceptance/，隔离性能测试运行、强制执行超时，并清理由测试创建的子进程。

公开发布状态

当前公开版本提供面向单用户的 Windows x64 安装程序、原生辅助程序、校验和清单、blockmap，以及由 GitHub 托管的更新元数据。公开版 Windows CI 会验证依赖项审计、原生辅助程序编译、安全边界、事务回滚、辅助程序协议行为、布局和文件夹双击行为。

仍有两项外部认证工作尚未完成：

• 受信任的生产环境 Authenticode 签名；
• 实体 MTP/PTP 手机或相机认证。

每个版本都会披露这些限制。正常浏览无需以管理员身份运行。

许可证

Explore Better 是根据 MIT License 分发的开源软件。独立的 MCPB 包含相同的许可证，并可在遵守其声明要求的前提下使用、修改和重新分发。