/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
1. 先搞清楚 Codex、SketchUp 和 MCP 插件到底是什么关系
如果你看到“Codex+SketchUp 实时建模 MCP 插件”这个组合，第一反应可能是“这到底是个什么工具？”。简单来说，这是一个能让 SketchUp 这个三维建模软件，通过 MCP（Model Context Protocol）协议 ，与 Codex 这类 AI 代码生成模型进行实时交互的插件。它的核心价值在于， 让你能用自然语言描述想法，直接驱动 SketchUp 完成建模操作 ，而不是手动去点每一个按钮、画每一条线。
这听起来很酷，但别急着兴奋。在动手安装之前，最关键的是理解这三者的角色和依赖关系，否则环境配置会变成一团乱麻。
- SketchUp ：这是你的“画布”和最终操作执行者。你需要一个正常运行的 SketchUp（通常是桌面版）。
- Codex ：这里通常指的是 OpenAI 的 Codex 模型或其类似物（如 GitHub Copilot 背后的模型），它是一个能理解自然语言并生成代码（特别是 Python、JavaScript 等）的 AI。 它不直接和 SketchUp 对话 。
- MCP 插件 ：这才是连接两者的“桥梁”或“翻译官”。它可能是一个运行在 SketchUp 里的 Ruby 插件，或者一个独立的本地服务。它的工作是：
- 接收你在 SketchUp 里或用其他方式输入的自然语言指令（如“画一个长5米、宽3米、高2.7米的盒子”）。
- 通过 MCP 协议，将指令发送给一个 MCP 服务器 。
- MCP 服务器再调用 Codex（或类似模型）的 API，将指令转换成 SketchUp 能执行的 Ruby 脚本或 API 命令。
- 最后，插件将生成的脚本送回 SketchUp 执行，完成建模。
所以，整个流程的链条是： 你的指令 -> SketchUp 插件 -> MCP 服务器 -> Codex API -> 生成代码 -> MCP 服务器 -> SketchUp 插件 -> SketchUp 执行 。环境配置的核心，就是让这条链路上的每一个环节都能正确安装、启动并相互通信。
对于想尝试 AI 辅助建模的设计师、建筑师或爱好者来说，这个方案最吸引人的点是 创意快速可视化 。你不用先精通复杂的 SketchUp Ruby API，就能把想法快速变成三维模型。但它的“坑”也在于此：它不是一个开箱即用的傻瓜软件，而是一个需要串联多个技术组件的“工作流”，任何一个环节出错，整个流程就断了。
2. 环境配置清单：从零开始的完整依赖梳理
在点击任何安装包之前，先对照这个清单，把你的系统环境准备好。很多后续的报错，根源都出在缺失或版本不对的前置依赖上。
2.1 核心软件准备
SketchUp 桌面版 ：
- 版本 ：建议使用较新的 SketchUp Pro 版本（如 2022, 2023, 2024）。某些插件可能对最新版支持最好，也可能对旧版更稳定，需要查看具体插件的说明。 不要使用 SketchUp Free (Web 版) ，因为它通常不支持复杂的本地 Ruby 插件扩展。
- 获取 ：从 SketchUp 官网下载试用版或购买正式版。确保安装完成后能正常打开并创建一个新模型。
- 权限 ：在 Windows 上，建议不要安装在 C:\\Program Files\\ 这类需要管理员权限的目录下，或者确保你后续安装插件时有足够的写入权限，避免因权限问题导致插件安装失败。
Ruby 环境 ：
- SketchUp 内置了 Ruby 解释器，这是其插件系统的基础。你通常 不需要单独安装系统级的 Ruby 。但是，你需要确认 SketchUp 自带的 Ruby 版本，因为某些 MCP 插件依赖的 Gem（Ruby 的包）可能需要特定版本。
- 如何查看 ：在 SketchUp 中，点击菜单栏 窗口 (Window) -> Ruby 控制台 (Ruby Console) 。在弹出的控制台中输入 RUBY_VERSION 并回车，即可看到版本号（如 2.7.4 ）。
- 关键点 ：记住这个版本号。如果你后续需要通过命令行 gem install 为 SketchUp 的 Ruby 安装额外依赖，你需要确保使用的是 SketchUp 自带的 Ruby，而不是系统可能存在的另一个 Ruby。这通常需要配置环境变量或使用绝对路径。
