WPackagist 是将 WordPress.org 插件/主题映射为 Composer 包的元数据索引服务，不托管代码；需手动配置仓库地址、使用 composer/installers 重定向路径，并注意版本格式与激活流程。
WPackagist 是什么，为什么不能直接用 composer require
WPackagist 是一个把 WordPress.org 插件/主题仓库映射成 Composer 可识别包源的第三方服务。它本身不托管代码，只提供 composer.json 元数据索引。你执行 composer require wpackagist-plugin/akismet 失败，大概率是因为没提前配置它的仓库地址——Composer 默认只认 Packagist.org，对 WPackagist 一无所知。
常见错误现象：Could not find package wpackagist-plugin/akismet 或 Package not found，不是插件名写错，而是根本没告诉 Composer 去哪找。
- 必须在项目根目录的
composer.json中手动添加repositories配置，指向https://wpackagist.org - 类型必须是
composer（不是package或vcs），否则无法解析 WordPress 插件的语义化版本规则 - WPackagist 的包命名有固定格式：
wpackagist-plugin/{slug}或wpackagist-theme/{slug}，比如classic-editor插件对应wpackagist-plugin/classic-editor
怎么安全地把插件装进 wp-content/plugins 目录
默认情况下，Composer 把所有包装进 vendor/，但 WordPress 要求插件必须在 wp-content/plugins/ 下才能被识别。不改安装路径，装了也白装。
核心解法是用 composer/installers 这个约定式路径重定向插件，它能识别 wpackagist-plugin 这类 type，并自动投递到正确位置。
- 先运行
composer require composer/installers（确保已存在） - 在
composer.json里显式声明"type": "wordpress-plugin"或"type": "wordpress-theme"——注意：这是给composer/installers看的，不是给 WPackagist 看的 - 必须设置
"installer-paths"，例如：{"wp-content/plugins/{$name}": ["type:wordpress-plugin"], "wp-content/themes/{$name}": ["type:wordpress-theme"]} - 别依赖
composer install自动发现路径；如果已有vendor/下的旧包，先composer dump-autoload再composer update，否则路径重定向可能不生效
更新插件时为什么经常卡住或报错
WPackagist 的版本号来自 WordPress.org 的 SVN 标签，和 Git 的 commit hash 不同，它用的是类似 12.3 或 trunk 这样的标识。而 Composer 默认只接受符合 SemVer 规范的版本（如 ^12.3），遇到 trunk 或无明确版本号的插件就会拒绝安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型报错：Root composer.json requires wpackagist-plugin/query-monitor ^3.0, found wpackagist-plugin/query-monitor[dev-trunk] but it does not match the constraint.
- 解决方法：显式指定分支，例如
composer require wpackagist-plugin/query-monitor:dev-trunk - 更稳妥的做法是查插件页面的「Stable tag」字段（在插件 SVN 的
readme.txt里），用那个值当版本号，比如3.18.1 - 避免用
dev-master——WPackagist 没有 master 分支概念，这个写法基本无效 - 如果插件长期不更新标签，
composer outdated可能显示“up to date”，但实际 WordPress 后台提示有新版本——因为 WPackagist 同步有延迟（通常几小时）
为什么有些插件装不上，或者装上后不显示在后台
不是所有 WordPress 插件都适合 Composer 管理。WPackagist 只索引公开在 wordpress.org 上的插件，且要求其 SVN 结构规范。很多问题其实出在插件自身，而非你的配置。
常见假性失败场景：composer require 成功，但 WordPress 后台看不到插件，或启用时报 Plugin could not be activated。
- 检查插件主文件是否在根目录（如
wp-content/plugins/akismet/akismet.php），WPackagist 要求插件入口文件名必须和目录名一致，否则composer/installers会投错位置 - 某些插件依赖其他插件或特定 PHP 扩展（如 cURL、XML），Composer 不校验这些运行时依赖，得自己排查
- 如果你用的是 Bedrock 结构（roots/bedrock），插件路径默认是
web/app/plugins/，需同步修改installer-paths中的路径，不能照搬标准 WordPress 路径 - 别忽略文件权限：Composer 解压后，Web 服务器用户（如 www-data）必须对
wp-content/plugins/xxx有读取权限，否则 WordPress 加载失败
最常被忽略的一点：WPackagist 不处理插件激活状态。装完还得手动在 WordPress 后台点击「启用」，或者用 WP-CLI wp plugin activate 补上这一步——Composer 只管文件，不管业务逻辑。
