composer原生不支持安装时弹窗或交互提示，仅能通过post-autoload-dump脚本输出文本、description字段在show/search中显示，或readme.md与support.docs配合实现静态说明。
Composer 本身不支持“动态注释”或“提示框”这类 UI 层面的功能，所有所谓“添加注释说明”的行为，必须通过 composer.json 的标准字段（如 description、keywords）或第三方插件间接实现，且仅在命令行输出、Packagist 页面或 IDE 提示中静态呈现——不存在运行时弹窗或交互式提示。
如何让 composer require 安装时显示自定义说明
Composer 原生不触发任何钩子来打印安装提示。但可通过 scripts 配合 post-autoload-dump 或 post-install-cmd 实现近似效果：
-
post-install-cmd在composer install结束后执行，适合首次安装时提醒，但不会在require单个包时触发 -
post-autoload-dump每次自动加载器重建时都执行（包括require后），更贴近“添加包即提示”的需求 - 脚本内容建议用
echo输出纯文本，避免调用外部命令（如notify-send）导致跨平台失败 - 示例：
"scripts": { "post-autoload-dump": "echo '⚠️ 注意：本包需配合 config/app.php 中的 custom_driver 配置使用'" }
为什么 description 字段不总显示在终端
Composer 只在少数场景下展示 description：比如 composer show vendor/package 或 composer search，但 require 过程中默认静默。IDE（如 PHPStorm）和 Packagist 网站会渲染它，但终端无强制输出逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要依赖
description传递关键配置步骤，它不是安装引导机制 - 若想增强可见性，可将关键说明写进
readme.md并确保composer.json的homepage指向该文件（部分 IDE 会抓取） - 某些私有仓库管理工具（如 Satis）会渲染
description到 HTML 包列表页，但这与 Composer CLI 无关
用插件实现“安装后自动提示”要绕过哪些坑
社区有插件如 hirak/prestissimo 或自定义插件，但真正稳定支持安装后提示的极少。若坚持走插件路线：
- 必须实现
EventSubscriberInterface，监听PackageEvents::POST_PACKAGE_INSTALL，而非伪造命令钩子 - 插件的
composer.json必须声明"type": "composer-plugin"且"extra": {"class": "..."}正确指向类 - 插件内不能依赖未声明的全局函数（如
dd()），否则在无 Laravel 环境下报错 - PHP 版本兼容性极易出问题：Composer 2.x 使用 PHP 7.4+ 类型声明，插件若用
mixed类型却部署在 PHP 8.0- 下会直接拒绝加载
真正可控的“说明”只存在于文档、脚本输出和 IDE 支持字段里；把提示逻辑塞进 Composer 流程，等于在构建系统上叠 UI 层，既难调试又不可靠。最省事的方式，是把关键步骤写进 README.md 第一行，并在 composer.json 的 support.docs 字段明确指向它——这是 Packagist 和大多数 IDE 唯一保证解析并展示的位置。
