公共文档
plugin-kit-ai
在一个仓库里构建，默认先走 Go 路径，之后再按需要加入 packages、Claude hooks、Gemini， 或由仓库管理的集成配置，无需拆分项目。
默认开始
- 当您想要最强的运行时和发布故事时，
Codex runtime Go是默认开始。
立即了解什么
- 当您添加更多通道时，一个存储库仍然是事实来源
- 选择符合您今天需要的起始路径
- 当产品需要更多输出时，稍后从同一存储库进行扩展
- 使用
generate和validate --strict作为共享准备工作流程
支持 Node 和 Python 路径
codex-runtime --runtime node --typescript是主要支持的非 Go 路径。codex-runtime --runtime python是受支持的 Python-first 路径。- 两者都是本地解释运行时路径，因此目标机器仍然需要 Node.js
20+或 Python3.10+。 - 对于已经在这些堆栈中工作的团队来说，它们是明确的早期选择，但它们不是默认的开始。
快速启动
首先使用最强的默认路径，只有当产品需要更多输出时才扩展。
查看产品形状
查看一个存储库如何发展为运行时、包、扩展和存储库拥有的集成设置。
选择目标
将目标与您想要发送插件的方式相匹配，而不是将每个输出视为相同的东西。
检查确切的合同
当您需要精确的支持边界和兼容性术语时，请使用参考页。
如果您稍后需要更多
- 当产品要求 Claude 挂钩时，添加
Claude default lane。 - 当产品是包或扩展输出时，添加
Codex package或Gemini packaging。 - 当存储库应拥有集成设置时，添加
OpenCode或Cursor。 - 在切换或 CI 之前使用
validate --strict作为准备门。
常用扩展路径
- 从 Codex 运行时存储库开始，然后在包装成为产品的一部分时添加 Codex 包或 Gemini 。
- 当 Claude 钩子是产品时，从 Claude 开始，然后保持仓库开放，以供以后更广泛的交付通道使用。
- 从本地 Node 或 Python 开始，然后在下游交付很重要时添加捆绑包切换。
- 当存储库应管理集成配置而不仅仅是可执行行为时，添加 OpenCode 或 Cursor 。
按这个顺序阅读
1。快速入门
在考虑扩展之前先从一条推荐路径开始。
2。您可以构建什么
查看跨运行时、包、扩展和集成通道的产品形状。
3。选择目标
选择与您实际想要发送插件的方式相匹配的目标。
4。支持边界
当您需要精确的兼容性语言和支持详细信息时，请使用参考集群。
如果您是新手，请在这四页之后停止。其他一切都是更深入的参考或实现细节。
当前仓库基线
- 此文档集中当前的公共基准是
v1.0.6。 - 该版本使 Python 和 Node 的共享运行时包交付成为完全支持的故事。
- 当您需要当前推荐的基线时从这里开始。
这个网站可以帮助您做什么
- 启动一个插件存储库，而不是按生态系统分割事实来源
- 选择推荐的起始路径，无需预先了解每个目标细节
- 稍后将相同的存储库扩展到更多运输路径
- 随着存储库的增长保留一个审查和验证故事
- 仅在需要时找到确切的合同