authors字段必须是数组，因Composer官方JSON Schema硬性规定其为array类型，每个元素须含name字符串；写成字符串或单对象会导致validate报错且show无法识别。
authors 字段必须是数组，哪怕只有一个人；写成字符串或单个对象，composer validate 直接报错，composer show 也查不到作者。
authors 字段为什么必须是数组？
Composer 官方 JSON Schema 明确规定 authors 是 array 类型，每个元素是含 name（必填字符串）的对象。这不是建议，是硬性校验规则。
- 写成
"author": "John Doe"或"author": {"name": "John"}——composer validate报错，且所有工具（Packagist、IDE、composer show）都忽略该字段 - 正确写法只能是
"authors": [{"name": "John Doe"}]，哪怕只有一人，也得套一层中括号 - 漏掉
name、值为空字符串或纯空格（如"name": " "），同样被当作无效项处理
email 和 homepage 怎么填才不踩坑？
email 和 homepage 都是可选字段，但填了就得符合基本格式，否则虽不阻断安装，却可能在 CI 环境或 Packagist 同步时触发警告甚至失败。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
email必须是合法邮箱格式（如"alice@example.com"），不能是"alice@"或未加引号的alice@example.com（YAML 解析器可能出错） - Windows 下用记事本编辑时，若保存为 ANSI 编码，
@或中文名可能乱码；务必用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM -
homepage建议填真实可访问链接（如 GitHub 主页），但不要填support、docs等非标准字段——它们会被完全忽略 - 别把
role当装饰字段乱填，目前没有任何官方工具解析或展示它
改完 authors 后，为什么 composer show 还是空的？
本地改完 composer.json 不等于信息立刻生效，常见失效原因就三个：
- 没运行
composer validate：先确认是否通过校验，报错说明结构不对 - 没打新 tag：Packagist 只读取你 push 的 tag 对应的
composer.json，改完不git tag v1.2.4 && git push --tags，线上页面永远不变 - 误用了
author（单数）字段名：必须是复数authors，拼写错误会导致整个字段被跳过
全局配置能自动填 authors 吗？
可以，但仅影响后续 composer init 新建项目，不会修改已有项目的 authors。
- 执行
composer config -g name "Your Name"和composer config -g email "you@example.com"（必须分两次） - 之后在空目录下运行
composer init -n，生成的composer.json就会自动带好authors数组 - 注意：
composer init -n不会覆盖已存在的authors，也不会补全空字段——它只对完全缺失的字段（如type、license）填默认值
最容易被忽略的是两件事：数组结构是强制要求，不是风格偏好；tag 一旦打出去就不可变，改作者必须发新版本。这两个点卡住，其他操作全白忙。
