Blueprint Studio

Blueprint Studio

Blueprint Studio 是一家设计与开发工作室。此插件将 Claude Code 和 Codex 连接到 Blueprint Studio Asset Generator，让任何人都能使用自己品牌的 Styles 和徽标，创建符合品牌风格的图像和视觉素材。工作室客户还可以直接在编码 Agent 中使用我们的团队为他们维护的品牌工作区（官方徽标、品牌指南和 Styles）。

你的品牌 Styles、官方徽标和指南以及素材库都集中在一处，并与团队共享。你的 Agent 会使用它们制作风格统一的图标、社交媒体图片、主视觉图和幻灯片，并将其保存到你的项目和 Asset Generator 素材库中。技能是可选的；这些工具可以独立使用。

改用网页版、桌面版或移动版 Claude、ChatGPT、Cursor 或 VS Code？请参阅连接你的 AI。

请从下方的 Blueprint marketplace 安装。此代码仓库保留名称 claude-code-asset-generator，以确保现有安装继续正常工作。

安装

Claude Code：

/plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace
/plugin install blueprint-studio@blueprint-studio-marketplace

或者在终端中运行一行命令：

claude plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace && claude plugin install blueprint-studio@blueprint-studio-marketplace

要连接，请运行 /mcp，选择 plugin:blueprint-studio:asset-generator（Blueprint Studio），然后选择 Authenticate；如果点击 Connect 后 Claude Code 未检测到登录状态，请从 Blueprint Studio 标签页复制链接并粘贴到 Claude Code，或者再次运行 /mcp → plugin:blueprint-studio:asset-generator → Authenticate。

Claude Code 会要求你批准 Blueprint Studio 的每个步骤。若要一次性允许所有步骤，请运行 /permissions 并添加允许规则 mcp__plugin_blueprint-studio_asset-generator（该规则仅涵盖此插件的工具，包括删除操作）；你可以随时在该处移除它。

要预览本地分支，请使用 --plugin-dir /absolute/path/to/this/repo 启动 Claude Code。如果插件已提供 asset-generator，请勿再添加单独的 MCP 连接。

Codex 从同一市场安装相同的插件：

codex plugin marketplace add https://github.com/Blueprint-Studio-AI/claude-code-marketplace.git
codex plugin add blueprint-studio@blueprint-studio-marketplace

或者运行以下单行命令，同时完成登录：

codex plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace && codex plugin add blueprint-studio@blueprint-studio-marketplace && codex mcp login asset-generator

浏览器会打开，你可以在 Blueprint Studio 窗口中点击 Connect。然后启动新的 Codex 会话。只想使用工具而不安装插件？请改为运行 codex mcp add blueprint-studio --url https://tools.blueprintstudio.ai/api/mcp。请二选一，不要同时使用。

更新

这些工具来自托管服务，因此始终保持最新。技能会随插件一起更新。插件有新版本时，get_workspace_context 会在每个会话中提示一次（pluginUpdate），并告知你的 Agent 如何更新。

Claude Code：运行 /plugin，打开 Installed，选择 blueprint-studio，然后选择 Update now，接着运行 /reload-plugins。也可以在终端中运行：

claude plugin update blueprint-studio@blueprint-studio-marketplace

若要自动获取新版本，请运行 /plugin，打开 Marketplaces，选择 blueprint-studio-marketplace 并启用自动更新。如果你是从 Claude 的 Directory 添加 Blueprint Studio，Claude Code 会在启动时更新它；前提是 Directory 已提供新版本。

Codex：

codex plugin marketplace upgrade blueprint-studio-marketplace

然后启动新的 Codex 会话。

第一张图片

在 Claude Code 中运行 /blueprint-studio:start（或询问 Blueprint Studio Asset Generator 能做什么）。它会读取账户信息，介绍 Asset Generator 的功能和实际可用的免费额度，提供三个入门选项，然后根据你的选择生成图片，将图片保存到项目中，并在 Asset Generator 中添加链接。无需品牌或设置。

或者在任意宿主应用中直接提出请求：

使用 Blueprint Studio Asset Generator 为我的网站制作一张主视觉图片：一家舒适的社区咖啡馆，日出时分，暖色光线，16:9

然后，为了让之后生成的图片符合你的品牌风格，可以这样说：

根据 mywebsite.com 为我设置品牌，让我的图片符合品牌风格

该服务还通过 MCP 提示词提供这些入门选项：first_image、brand_from_website、app_icon 和 social_post。在 Claude Code 中，它们会显示为斜杠命令，例如使用此插件时的 /mcp__plugin_blueprint-studio_asset-generator__first_image。Claude Code 只会传递提示词参数的第一个词，因此图片入门选项会要求提供一行文本，而不是接收一个词；brand_from_website 接收一个网站。Codex 不会显示 MCP 提示词；其插件卡片提供相同的入门选项（defaultPrompt）。

使用其他 AI 应用？按照连接你的 AI中的步骤，将它连接到 https://tools.blueprintstudio.ai/api/mcp。如果没有此插件，get_guide 会为你的 Agent 提供与操作指南相同的技能。支持技能的应用也可以使用 skills/。

在应用提示时登录。一个连接即可访问你的个人库，以及你所属的所有品牌。先使用 get_workspace_context：它会返回你的套餐、剩余额度、默认图片的费用、品牌及其指南、你的角色权限，以及新账户的入门计划。无需品牌；省略 brandId 即可使用个人库。如果你恰好只有一个品牌，除非你要求使用个人库，否则 Agent 会在该品牌中工作；如果有多个品牌，它会在每次调用时传入你指定品牌的 brandId。安装插件不会将你加入品牌，因此请先接受品牌邀请。如果旧连接只能看到一个品牌，请在 Settings 中断开连接，然后重新连接。API 密钥仅用于脚本和自动化，Pro 和 Max 套餐才提供（所有套餐均可登录）；你不需要 OpenAI 或 Google 密钥，也不要将密钥放入项目文件中。

技能

每项技能都基于一条规则，这些规则根据我们自己的服务、已遇到的失败情况及其限制制定。start 会引导你使用其他技能。

技能	用途	规则
start	首次运行：了解 Asset Generator 的功能、你的实际余额、三个入门示例，以及生成第一张图片	最多只问一个问题，然后开始制作
asset-generator	生成一张图片，将其检查并保存到项目中；编辑已保存的图片	编辑时基于已保存的图片，只做一项更改，绝不重新编写提示词
asset-sets	批量生成多张风格匹配的图片：图标集、系列图，或多个尺寸的单次活动素材	N 张图片只需等待一次，而不是等待 N 次
brand-setup	根据你的网站或几张图片保存品牌信息，并设置 Style 和品牌标志	只保存你批准的内容
official-logos	查找、添加、标注和放置你的官方品牌标志	按提供的原样使用品牌标志，绝不重新绘制
styles	创建、测试并保留可复用的 Style	只有在某个 Style 通过三个不同的任务简述测试后才保留

每个技能文件夹都包含一个简短的 SKILL.md、用于深入了解的 references/，以及带有试用提示词和预期行为的 evals/evals.json。未安装插件的应用可从服务获取相同文本：调用 get_guide，并将 topic 设为 start、assets（asset-generator）、asset_set（asset-sets）、brand（brand-setup）、logos（official-logos）、styles 或 contract（任务和恢复）。安装了插件后，你已可使用这些内容。

在 2.11.0 之前，插件包含 brand-manager 和 style-gym 技能，以及两个 Claude Code Agent：asset-creator 和 style-evaluator。这些内容现已整合到 brand-setup、styles 和 asset-sets 及其参考资料中。

建议向现有项目 Agent 交接：

使用 Blueprint Studio Asset Generator 处理此项目的品牌背景和素材。从 list_brands 中选择目标品牌，并在每次调用时传入其 brandId。检查可用的 Style，以及发现的品牌指南和官方素材。继续处理现有的任务简述。直接使用工具或调整可选工作流；将所选素材、收据、Style ID，以及任何尚未解决的任务或请求 ID 与工作一并保存，以便其他会话继续处理。

项目 .blueprint.json 可设置本地偏好。它不是授权机制。请勿将实时品牌文件复制到此插件中来个性化安装。

插件连接的内容

该插件没有钩子或本地程序。它会添加一个远程 MCP 服务，即 Blueprint Studio 托管于 https://tools.blueprintstudio.ai/api/mcp 的服务，你可以通过 OAuth 登录。因此，服务可以告知你有较新版本的插件，而插件会告知服务自身的版本。在 Codex 中，每个请求都会携带一个 X-Blueprint-Plugin 标头，其中包含插件名称和版本（例如 blueprint-studio/2.10.2）。在 Claude Code 中，连接不会发送额外标头；相反，start 和 asset-generator 技能会要求你的 Agent 在调用 get_workspace_context 时传入版本作为 pluginVersion。这两种方式都不会传递其他内容。当你的 Agent 调用工具时，该工具所需的信息会发送到服务：你的提示词和设置、品牌详情，以及你作为输入提供的任何图片、文件或链接。图片由 AI 模型提供商生成，并保存到你的 Blueprint Studio 资源库中。品牌设置会在你提出请求时读取你指定的网站，且只读取一次。如果可以访问 Shell，技能还会使用 curl 执行两项操作：从服务返回的 downloadUrl 保存已完成的图片；以及通过 create_upload_link 返回的一次性上传链接发送本地文件。这两个链接都指向 Blueprint Studio 自己的文件存储（托管于 Supabase）。请参阅隐私政策。

维护者

请参阅分发与发布说明。

许可证

此公开插件包采用 MIT 许可。此许可不涵盖 Blueprint Studio 单独托管的后端、私有样式说明或客户端材料。已发布的 MCP Registry 元数据根据 Registry 条款 单独以 CC0 许可发布。