Composer 不支持中文规范，必须通过本地映射文件（如 zh-mapping.json）和脚本注入实现中文语义层，并手动维护 autoload 配置、执行 dump-autoload，且 CI/CD 中所有中文须转为 ASCII 安全形式。
composer 本身不支持“中文规范”，所谓通用 SDK 自动化生成系统，必须绕过 Composer 原生限制，在其之上叠加元数据桥接层与生成调度逻辑——否则所有“中文命名”“自动映射”“语义化提醒”都会在 composer install 阶段失效或静默丢弃。
中文包名/描述不会被 composer outdated 识别
Composer 的版本比对只依赖 name（如 guzzlehttp/guzzle）和 version 字段，description、keywords 等纯文本字段完全不参与计算。即使你在 composer.json 里写 "description": "HTTP 客户端（中文增强版）"，composer outdated 输出仍是英文包名 + 版本号。
-
composer outdated --format=json返回的 JSON 中不含任何中文字段，Packagist API（如https://packagist.org/packages/guzzlehttp/guzzle.json）也无zh-CN子项 - 强行用中文注册私有包（如
"公司/支付SDK"）会触发Invalid package name "公司/支付SDK": contains invalid characters - 有人试图在
composer.lock的packages节点下硬塞"zh_name": "微信支付 SDK"，但下次composer install会直接覆盖整个文件，手工字段必然丢失
真正可行的中文语义层：本地映射 + 脚本注入
要让运维看到“微信支付 SDK 已过时”，而不是“wechatpay/wechatpay 有新版本”，你得自己维护一个 zh-mapping.json，再用脚本解析 composer outdated --format=json 输出并查表注入。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 映射文件示例：
{"wechatpay/wechatpay": {"zh_name":"微信支付 SDK","category":"支付"}} - 脚本语言不限（PHP/Python/Node.js），但映射关系必须人工维护或半自动同步（例如定期抓取 GitHub README 首行标题做关键词提取）
- GitHub Actions 中建议将
zh-mapping.json纳入 Git，避免 CI 动态拉取不可靠的第三方中文描述 - 不要把映射逻辑塞进
composer.json的scripts字段——某些旧版 Composer 解析器会因中文注释卡住
SDK 生成阶段必须脱离 composer install 流程
composer install 不生成任何 SDK，它只安装已存在的包。OpenAPI 或 WSDL 生成的 SDK 是代码产物，需先用工具产出，再通过 autoload 接入 Composer 加载体系。
- 用
openapi-generator-cli generate -i openapi.yaml -g php --package-name MyApiSdk -o ./sdk生成后，必须手动补全composer.json中的"psr-4": {"MyApiSdk\": "sdk/lib/"} - 生成目录不能扔进
vendor/——Composer 不管理手动放入的代码，且会因路径冲突导致Class not found - 执行
composer dump-autoload是强制步骤，否则新增 autoload 规则不生效；可用composer dump-autoload -v检查是否列出映射路径 - 若用
wsdltophp/packagegenerator，同样需配置 autoload 并运行dump-autoload，不能依赖composer require自动完成
CI/CD 中所有“中文”都必须转为 ASCII 安全形式
CI 脚本里出现中文字符，90% 是编辑器全角符号、BOM、零宽空格（U+200B）或未 URL 编码的环境变量值导致构建失败，不是 Composer “不支持中文”。
- 参数必须用半角破折号：
--no-dev，不是—no-dev或——no-dev - 私有源含中文域名？必须 Punycode 编码（如
xn--fsq512a.example.com），否则composer install卡在 DNS 查询 - COMPOSER_AUTH 中若含中文密码，需
urlencode()后传入，否则静默失败 - 复制粘贴自微信/QQ 的命令常带全角空格，
composer install --no-dev看似正常，实则第二个空格是全角，报错Unknown option '--no-dev'
zh-mapping.json 一旦过期，中文提醒就变成误导；而每次 OpenAPI 变更后，psr-4 路径、命名空间、dump-autoload 是否执行，三个环节缺一不可。这些都不是 Composer 自动做的，得靠人盯住。 
