38 · 插件参考：目录、清单与发布

插件目录结构、manifest、组件路径、版本与 marketplace 分发方式，适合需要制作、检查或发布插件的读者。

这一篇是给「要自己制作、检查或发布插件」的人看的进阶参考。

「插件目录结构」：一个插件内部是怎么组织的——哪些文件、哪些目录、各自放什么。理解这个，你才能自己动手做一个。

「manifest（清单）」：插件的「身份证」，声明这个插件叫什么、版本多少、包含哪些组件、依赖什么。它是插件能被识别和加载的关键。

「组件路径」：插件里的命令、Skill、Hook、子代理等，各自要放在规范的位置，路径对不上就加载不了。

「版本」：插件的版本管理，涉及更新、兼容性。做好版本，分发和升级才不乱。

「marketplace 分发」：把插件发布到市场，让团队或公众能安装。这涉及打包、发布流程。

「适合读者」：如果你只是「用」插件，这篇了解即可；如果你要「造」插件、「审」插件、或「发布」插件，这篇就是你的操作手册。

制作插件的本质，是把「你的最佳配置」打包成「别人也能一键获得」的东西。这既是能力沉淀，也是团队协作的高级形态。

提醒一句：发布前一定要检查清楚插件里有没有敏感信息、有没有不必要的权限，别把不该带的东西带出去。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。