Composer 中文元数据源自开发者手动填写的 composer.json 字段或 Packagist API 返回的 description，非官方提供；兼容性需结合 constraint 解析与 AST 扫描；报告应输出结构化 JSON 并解耦模板；中文关键词提取依赖预定义规则而非分词模型。
Composer 中文元数据从哪来？别直接 parse composer.json
Composer 官方不提供中文元数据，所谓“中文元数据”实际是开发者在 composer.json 的 description、keywords、name 字段里手动填的中文，或通过第三方包（如 phpstan/phpstan 插件、composer-unused）间接提取的语义信息。直接用 json_decode(file_get_contents('composer.json')) 读取本地文件，根本拿不到跨包的中文描述聚合——你得先有所有目标包的 composer.json 快照。
可行路径只有两条：
• 走 Packagist API（https://repo.packagist.org/p2/{vendor}/{package}.json），它返回的 JSON 包含 description 字段，且部分维护者确实写了中文；
• 或镜像同步 Packagist 元数据到本地 SQLite，用 curl -s "https://packagist.org/packages/list.json" | jq '.packageNames' 拉全量包名再逐个抓取。
- 注意 Packagist API 有速率限制（默认 60 次/小时），加
User-Agent和缓存头能绕过一部分 -
description字段长度上限 120 字符，很多中文描述被截断，不能当唯一依据 - 别依赖
keywords做语义分类——90% 的包 keywords 是英文或空，中文 keywords 几乎为零
兼容性分析不是版本号比大小，而是 constraint 解析+AST 检查
仅靠 composer show --tree 输出或 composer depends 列出依赖链，没法判断「某类库是否支持 PHP 8.2 + Laravel 11 + ext-redis 5.3.7」。真正的兼容性要拆两层：
- 第一层：解析
require字段里的约束表达式，比如"php": "^8.1"、"laravel/framework": "11.*"、"ext-redis": ">=5.3.0"，用Composer\Semver\Constraint\ConstraintParser实例化后调matches() - 第二层：对源码做轻量 AST 扫描，确认是否调用了已被弃用的函数（如
mysql_connect()）、是否用了未声明的扩展类（如new \RedisCluster()但没申明ext-redis）
示例：判断一个包是否兼容 PHP 8.2，不能只看 "php": "^8.1" —— 这个约束允许 8.1.x 和 8.2.x，但若其代码里用了 #[\Override] 属性（PHP 8.2 新增），而 composer.json 里写的是 "php": "^8.1"，那它实际不兼容 8.1.x，却仍被判定为“兼容”。必须结合 AST 验证。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
自动生成报告时，模板和数据源必须解耦
很多人把 HTML 模板硬编码进 PHP 脚本，结果改个表格样式就得重跑全量分析。正确做法是让报告生成器只输出结构化数据（JSON），再用独立模板引擎渲染。推荐用 league/commonmark 渲染 Markdown 报告，而非直接拼 HTML。
- 输出 JSON 至少包含三块：
metadata（包名、版本、中文描述）、compatibility（PHP/Laravel/ext 版本匹配结果、失败原因）、ast_issues（AST 扫描发现的潜在不兼容点） - 避免在 JSON 里塞 HTML 片段——比如把「
<span class="warning">ext-redis 未声明</span>」直接写进字段，这会让下游无法做国际化或格式转换 - 如果要用中文标题，把翻译映射表单独放
lang/zh.json，不要写死在逻辑里
中文分词不是必须项，但关键词提取得靠规则而非模型
不需要上 jieba 或 pkuseg 做分词——Composer 元数据里中文极少，且基本是短语（如“微信公众号 SDK”、“Laravel 缓存驱动”）。真正要解决的是：怎么从一堆中文 description 里抽取出可归类的标签？
简单有效的方法是预定义规则集：
• 匹配「微信|公众号|小程序|支付」→ 归入 weixin 类别
• 匹配「缓存|Cache|cache|redis|memcached」→ 归入 cache 类别
• 匹配「Laravel|lumen|illuminate」→ 归入 laravel 类别
- 正则用
mb_ereg_match()或preg_match()+u修饰符，确保 UTF-8 正确匹配 - 别用模糊匹配（如相似度算法），中文 description 太短，Levenshtein 距离毫无意义
- 规则优先级很重要：先匹配长关键词（如“微信小程序”），再匹配短关键词（如“微信”），否则会漏判
真正难的不是提取，而是当多个包都标“微信 SDK”，但一个只支持公众号，一个只支持小程序，一个两者都支持——这时得回溯到它们的 require 和 autoload，看实际加载了哪些类，而不是只信 description 里写的字。
