工具与全局设置¶
这里介绍PrintHaus的通用工具、视图操作和设置。
操作和图标提示¶
应用内隐藏所有滚动条。可使用鼠标滚轮、触控板、触摸操作或键盘滚动。
在窄窗口中，只有当下方能完整容纳可见性面板时，页眉和操作栏才会固定。高度不足时，两者都会随内容一起滚动。
将鼠标指针在图标上稍作停留，即可阅读工具提示。使用 Tab 键导航时，获得焦点的控件会立即显示帮助。按 Escape 键可隐藏提示。帮助文字使用当前所选语言。
使用统一的数值控件设置尺寸：减号和加号逐步调整数值，蓝色滑块在允许范围内移动数值。Bomb Blast 的尺寸和角度也采用相同操作。灰显的控件在当前状态下不可用。
参数面板中的控件按功能分组。点击组标题即可展开设置。打开另一组时，之前的组会自动折叠。已设置的数值和尚未应用的修改都会保留。
尺寸对话框和绘图工具的小数输入框支持句点或逗号作为小数分隔符。整个输入必须是有效数字；含有额外字符或多个分隔符时，不会只采用其中的部分数字。绘制自由平面图、平行偏移轮廓或内墙时，先用指针确定方向或偏移侧，再输入尺寸并按 Enter 确认。移入数字输入框后方向仍会保留。长度和偏移距离必须大于零。
3D 预览¶
预览始终可见——它显示每一步得到的模型。用鼠标可以旋转、平移和缩放（轨道控制）。预览的左上角是 视图立方：点击它的某个面即可跳到一个固定视角——右 · 左 · 后 · 前 · 上 · 下。
可用窗口高度减少时，Archie 保持在底部。主面板的间距与选择图标最多缩减百分之十，不扭曲文字或图纸。空间仍不足时，较长内容仍可滚动。
可见性¶
点击X-Ray前的色块可打开背景色板。“默认”保留原来的深色背景。选择颜色后会隐藏周围环境，并在此浏览器中保存选择。
在可见性面板中，直接点击灯泡即可显示或隐藏一组部件。灯泡亮起表示可见，熄灭表示隐藏。此操作只影响预览。
在剖面、楼层和构件之间切换时，可见性面板保持相同高度。项目较多时，可在行内水平滚动。其余空间留给3D预览。
显示与剖面¶
| 开关 | 作用 |
|---|---|
| X-Ray（透视） | 将墙体显示为半透明。默认关闭，在室内外构件步骤以及附加功能中启用 Bomb Blast 时自动开启。手动点击一次后，将保留你的选择。 |
| 环境 | 显示或隐藏地面/天空环境（默认关）。 |
光源固定在观察者的左上方。旋转建筑时，立面上的投影会变化。X-Ray模式不显示阴影。
在剖面中，每个图标都显示原点的三个轴，对应的剖切轴以黄色突出显示。X和Y进行竖直剖切，Z进行水平剖切。减号、加号和滑块用于移动剖面位置。X和Y旁的按钮用于切换移除的一侧。剖切面保持敞开；地面和天空不参与剖切。
分组与构件¶
- 楼层——首层、楼上 1 层、楼上 2 层……以及屋顶可分别切换。如果你的建筑带有 附属体，则每个附属体都有自己的开关（"附属体 1"、"附属体 2" ……）；它连同 该形体的窗户、门和屋顶一起切换。
- 构件——跨楼层，例如外墙、内墙、楼板、门窗、地板、楼梯、栏杆、阳台、露台、立柱、雨棚。
只有当某个构件或形体在模型中确实存在时，其开关才会出现。
附属体屋顶受两个开关控制
附属体的屋顶既会随它所属的附属体消失，也会随屋顶开关消失——隐藏"屋顶"时，所有屋顶 都会消失，附属体的也不例外。
只影响显示
隐藏不会改变你的模型。导出时你可以另行决定是否只输出可见的部分——见 导出。
颜色¶
可见性 → 颜色在主面板内打开颜色对话框，同时保留3D预览。顶部选择主楼或已有的附楼。墙体、楼板、屋顶、构件和洞口显示可用的颜色组。墙体和楼板可以统一或分别着色。洞口分为窗、门和通道，并包含已设置的细部。屋顶露台地面和栏杆分别着色，连续腰线沿用墙体腰线的颜色。放弃恢复原有颜色，应用保存方案。
点击中央颜色对话框中的色点，会在左侧原有的可见性面板中打开调色板。颜色只在此处选择，部件编辑器不再提供独立色点。标签包括历史色、标准色，以及按字母顺序排列的厂商：Anycubic、Bambu Lab、Creality、ELEGOO、eSUN、HATCHBOX、OVERTURE、Polymaker、Prusament 和 SUNLU。每个厂商的普通与哑光纯色 PLA 合并后按颜色排序；不包含 PETG、渐变或特效耗材。可按产品系列筛选。提示气泡显示耗材、颜色名称、十六进制色码、表面类型、地区和颜色来源。
小方形色块铺满面板宽度。面板高度固定，至少可容纳五行，更多颜色在调色板内部滚动。颜色预览和十六进制输入框位于标题栏中 X 的右侧。选择结果仍是部件颜色草稿中的十六进制颜色，并不会选择切片软件耗材、打印机配置或 AMS 槽位。普通和哑光选项通过色块外观区分。自动装饰色会与墙色区分，例如白墙搭配灰色装饰；明确指定的细节颜色保持不变。
所选楼层的部件¶
右侧列表显示位于所选楼层或穿过该楼层的部件，不受当前放置工具的限制。因此，从底层开始的烟囱在上方楼层也可以选中。
在屋顶选项卡中，列表包含整个屋顶区域的部件，包括凸窗和附属建筑的屋顶。点击列表项或尺寸即可打开对应编辑器并突出显示部件。编辑穿过当前楼层的烟囱时，视图保持在当前楼层；编辑的仍是同一根烟囱。
同类零件达到三个时，该组可以折叠。楼层在左侧主面板选择，列表不再增加楼层折叠项。点击按楼层复制后，图标显示黄色边框，勾选框才会出现。可以全选、选择一组或单个零件。来源始终是当前楼层。在列表下方的将所选项复制到选择目标楼层，再点击立即复制。关闭此模式后，勾选框隐藏，复制选择清空。
如果已选择源楼梯且目标楼层已有楼梯，应用会在替换前请求确认。未选择源楼梯时，目标楼层的楼梯会保留。
操作平面图¶
首次打开时，视图会完整显示当前平面图，并在周围留出空白。滚动鼠标滚轮可放大或大幅缩小；按住滚轮拖动可平移视图。切换楼层或工具时，当前视野保持不变。点击适应视图按钮可随时重新显示全部内容。
屋顶视图显示主屋顶、凸窗屋顶和附属建筑屋顶，以及屋脊、斜脊、谷线和坡度变化处的折线。现有烟囱、老虎窗和天窗可直接点击选择，即使当前选择了其他类型的放置工具。只命中一个部件时会立即打开对应编辑器；多个部件重叠时，点击位置会出现一个小型选择列表。
计算屋顶面时会显示加载提示。如果计算失败，PrintHaus 会显示错误；屋顶视图不完整时不能放置新的部件。
参数作为固定标题始终展开。较小的子组可以折叠。提示位于参数面板内部的最下方，默认展开；帮助在右上角。
撤销 / 重做¶
主面板右上方有两个图标按钮撤销和重做。此外还支持快捷键：
| 操作 | 快捷键 |
|---|---|
| 撤销 | ⌘ Z（Mac）· Ctrl + Z（Windows） |
| 重做 | ⌘ ⇧ Z（Mac）· Ctrl + ⇧ + Z（Windows） |
文本框里的原生撤销不受此影响。
级联警告
如果你改动了某些基础项——户型形状、尺寸、镜像、某个楼层或屋顶形状——之后有些已放置的构件 可能不再匹配。PrintHaus 会显示一条警告，列出受影响的构件（"……将被删除"）。你用 "仍然更改"确认，或用"取消"中止。
设置¶
扩展启用后，STEP 是 STL 旁独立的第六个打印目标。需要 CAD 导出时必须明确选择它。普通打印目标不再附带 STEP 文件，也没有额外的 STEP 开关。
仅外壳模式不生成楼梯梯段和中间楼板。可步行平屋顶的最后一块楼板保留最上层已保存楼梯的洞口，以及选定的洞口护栏。
首次登录时，在 打印导出设置 中先选择 3D打印 或 场景导出。打印模式需要逐项选择打印机或手动打印空间、输出目标、构造方式、门和玻璃。只有 0.4 mm 喷嘴和 0.20 mm 层高预先填写。场景导出只需选择质量。点击 应用 将完整设置保存到账户。缺少选择或尝试关闭时会显示 “请完成打印导出设置。”。保存成功后再次登录不会重复此步骤，仍可在设置中修改。已有配置的账户保留原设置。
设置标题栏包含紧凑的语言选择、载入项目、版本和反馈。打印选项统一放在打印导出面板中：第一行是两个构造图标和两个门图标，第二行是两个玻璃图标和两个颜色图标。八个图块均为正方形，名称在下方。选中时只增加黄色边框。取消或应用始终可以从底部操作。
MCP 接口直接显示在 STEP 下方，并标明是否已启用。 额度与兑换代码下方的下载 AI 聊天机器人插件按钮占据整行。邮箱下的昵称（可选）不是必填项。保存后显示昵称和编辑铅笔；保存为空即可删除。未填写昵称也能正常使用应用和 Archie。Archie 会在问候中使用昵称；永久保存聊天前会清除识别出的账户信息。
免费账户无需访问码。使用邮箱和密码注册，并验证邮箱。Google和Apple登录需在相应提供商完成配置并启用后使用。首次登录创建账户，之后继续使用同一账户。支持Apple隐藏邮箱地址。额外服务需要单独开通；仅创建账户不会获得打印导出权限或新的测试额度。
通过3D预览上方的箭头图标保存项目。保存和载入需要登录。发送反馈时可选择附件，模型附件默认关闭。发送前请检查图片中的个人信息。
重置（红色按钮）位于 3D 预览上方同一按钮行的最左侧：确认后放弃所有输入，从"楼层"重新开始。该行从左到右依次为重置 · 保存 · 上一步 · 下一步。
专业术语
檐口、屋脊、山墙檐边等术语在术语表中有解释。
注册与项目备份¶
每个新账户在注册后，可获得一次个人用途下载和AI接口访问权限。通过Google或Apple注册同样适用。欢迎下载属于累计额度，不会定期补充。STEP需要单独的使用权限。
你可以随时将设计保存为 model.json，包括正在设计的时候。打印下载次数会保持不变。之后通过设置 → 加载项目（model.json）打开文件，即可继续设计。
法律信息¶
运营者信息和隐私声明链接位于左下角 YouTube 图标旁，纵向排列。点击后，正文会在应用内打开。两个面板均与立面编辑器尺寸相同。较长的正文在面板内滚动，标题和关闭按钮始终可见。点击叉号或按 Escape 键即可关闭。法律文本提供德语和英语版本。
比例换算器¶
测量单位¶
在设置中选择公制或英尺/英寸。建筑调节控件随后使用整数英寸；切换单位会完整保留现有尺寸的精确值。舍入显示带有=标记。较小的打印尺寸以英寸分数显示。比例换算器以英尺/英寸显示实际尺寸，以英寸显示模型尺寸。在1:100下，8英尺4英寸恰好对应模型的1英寸。1:n比例保持不变；换算器不会改变建筑或导出比例。
已打开的尺寸对话框会保留打开时显示的单位。如果不修改舍入显示而直接确认，保存的精确尺寸会保持不变。
MCP 接口¶
打开账号设置，选择“下载 AI 聊天机器人插件”。将 ZIP 文件交给支持 MCP 连接和自定义插件的聊天机器人，请它安装并连接 PrintHaus。在打开的 PrintHaus 登录窗口中登录自己的账号，并确认连接。
然后，你可以提供照片、图纸或文字说明。请聊天机器人使用 PrintHaus 的构件创建建筑模型，并展示预览。它会采用账号中保存的外壳、内装、打印机等设置。
请选择具有图像理解能力、能可靠使用工具的高性能 AI 模型。模型质量对理解参考资料并将其转化为高质量建筑模型有重要影响。
如果聊天机器人具备浏览器访问能力，它会直接在 PrintHaus 的导出步骤中打开完成的模型，并检查模型是否已完整加载。你可以在那里仔细查看建筑，再亲自开始下载。以后需要修改时，AI 可以继续使用你上次在应用中保存的设计。
Remote MCP: https://printhaus.app/mcp
AI 会复用现有的 PrintHaus 登录状态。尚未登录时，它会打开 Google、Apple 或电子邮件登录页面。使用 Google 或 Apple 时不需要单独的 PrintHaus 密码，登录直接在提供商的页面完成。返回后继续已开始的 MCP 连接。已保存的打印设置直接从账户读取，不再重复询问。
AI 通过 app_map 获取已识别的源码位置和键盘操作声明目录，并可按区域加载详细信息。coverage 说明识别范围的限制；该目录不能证明已完整覆盖界面、交互关系图或所有按键绑定。功能地图区分 API 操作、仅限浏览器的操作以及尚未验证的状态，不提供源代码访问。project_schema 说明项目字段。只有调用成功才能确认连接可用，仅安装插件并不够。
可通过 api_documentation 和 /api/v1/api-documentation 获取技术 API 参考文档。文档说明方法、参数、返回值、权限、错误情况和工作流程示例。使用 method 选择方法，使用 query 搜索，或通过 view="full" 获取完整参考文档。技术模式来自实际接口定义，应用功能地图补充产品使用规则。没有搜索结果时会明确说明。不会提供内部源代码。
如果账户或登录验证暂时不可用，PrintHaus 会返回服务错误（503）。这并不表示您已退出登录或连接权限已被撤销。请保留现有连接，在服务恢复后重试同一操作。在 OAuth 令牌交换过程中，错误名称为 temporarily_unavailable。经确认无效的凭据仍会被拒绝。
已验证的解决方案¶
在 configure_build 之后，AI 先通过 prepare_tab 01 确认楼层，再通过 02 确认平面轮廓，最后通过 prepare_building 03 确认屋顶。基础形状仅包含 geschosse、grundriss、dach 和可选的 kommunwaende，也包括附属建筑的基础形状。屋顶被拒绝时，在 03 完成之前可能返回 printhaus-base-plan-v1，状态为 solutions_available 或 fixed_requirements_conflict。只有 native_candidate_verified 表示已验证的替代方案。这项证明仅覆盖原始实际尺寸的基础几何，不包括打印目标、后续外墙突出部和组件、纹理或已保存的输出文件。
AI 根据参考图，在固定要求范围内选择一套完整方案。选择时，将未修改的 selection_receipt 与同一原始基础项目、configuration_receipt、02 的 tab_receipt 和 fixed_paths 一起发送给 prepare_building。账户设置、目录、计算引擎、连接、项目和固定路径的绑定保持有效。solution_selected 仅返回准确修改后的 project，不会保存项目，也不会生成 geometry_receipt。不得悄悄改变输入、重新拼凑数值或混合部分修改。
将所选基础项目再次发送给 prepare_building，此次不附带 selection_receipt。如果楼层或平面轮廓改变，应先更新 01/02；否则保留匹配的 02 确认。只有同时取得 base_geometry_checked 和 geometry_receipt 才表示 03 已确认，并允许后续组件、dormer_placement 和 check_components。随后 AI 展示原始基础 PNG，无需再次询问批准即可继续；收到异议时，应在相关后续工作开始前处理。之后，check_components 检查所有已选择的后续选项和已配置的打印目标。纹理浮雕和已保存文件仍须在输出流程中单独检查。
原生楼层数据在 prepare_tab 02 和 prepare_building 的 floors 中返回；不带 group_layout 的 dormer_placement 则通过 actual_floors 返回。interior_wall_segments 描述实际内墙段，column_carriers 描述柱子的承托构件及其边，rooms 描述识别出的房间及其键、标签点、名称和面积。坐标与长度以米为单位，flaeche 以平方米为单位；name 和 anchor 可以是 null。内墙编号从 0 开始；底层先列出主列表中的墙，再列出启用的附楼内墙。这些是输出参考数据，不是新的输入字段，也不能证明存在可自由放置构件的区域。空列表仅对应已提交的阶段：基础形体准备尚不包括后续内墙和承托构件。缺失或失败的结果不能视为已检查的空结果。 房间计算失败时返回 503 room_geometry_unavailable，并附带 preserve_project=true；不会返回成功的几何结果，也不会签发新的准备凭证。请保留完整项目并解决所报告的计算错误原因。
玻璃选项通过 extras.fenster_variante 应用于整个项目：mono 包含玻璃，ohne_scheiben 不含玻璃。缺少 extras 或该值时，原生模型使用 ohne_scheiben。账户首次设置仍要求明确选择玻璃选项。configure_build 按已保存的账户设置执行，原生默认值不会替代该选择。
早期的 roof_eave_profile_space 矛盾要求：所有允许的基础顶层字段都明确固定，并由原生计算引擎重新验证必要条件，其中也包括空的 kommunwaende。仅固定屋檐伸出长度或拒绝某个提案，并不能证明任务无法实现。搜索失败以及服务、CAD 或渲染故障都不是已验证的替代方案。确认过期、改变或无效时，AI 应遵循返回的具体阶段更新步骤，保留完整设计和已确认的回答，不得进入通用的重试循环。
不指定 placement_paths 时：check_components 使用原生几何引擎，为预览和所有已配置的打印目标构建完整设计。construction_verified 确认未修改的设计。solutions_available 提供完整的修改方案；只有 native_candidate_verified 表示已通过构建验证的替代方案。AI 根据参考图并遵守固定要求进行选择。
对于主建筑中新建或修改的普通外墙开口，可以使用 placement_paths 将检查限定在这些开口未更改的原始路径上。完整设计仍作为周边条件保留。placement_checks_passed 只确认列出的局部检查；placement_check_incomplete 不表示检查通过。需要完整建造判断或替代方案时，应省略 placement_paths。
搜索在首次得到完整构建方案的层级停止。对于在该层级验证成功的每个不同初始候选，最多返回一条完整的后续修改链。search_scope 说明这一范围；未探索的变体和更深层级不会被判定为不可能。
选择时，AI 将未修改的 selection_receipt 与同一原始项目、geometry_receipt 和 fixed_paths 一起提交。solution_selected 返回所选的准确 project，不得重新拼凑单独的数值。基础形状改变后必须重新准备，随后保存、预览并导出。构建验证本身不能证明纹理浮雕或最终打印文件已经合格。
不同打印目标保留同一份公共设计，并在 _export.target_variants 中保存明确的变体。每个变体都包含 target_id、完整的已配置打印目标，以及生成几何形状前的精确修改。向 start_job 传入该标识符及匹配的比例和模型类型。导出时不会悄悄覆盖门、玻璃或颜色。针对某个目标保存的文件会注明实际使用的打印目标；固定要求仍须遵守。
fixed_requirements_conflict 指出具体的规则矛盾和需要放宽的固定要求。AI 只询问这一项决定。技术中断会保留原因和任务标识，并不表示无法构建。只有明确提供的 resume_available 续作方案才能使用，且不得修改其参数。不得替换正在执行的任务。
中央 AI 指令允许正常的建筑模型操作及其公开参数。未经运营者明确授权，AI 不得重构或复制 PrintHaus 软件及其内部算法。此指令并不保证防复制效果。服务器另外检查访问权限和请求限制。
打开已计算的结果¶
如果聊天机器人具备浏览器访问能力，它会直接在 PrintHaus 的导出步骤中打开完成的模型，并检查模型是否已完整加载。你可以在那里仔细查看建筑，再亲自开始下载。以后需要修改时，AI 可以继续使用你上次在应用中保存的设计。
无论当前打开的模型及其类型如何，都可以随时在“设置 → 打印导出设置 → 颜色”中选择偏好的颜色模式。该选择会被保存。BM 支持多色打印零件；HM 和 MM 的每个打印零件仍使用单色。
问号帮助链接位于所属卡片或面板的右边缘，并保留常规内边距。在窗户和门编辑器中，帮助链接位于整个对话框标题栏的右侧。
MCP响应前的等待信息¶
HTTP拒绝可能发生在MCP响应之前。请求频率限制的响应包含实际数值 retry_after_seconds，并保留原有的 Retry-After 响应头。至少等待该时长，保留已接受任务的标识，只重试被拒绝的请求。这种限制不能证明RAM不足或CAD处理拥塞。
账户与许可证的帮助位于右上角。两张设置卡片的底边对齐。Admin级别和管理控制台使用受保护的账户角色。昵称仍为可选。
Archie：设备端语音输入¶
如果浏览器支持所选聊天语言（德语或英语）的设备端语音识别，Archie 输入框旁会显示麦克风。缺少语言包时，点击麦克风可通过浏览器下载。语言包准备就绪后，再次点击才会开始听写；再点一次即可停止录音。浏览器在设备上转写语音，不会改用云端识别服务。识别出的文字保留在输入框中供检查和修改，只有点击发送后才会交给 Archie。即使浏览器不支持、麦克风权限被拒绝或语言包下载失败，仍可使用键盘输入。
根据参考资料重建建筑¶
聊天机器人会记录实际任务、图像中观察到的特征、已知尺寸或明确标注的估算值，以及重要比例。它会检查相关构件，包括颜色、纹理和细节。对于尚未确定的选项，例如是否需要基础及相应的地下室窗户，它会有针对性地提问，并沿用已有回答。局部修改会保留无关构件。
接口通过 configure_build 将这些信息与任务绑定，并在 start_job 前检查所记录特征是否对应实际模型字段、是否符合固定要求。在 job_result 后，AI 将原始预览图与参考资料进行比较，并通过 review_reconstruction 报告具体模型和图像的一致之处、差异及不可见区域。这是聊天机器人的评估，不是服务器独立进行的图像识别。计算完成本身并不能证明模型忠实于参考资料。轻量视图仍为默认选项；下载由你在应用中启动。