用 Claude Code 等 AI 应用做 Rust 地图：连接 Crucible

简短回答： 打开 Crucible 启动器里的 智能体，再打开连接，在你的 AI 应用旁边按连接，然后重启它，或在其中开始一个新聊天。对于任何其他运行 MCP 服务器的应用，复制配置 会复制出一段配置块供你粘贴进去。无法撤销的改动会等你在活动里点允许。

Crucible 启动器里的 智能体 标签页有三个部分：

本地智能体（另见与本地智能体聊天），一个运行在你自己电脑上的小型 AI，回答关于 Crucible、Rust 地图和本地服务器的问题。它也能替你做一些简单的事，比如打开应用或启动服务器。
活动，列出 AI 在 Crucible 里做过的一切，其中有等你点头的卡片。
连接，在这里挂接你已经在用的 AI 应用（Claude Code、Codex、Cursor 等），让它能替你在 Crucible 里工作：打开和更新你的应用，在 Crucible Heightmap 里构建并导出 Rust 地图，并在 Crucible Local Server 里运行本地 Rust 测试服务器。

应用窗口一直留在你的屏幕上，所以你能看着 AI 工作。

本地智能体

本地智能体是免费的，完全运行在你的电脑上。在你要求之前不会安装任何东西。

选择模型

打开 智能体，再打开 本地智能体。第一个界面显示你的显卡、它的显存（VRAM）和你电脑的 RAM，以及本地智能体能运行的三个模型，都出自 Qwen 团队：

模型	回答	下载	显存
标准（Qwen3.5-2B）	最快	约 1.2 GB	约 2.0 GB，或在处理器上运行
更智能（Qwen3.5-4B）	更好，错误更少	约 3.8 GB	约 3.6 GB，仅限显卡
最佳（Qwen3.5-9B）	最好，又慢一些	约 6.5 GB	约 5.9 GB，仅限显卡

有一个模型会为你的显卡标上推荐（在模型菜单里是一颗星）。为 Rust 和游戏内视图留出显卡空间（一开始是开启的）决定是哪一个：

开启会建议一个让显卡大部分空闲的模型，让 Rust 或 Heightmap 的游戏内视图在它旁边运行得更流畅。
关闭会建议你的显卡能容纳的最大的模型。

选任何你的显卡放得下的模型，然后按安装。更智能和最佳会连同标准一起安装，当 Rust 或游戏内视图让显卡没有空间时，由标准来回答；上面的大小已经包含了它。如果下载中断，继续安装 会从中断的地方接着来。

然后按加载把模型放进内存，再问你的问题。

它知道什么，会做什么

它知道 Crucible 如何工作，以及每个滑块和按钮做什么。它用到的页面的链接会显示在每个回答下面。

它也了解 Rust 本身，和 Rust 游戏参考一样：控制台命令、服务器变量、带 shortname 的物品、堆叠大小和制作配方、prefab 路径，以及 Oxide 和 Carbon 插件的基础，并随每次 Rust 更新保持最新。问它“关闭腐朽的命令是什么”或者“大型木箱的 prefab 是什么”。

当文档没有涵盖某个问题时，比如抄家成本或最新的 Rust 更新加了什么，它会说它不知道，而不是瞎猜，并把你指向知道的地方：Crucible 的 Discord、RustHelp、Facepunch 的更新新闻，或者一次快速的 Google 或 YouTube 搜索。

它也帮你处理购买和账单（结账、折扣码、切换方案、取消、发票），以及让朋友加入你的服务器（playit.gg、端口转发）。它解释这些步骤并把位置指给你看；花钱或更改你订阅或许可证的按钮始终由你自己来按。

你用平常的话要求时，它能在每个 Crucible 应用里做事：

启动器： 打开、关闭、安装、更新或卸载 Crucible Heightmap 或 Crucible Local Server，更改启动器的设置（语言、开机启动、托盘、自动更新、减少动效），检查更新，为支持保存你的日志，清理临时文件，并保存或安装免费下载（它可以把一个免费插件直接放到 Carbon 或 Oxide 服务器上）。
Crucible Heightmap： 制作新地图，更改滑块和地图大小，撤销和重做，保存和打开项目与种子，构建 worldgen，编辑岛屿、坡道和通道切口，绘制，以及导出，带导出的任意文件。
Crucible Local Server： 设置、启动、停止和重启服务器，更改它们的设置，运行控制台命令并读取控制台（例如查看服务器为什么停了），查看谁在线，制作备份，wipe，以及管理插件和地图。
它自己： 它的语音、朗读回答、免提、记忆和模型、行动前询问，以及你的聊天。

它会直接做这些；想让它先展示计划并等你点允许，见它会先问我什么。

它还能完成几项一次请求就要多个步骤的工作：

设置服务器：描述它（“一个 4k 的 PvE 服务器，10 人，带 Oxide，名叫 Test”），它就会创建服务器，设置它的地图（带你给的大小和种子的程序化地图，或你最新的 Heightmap 导出），应用你说到的设置，下载服务器文件并启动它。说“让我成为管理员”，这台电脑上登录的 Steam 账号就会成为服务器的 owner；说“服务器起来之后加入它”，它会等世界加载完成，启动 Rust 并加入，然后在聊天里告诉你（开着语音时也会大声说出来）。它等待期间你可以继续使用启动器。
把地图放到服务器上：把你最新的 Heightmap 导出放到一个服务器上并启动它，如果你要求，等它起来后加入。
服务器设置：更改服务器的玩家数、PvE、游戏模式、名称或描述。

每一项都只填入你说到的内容：你没给的名称、大小或种子绝不会被编造。它需要的应用如果是关着的，会先打开。对于大型工作，比如一步一步构建整张地图或精细的绘制，它会尽力而为，并在你在连接里连接的 AI 应用，比如 Claude Code 或 Codex，能做得更好时告诉你。如果 Crucible Heightmap 或 Crucible Local Server 比本地智能体能配合的版本更旧，它会说出来：关闭应用，在应用里对它按更新，然后再次打开它。

当答案是一个位置时，它一边解释一边展示给你看：问在哪里取消订阅，启动器就切换到账户；问附加内容，它就打开商店 > 附加内容；问保存给客服在哪里，它就指向设置里的那一行。它用同样的方式展示 Heightmap 的面板和视图，以及 Local Server 的标签页。

语音

本地智能体可以在写出回答的同时把它朗读出来，你也可以和它说话而不用打字。语音随安装一起提供（多约 0.5 GB）。

聊天上方那一栏里的语音，打开或关闭 朗读回答，并选择十种声音之一（选一个会播放示例）、音量、速度和 麦克风。发送消息、切换聊天或按暂停按钮都会打断朗读。
发送旁边的 麦克风按钮：按下并说话，然后再按一次，或者直接停止说话。你的话会落进输入框，所以你可以在发送前检查它们。
语音菜单里的免提：本地智能体听“Hey”加上你选的声音的名字（“Hey Luna”），然后照你说的做，并把回答朗读出来，不用按任何按钮。听到名字时，会响起一声短促的提示音，麦克风按钮变红。可以一口气说完（“Hey Luna，启动我的服务器”），或者先说名字，等提示音，再说其余的。“Hey Luna，停” 会让它停止说话。启动器最小化或在游戏后面时，它也会继续听。免提开启时，麦克风按钮会让麦克风静音和取消静音。

如果麦克风按钮没反应，可能是 Windows 在阻止麦克风：在 Windows 设置 > 隐私和安全性 > 麦克风里，打开 麦克风访问权限 和 允许桌面应用访问你的麦克风。中文回答不会被朗读。

显卡还是处理器

你按加载时，本地智能体在显卡有空间时运行在显卡上，那是最快的，没有空间时就运行在你的处理器上。弹出旁边的标签显示它在用哪一个。

按钮下面的条会实时显示你的电脑正在使用多少显存（VRAM）和 RAM，本地智能体自己的那一份用青柠色标出，这个聊天的 上下文 有多满，以及它写得多快（每秒 token 数）。

模型：以后再切换

模型随时在标准、更智能和最佳之间切换；你的聊天会延续。每一行显示那个模型在你电脑上占多少空间，一颗星标出为你的显卡推荐的那个。

还不在你电脑上的模型 显示一个下载标记。选它会带回设置界面，显示一条进度条直到下载完，然后聊天回来。
更智能或最佳旁边的 垃圾桶图标 会把那个模型从你的电脑上移除并释放它的空间。标准保留，再次选择该模型会把它重新下载回来。

更智能和最佳只在显卡上运行。当显卡没有空间容纳你选的那个时，例如游戏内视图开着的时候，会由一个更小的模型来回答，模型按钮会变成金色来提示这一点；关掉一些占资源的东西，然后按弹出和加载。

记忆：它在心里保留一个聊天的多少内容

记忆设置本地智能体一次在心里保留一个聊天的多少内容：

设置	保留在心里的量	显存：标准	更智能	最佳
自动（默认）	按你的电脑设定	约 2.0 GB	3.6 GB	5.9 GB
短	8k token	约 1.9 GB	3.4 GB	5.6 GB
中	16k token	约 2.0 GB	3.6 GB	5.9 GB
长	32k token	约 2.1 GB	4.2 GB	6.4 GB
最长	64k token	约 2.5 GB	5.2 GB	7.4 GB

更多让它能跟上更长的聊天和更长的多步骤工作。当聊天满了，最旧的消息会从模型的记忆里掉出去，但绝不会从聊天本身里消失。

聊天

新聊天 开始一段新的。聊天本月内按周分组，更早的按月分组。点击一个分组打开或关闭它，垃圾桶图标删除单个聊天或整个分组。

Rust 与本地智能体

Rust 和本地智能体共用你的显卡和内存。如果你按加载时 Rust 是打开的，或者模型已加载时 Rust 启动了，启动器会来到前面，并建议你聊天期间关闭 Rust。弹出会把所有内存还回去。

弹出、更新、移除

弹出卸载模型。你的聊天会保留。
发布了较新的本地智能体时会出现更新。
聊天列表底部的 移除本地智能体，会把本地智能体从你的电脑上移除。你的聊天会保留，第一个界面会回来，让你可以再次选择模型。

怎么连接 AI 应用？

打开 智能体，再打开连接。启动器会列出它在你电脑上找到的 AI 应用：

连接把 Crucible 加到那个应用里。重启那个 AI 应用，或在其中开始一个新聊天，让它加载 Crucible。
撤销把 Crucible 再取出来。
当某个应用指向已经移动过的 Crucible 安装时会显示修复；它会让它指向现在这一个。
不在这台电脑上 表示这个应用没有安装。

列表涵盖 Claude Code、Claude Desktop、Cursor、VS Code、Codex、Antigravity、Windsurf、Gemini CLI 和 LM Studio。这些是运行在你电脑上的 AI 应用（在终端、编辑器或桌面应用里）；浏览器里的聊天网站无法访问你电脑上的应用。

另一个 AI 应用 适用于任何运行本地 MCP 服务器的应用，包括还不存在的那些。复制配置 会复制标准的 MCP 配置块：

{
  "mcpServers": {
    "crucible": {
      "command": "<the Crucible program on your PC>",
      "args": ["--mcp"]
    }
  }
}

把它粘贴到那个应用的 MCP 设置里，或者把它粘贴给 AI 智能体本身，让它把 Crucible 加进去。复制出来的配置块里已经带着适合你电脑的正确路径。

你不需要先打开启动器。

连接的 AI 应用在 Crucible 里能做什么？

启动器： 查看已安装和正在运行的内容，安装、更新、打开和卸载应用，检查你电脑的空闲内存，搜索这些文档，给你展示任何标签页或页面，更改启动器的设置（语言、开机启动、托盘、自动更新、减少动效），检查更新，为支持保存你的日志，清理临时文件，读取你的方案和续订日期，更改本地智能体的设置，并保存免费的插件、预制件、地图和指南（由你选文件夹），或把一个免费插件直接放到 Carbon 或 Oxide 服务器上。
Crucible Heightmap（打开着，并带有涵盖它的许可证）：按屏幕上的名称读取和更改任何设置，conjure 一张新地图，处理岛屿，运行 worldgen 并更改它的设置（生物群系和层级占比、旋转、悬崖、湖泊、熔岩、topology），添加坡道和通道，绘制，设置每一种画笔，按高度和坡度绘制地面，更改 Conjure 掷出的内容，视图的叠加层和一天中的时间，以及应用自己的设置，把你 imports 文件夹里的一张图片变成岛屿，使用你保存的岛屿形状，为地图或游戏内视图截图，保存、打开、重命名和删除项目，处理保存的种子（收藏、标签、导入），并通过你用的同一个导出面板导出，包括一次导出多个已保存的项目。
Crucible Local Server（打开着）：创建、重命名、复制和删除服务器，下载和管理它们的服务器文件，更改设置和线上规则，设置每日重启，启动、停止和重启它们，按快速视图的按钮，运行控制台命令并读取控制台，列出玩家，处理地图和存档，搜索并管理插件及其配置文件，制作备份和 wipe，读写服务器的笔记，浏览它的文件，更改应用自己的设置，以及启动 Rust 来加入。

Heightmap 里的地图位置是按地图图片给出的：从左到右、从上到下，北在顶部，就是你看到的样子。

它会先问我什么

任何无法撤销的事都会等你。智能体 > 活动里会出现一张卡片（对本地智能体自己的请求，则出现在它的聊天旁边），启动器来到前面，AI 等着，直到你按允许或拒绝。拒绝会告诉它你说了不。这涵盖其中的这些：

替换一张有未保存改动的 Heightmap 地图，以及删除项目、已保存的种子或已保存的形状，
清除 Heightmap 里所有手绘的地面，
卸载应用，
删除服务器、地图、存档、世界或笔记页面，以及移除服务器文件，
wipe、恢复备份和删除备份，
从链接或文件安装插件（那是别人的代码在你的服务器里运行）、删除插件，以及更改插件的配置文件，
替换 server.cfg 或启动参数，或者把服务器恢复到它的预设，
清除 Crucible Local Server 保存的文件，
会改变服务器的控制台命令（status 这样的读取命令会直接运行），
在服务器运行时关闭应用，
本地智能体在服务器运行时关闭 Crucible Local Server，
本地智能体卸载应用或删除聊天。

本地智能体会直接启动、停止和设置服务器。想让它先在一张卡片里展示它的计划并等允许，就按活动里的 本地智能体直接执行，不再询问，让它变成 本地智能体执行前先询问。wipe、删除和任何会丢掉未保存工作的操作总是会询问。

本次会话全部允许 会让连接的 AI 应用的改动不经卡片就通过，直到启动器关闭。它永远不会被保存，也不改变本地智能体。

它绝对做不了什么？

购买任何东西、更改你的订阅或看到你的许可证密钥。 购买、方案更改、取消和许可证都留在启动器的商店和账户标签页里，在那里由你来按按钮。
读取密码。 你的服务器的 RCON 密码对 AI 应用保持隐藏。
开始你的电脑没有空间容纳的步骤。 当你的电脑为某个步骤缺少内存时，Crucible 会说明是什么在占用它，让你决定关掉什么。

怎么让它停下来？

智能体标签页右侧的停止，会拒绝 AI 应用和本地智能体要求做的一切，直到你按恢复，并且在启动器重启后依然有效。已经在运行的下载会完成，所以不会有应用停在更新到一半。想在回答中途让本地智能体停下，按发送原来所在位置的暂停按钮。

活动列出每个请求：是哪个 AI 提出的、它要求了什么，以及结果如何。

我的数据会被分享吗？

本地智能体运行在你的电脑上。你的聊天留在你的电脑上，你输入或说的任何东西都不会被发送到别处。

连接的 AI 应用只会得到 Crucible 在你电脑上给出的回答，别无其他。那个应用怎样处理它们（地图图片、设置、服务器状态），遵循那个应用自己的政策，和你给它看的其他任何东西一样。它永远得不到你的许可证密钥或你的密码。

在哪里查看发生了什么？

设置里的 保存给客服 包含 AI 应用做过的事，供你需要帮助时用。同一个设置标签页里的 打开文件夹 会显示 Crucible 在你电脑上的位置。