type 字段是生态身份证而非安装开关，它仅标识包角色类型（如library、composer-plugin），具体安装行为由对应installer插件实现；若type值正确但未安装匹配的installer插件，则包仍按默认路径放入vendor/。
为什么 type 字段不是安装开关，而是生态身份证
Composer 的 type 字段本身不控制文件怎么复制、放哪、是否执行，它只告诉工具链“这个包属于哪一类角色”。比如 "type": "library" 表示这是个可复用类库，"type": "composer-plugin" 表示它是个插件，而 "type": "phpdocumentor-template" 这种自定义值，只有配套的 installer 插件（如 phpdocumentor/template-installer-plugin）才认识——否则 Composer 就当它是普通 library，原样放进 vendor/，什么也不多做。
常见错误现象：composer install 成功但模板文件没出现在 templates/ 目录下；或者报错 Could not find installer for type phpdocumentor-template。根本原因就是 type 值写对了，但没显式 require 对应 installer 插件，或者 installer 插件没在 require 里提前声明。
- Packagist 只接受官方标准
type值（library、project、metapackage、composer-plugin等），自定义值如my-framework-theme会被忽略 - 自定义
type必须和某个已安装的 installer 插件约定一致，比如phpdocumentor-template对应phpdocumentor/template-installer-plugin的逻辑 - installer 插件必须在目标包被安装前就存在，所以要在主项目的
composer.json中require它，不能只放在目标包自己的require里
如何让自定义 type 触发非标准安装路径（如 templates/）
默认情况下，所有包都解压到 vendor/{vendor}/{name}。要让它落到 templates/ 或 themes/ 下，得靠 installer 插件实现 Composer\Installer\InstallerInterface，并在 install() 方法里重写安装逻辑。
实操关键点：
- installer 插件的
composer.json必须声明"type": "composer-plugin"，且autoload正确映射到Plugin.php和Installer.php - 自定义 installer 类需实现
supports()方法，返回true仅当 $package->getType() === 'phpdocumentor-template' - 安装路径由
getInstallPath()决定，例如返回templates/' . $package->getPrettyName()，注意路径是相对于项目根目录，不是vendor/ - 别硬编码路径，用
$composer->getConfig()->get('vendor-dir')或$io获取上下文，避免跨环境失效
type 配置写错或缺失时，为什么类能加载但资源不出现
这是最易混淆的点：autoload 配置（psr-4、files）和 type+installer 是两套机制。前者管“PHP 类怎么自动加载”，后者管“包文件往哪放、要不要重命名、是否需要 post-install 脚本”。一个包可以同时有 "type": "phpdocumentor-template" 和 "autoload": {"psr-4": {"MyTemplate\": "src/"}}，但如果你只配了 autoload，没配 type + installer，那它的模板文件就只会躺在 vendor/myorg/my-template/src/ 里，不会挪到 templates/my-template/。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证方法：
- 运行
composer show myorg/my-template，看输出里type字段是否为你期望的值 - 检查
vendor/composer/installed.json，确认该包的type和install-path是否被 installer 修改过 - 如果
install-path仍是vendor/myorg/my-template，说明 installer 没生效——大概率是插件未安装，或supports()返回 false
自定义 type 包名命名冲突与 installer 约定
很多 installer 插件会校验包名格式，比如 phpdocumentor/template-installer-plugin 要求包名必须以 phpdocumentor/template- 开头，否则直接跳过。这不是 Composer 强制的，而是 installer 实现者加的守门逻辑。
容易踩的坑：
- 写了
"type": "phpdocumentor-template"，但包名是myorg/responsive-theme→ installer 不认，静默 fallback 到默认路径 - 包名符合约定（如
phpdocumentor/template-responsive），但type写成"phpdoc-template"→ 类型不匹配，installer 的supports()返回 false - 多个自定义 type 共存时，installer 插件可能只处理其中一个，其他 type 仍走默认流程，需确认插件源码是否支持多 type
真正起作用的是 installer 插件代码里的判断逻辑，不是 Composer 自身解析 type 的能力。所以不要只看文档示例，得翻对应插件的 supports() 和 getInstallPath() 实现。
