初始化可发布Composer包需三步：规范目录结构（src/、tests/）、写准composer.json（name为vendor/package-name、psr-4映射正确、type=library）、确保自动加载有效；本地必须通过composer install和dump-autoload验证。
怎么初始化一个可发布的 Composer 包
核心就三件事：目录结构得对、composer.json 得写准、代码得能被自动加载。别急着 push，本地没跑通 composer install 和 composer dump-autoload 就别想别人能用。
常见错误是把包当成普通项目——比如根目录下直接放 index.php 或 public/，这会让 Composer 找不到入口。正确做法是按 PSR-4 规范组织：src/ 放类、tests/ 放测试、composer.json 在最外层。
-
name字段必须是vendor/package-name格式（如myname/my-awesome-helper），不能带下划线或大写字母 -
autoload里至少配好psr-4，比如"MyName\Helper\": "src/"，注意命名空间末尾的反斜杠不能漏 - 加
"type": "library"，否则 Packagist 会把它当应用处理，不收录 - 本地测试时用
composer require ./path/to/your/package比直接发版更安全
为什么 packagist.org 提交后不显示最新版本
不是提交失败，而是 Packagist 不主动拉取代码——它只监听你 GitHub/GitLab 仓库的 push 或 tag 事件。手动点 “Update” 按钮只是触发一次同步，不会绑定后续更新。
真正生效靠的是 Git tag。Composer 安装时认的是 tag 名，不是分支名。比如 v1.0.0、1.2.3 这种语义化版本 tag，而不是 main 或 dev-feature。
- 打 tag 前先
git commit -m "release v1.0.0"，再git tag v1.0.0，最后git push --tags - tag 名必须符合
^(d+).(d+).(d+)(?:-[w.]+)?$，v1.0或1.0.0-beta可以，1.0.0beta不行 - Packagist 同步有延迟，通常 1–5 分钟；如果等太久，去仓库页面点 “Force update”
- 别用
dev-main这类开发版依赖上线，它不稳定，且 Composer 默认不启用minimum-stability: dev
如何让别人 require 你的包时不报 autoload 错误
根本原因是类文件路径和 composer.json 里声明的命名空间对不上。Composer 不解析 PHP 文件内容，只靠配置做文件映射。哪怕类定义完全正确，只要路径错一丁点，Class not found 就立刻报。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
最容易被忽略的是大小写和命名空间分隔符。Windows 下不敏感，Linux/macOS 严格区分 src/Helper/Str.php 和 src/helper/str.php；PHP 命名空间必须用反斜杠 ，不是正斜杠或下划线。
- 运行
composer dump-autoload -o生成优化后的加载器，能暴露路径问题（比如提示 “class not found in …”） - 检查
vendor/composer/autoload_psr4.php生成的内容，确认你的命名空间是否真被注册进去 - 如果用了子命名空间（如
MyNameHelperUtils），确保src/Utils/目录存在，而非src/utils/ - 别在
src/外写类，也别用files自动加载全局函数——除非你明确知道后果
私有包怎么让团队不用 token 也能 composer install
不是所有公司都愿意把 Git 凭据塞进 auth.json。更稳的方式是用 Composer 的 repositories + SSH，绕过 HTTPS 认证。
关键在于 Git URL 必须是 SSH 格式（git@github.com:vendor/repo.git），且目标服务器已配置好部署密钥。HTTP/HTTPS 地址走不了免密流程，除非你开个私有 Packagist 镜像——那成本太高。
- 在项目级
composer.json里加"repositories"，类型设为vcs，URL 写成"git@github.com:myorg/internal-utils.git" - 确保运行
composer install的机器上，ssh -T git@github.com能通（即已配好 SSH key） - 私有包的
composer.json里不要写packagist.org相关配置，避免误导 Packagist 抓取 - CI 环境记得提前注入 SSH key，GitHub Actions 用
webfactory/ssh-agent，GitLab CI 用SSH_PRIVATE_KEY变量
事情说清了就结束。最常卡住的地方不是发布动作本身，而是本地 autoload 映射和远程 tag 版本号这两处——它们不出错，别的基本不会拦你。
