摘要应包含研究背景与目的、研究方法与过程、核心发现与结果、结论与意义四部分，依次简明陈述，突出创新点与关键数据，保持客观、独立、完整。
别写 version 字段。 它不是项目版本号的填写位置，而是 Composer 的一个特殊开关：一旦写了，就等于告诉 Composer “这包没 Git、没 tag、不走 Packagist”，后续所有依赖解析、安装、同步都会按这个错误前提运行——轻则装错版本，重则 Could not find package 直接失败。
为什么 version 字段一写就出问题
Composer 从不读取你写的 "version": "1.2.3" 来决定装哪个版本。它只看 Git tag（比如 v1.2.3）或当前分支名（比如 dev-main）。你硬填了，它反而会忽略 tag，坚持用你写的字面值。
- 你在
composer.json写"version": "1.0.0"，又打了git tag v2.0.0→ Composer 仍当它是1.0.0 - 你发版到 Packagist，但
composer.json里有version字段 → Packagist 拒绝收录或解析为本地包 - CI 脚本用
sed替换version→composer.lock里的 commit hash 和 tag 对不上，构建不可复现
什么情况下才允许写 version
只有满足全部以下条件时，才能勉强考虑手动写：
- 代码完全不托管在 Git 或任何 VCS 上（比如纯 ZIP 分发的闭源组件）
- 不发布到 Packagist，也不进私有仓库（如 Satis、Private Packagist）
- 所有下游 require 都通过
repositories.type = "path"指向本地文件夹 - 值必须是合法语义化版本，如
"1.2.3"；禁用"v1.2.3"、"1.2"、"@package_version@"
哪怕只有一条不满足，就该删掉这个字段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确发布稳定版本的实操路径
真正生效、可复现、被全链路（Git / Composer / Packagist / CI）识别的版本，只来自 Git tag。
- 确保
composer.json中没有version字段（或已清空） - 提交你想发布的代码状态：
git add . && git commit -m "release: v3.2.1" - 打符合规范的 tag：
git tag v3.2.1（注意开头的v） - 推送到远程：
git push origin v3.2.1 - Packagist 自动抓取后，别人就能用
"your/package": "^3.2"正常 require
如果本地 composer show 还显示 dev-main 而不是 3.2.1，先检查 tag 是否推上去了、名字是否带 v、有没有被 .gitignore 掉。
require 里的版本约束怎么配才不翻车
你控制别人怎么装你的包，靠的是别人 require 里的写法，不是你自己 composer.json 的 version。
-
"my/package": "^3.2.0"→ 允许3.2.0到4.0.0前，但要求作者守 SemVer -
"my/package": "~3.2.0"→ 更窄，只允许3.2.x，补丁级升级安全 -
"my/package": "3.2.1"→ 精确锁定，适合生产环境 + 提交composer.lock - 避免
"my/package": "^3"或"*"，主版本跨度大，兼容性风险高
最易被忽略的一点：tag 名必须匹配正则 ^v?\d+\.\d+\.\d+。写成 release-3.2.1 或 3.2.1-final，Packagist 就认不出这是个版本。
