Finder 文件管理

ALemonX 的跨平台本机文件管理插件。它将宝塔的操作效率、终端文件管理的直接性，以及 macOS Finder 的浏览习惯放进一个轻量的桌面界面。

功能

• 左侧常用位置与磁盘入口，支持主目录、桌面、文稿、下载等目录快速跳转。
• Finder 式路径栏、前进/后退、上级目录、列表/图标双视图与实时过滤。
• 新建文件夹、新建空文件、重命名、复制、移动、ZIP 压缩/解压，以及跨目录浏览。
• 可从系统文件管理器将一个或多个文件直接拖入列表上传，也可使用「上传文件」按钮；单次总大小最多 2 GB，同名文件不会覆盖。
• 内置文本编辑器：安全打开并保存不大于 1 MB 的文本文件；二进制与大文件不会被错误当作文本写入。
• 深度搜索当前目录，自动跳过 .git 和 node_modules，最多显示 200 个结果；普通目录最多展示 5,000 项，避免界面被超大目录拖慢。
• 删除采用“移入废纸篓”：macOS 使用系统 ~/.Trash，其他平台使用用户目录下的 .alemonx-finder-trash，不会直接永久删除；插件会保留原路径，可在侧栏「废纸篓」一键恢复。

安装

1. 下载与你系统匹配的发布包并解压。
2. 将完整 alemonx-finder 文件夹放入当前工作区的 <workspace>/plugins/alemonx-finder/。工作区由启动参数 --workspace 或 ALX_WORKSPACE 决定；通过应用内插件页安装时会自动放到此处。
3. 在 ALemonX 左侧插件列表中打开 Finder。

使用

• 单击选中项目；双击文件夹进入，双击文本文件在内置编辑器中打开。
• 底部操作栏提供打开、重命名、移动和移入废纸篓。
• 搜索框默认过滤当前目录；按回车会进行递归深度搜索。
• 路径统一以绝对路径执行，避免对当前工作目录产生歧义。

废纸篓恢复所需的记录保存在 <workspace>/store/alemonx-finder/，可随 Docker 工作区挂载持久化；实际被移入的文件仍在操作系统的用户废纸篓中，以保留系统原有 的恢复语义。首次使用新目录时会复制旧版记录，原记录不会被删除。

安全边界

文件操作由本机插件进程执行，不会上传文件内容。新建与保存仅能写入绝对路径；文本保存采用同目录临时文件再替换，降低中断导致半写入的风险，并会拒绝覆盖编辑期间被外部修改的文件；重命名、复制和移动不覆盖已有项目；移动和废纸篓跨磁盘时会在完整复制后才移除源项目。删除会移入废纸篓而非直接永久删除。系统受保护目录是否可写仍由当前操作系统账户权限决定。

压缩与解压不调用 shell，仅支持 ZIP；解压会拒绝越界路径、符号链接、超过 10,000 个项目或超过 1 GB 的内容，避免恶意压缩包写出目标目录。

开发

• make check：运行 Go 测试、静态检查和插件清单验证。
• make web：构建 React 文件管理界面到 web/。
• make build：构建各平台运行二进制。
• make dist：打包发布文件。