AI 与智能辅助

BlockWerk 配备了功能强大的 AI 助手，能够协助您构建、分析以及排查仿真图中的问题。默认情况下，应用使用内置代理提供基础 AI 功能。为了获得最优质、最快速且最注重隐私的体验，我们建议您自带 AI 提供商（"Bring Your Own AI"）。

为什么要自带 AI（BYOAI）？

完全掌控：在直接 AI 交互、Web AI（ChatGPT/Claude）以及外部 MCP 工具之间无缝切换。
隐私保护：使用自备密钥（BYOK）或本地模型时，数据直接从浏览器发送至 AI 提供商，无任何中间服务器参与。
更强模型：直接调用 Gemini 1.5 Pro、GPT-4o 或 Claude 3.5 Sonnet 等业界顶尖模型。

桥接选择器（Bridge Selector）：选择您的工作流

在 AI 助手面板顶部，您会看到 Bridge Selector。它决定了 BlockWerk 与 AI 模型的交互方式：

1. Direct AI（推荐）

AI 直接与仿真引擎交互，这是构建或修改仿真模型最快捷的方式。

Proxy Mode：使用我们的免费 Gemini 代理（无需额外配置）。
BYOK Mode：添加您自己的 API 密钥以获得极速响应和最高隐私。

2. Web AI（蓝图模式 Blueprint Mode）

如果您更习惯使用 ChatGPT、Claude.ai 或 Gemini 的网页端界面：

点击 Copy Context for Web AI，当前仿真图的全部上下文信息将被复制到剪贴板。
将其粘贴到 AI 对话框中，并提出您的修改需求。
如果 AI 返回了 JSON 代码块，复制该代码块并粘贴到 Web AI 标签页中，然后点击 Apply Blueprint。

3. AI Bridge（MCP）

让外部 AI 驱动当前画布——无论是 ChatGPT、Claude.ai、Mistral 等网页对话，还是 Claude Desktop、Cursor 等桌面端工具。

在 AI 面板中点击 Connect AI。
选择 AI 的运行位置：In a web chat（网页对话）或 On my computer（本地电脑）。
点击 Copy link（网页对话）或 Copy config（桌面端）。点击的同时也会立即建立连接——无需单独的启动按钮。
进行粘贴配置：

- 网页端：作为自定义/远程 MCP 连接器添加。在 claude.ai 中位于设置 → Connectors → Add custom connector；OAuth 字段保持为空即可。

- 桌面端：粘贴到面板提示的配置文件中，然后重启对应的工具。

面板将显示 "Waiting for your AI to connect…"，首条指令到达时会自动切换并列出最近的调用记录。

重要注意事项：

连接绑定于当前浏览器标签页。关闭该标签页连接即失效；在新标签页中需重新连接（或点击 "Already set up? Open the connection"）。
链接中包含 Device Token（设备令牌），只要当前标签页保持打开状态，该令牌就拥有画布的访问权限。切勿公开分享或在截图展示。若发生泄露，点击 Copy 旁边的 ⟳ 按钮即可作废旧令牌并生成新令牌。
Advanced 下方的 Session ID 并非配对码，而是当前标签页的端到端加密密钥。切勿将其粘贴至对话中；配对始终通过上述链接完成。
破坏性操作（如清空画布、删除模块）会首先在当前标签页中弹出确认提示，AI 将等待您的确认后再执行。

获取免费的 Gemini API 密钥（推荐）

Google Gemini 目前通过 Google AI Studio 为开发者提供极其慷慨的免费调用额度，非常适合搭配 BlockWerk 使用。

访问 Google AI Studio API Key 页面。
使用您的 Google 账号登录。
点击 Create API key。
复制生成的密钥。
在 BlockWerk 中，前往 设置 > AI 与智能辅助。
选择 Gemini 作为提供商并粘贴您的密钥。

本地运行 AI（完全私密且免费）

如果您的电脑配置充足，可以在本地运行 AI 模型，100% 私密且完全免费。

使用 Ollama

下载并安装 Ollama。
在终端中运行模型：ollama run llama3（或 mistral、gemma）。
在 BlockWerk 中选择 Ollama 作为提供商。
确保 Custom URL 设置为 http://localhost:11434。

使用 LM Studio

下载并安装 LM Studio。
下载所需模型并启动 Local Server。
在 BlockWerk 中选择 LM Studio。
将 Custom URL 设置为 http://localhost:1234。

其他免费提供商（BYOAI）

除 Gemini 外，您还可以使用其他提供开发者免费额度的服务商。

Groq（超高推理速度与 Llama 3）

前往 Groq Cloud Console。
创建免费 API 密钥。
在 BlockWerk 中选择 Groq。
输入您的密钥并指定模型 ID（例如 llama3-70b-8192）。

OpenRouter（聚合全模型访问）

OpenRouter 为数百种 AI 模型提供统一的 API 接口，其中包括许多免费模型。

前往 OpenRouter。
创建 API 密钥。
在 BlockWerk 中选择 OpenRouter 并输入密钥。
填写模型 ID（例如 google/gemini-pro-1.5 或 meta-llama/llama-3-8b-instruct:free）。

Hugging Face（Serverless 推理）

Hugging Face 通过其 Serverless API 免费提供海量开源模型。

前往您的 Hugging Face 设置。
创建一个 Access Token（读取权限 / read）。
在 BlockWerk 中选择 Hugging Face 并粘贴令牌。
输入您想要调用的模型 ID（例如 mistralai/Mistral-7B-v0.1）。

故障排查

CORS 跨域错误：某些本地环境可能会阻止来自浏览器的请求。对于 Ollama，在启动服务前可能需要设置环境变量 OLLAMA_ORIGINS="*"。
密钥无效：请检查粘贴 API 密钥时是否带有首尾多余空格。
未找到模型：如果使用本地模型，请确认模型已成功加载且本地服务处于运行状态。

另请参阅

AIAssistant：学习如何使用 AI 助手高效构建系统模型图。
快捷键：使用快捷键 Ctrl+Shift+A 快速打开 AI 面板。