Composer如何配置项目的支持链接_在json添加issue和wiki地址【项目文档】-composer-PHP中文网

在 composer.json 根对象的 support 字段下添加 issues 和 wiki 子键，值为完整 HTTPS URL，如 "support": {"issues": "https://...", "wiki": "https://..."}，并确保 Packagist 已同步最新配置。

composer如何配置项目的支持链接_在json添加issue和wiki地址【项目文档】

composer.json 里怎么加 issue tracker 和 wiki 链接

Composer 本身不直接解析或使用 issues 或 wiki 字段，但 Packagist（主流 PHP 包仓库）会识别并展示这两个字段。只要你在 composer.json 的顶层写对了键名，发布到 Packagist 后，项目页面右上角就会出现对应图标和跳转链接。

必须写在根对象下，不能嵌套在 extra 或其他字段里：

{
    "name": "vendor/package",
    "description": "A sample package",
    "homepage": "https://example.com",
    "support": {
        "issues": "https://github.com/vendor/package/issues",
        "wiki": "https://github.com/vendor/package/wiki"
    }
}

support 是必用的外层字段名，大小写敏感，不能写成 Support 或 support-info
issues 和 wiki 是 support 下的子键，值必须是完整、可访问的 HTTPS URL
GitHub/GitLab 项目默认有 issues 和 wiki，但路径要写全；如果禁用了 issues，填了也无效（点击后 404）
Packagist 不校验 URL 是否真实可达，只做字符串透传 —— 填错地址只会让用户点开后失望

为什么 support.issues 没出现在 Packagist 页面上

最常见原因是：你改了 composer.json，但没触发 Packagist 的同步。Packagist 不自动轮询你的仓库，它依赖 GitHub/GitLab 的 webhook 或手动更新。

确认你的 GitHub 仓库已接入 Packagist webhook（Settings → Webhooks → 查看是否含 packagist.org 回调）
如果没有，去 Packagist 个人页 → “Update” 对应包，强制拉取最新 composer.json
检查 Packagist 页面右上角「Source」旁是否有「Issues」和「Wiki」按钮 —— 如果没有，说明 support 结构未被识别（比如缩进错误、逗号遗漏、用了单引号）
运行 composer validate 可快速发现 JSON 语法问题，但不会报 support 字段无效 —— 它合法，只是 Packagist 才消费

除了 issues 和 wiki，support 还能填什么

support 是 Packagist 明确支持的字段组，除 issues 和 wiki 外，还接受以下键（全部可选）：

email：联系邮箱，显示为 mailto: 链接
irc：IRC 频道地址，格式如 irc://irc.freenode.net/#package
source：源码仓库地址（通常和 homepage 或 repositories 一致，Packagist 会优先用仓库配置）
docs：文档站点，独立于 wiki，例如 ReadTheDocs 地址
rss：RSS 订阅源（极少用）

注意：support 下任意字段都不影响 Composer 安装行为，纯属元信息展示 —— 但用户第一眼看到「Wiki」按钮却跳转 404，比没按钮更伤信任。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

要不要把 issue 模板也塞进 composer.json

不用，也不能。GitHub/GitLab 的 issue template 是仓库根目录下的 .github/ISSUE_TEMPLATE/ 文件系统结构，和 composer.json 无关。Composer 不读取、不转发、不校验这些模板。

如果你希望贡献者提 issue 时自动带格式，唯一有效做法是：

在 GitHub 仓库中启用 issue template（通过 .github/ISSUE_TEMPLATE/bug_report.md 等文件）
确保 support.issues 指向的是该仓库的 issues 主页（如 https://github.com/vendor/package/issues），而不是某个具体 issue
别试图用 extra 字段模拟支持链接 —— Packagist 忽略它，用户也看不到

真正容易被忽略的点是：字段名拼写、URL 可达性、以及 Packagist 同步机制 —— 三者缺一，链接就等于没配。