必须将repositories写在主项目composer.json根级数组中，类型为"path"，url用相对路径指向含合法composer.json的目录，且本地包name、version与require严格匹配，否则Composer静默跳过。
repositories 必须写在主项目 composer.json 根级
Composer 只读取项目根目录下 composer.json 文件顶层的 repositories 数组，其他位置（如嵌套在 config、extra 或本地包自己的 composer.json 中）一概忽略。常见错误是把配置写进子目录或依赖包里，结果 composer require 一直报 Could not find package，其实根本没触发路径扫描。
正确结构示例：
{
"repositories": [
{"type": "path", "url": "../my-utils"},
{"type": "path", "url": "./packages/api-client"}
],
"require": {
"acme/my-utils": "dev-main",
"acme/api-client": "dev-develop"
}
}
-
repositories是数组，哪怕只配一个 path 源，也必须用[{...}]包裹 - 不能写成
"repositories": {"type": "...", "url": "..."}（对象格式会静默失效） - Windows 下路径避免中文、空格、盘符大小写混用；推荐统一用
./或../开头的相对路径
url 必须指向含 composer.json 的目录，且路径要相对
url 值不是文件路径，也不是 file:// 链接，而是一个**存在合法 composer.json 的目录**。绝对路径（如 /home/user/pkg）、波浪号（~/pkg）、环境变量（$HOME/pkg）全部静默失败——Composer 不解析它们。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- ✅ 正确：
"../my-package"、"./packages/utils"（开头有./或../） - ❌ 错误：
"/tmp/my-pkg"、"file:///tmp/my-pkg"、"my-package"（缺上级路径）、"../my-package/composer.json"（指向文件而非目录） - 目录必须已执行
git init并至少有一个 commit，否则 Composer 直接跳过该路径
本地包的 name 和 version 必须与 require 严格对齐
Composer 不看目录名、不猜包名，只认本地包 composer.json 里的 name 字段。它和主项目 require 中写的字符串必须逐字一致：大小写、斜杠、连字符全敏感。
-
name必须是vendor/name格式，例如"acme/utils"；写成"utils"或"Acme/Utils"都会匹配失败 - 若本地包没打 tag，版本请用分支名，如
"dev-main"（对应main分支），而不是"1.2.0" - 主项目
composer.json中需设"minimum-stability": "dev"，否则dev-main会被过滤掉 - 改完本地包的
composer.json或代码后，需在主项目中运行composer dump-autoload才能刷新自动加载映射
启用 symlink 才能实时调试，且需系统支持
默认情况下，type: "path" 会创建符号链接（Linux/macOS 默认开启，Windows 需显式配置且开启开发者模式）。如果 vendor/acme/utils 是普通文件夹而非链接，说明 symlink 未生效，改本地代码不会反映到主项目中。
- 在
repositories条目中加"options": {"symlink": true}，例如：{"type": "path", "url": "../my-utils", "options": {"symlink": true}} - Windows 用户必须以管理员权限运行命令行，或提前开启“开发者模式”，否则
symlink创建失败且无提示 - 验证方式：
ls -la vendor/acme/utils（Linux/macOS）应显示箭头指向源目录；dir vendor\acme\utils（Windows）应标为“快捷方式” - 执行
composer update acme/utils才会重建链接；composer install不会重新解析 repositories，也不会刷新 symlink
name 和 require 对不上。这些地方一错，Composer 就安静地跳过，连 warning 都不给。 
