BotKelp

BotKelp 组件

BotKelp 实际使用的单个组件的公开源代码。

你可以浏览、复制和复用这些文件。这正是此仓库的用途。

我们提供的内容

components/ 下的每个文件夹对应一个组件：

• manifest.json — ID、不可变的 semver、requires / provides、compatibility 范围、npm 包和生成器操作
• templates/ — 生成器应用的文件（EJS 模板；大多数是没有模板逻辑的纯源文件）
• versions/<semver>/（可选）— 其他不可变版本。顶层的 manifest.json 始终对应最新版本。较旧版本保存在 versions/ 下，因此发布 2.0.2 不会覆盖 1.4.2。

compatibility 是一项严格的注册表规则，不是 Agent 应该猜测的内容。示例：

"compatibility": { "nextjs": ">=16 <17", "react": ">=19 <20" }

BotKelp MCP 会查询 (component, version, stack)，并执行以下操作：

1. 版本完全匹配且兼容 → 返回该制品
2. 版本完全匹配但不兼容 → 返回 COMPONENT_VERSION_INCOMPATIBLE 和备选版本 — 不返回文件
3. 未指定版本 → 自动选择最适合的兼容版本
4. allow_incompatible: true → 返回指定版本并附带警告；compatible: false 仍然成立

同一列表也位于 CATALOG.md 和 catalog.json 中。

此仓库是 BotKelp 组件目录的唯一真实来源。MCP 生成器和网站会加载这些文件（而非私有副本）。这不是演示项目，也不是经过整理的节选。

我们不提供的内容

• 不是完整应用。 克隆此仓库不会得到一个可运行的网站。
• 不是组装或生成的项目构建。 通过 BotKelp MCP 工具 purchase_scaffold 构建的脚手架（已将多个组件连接在一起的完整应用）不会在此发布。
• 不是 BotKelp 服务。 MCP 服务、计费、账户和生成引擎位于其他地方，不在此仓库中。

如果你想获取生成的项目，请将你的 Agent 连接到 BotKelp MCP 服务：https://www.botkelp.com/mcp（远程 HTTP；没有 npm 包或 stdio 服务），调用 get_help 和 search_components 选择组件 ID，然后调用 purchase_scaffold。构建会使用账户额度（通过 MCP OAuth 登录，或将 https://www.botkelp.com/dashboard 中的 bk_live_ 密钥作为 Authorization: Bearer 标头发送；切勿将其作为工具参数），且只有构建成功后才会收费。各客户端的设置说明：https://www.botkelp.com/llms.txt

如果你想复制导航栏、Supabase 客户端或 Tailwind 配置，请使用此仓库。

如何复制组件

1. 打开 components/<id>/。
2. 查看 manifest.json，了解 npm 包和环境变量。
3. 将 templates/ 下的文件复制到应用中 manifest 列出的 destination 路径。
4. 安装列出的 dependencies / devDependencies。
5. 遵守组件所封装的上游库（Next.js、Tailwind、shadcn/ui、Supabase 等）的许可。这些库仍受各自的许可约束。

nextjs-base 是其他组件所依赖的基础组件。它仍然只是一个组件，并非我们作为完整构建发布的产品应用。

许可证

BotKelp 编写的文件依据 BotKelp Limited Use Licence 授权。

每个文件都注明 INTLEACHT RESEARCH LIMITED（以 BotKelp 名义运营）。你可以将单个组件的源代码复制到自己的项目中。你不得将此目录或生成器伪装成自己的产品，也不得移除此处发布文件中的运营方署名。

组件中提及的第三方项目仍受各自许可约束。复制组件并不会改变 Next.js、Tailwind、Prisma 或其他任何内容的许可。

网站

BotKelp 网站上的注册表展示了相同的组件，并提供可复制的文件内容。 仓库：https://github.com/botkelp/components