Linux 软件免费装
Banner图

MediaPilot AI – Media Library Folders, Cleanup & AI Metadata

开发者 brainstudioz
更新时间 2026年9月15日 11:05
PHP版本: 8.1 及以上
WordPress版本: 7.1
版权: GPL-2.0-or-later
版权网址: 版权信息

标签

media library media folders image optimization unused media duplicate images

下载

详情介绍:

Stop scrolling through thousands of WordPress uploads. MediaPilot AI adds drag-and-drop folders to the native Media Library, then helps you find unused files, remove duplicates safely, replace attachments, optimize images and understand where your storage goes. Organize, clean and optimize in one plugin Already using FileBird, Real Media Library, Wicked Folders or HappyFiles? Import your existing folders and assignments without changing the other plugin's data. Folders are virtual by default, so organizing an attachment does not move the file on disk or change its URL. An opt-in Real Filesystem Mode moves files into matching directories instead. All core media management runs on your own server — no account, no quota, no telemetry. The three optional integrations (AI, Google Drive, CDN) stay off until you configure them. Media folders and smart views Create unlimited folders and subfolders and move files by drag and drop, singly or in bulk. New uploads land in the folder you have open. Unused media cleanup, and how it protects you MediaPilot indexes where each attachment is used: post content, featured images, shortcodes (including [gallery], WPBakery and Divi), every post meta value, widgets, term and user meta, site options, the Site Icon and the Custom Logo. Because it reads all post meta rather than a fixed list of keys, references stored by Elementor, Beaver Builder, Bricks, ACF and WooCommerce galleries are picked up too. Indexing starts on activation and runs in background batches. Cleanup stays unavailable until the index reports ready, so no decision is made from a partial scan. The workflow, in order:
  1. The index proposes candidates that nothing appears to reference.
  2. Each candidate is re-verified by a slower live scan immediately before removal. This is the load-bearing step: within the database sources MediaPilot supports, a stale or incomplete index can only cause a file to be skipped, never wrongly removed. That is a guarantee about the index, not about your whole site — a reference the scan cannot see at all (see below) is invisible to both stages.
  3. Survivors move to a restorable Trash, and the files stay on disk.
  4. Permanent deletion is a separate, explicit action — and it is irreversible.
No reference scanner can be exhaustive. A URL hard-coded in a theme template, built at runtime by custom PHP, or held only in an external system cannot be detected by any tool that reads the database. Review what is proposed, keep a current backup, and treat cleanup as assisted judgement rather than an authority. The duplicate image finder uses the same restorable workflow, with two cancellable background scans: exact, by MD5 hash, and visually similar, comparing a 64-bit perceptual signature within an adjustable distance (this needs the GD extension). Configure the scan scope, batch size and image filters before starting. Images already in use are preferred as the primary copy, and you can choose another. Supported references are reassigned to the selected primary before duplicates move to Trash; files with unresolved references are retained. Replace a file, keep its URL Replace an image, PDF, video or any other attachment and the attachment ID always stays the same. Keep the same filename and the public URL is unchanged too — nothing anywhere needs updating, which is the safest way. Change the filename and the URL necessarily changes with it. MediaPilot then rewrites the references it can reach: post content and post meta in your database. It cannot rewrite a URL that lives outside the database — hard-coded in a theme or plugin file, built at runtime by code, cached by a CDN, or held in an external system — so on a site with hard-coded media URLs, keep the filename. Thumbnails are regenerated and attachment metadata preserved either way. Identical files are caught by SHA-256 and rejected rather than written twice. The previous file is archived under uploads/mediapilot-versions/ so you can roll back, and old versions can be pruned to a keep limit. Image optimization Local optimization on your own server, with no monthly allowance. WordPress media analytics Total storage, and storage by folder and file type. Upload activity over time. Most-used and never-used attachments. Insert and download counts, recorded in your own database from the admin only — no front-end tracker, no visitor tracking. CSV export of the data. For metadata and accessibility work: a Smart View listing every image with no alt text, bulk editing of alt text, title, caption and description across many attachments, and media tags backed by the same local index that powers the search. AI image metadata, only when you configure it Every feature above works without AI. The assistant stays dormant — no outbound request of any kind — until an administrator switches it on, records consent, and saves their own OpenAI or Google Gemini API key. There is no MediaPilot account and no credit system. It drafts alt text, a title, a caption, a description and tags for one image at a time. You choose the fields, and the plugin shows you what will leave your server first: provider, model, whether the full image or a smaller copy is sent, and any context you opted in to. Nothing is saved automatically. Suggestions arrive in editable fields; you accept, edit, regenerate or discard each one, and only what you approve is written. Existing metadata is never replaced without confirmation, and alt text that looks too long, too vague, keyword-stuffed or identical to the caption is flagged. Requests are rate-limited; the provider bills you directly. A generated description is a draft, not an accessibility guarantee. A model describes what it sees; only you know what the image does on the page. Import, migrate and extend Import and export as CSV, build folder galleries and document libraries with blocks, shortcodes and page-builder modules, and drive it all from WP-CLI or the REST API. The FAQ covers this in detail. Privacy Nothing is sent to BrainStudioz: no account, no licence check, no usage reporting, no telemetry. The AI assistant contacts OpenAI or Google Gemini, Drive sync contacts Google, and CDN rewriting points visitors at your CDN — each only after you configure it. External services below states what each receives and when. Uninstalling removes the plugin's tables, options, post meta, scheduled events and capabilities, on every site of a multisite network. Free and Pro MediaPilot AI Pro is a separate paid add-on requiring this plugin; everything above works without Pro. Pro adds cloud storage beyond Google Drive, offloading, backup and migration, cloud optimization, storage cost analytics, a brandable client portal, and approval and audit workflows. Full comparison in the FAQ; details at portal.brainstudioz.com.

安装:

  1. In your WordPress dashboard, go to Plugins > Add New.
  2. Search for MediaPilot AI, then click Install Now.
  3. Activate the plugin.
  4. Open Media > Library to create folders and organize existing uploads.
  5. Open Media > MediaPilot AI for cleanup, optimization, analytics and settings.
Nothing else is required. On an existing site MediaPilot starts indexing your content in the background as soon as it is activated; progress is shown under Media > MediaPilot AI > Unused media. Cleanup tools stay unavailable until that first index finishes, so they are never acting on a partial picture. Optional: the AI assistant needs your own OpenAI or Google Gemini API key, and Google Drive needs your own Google OAuth client. Neither is required, and neither contacts anything until you configure it.

屏幕截图:

  • Find exact duplicates and visually similar images with a cancellable background scan.
  • Review unused files and images with missing alt text through Smart Views.
  • Understand storage, file types, upload trends and usage from the media analytics dashboard.
  • Configure local WebP and AVIF conversion, your own CDN base URL, and optional content-image lazy loading.
  • Replace an attachment while retaining its URL, then review or restore earlier versions.
  • Import, export, or migrate folder structures and media assignments.

升级注意事项:

2.9.1 Recommended. Duplicate cleanup now keeps the copy your site is actually using instead of the oldest one, moves every reference onto it before anything is trashed, and lets you configure and pace a scan before it runs. Also fixes several admin display faults. No database changes. 2.9.0 Recommended. Fixes a storage scan that could restart in a loop or skip files while the library changed, and speeds up the Analytics dashboard. Adds a tool under Settings → Advanced that reclaims replaced files stranded on disk — it reports before deleting and asks you to confirm. 2.8.1 Contains a one-way database migration. It permanently drops five unused columns from the version-history table. They were never populated, so no history or backup is lost, but downgrading cannot undo it — back up your database first. Also widens Analytics access to any user with manage_options. 2.3.0 Adds a free AI Metadata Assistant that uses your own OpenAI or Gemini key. It is off until you configure it, every suggestion is reviewed before saving, and no data reaches BrainStudioz. Also adds a front-end Document Library block, folder locking and starred folders. 2.1.1 Security release. Folder permissions are now enforced on every listing, search and download route, and on the core media REST API. "Viewer" and "None" rules genuinely restrict access, and rename/delete need write/delete rather than read. 2.1.0 Recommended. The usage index now builds itself in the background, and Unused Media no longer reports every file on the site as unused when the index is missing or incomplete. Your index is rebuilt once automatically on upgrade. 2.0.1 Update for clearer documentation, improved plugin-directory presentation, and a more accurate explanation of MediaPilot AI Free and Pro capabilities. This release contains no functional code changes.

常见问题:

Can MediaPilot detect every media reference?

No, and no plugin can. MediaPilot reads the database: post content, featured images, shortcodes, every post meta value, widgets, term and user meta, site options, the Site Icon and the Custom Logo. That covers references written by the block editor, the Classic Editor, Elementor, Beaver Builder, Bricks, Divi, WPBakery, ACF and WooCommerce, because it scans all meta rather than a list of known keys. What it cannot see is anything that never reaches the database: a URL hard-coded in a theme template or a child theme, an image assembled at runtime by custom PHP or JavaScript, or a file referenced only by an external system. Treat the results as a strong shortlist, not a verdict.

Is unused-media cleanup safe?

It is designed to fail safely rather than to be infallible, and the distinction matters. Cleanup is unavailable until the reference index has finished building, so it never acts on a partial scan. Every candidate is then re-verified by a slower live database scan immediately before removal, which means a stale or incomplete index can only cause a file to be skipped, never wrongly removed. And nothing is deleted: candidates are moved to a restorable Trash. That still leaves the limitation above. Review what is proposed and keep a current backup before you empty the Trash.

What is the difference between Trash and permanent deletion?

Trash is reversible. The attachment's post status changes, it disappears from the media library grid, and the files stay on disk. You can restore it at any time from the Trash panel, and it returns untouched. Permanent deletion removes the database row and every file from disk. It is irreversible and there is no undo. It is always a separate, explicit action — MediaPilot never goes straight there. Items MediaPilot trashed are purged automatically after a retention window you configure (30 days by default). Attachments you trashed yourself through the media library are left alone.

Does the plugin send media or metadata to AI providers?

Only if you set that up, and only one image at a time when you ask for it. With no API key saved, the assistant makes no outbound request of any kind. An administrator has to enter their own OpenAI or Google Gemini key, enable the assistant, and accept the consent notice before anything can be sent. Once that is done, a request happens only when a user with permission to edit that file presses Generate — never on upload, never in the background, never on a schedule. What goes: the image (a smaller generated copy by default), the instruction text built from your settings, and, only if you switch those options on, the file's existing metadata and the title of the post it is attached to. Nothing is saved until you approve it. See External services above for the full disclosure and each provider's terms and privacy policy.

Does it work with WooCommerce and page builders?

For reference detection, yes for the ones named above: WooCommerce product galleries and featured images, Elementor, Beaver Builder, Bricks, Divi and WPBakery are all read by the index, and MediaPilot ships gallery modules for Elementor, Divi, Beaver Builder, Bricks and WPBakery. That is a statement about the storage patterns these tools use, not a compatibility guarantee for every plugin and theme on your site. A builder that stores media in a way none of these patterns match will not be seen — which is the same limitation described in the first question, and the reason the pre-deletion re-verification exists.

What is included in Free versus Pro?

The core features described above are included in Free. Pro is a separate paid add-on that runs alongside Free; the additional Pro capabilities are listed below. | Capability | Free | Pro | | --- | --- | --- | | Media folders: nesting, drag and drop, templates, permissions, ZIP, CSV, migration | Yes | Yes | | Usage indexing, unused media cleaner, duplicate finder, restorable Trash | Yes | Yes | | Media replacement with version archive and rollback | Yes | Yes | | Local WebP and AVIF conversion, bulk conversion, CDN rewriting, lazy loading | Yes | Yes | | Media analytics, CSV export, bulk metadata editing | Yes | Yes | | Google Drive: connect, copy, backup, bulk sync, restore | Yes | Yes | | AI metadata, one image at a time, your own key, reviewed before saving | Yes | Yes | | S3 and S3-compatible, Dropbox, OneDrive, Google Cloud Storage, Azure Blob, Bunny | — | Yes | | Offloading media off local disk and rewriting delivery URLs to cloud storage | — | Yes | | Multiple cloud connections, cross-provider migration and redundancy | — | Yes | | Import new cloud objects into WordPress from S3-compatible storage | — | Yes | | Backup policies, scheduled backups, backup verification | — | Yes | | Cloud optimization with a metered allowance, including PDF and video | — | Yes | | Storage analytics over time, usage against allowance, provider cost estimates | — | Yes | | Client portal with expiring, password-protected, download-limited share links | — | Yes | | Approval workflow, audit logging, WooCommerce product media audit | — | Yes | Pro cloud operations require configured provider accounts. Cloud optimization depends on the external optimization service and is metered against the license allowance; storage provider charges are separate. Pro does not add a separate AI metadata generator: the review-first assistant is included in Free. Find setup guidance, version information and changelog links under Help. Administrators can open What's in Pro for the dedicated feature comparison. Existing About links open Help.

Does MediaPilot AI replace the default WordPress Media Library?

No. It adds folders, filters and tools to the library you already use, rather than replacing it with a separate screen. Turn the plugin off and your media, URLs and permalinks are exactly as they were.

Does MediaPilot AI create physical folders?

Not by default. Folders are virtual: an attachment's folder is a taxonomy term, so organizing files never moves them on disk and never changes a URL. If you want the folders to be real directories, Real Filesystem Mode is an opt-in setting that moves files under uploads/mediapilot-ai/ and updates references to match.

Can I organize media that is already uploaded?

Yes. Existing uploads can be assigned individually or in bulk, and you can import an existing structure with CSV or migrate it from FileBird, Real Media Library, Wicked Folders or HappyFiles. Migration reads the other plugin's data and never modifies it.

Can I replace a file without changing its URL?

Yes, when the replacement keeps the same filename — the attachment ID and the public URL are preserved, thumbnails are regenerated, and the previous file is archived so you can roll back. If the filename changes, the plugin updates references in post content and post meta instead.

Does the plugin need an AI provider or a cloud account to be useful?

No. Folders, search, the unused media cleaner, the duplicate image finder, replacement, optimization and analytics all run locally with no account and no key. AI and Google Drive are optional integrations that stay dormant until you configure them.

Does BrainStudioz receive my images or any usage data?

No. The Free plugin makes no request to BrainStudioz at all — no account, no licence check, no telemetry. The only outbound requests it can make are to an AI provider you configured and to Google Drive using your own OAuth client, both described under External services.

Does MediaPilot AI support WordPress multisite?

It runs per site rather than network-wide, and uninstalling removes its data from every site on the network. Multisite has not been tested as thoroughly as single-site, so try it on staging before deploying across a network.

How does it fit with the rest of my stack?

  • Migrate folder structures and assignments from FileBird, Real Media Library, Wicked Folders and HappyFiles — the other plugin's data is read, never modified
  • Import and export folders and assignments as CSV, or manage them from WP-CLI
  • Galleries from a folder via a block or [mdpai_gallery], with modules for Elementor, Divi, Beaver Builder, Bricks and WPBakery, plus WPML and Polylang integrations and RTL stylesheets throughout the admin
  • Publish a folder as a browsable file list with the Document Library block or [mdpai_documents]. A folder becomes visible to visitors only when you publish it explicitly, and folders carrying access restrictions cannot be published
  • A REST API under mediapilot/v1, plus actions, filters and a pluggable interface for your own reference sources
  • An opt-in Real Filesystem Mode that mirrors folders to real directories under uploads/mediapilot-ai/ and updates references when files move
  • Long jobs run in background batches on WP-Cron with progress, pause, resume and cancel; where cron is unavailable the next status poll runs the overdue batch

What does it need from my server?

WordPress 6.4 or newer and PHP 8.1 or newer. Perceptual duplicate detection needs the GD extension; AVIF conversion needs Imagick built with AVIF support, and the settings screen tells you whether your server has it. Everything else works on a standard host.

Will MediaPilot slow down my website?

MediaPilot's management interface runs in the WordPress admin. Large-library operations such as indexing, duplicate detection and optimization run in small background batches with progress controls, so they do not depend on keeping a browser tab open. MediaPilot adds no visitor-tracking script. Front-end output is added only for features you choose to publish or enable, such as folder galleries, document libraries, CDN URL rewriting or lazy loading.

更新日志:

2.9.1 2.9.0 2.8.1 2.5.9 2.5.7 2.5.6 2.5.5 2.5.4 2.5.3 2.4.0 2.3.0 2.1.1 Security release. Updating is strongly recommended for any site that uses folder permissions. 2.1.0 2.0.1 2.0.0 1.6.0 1.5.5 1.5.4 1.5.0 1.4.0 1.1.0 1.0.0