diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7e26b4a2..2c1e6512 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,10 @@ All notable changes to this project are documented here. The format is based on
- Bed fit now reports each object's size and the instances' placement as separate facts; several small, separated objects are no longer summed into one "too big" object (#91).
- Object placement judges each placed copy of a repeated object on its own, so a copy that hangs off the plate is no longer hidden by one that does not (#93).
- Placement and plate-fit checks are withheld (reported as not checked) for projects whose physical size the file does not establish: a non-millimetre unit, or a rotated or scaled object.
+- A project with several plates is no longer called ready or "fits the bed" just because each plate fits on its own: the placement card, the preflight bed check, Ready Now and the Doctor's READY action say Studio cannot check where the plates sit.
+- Studio no longer recommends Arrange all plates as a fix. It was only seen failing to fix an Outside object in one tested project; the text now says to review the project in Snapmaker Orca before slicing.
+- Preparing with Recommended settings now says the creator's supports are not kept when they were turned on, and no longer describes the written settings as "kept". The Validation Center only says values are kept for a Preserve copy.
+- When the bed-fit check could not run, the Intelligence Report headline, next action and comparison lines say it was not verified instead of reading as a clean result.
## [1.6.0] - 2026-10-21
diff --git a/backend/snapstudio_api/service.py b/backend/snapstudio_api/service.py
index 1cd1f6fa..45337a6e 100644
--- a/backend/snapstudio_api/service.py
+++ b/backend/snapstudio_api/service.py
@@ -499,10 +499,14 @@ def insights(path: str) -> dict:
return project_info(path, placement_aware=True)
-def report(path: str) -> dict:
- """Read-only Validation Center report: checks + preserved/changes/at-risk."""
+def report(path: str, prepare_mode: str | None = None) -> dict:
+ """Read-only Validation Center report: checks + preserved/changes/at-risk.
+
+ `prepare_mode` is only for a caller that knows how the file was prepared; the
+ file itself does not say, and without it the report makes no promise about
+ whether the creator's setting values were kept."""
from snapstudio_core.validation_report import readiness_report
- return readiness_report(path)
+ return readiness_report(path, prepare_mode)
def canonical(path: str) -> dict:
diff --git a/backend/snapstudio_core/bed_fit.py b/backend/snapstudio_core/bed_fit.py
index d7cb1ad2..cceef85c 100644
--- a/backend/snapstudio_core/bed_fit.py
+++ b/backend/snapstudio_core/bed_fit.py
@@ -125,7 +125,7 @@ def bump(level: str) -> None:
diag = (x + y) / (2 ** 0.5)
if (over_x ^ over_y) and diag <= min(bx, by):
fixes.append(f"Or it may fit rotated ~45° on the plate — the diagonal ({diag:.0f} mm) "
- f"is within the bed; try Arrange in Orca to confirm.")
+ f"is within the bed; confirm it in Snapmaker Orca.")
# Almost the whole plate — fits, but brim/skirt/tower can spill over.
elif x > bx * EDGE_FRAC or y > by * EDGE_FRAC:
@@ -154,7 +154,7 @@ def bump(level: str) -> None:
if object_count and object_count > 1:
findings.append(_f("ok", f"The project has {object_count} objects. Whatever sits on one plate "
f"must fit that plate together; if Snapmaker Orca still says out of "
- f"bounds, one object is off its plate and Arrange can re-pack them."))
+ f"bounds, one object is off its plate; review the plate in Snapmaker Orca."))
# Where the instances sit is a different fact from how big each object is.
placed_level = _placed_findings(placed, findings, fixes)
@@ -248,8 +248,8 @@ def _placed_sideways(placed: dict, findings: list, fixes: list) -> str | None:
findings.append(_f("risk", f"By placement, plate {plate['plate']}: {plate['reason']}. "
"Scale it down or split it.",
id="placement-plate-oversized",
- action="Scale the oversized plate down or split it, then use Arrange in Snapmaker Orca."))
- fixes.append("Scale the oversized plate down or split it, then use Arrange in Snapmaker Orca.")
+ action="Scale the oversized plate down or split it, then review the project in Snapmaker Orca."))
+ fixes.append("Scale the oversized plate down or split it, then review the project in Snapmaker Orca.")
return "risk"
if placed.get("not_judged"):
findings.append(_f("warn", f"By placement: {placed.get('summary')}",
@@ -257,7 +257,7 @@ def _placed_sideways(placed: dict, findings: list, fixes: list) -> str | None:
action="Check these instances in Snapmaker Orca; Studio could not judge their placement."))
return "warn"
findings.append(_f("ok", f"By placement, each of the {plate_count} plates fits on its own. "
- "Positions across plates are not checked; use Arrange in Snapmaker Orca."))
+ "Positions across plates are not checked; review the project in Snapmaker Orca."))
return None
if not placed.get("off_plate"):
if placed.get("not_judged"):
@@ -268,8 +268,8 @@ def _placed_sideways(placed: dict, findings: list, fixes: list) -> str | None:
findings.append(_f("ok", "By placement, every placed instance sits inside the plate."))
return None
move = ("Move the arrangement onto the plate (Studio can save a corrected copy), "
- "or use Arrange in Snapmaker Orca." if placed.get("fixable") else
- "Use Arrange in Snapmaker Orca to bring every instance onto the plate.")
+ "or review the project in Snapmaker Orca." if placed.get("fixable") else
+ "Review the project in Snapmaker Orca; Studio could not bring every instance onto the plate.")
findings.append(_f("risk", f"By placement: {placed.get('summary')}", id="placement-off-plate", action=move))
fixes.append(move)
return "risk"
diff --git a/backend/snapstudio_core/community_knowledge.py b/backend/snapstudio_core/community_knowledge.py
index c3889f0d..97d0ecac 100644
--- a/backend/snapstudio_core/community_knowledge.py
+++ b/backend/snapstudio_core/community_knowledge.py
@@ -35,7 +35,7 @@
"cause": "The model (or its skirt/brim/prime tower) extends past the U1's "
"270×270×270 mm printable area; Orca refuses to slice but doesn't say which axis.",
"community_fix": "Scale to fit (Studio's Project Doctor gives the exact %), rotate ~45° "
- "if only one axis is over, or split the model. Re-arrange so every object is on the plate.",
+ "if only one axis is over, or split the model. Check in Snapmaker Orca that every object is on the plate.",
"sources": ["r/snapmaker", "Snapmaker forum", "Facebook Snapmaker U1 group"],
},
{
diff --git a/backend/snapstudio_core/compatibility.py b/backend/snapstudio_core/compatibility.py
index 22b04866..275fe628 100644
--- a/backend/snapstudio_core/compatibility.py
+++ b/backend/snapstudio_core/compatibility.py
@@ -204,8 +204,8 @@ def check(path: str) -> dict:
"Studio does not yet check object-to-object spacing for multi-part 3MF "
"layouts, so it cannot confirm objects aren't too close or colliding.",
"Object layout (plate)",
- "Open in Snapmaker Orca and check for too-close / collision warnings; use "
- "Arrange or move objects before slicing.",
+ "Review the project in Snapmaker Orca and look for too-close / collision "
+ "warnings before slicing.",
(f"{oc} object(s) on the plate; spacing unchecked by Studio" if oc
else "object count unknown; spacing unchecked by Studio"),
))
diff --git a/backend/snapstudio_core/convert.py b/backend/snapstudio_core/convert.py
index 9424e307..73784fe8 100644
--- a/backend/snapstudio_core/convert.py
+++ b/backend/snapstudio_core/convert.py
@@ -169,6 +169,43 @@ def _is_preserved_value_mapping(old, new) -> bool:
return _strict_value_equal(new, expected)
+def _is_on(value) -> bool:
+ """Whether a project-settings switch such as `enable_support` is on."""
+ if isinstance(value, list):
+ value = value[0] if value else None
+ return str(value).strip().lower() in ("1", "true")
+
+
+def _supports_note(tm: ThreeMF, before: dict, after: dict, prepare_mode: str) -> str | None:
+ """Say so when the creator's supports will not be in effect in Snapmaker Orca.
+
+ Orca resets every process value the project does not declare in
+ `different_settings_to_system` to the U1 preset, where supports are off.
+ Recommended blanks the source's declaration and re-declares only what Studio
+ itself changed, so a creator's `enable_support=1` stays in the file but is not
+ used. Computed from the source and the written config, never asserted; Preserve
+ keeps the declaration, so it has nothing to say.
+ """
+ from .preset_deviation import declared_process_keys
+
+ if prepare_mode == "preserve" or not _is_on(before.get("enable_support")):
+ return None
+ if "enable_support" in declared_process_keys(after) and _is_on(after.get("enable_support")):
+ return None
+ note = ("Supports: the creator turned supports on. This mode does not keep them; "
+ "Snapmaker Orca will open with supports off. Turn them on in Orca's Support tab "
+ "or prepare with Preserve creator settings.")
+ try:
+ painted = sum(tm.read_part(p).count(b"paint_supports")
+ for p in tm.list_parts() if p.endswith(".model"))
+ except Exception:
+ painted = 0
+ if painted:
+ note += (" The painted support areas stay in the file but do nothing while "
+ "supports are off.")
+ return note
+
+
def _settings_summary(before: dict, after: dict, raw_config: bytes, outcome,
prepare_mode: str, profile_name: str = "snapmaker_u1",
recommended_after: dict | None = None) -> dict:
@@ -449,6 +486,9 @@ def convert_to_u1(path: str, out_dir: str | None = None, prepare_mode: str = "pr
recommended_after = load_project_settings(recommended_tm.read_part(SETTINGS))
summary = _settings_summary(before, after, raw_config, outcome, prepare_mode,
recommended_after=recommended_after)
+ supports_note = _supports_note(tm, before, after, prepare_mode)
+ if supports_note:
+ summary["supports_note"] = supports_note
if confirmed_presets or confirmed_colours or filament_catalog is not None:
# Only when Project Materials is in use, so a plain Prepare reports exactly what it did.
summary["project_materials"] = {
diff --git a/backend/snapstudio_core/doctor.py b/backend/snapstudio_core/doctor.py
index 0586da7b..6232ec6a 100644
--- a/backend/snapstudio_core/doctor.py
+++ b/backend/snapstudio_core/doctor.py
@@ -18,6 +18,12 @@
HIGH_RISK = "HIGH_RISK" # not a usable project (broken / not a 3MF)
CONVERTIBLE = "CONVERTIBLE" # an STL - convert it with `repair`
+# Appended to the READY action of a project with more than one plate.
+MULTI_PLATE_READY_NOTE = (
+ " This project has several plates and Studio has not checked where they sit; "
+ "Snapmaker Orca may list an object as Outside. Review it in Snapmaker Orca before slicing."
+)
+
@dataclass
class Diagnosis:
@@ -134,6 +140,9 @@ def diagnose(tm: ThreeMF) -> Diagnosis:
elif score == 100 and not compatibility_issues:
verdict = READY
action = "Ready for Snapmaker U1 - open it in Snapmaker Orca and slice."
+ if fp.plate_count > 1:
+ # The profile is ready; where the plates sit is not something Studio checks.
+ action += MULTI_PLATE_READY_NOTE
else:
verdict = REPAIRABLE
action = "Prepare a U1 profile copy, then review it in Snapmaker Orca before slicing."
diff --git a/backend/snapstudio_core/intelligence_report.py b/backend/snapstudio_core/intelligence_report.py
index 7f6a2e40..5dc8f416 100644
--- a/backend/snapstudio_core/intelligence_report.py
+++ b/backend/snapstudio_core/intelligence_report.py
@@ -18,6 +18,11 @@
_ORDER = {"ok": 0, "warn": 1, "risk": 2}
+def _phrase(items: list[str]) -> str:
+ """"object spacing", "object spacing and bed fit", "a, b and c"."""
+ return items[0] if len(items) == 1 else ", ".join(items[:-1]) + " and " + items[-1]
+
+
def _community_entries(ck, risk) -> list:
"""(entry, confidence) pairs for one report risk, chosen by IDENTITY: the condition id maps to one curated entry
(conditions.COMMUNITY_ENTRY) or to none. Confidence is "High" when one of the entry's symptom phrases also appears
@@ -190,8 +195,8 @@ def build(predict=None, bed_fit=None, mm=None, first_layer=None, health=None,
# The step that goes with the biggest risk, not just the first fix in Doctor order.
next_action = biggest_risk.get("action") or f"Look into: {biggest_risk['text']}"
else:
- next_action = ("Check spacing between objects in Snapmaker Orca, then prepare a U1 profile copy and review it before slicing."
- if spacing_unverified else
+ next_action = (f"Check {_phrase(not_verified)} in Snapmaker Orca, then prepare a U1 profile copy and review it before slicing."
+ if not_verified else
"Review the recommendations, then prepare a U1 profile copy and check it in Snapmaker Orca before slicing.")
# --- supporting evidence (each Doctor's one-line status) ---
@@ -226,8 +231,10 @@ def add(name, ok, status, detail):
verdict = f"{count}top risk: {biggest_risk['text']}."
else:
verdict = "Studio's checks found no risks. That is not a sign the print will succeed."
- if not risks_found and spacing_unverified:
- verdict = ("Studio's other checks found no risks, but object spacing was not verified. "
+ if not risks_found and not_verified:
+ # A check that could not be run is not a clean result: say which one(s) did not run.
+ verdict = (f"Studio's other checks found no risks, but {_phrase(not_verified)} "
+ f"{'was' if len(not_verified) == 1 else 'were'} not verified. "
"That is not a sign the print will succeed.")
# --- Before vs After: "why not just use Orca?" ---
@@ -241,9 +248,12 @@ def add(name, ok, status, detail):
f"{n_fixes} fix{'es' if n_fixes != 1 else ''} before you slice{money_bit}.")
else:
orca_line = ("Only Snapmaker Orca's preview can show spacing between objects."
- if spacing_unverified else "Orca slices the file as you give it.")
- studio_line = (("Studio's other checks found nothing in this file, but object spacing was not verified. "
- if spacing_unverified else "Studio's checks found nothing in this file. ")
+ if spacing_unverified else
+ "Snapmaker Orca's preview shows what Studio did not verify here."
+ if not_verified else "Orca slices the file as you give it.")
+ studio_line = ((f"Studio's other checks found nothing in this file, but {_phrase(not_verified)} "
+ f"{'was' if len(not_verified) == 1 else 'were'} not verified. "
+ if not_verified else "Studio's checks found nothing in this file. ")
+ "They do not cover slicer settings, filament condition, bed cleanliness or "
"mid-print behavior. Verify in Snapmaker Orca before you print.")
comparison = {
diff --git a/backend/snapstudio_core/layout.py b/backend/snapstudio_core/layout.py
index 1c42bb69..1053d96e 100644
--- a/backend/snapstudio_core/layout.py
+++ b/backend/snapstudio_core/layout.py
@@ -76,8 +76,8 @@ def assess_layout(path: str) -> dict:
"plates": plates,
"object_count": 0,
"messages": [
- "Studio couldn't read object placement from this file — open it in "
- "Snapmaker Orca and use Arrange all plates to check the layout before slicing."
+ "Studio couldn't read object placement from this file — review the project in "
+ "Snapmaker Orca before slicing; Studio could not establish where the objects sit."
],
}
@@ -96,8 +96,8 @@ def assess_layout(path: str) -> dict:
status = "warn"
messages.append(
f"Multi-plate project ({plates} plates) — Studio can't fully verify each plate's "
- "object positions from the file. Open in Snapmaker Orca and use Arrange all plates "
- "before slicing; objects may sit outside a plate."
+ "object positions from the file. Review it in Snapmaker Orca before slicing; "
+ "objects may sit outside a plate, and Arrange all plates did not fix that in our test."
)
else:
(xlo, xhi), (ylo, yhi) = plate_window(items)
@@ -111,7 +111,7 @@ def assess_layout(path: str) -> dict:
status = "fail"
messages.append(
f"{len(off)} object(s) sit outside the U1 build plate ({int(U1_PLATE_MM)} mm). "
- "Open in Snapmaker Orca and use Arrange all plates before slicing."
+ "Review the project in Snapmaker Orca before slicing."
)
if oversized:
diff --git a/backend/snapstudio_core/plate_placement.py b/backend/snapstudio_core/plate_placement.py
index d31c44a9..7ae97fa3 100644
--- a/backend/snapstudio_core/plate_placement.py
+++ b/backend/snapstudio_core/plate_placement.py
@@ -6,7 +6,7 @@
never catch it, because nothing is too big — it is in the wrong place.
Snapmaker Orca's answer to this is a bare "out of bounds", and the community's
-answer is "hit Arrange and hope". This module gives the specific answer instead:
+answer is a guess. This module gives the specific answer instead:
which object is off the plate, by how much and on which edge, whether one
translation would bring the whole arrangement back on, and — when it would —
writes a new copy with exactly that translation applied.
@@ -23,7 +23,7 @@
all: the spacing between plates is not recorded in the file, so any move would
be a guess. They are still *checked* — each plate is judged on whether its own
contents fit a U1 plate, which does not depend on the grid — and the answer is
- "open this in Orca and use Arrange".
+ "review this in Orca before slicing".
"""
from __future__ import annotations
@@ -362,14 +362,26 @@ def _unavailable(reason: str) -> dict:
# object at X=900 on plate 3 is not "off the plate", and Studio no longer says it
# is.
#
-# Moving them is Snapmaker Orca's Arrange, and Studio says so.
+# Studio says it cannot place them and points the user to Snapmaker Orca.
MULTI_PLATE_REFUSAL = (
"Studio does not reposition multi-plate projects. The spacing between plates "
- "is not recorded in the file, so any move would be a guess — open the project "
- "in Snapmaker Orca and use Arrange."
+ "is not recorded in the file, so any move would be a guess — review the plates "
+ "in Snapmaker Orca."
)
+# What Studio can say about a multi-plate project when every plate fits on its own.
+# It is deliberately not "every object is inside": the plates sit on one grid that
+# Studio neither moves nor checks, and Snapmaker Orca can list an object as Outside.
+MULTI_PLATE_CANNOT_CHECK = (
+ "Studio cannot check where the plates sit. In our "
+ "test with a two-plate project made for a larger-bed printer, Snapmaker Orca listed "
+ "one object as Outside and would not slice until it was moved by hand; "
+ "Arrange all plates did not fix that in our test. "
+ "Review the project in Snapmaker Orca before slicing."
+)
+MULTI_PLATE_UNVERIFIED = "Each plate fits on its own, but " + MULTI_PLATE_CANNOT_CHECK
+
_MODEL_INSTANCE_RE = re.compile(r"(.*?)", re.S)
_METADATA_RE = re.compile(r'key="([^"]*)"\s+value="([^"]*)"')
@@ -606,15 +618,11 @@ def assess(path: str, bed: dict | None = None, bed_name: str | None = None,
"judged, so Studio cannot say whether everything is on the plate.")
if multi_plate and not off_plate:
- if plate_fit:
+ if not_judged:
summary = (f"None of the plates Studio could assign is too big for {whose} printable area."
- if not_judged else
- f"All {len(plate_fit)} plate{'s' if len(plate_fit) != 1 else ''} fit "
- f"{whose} printable area.")
+ + unjudged + " " + MULTI_PLATE_CANNOT_CHECK)
else:
- summary = ""
- summary = (summary + unjudged + " Studio does not reposition multi-plate projects — open "
- "the project in Snapmaker Orca to arrange the plates.").strip()
+ summary = MULTI_PLATE_UNVERIFIED
elif multi_plate and oversized_plates:
names = ", ".join(str(p["plate"]) for p in oversized_plates)
summary = (f"Plate {names} does not fit {whose} printable area: "
@@ -641,7 +649,7 @@ def assess(path: str, bed: dict | None = None, bed_name: str | None = None,
"back on, keeping the creator's layout, rotation and scale.")
else:
summary = (f"{count_text} {fall} outside {whose} plate and one "
- "move will not fix it. Open it in Snapmaker Orca and use Arrange." + unjudged)
+ "move will not fix it. Review the project in Snapmaker Orca before slicing." + unjudged)
return {
"schema_version": SCHEMA_VERSION,
@@ -652,6 +660,8 @@ def assess(path: str, bed: dict | None = None, bed_name: str | None = None,
"source_bed": source_bed,
"source_printer": (traits.get("target_printer") or {}).get("value"),
"plate_count": plate_count,
+ # False whenever positions across plates are not established by Studio.
+ "placement_established": not multi_plate,
"item_count": len(reported),
"items": reported,
"off_plate": off_plate,
@@ -931,8 +941,8 @@ def prepare_placed_copy(path: str, out_dir: str | None = None,
return {
"schema_version": SCHEMA_VERSION, "ok": False,
"reason": ("Studio moved the arrangement but the copy still has objects "
- "off the plate, so it is not safe to rely on. Open the original "
- "in Snapmaker Orca and use Arrange."),
+ "off the plate, so it is not safe to rely on. Review the original "
+ "in Snapmaker Orca before slicing."),
"output_path": str(out), "output_name": out.name,
"before": before, "after": after,
}
diff --git a/backend/snapstudio_core/preflight.py b/backend/snapstudio_core/preflight.py
index 199023ed..8e716d6c 100644
--- a/backend/snapstudio_core/preflight.py
+++ b/backend/snapstudio_core/preflight.py
@@ -385,7 +385,7 @@ def _bed(project: dict, printer: dict, placement: dict | None) -> dict:
"cannot say whether everything is on the plate"),
confidence=INFORMATIONAL,
consequence="Studio cannot confirm the objects land on this printer's plate.",
- action="Open the project in Snapmaker Orca and use Arrange.",
+ action="Review the project in Snapmaker Orca before slicing.",
source=f"project geometry vs {owner} printable area")
if not off and tall:
return _check(
@@ -407,6 +407,19 @@ def _bed(project: dict, printer: dict, placement: dict | None) -> dict:
consequence="A slicer prints what is above the plate; Studio cannot confirm this prints as modelled.",
action="Check the height of these objects in Snapmaker Orca.",
source="project geometry vs the build plane")
+ if not off and (placement.get("plate_count") or 1) > 1:
+ # Each plate may fit, but where the plates sit on the slicer's grid is not
+ # something Studio establishes. Not OK, and not an error either: unknown.
+ return _check(
+ "bed.fit", "Fits the printer's bed", UNKNOWN,
+ evidence=(f"the project has {placement.get('plate_count')} plates and each fits "
+ f"the {area} on its own, but Studio does not check where the plates sit"),
+ confidence=INFORMATIONAL,
+ consequence=("Snapmaker Orca can list an object as Outside even when its plate "
+ "fits, so Studio cannot confirm the objects land on this printer's plates."),
+ action=("Review the project in Snapmaker Orca before slicing; an object may be "
+ "listed as Outside."),
+ source="project geometry vs printer bed")
if not off:
if tops and height:
return _check(
@@ -431,7 +444,8 @@ def _bed(project: dict, printer: dict, placement: dict | None) -> dict:
"plate."),
action=("Use Studio's object-placement fix to move them on — it saves a copy and "
"leaves your original alone." if placement.get("fixable")
- else "Open the project in Snapmaker Orca and use Arrange."),
+ else "Review the project in Snapmaker Orca before slicing; Studio could not "
+ "bring every object onto the plate."),
source="project geometry vs printer bed")
diff --git a/backend/snapstudio_core/scale_doctor.py b/backend/snapstudio_core/scale_doctor.py
index 81c71a0d..b80f388d 100644
--- a/backend/snapstudio_core/scale_doctor.py
+++ b/backend/snapstudio_core/scale_doctor.py
@@ -107,7 +107,7 @@ def preview(path: str, scale_percent: float) -> dict:
risks = [
"Fit by SIZE only — Snapmaker Orca can still reject a scale because where the object "
- "sits on the plate also matters. Confirm placement in Orca (Arrange all plates) after scaling.",
+ "sits on the plate also matters. Check placement in Snapmaker Orca after scaling.",
"Holes, threads, snap-fits, joints and tolerances may not scale correctly — "
"check fit-critical features after scaling.",
"Thin-wall safety check is not available here — verify wall thickness after scaling (approximate).",
@@ -352,7 +352,7 @@ def by_part(pct):
if not verified:
warnings.append("Sizes below are a theoretical fit BY SIZE only. Snapmaker Orca can still "
"reject a scale because where the object sits on the plate also matters. "
- "After scaling, open in Orca and use Arrange all plates to confirm it fits.")
+ "After scaling, check in Snapmaker Orca that it fits.")
if multi:
warnings.append("Use the same scale on all related parts — do not scale plates "
"differently if they need to fit together.")
@@ -360,7 +360,7 @@ def by_part(pct):
headline = (f"Largest verified scale that stays on the plate: {safe_pct:.0f}%."
if verified else
f"Largest size-only fit is {safe_pct:.0f}% — verify placement in Snapmaker Orca "
- "(Arrange all plates) after scaling.")
+ "after scaling.")
next_steps = [
headline,
"Apply the same scale to all related parts in your slicer.",
diff --git a/backend/snapstudio_core/validation_report.py b/backend/snapstudio_core/validation_report.py
index 5687d1d1..b6518323 100644
--- a/backend/snapstudio_core/validation_report.py
+++ b/backend/snapstudio_core/validation_report.py
@@ -32,7 +32,24 @@ def _check(name, ok, detail):
return {"name": name, "status": "pass" if ok else "warn", "detail": detail}
-def readiness_report(path: str) -> dict:
+def _preset_markers_line(prepare_mode: str | None) -> str:
+ """What the cleared preset markers mean for the user's setting values.
+
+ Only Preserve keeps the creator's values in effect. In Recommended Studio writes
+ its U1 starter settings, and Snapmaker Orca resets anything not declared as the
+ creator's to the U1 preset. A file alone does not say which mode made it, so
+ without a mode the line makes no promise about the values.
+ """
+ base = "Customized-preset markers cleared so Orca opens it clean"
+ if prepare_mode == "preserve":
+ return base + " — your setting values are kept"
+ if prepare_mode in ("recommended", "u1"):
+ return base + " — your settings were replaced by Studio's U1 starter settings"
+ return (base + " — setting values are kept only when prepared with Preserve creator "
+ "settings; Studio's U1 starter settings replace them")
+
+
+def readiness_report(path: str, prepare_mode: str | None = None) -> dict:
info = project_info(path, placement_aware=True)
diag = diagnose_path(path).to_dict()
is_stl = diag.get("input_type") == "stl"
@@ -130,7 +147,7 @@ def _name(entry):
changes.append(f'Printer identity → Snapmaker U1 (was {cfg.get("printer_model")})')
dss = cfg.get("different_settings_to_system")
if (isinstance(dss, list) and any(str(x) for x in dss)) or (isinstance(dss, str) and dss):
- changes.append("Customized-preset markers cleared so Orca opens it clean — your setting values are kept")
+ changes.append(_preset_markers_line(prepare_mode))
if cfg.get("print_sequence") not in (None, "by layer"):
at_risk.append('Print order changes from "by object" to "by layer" (avoids a collision warning; re-enable in Orca if you need by-object)')
if not changes and verdict == READY:
@@ -182,8 +199,8 @@ def _name(entry):
# A crash in layout analysis must NOT silently let the file pass as ready —
# fall back to an explicit "unknown" that blocks readiness.
layout = {"status": "unknown", "plates": 0, "object_count": 0,
- "messages": ["Layout couldn't be checked — open in Snapmaker Orca and use "
- "Arrange all plates to confirm placement before slicing."]}
+ "messages": ["Layout couldn't be checked — review the project in "
+ "Snapmaker Orca before slicing."]}
if layout["status"] != "pass":
checks.append(_check(
"Layout / plate fit",
diff --git a/backend/tests/test_honest_claims.py b/backend/tests/test_honest_claims.py
new file mode 100644
index 00000000..2536215f
--- /dev/null
+++ b/backend/tests/test_honest_claims.py
@@ -0,0 +1,274 @@
+"""Release correction: Studio must not express more confidence than it has.
+
+Four claims, each checked through the real producers (service entry points), on
+fixtures built at test time from the committed Bambu Studio-authored base project
+(no third-party model file is committed):
+
+1. A multi-plate project is never reported as "every object is inside".
+2. Preflight's bed check on such a project is unknown, and Ready Now does not
+ treat it as ready.
+3. The Doctor's READY action carries the unresolved-placement note.
+4. Use Studio's U1 starter settings (Recommended) says when it drops the creator's
+ supports, and no report says the creator's values are kept where they are not.
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import zipfile
+
+import pytest
+
+from snapstudio_api import service
+from snapstudio_core import fingerprint, plate_placement
+from snapstudio_core import preflight as pf
+from snapstudio_core import readiness as rd
+from snapstudio_core.container import ThreeMF
+from snapstudio_core.filaments import PER_FILAMENT_KEYS
+from tests.test_readiness import PROJECT, printer, spool, traits
+
+HERE = os.path.dirname(__file__)
+BASE = os.path.join(HERE, "fixtures", "painted", "bambustudio-2.08.02.61-authored.3mf")
+
+MODEL = "3D/3dmodel.model"
+MODEL_SETTINGS = "Metadata/model_settings.config"
+SETTINGS = "Metadata/project_settings.config"
+
+# Bambu H2C-class bed, and the plate stride the authoring slicer uses for it
+# (bed width x 1.2). The second plate's object sits one stride to the right.
+BED_W, BED_D = 330, 320
+STRIDE = 396
+
+NOTE = ("Each plate fits on its own, but Studio cannot check where the plates sit. In our "
+ "test with a two-plate project made for a larger-bed printer, Snapmaker Orca listed "
+ "one object as Outside and would not slice until it was moved by hand; Arrange all "
+ "plates did not fix that in our test. Review the project in Snapmaker Orca before slicing.")
+
+
+def build(tmp_path, name="two-plate.3mf", *, plates=2, plate_json=0, supports=False,
+ painted_supports=False, source_declares_supports=True):
+ """The base project with `plates` plates, one slab each, at Bambu-stride offsets."""
+ out = tmp_path / name
+ with zipfile.ZipFile(BASE) as src, zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as dst:
+ for item in src.infolist():
+ data = src.read(item.filename)
+ if item.filename == MODEL:
+ text = data.decode("utf-8")
+ objects, items = "", ""
+ for n in range(1, plates):
+ oid = 2 + n
+ objects += (f' \n')
+ items += (f' \n')
+ text = text.replace(" ", objects + " ")
+ text = text.replace(" ", items + " ")
+ data = text.encode("utf-8")
+ elif item.filename == MODEL_SETTINGS:
+ text = data.decode("utf-8")
+ block = re.search(r' \n', text, re.S).group(0)
+ objs, pls = "", ""
+ for n in range(1, plates):
+ oid = 2 + n
+ objs += block.replace('id="2"', f'id="{oid}"')
+ pls += (f' \n \n'
+ ' \n'
+ f' \n \n'
+ ' \n'
+ ' \n \n')
+ text = text.replace(" ", objs + " ", 1)
+ text = text.replace(" ", pls + " ", 1)
+ data = text.encode("utf-8")
+ elif item.filename == SETTINGS:
+ cfg = json.loads(data)
+ # Four filaments, as a U1-shaped project has, so a prepared copy is
+ # internally consistent and the Doctor can judge it on its own merits.
+ for key in PER_FILAMENT_KEYS:
+ if isinstance(cfg.get(key), list) and cfg[key]:
+ cfg[key] = (cfg[key] + [cfg[key][-1]] * 4)[:4]
+ cfg["flush_volumes_matrix"] = ["0"] * 16
+ cfg["printable_area"] = ["0x0", f"{BED_W}x0", f"{BED_W}x{BED_D}", f"0x{BED_D}"]
+ if supports:
+ cfg["enable_support"] = "1"
+ cfg["support_type"] = "tree(manual)"
+ if source_declares_supports:
+ cfg["different_settings_to_system"] = [
+ "enable_support;support_type", "", "", "", ""]
+ data = json.dumps(cfg, indent=4).encode("utf-8")
+ elif item.filename == "3D/Objects/object_1.model" and painted_supports:
+ data = data.replace(b'',
+ b'')
+ dst.writestr(item, data)
+ for n in range(1, plate_json + 1):
+ dst.writestr(f"Metadata/plate_{n}.json", "{}")
+ return str(out)
+
+
+def convert(path, mode, tmp_path):
+ out_dir = tmp_path / f"out-{mode}"
+ r = service.convert(path, out_dir=str(out_dir), prepare_mode=mode)
+ assert r["validated_ok"], r["errors"]
+ return r
+
+
+# --- 1. the plate count and the placement card ------------------------------------
+
+@pytest.mark.parametrize("plate_json", [0, 1])
+def test_plate_count_comes_from_the_plates_the_project_declares(tmp_path, plate_json):
+ path = build(tmp_path, plate_json=plate_json) # 2 plates, fewer than 2 plate_N.json
+ assert fingerprint.compute_fingerprint(ThreeMF.open(path)).plate_count == 2
+ assert service.doctor(path)["plate_count"] == 2
+
+
+def test_plate_count_falls_back_to_the_slice_cache_without_plate_records(tmp_path):
+ path = tmp_path / "no-plates.3mf"
+ with zipfile.ZipFile(BASE) as src, zipfile.ZipFile(path, "w") as dst:
+ for item in src.infolist():
+ if item.filename != MODEL_SETTINGS:
+ dst.writestr(item, src.read(item.filename))
+ dst.writestr("Metadata/plate_1.json", "{}")
+ dst.writestr("Metadata/plate_2.json", "{}")
+ assert fingerprint.compute_fingerprint(ThreeMF.open(str(path))).plate_count == 2
+
+
+def test_multi_plate_placement_is_never_every_object_inside(tmp_path):
+ check = service.placement_check(build(tmp_path))
+ assert check["available"] and check["plate_count"] == 2
+ assert check["off_plate"] == [] # each plate fits on its own...
+ assert check["placement_established"] is False
+ assert check["summary"] == NOTE # ...and Studio says what it cannot check
+ assert "inside" not in check["summary"].lower()
+ assert "use Arrange" not in check["summary"]
+
+
+def test_single_plate_placement_is_still_established(tmp_path):
+ check = service.placement_check(build(tmp_path, "one.3mf", plates=1))
+ assert check["plate_count"] == 1 and check["placement_established"] is True
+ assert "sits inside" in check["summary"]
+
+
+# --- 2. preflight and Ready Now ----------------------------------------------------
+
+def _prepared_multi_plate(tmp_path):
+ out = convert(build(tmp_path), "preserve", tmp_path)["output_path"]
+ return out
+
+
+def test_preflight_bed_fit_is_unknown_for_multi_plate_with_a_printer(tmp_path):
+ path = _prepared_multi_plate(tmp_path)
+ bed = {"min_x": 0.0, "min_y": 0.0, "max_x": 270.0, "max_y": 270.0}
+ placement = plate_placement.assess(path, bed=bed, bed_name="this printer's")
+ check = next(c for c in pf.evaluate(traits(), printer([spool()]), placement)["checks"]
+ if c["id"] == "bed.fit")
+ assert check["result"] == pf.UNKNOWN
+ assert check["confidence"] == pf.INFORMATIONAL
+ assert "Review the project in Snapmaker Orca" in check["action"]
+ assert "use Arrange" not in check["action"]
+ assert "Nothing is placed off the plate" not in json.dumps(check)
+
+
+def test_preflight_bed_fit_stays_ok_for_a_single_plate_project(tmp_path):
+ one = convert(build(tmp_path, "one.3mf", plates=1), "preserve", tmp_path)["output_path"]
+ bed = {"min_x": 0.0, "min_y": 0.0, "max_x": 270.0, "max_y": 270.0}
+ placement = plate_placement.assess(one, bed=bed)
+ check = next(c for c in pf.evaluate(traits(), printer([spool()]), placement)["checks"]
+ if c["id"] == "bed.fit")
+ assert check["result"] == pf.OK
+
+
+def test_ready_now_does_not_call_a_multi_plate_project_ready(tmp_path):
+ bed = {"min_x": 0.0, "min_y": 0.0, "max_x": 270.0, "max_y": 270.0}
+ p = printer([spool()])
+
+ def bucket(path):
+ placement = plate_placement.assess(path, bed=bed, bed_name="this printer's")
+ pre = pf.evaluate(traits(), p, placement)
+ return rd.classify_project(PROJECT, traits(), p, pre, "ok")
+
+ one = convert(build(tmp_path, "one.3mf", plates=1), "preserve", tmp_path)["output_path"]
+ assert bucket(one)["bucket"] == rd.READY_NOW # control: the same flow, one plate
+ multi = bucket(_prepared_multi_plate(tmp_path))
+ assert multi["bucket"] == rd.CANT_DETERMINE # unresolved, not blocked, not ready
+ assert "Fits the printer's bed" in multi["top_reason"]
+
+
+# --- 3. the Doctor ------------------------------------------------------------------
+
+def test_doctor_ready_carries_the_unresolved_placement_note_for_multi_plate(tmp_path):
+ prepared = _prepared_multi_plate(tmp_path)
+ d = service.doctor(prepared)
+ assert d["verdict"] == "READY" and d["plate_count"] == 2
+ assert d["recommended_action"].startswith(
+ "Ready for Snapmaker U1 - open it in Snapmaker Orca and slice.")
+ assert "has not checked where they sit" in d["recommended_action"]
+ assert "Review it in Snapmaker Orca before slicing" in d["recommended_action"]
+ assert "use Arrange" not in d["recommended_action"]
+
+
+def test_doctor_ready_for_a_single_plate_project_is_unchanged(tmp_path):
+ one = convert(build(tmp_path, "one.3mf", plates=1), "preserve", tmp_path)["output_path"]
+ d = service.doctor(one)
+ assert d["verdict"] == "READY"
+ assert d["recommended_action"] == "Ready for Snapmaker U1 - open it in Snapmaker Orca and slice."
+
+
+# --- 4. Recommended mode and the creator's supports ---------------------------------
+
+def test_recommended_says_it_does_not_keep_the_creators_supports(tmp_path):
+ src = build(tmp_path, supports=True, painted_supports=True)
+ summary = convert(src, "recommended", tmp_path)["settings_summary"]
+ note = summary["supports_note"]
+ assert note.startswith("Supports: the creator turned supports on. This mode does not keep them;")
+ assert "Snapmaker Orca will open with supports off" in note
+ assert "Support tab" in note and "Preserve creator settings" in note
+ assert "painted support areas" in note
+
+
+def test_recommended_does_not_mention_painted_supports_that_do_not_exist(tmp_path):
+ summary = convert(build(tmp_path, supports=True), "recommended", tmp_path)["settings_summary"]
+ assert "painted" not in summary["supports_note"]
+
+
+def test_the_note_is_computed_from_the_config_not_asserted(tmp_path):
+ # Supports off in the source: nothing to say, even in Recommended.
+ off = convert(build(tmp_path, "off.3mf"), "recommended", tmp_path)["settings_summary"]
+ assert "supports_note" not in off
+
+
+def test_preserve_keeps_the_supports_and_says_nothing_about_dropping_them(tmp_path):
+ src = build(tmp_path, supports=True, painted_supports=True)
+ r = convert(src, "preserve", tmp_path)
+ assert "supports_note" not in r["settings_summary"]
+ with zipfile.ZipFile(r["output_path"]) as z:
+ cfg = json.loads(z.read(SETTINGS))
+ assert cfg["enable_support"] == "1"
+ assert "enable_support" in cfg["different_settings_to_system"][0] # Orca will use it
+
+
+def test_recommended_still_writes_what_it_always_wrote_for_supports(tmp_path):
+ # Disclosure only: Recommended's output is not changed to re-declare the support keys.
+ r = convert(build(tmp_path, supports=True), "recommended", tmp_path)
+ with zipfile.ZipFile(r["output_path"]) as z:
+ cfg = json.loads(z.read(SETTINGS))
+ assert "enable_support" not in cfg["different_settings_to_system"][0]
+
+
+def test_validation_report_only_says_values_are_kept_where_that_is_true(tmp_path):
+ src = build(tmp_path, supports=True)
+ rec = convert(src, "recommended", tmp_path)["output_path"]
+ pres = convert(src, "preserve", tmp_path)["output_path"]
+
+ def changes(path, mode):
+ return " | ".join(service.report(path, mode)["changes"])
+
+ assert "your setting values are kept" in changes(pres, "preserve")
+ rec_text = changes(rec, "recommended")
+ assert "values are kept" not in rec_text
+ assert "replaced by Studio's U1 starter settings" in rec_text
+ # The file alone does not say how it was prepared: no promise either way.
+ unknown = changes(rec, None)
+ assert "your setting values are kept" not in unknown
+ assert "only when prepared with Preserve creator settings" in unknown
+ assert "your setting values are kept" not in changes(pres, None)
diff --git a/backend/tests/test_intelligence_report.py b/backend/tests/test_intelligence_report.py
index bdf0b9c0..6e453654 100644
--- a/backend/tests/test_intelligence_report.py
+++ b/backend/tests/test_intelligence_report.py
@@ -316,3 +316,22 @@ def test_an_unavailable_bed_fit_is_listed_as_not_verified_not_as_no_risk():
# control: a size that is not established is reported by its own finding, not double-listed
nc = ir.build(bed_fit={"available": False, "status": "not_checked", "reason": "unit is inch"}, mm=mm_ok)
assert "bed fit" not in nc["not_verified"]
+
+
+def test_an_unavailable_bed_fit_changes_the_headline_not_just_the_list():
+ """The headline must not read as a clean result when the bed-fit check could not run."""
+ from snapstudio_core import intelligence_report as ir
+ mm_ok = {"available": True, "overall_level": "ok", "findings": []}
+ out = ir.build(bed_fit={"available": False, "basis": "size", "reason": "printer not identified"}, mm=mm_ok)
+ assert "bed fit was not verified" in out["verdict"]
+ assert "found no risks. That" not in out["verdict"]
+ assert "bed fit" in out["next_action"].lower()
+ assert "bed fit was not verified" in out["comparison"]["studio_line"]
+ assert "found nothing in this file. " not in out["comparison"]["studio_line"]
+ # both gaps are named together
+ both = ir.build(bed_fit={"available": False, "basis": "size", "reason": "printer not identified"},
+ mm=mm_ok, spacing={"status": "unknown"})
+ assert "object spacing and bed fit were not verified" in both["verdict"]
+ # control: a size that is not established keeps its own finding and is not double-listed
+ nc = ir.build(bed_fit={"available": False, "status": "not_checked", "reason": "unit is inch"}, mm=mm_ok)
+ assert "bed fit was not verified" not in nc["verdict"]
diff --git a/backend/tests/test_no_arrange_remedy.py b/backend/tests/test_no_arrange_remedy.py
new file mode 100644
index 00000000..a2e30062
--- /dev/null
+++ b/backend/tests/test_no_arrange_remedy.py
@@ -0,0 +1,46 @@
+"""Studio does not recommend Arrange as a remedy.
+
+In Snapmaker Orca 2.4.0, on a two-plate project made for a larger-bed printer,
+Arrange all plates did not fix an Outside object or an inherited prime tower; for a
+single plate it was never tested. A text that tells people Arrange fixes placement is
+therefore unsupported. The one sentence that may name it says it did not work.
+"""
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+ALLOWED = "Arrange all plates did not fix that in our test"
+ARRANGE = re.compile(r"\barrange\b", re.IGNORECASE) # not "arrangement"
+
+SCAN = [
+ (ROOT / "backend" / "snapstudio_core", "*.py"),
+ (ROOT / "backend" / "snapstudio_api", "*.py"),
+ (ROOT / "backend" / "u1convert", "*.py"),
+ (ROOT / "desktop" / "src", "*.ts"),
+ (ROOT / "desktop" / "src", "*.tsx"),
+ # site/guide/content is deliberately not scanned here: the user guide is held and
+ # reviewed on its own, so this guard covers the app and engine text only.
+]
+
+
+def _files():
+ for base, pattern in SCAN:
+ for path in sorted(base.rglob(pattern)):
+ if ".test." in path.name or "node_modules" in path.parts:
+ continue
+ yield path
+
+
+def test_no_text_recommends_arrange():
+ offenders = []
+ for path in _files():
+ for number, line in enumerate(path.read_text("utf-8").splitlines(), 1):
+ if ARRANGE.search(line.replace(ALLOWED, "")):
+ offenders.append(f"{path.relative_to(ROOT)}:{number}: {line.strip()[:120]}")
+ assert not offenders, "Arrange is not a tested remedy:\n" + "\n".join(offenders)
+
+
+def test_the_guard_actually_scans_something():
+ assert sum(1 for _ in _files()) > 100
diff --git a/backend/tests/test_plate_placement.py b/backend/tests/test_plate_placement.py
index aa23a4ca..c9bbce69 100644
--- a/backend/tests/test_plate_placement.py
+++ b/backend/tests/test_plate_placement.py
@@ -310,7 +310,9 @@ def test_multi_plate_projects_are_never_repositioned(tmp_path):
}, printable_area=SOURCE_350)
out = pp.assess(p)
assert out["fixable"] is False
- assert "does not reposition" in out["summary"]
+ # Reworded: the old text claimed the plates "fit" the printable area and only said Studio
+ # does not reposition them; it now says what Studio cannot check (see test_honest_claims).
+ assert "cannot check where the plates sit" in out["summary"]
res = pp.prepare_placed_copy(p, out_dir=str(out_dir))
assert res["ok"] is False
assert not out_dir.exists() or list(out_dir.iterdir()) == []
@@ -321,7 +323,7 @@ def test_the_refusal_explains_why_rather_than_just_declining(tmp_path):
1: [(1, 170, 170)], 2: [(2, 540, 170)],
}, printable_area=SOURCE_350)
summary = pp.assess(p)["summary"]
- assert "not recorded in the file" in summary or "does not reposition" in summary
+ assert "cannot check where the plates sit" in summary and "did not fix that in our test" in summary
def test_a_plate_whose_contents_are_too_big_is_reported(tmp_path):
diff --git a/backend/tests/test_preflight.py b/backend/tests/test_preflight.py
index 388b85cd..aa448c5a 100644
--- a/backend/tests/test_preflight.py
+++ b/backend/tests/test_preflight.py
@@ -272,9 +272,12 @@ def test_objects_off_the_real_bed_need_attention_and_point_at_the_fix():
assert "placement fix" in check["action"] or "placement" in check["action"]
-def test_unfixable_placement_points_at_arrange_instead():
+def test_unfixable_placement_points_at_the_slicer_without_promising_a_fix():
+ # Reworded: Arrange is not a tested remedy, so the action says to review the project.
out = pf.evaluate(traits(), printer(), placement=placement(off=1, fixable=False))
- assert "Arrange" in by_id(out, "bed.fit")["action"]
+ action = by_id(out, "bed.fit")["action"]
+ assert "Review the project in Snapmaker Orca" in action
+ assert "Arrange" not in action
def test_bed_is_unknown_when_placement_could_not_be_read():
diff --git a/desktop/src/api.ts b/desktop/src/api.ts
index ecac8676..2b4dec0c 100644
--- a/desktop/src/api.ts
+++ b/desktop/src/api.ts
@@ -139,6 +139,8 @@ export interface SettingsSummary {
warnings: string[];
recommendations_available: boolean;
recommended_changes: SettingsChange[];
+ /** Present only when the creator's supports will not be in effect in Orca (Recommended mode). */
+ supports_note?: string;
/** Present only when Project Materials made a choice (or the engine was given the installed presets). */
project_materials?: ProjectMaterialsSummary;
}
@@ -1404,6 +1406,8 @@ export interface PlacementCheck {
reason?: string;
source_printer?: string | null;
plate_count?: number;
+ /** False when positions across plates are not established by Studio (multi-plate projects). */
+ placement_established?: boolean;
item_count?: number;
items: PlacementItem[];
off_plate: PlacementItem[];
diff --git a/desktop/src/components/FixPlan.tsx b/desktop/src/components/FixPlan.tsx
index 4d10f477..afe3720c 100644
--- a/desktop/src/components/FixPlan.tsx
+++ b/desktop/src/components/FixPlan.tsx
@@ -71,8 +71,8 @@ export function buildFixPlan(p: FixPlanProps): FixAction[] {
}
if (!p.isStl && (p.doctor?.object_count ?? 0) > 1) {
issues.push({
- title: "Arrange the plate and check spacing",
- detail: "Studio can't verify object-to-object spacing for multi-part layouts. In Orca, use Arrange and watch for too-close / collision warnings.",
+ title: "Check object spacing",
+ detail: "Studio can't verify object-to-object spacing for multi-part layouts. Review the project in Snapmaker Orca and watch for too-close / collision warnings.",
where: "Orca",
level: "warn",
});
diff --git a/desktop/src/components/PlacementCard.test.tsx b/desktop/src/components/PlacementCard.test.tsx
new file mode 100644
index 00000000..51f706e4
--- /dev/null
+++ b/desktop/src/components/PlacementCard.test.tsx
@@ -0,0 +1,32 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it } from "vitest";
+import type { PlacementCheck } from "@/api";
+import { PlacementView } from "./PlacementCard";
+
+const NOTE = "Each plate fits on its own, but Studio cannot check where the plates sit. In our test with a two-plate project made for a larger-bed printer, Snapmaker Orca listed one object as Outside and would not slice until it was moved by hand; Arrange all plates did not fix that in our test. Review the project in Snapmaker Orca before slicing.";
+
+const check = (over: Partial = {}): PlacementCheck => ({
+ schema_version: "placement/1", available: true, items: [], off_plate: [], fixable: false,
+ item_count: 2, plate_count: 1, ...over,
+});
+
+const render = (c: PlacementCheck) =>
+ renderToStaticMarkup( {}} />);
+
+describe("PlacementCard", () => {
+ it("never says every object is inside for a multi-plate project", () => {
+ const html = render(check({ plate_count: 2, placement_established: false, summary: NOTE }));
+ expect(html).toContain("Each plate fits on its own, but Studio cannot check where the plates sit.");
+ expect(html).toContain("Arrange all plates did not fix that in our test");
+ expect(html).not.toContain("use Arrange all plates");
+ expect(html).not.toContain("Every object sits inside");
+ expect(html).not.toContain("text-ready"); // no green check
+ });
+
+ it("still passes a single-plate project that is on the plate", () => {
+ const html = render(check());
+ expect(html).toContain("Every object sits inside the U1's printable area.");
+ expect(html).toContain("text-ready");
+ });
+});
+
diff --git a/desktop/src/components/PlacementCard.tsx b/desktop/src/components/PlacementCard.tsx
index 3d6a9351..c99d71ca 100644
--- a/desktop/src/components/PlacementCard.tsx
+++ b/desktop/src/components/PlacementCard.tsx
@@ -39,9 +39,6 @@ export function PlacementCard({ path }: { path: string }) {
// route still have something to say.
if (failed) return null;
- const verdict = placementVerdict(check);
- const blocked = blockedReason(check);
-
const runFix = async () => {
setFixing(true);
try {
@@ -52,12 +49,26 @@ export function PlacementCard({ path }: { path: string }) {
: "Studio did not move anything — see the reason on the card.");
if (result.ok) setCheck(result.after ?? check);
} catch {
- showToast("Couldn't reposition this project — open it in Snapmaker Orca and use Arrange.");
+ showToast("Couldn't reposition this project — review it in Snapmaker Orca before slicing.");
} finally {
setFixing(false);
}
};
+ return ;
+}
+
+/** What the card shows for a given check. Separate from the fetching so it can be rendered on its own. */
+export function PlacementView({ check, fix, fixing, onFix }: {
+ check: PlacementCheck | null;
+ fix: PlacementFix | null;
+ fixing: boolean;
+ onFix: () => void;
+}) {
+ const showToast = useToast((s) => s.show);
+ const verdict = placementVerdict(check);
+ const blocked = blockedReason(check);
+
return (
@@ -90,13 +101,13 @@ export function PlacementCard({ path }: { path: string }) {
{blocked && (
- {blocked} Open the project in Snapmaker Orca and use Arrange.
+ {blocked} Review the project in Snapmaker Orca before slicing.
)}
{verdict.canFix && !fix?.ok && (
-
diff --git a/desktop/src/test-fixtures/compat-blocked.json b/desktop/src/test-fixtures/compat-blocked.json
index 87dc5199..e0074d50 100644
--- a/desktop/src/test-fixtures/compat-blocked.json
+++ b/desktop/src/test-fixtures/compat-blocked.json
@@ -79,7 +79,7 @@
"title": "Object spacing / collisions are not verified by Studio yet",
"explanation": "Studio does not yet check object-to-object spacing for multi-part 3MF layouts, so it cannot confirm objects aren't too close or colliding.",
"setting_path": "Object layout (plate)",
- "suggested_action": "Open in Snapmaker Orca and check for too-close / collision warnings; use Arrange or move objects before slicing.",
+ "suggested_action": "Review the project in Snapmaker Orca and look for too-close / collision warnings before slicing.",
"evidence": "2 object(s) on the plate; spacing unchecked by Studio"
}
],
@@ -103,7 +103,7 @@
"title": "Object spacing / collisions are not verified by Studio yet",
"explanation": "Studio does not yet check object-to-object spacing for multi-part 3MF layouts, so it cannot confirm objects aren't too close or colliding.",
"setting_path": "Object layout (plate)",
- "suggested_action": "Open in Snapmaker Orca and check for too-close / collision warnings; use Arrange or move objects before slicing.",
+ "suggested_action": "Review the project in Snapmaker Orca and look for too-close / collision warnings before slicing.",
"evidence": "2 object(s) on the plate; spacing unchecked by Studio"
}
],
@@ -181,7 +181,7 @@
"title": "Object spacing / collisions are not verified by Studio yet",
"explanation": "Studio does not yet check object-to-object spacing for multi-part 3MF layouts, so it cannot confirm objects aren't too close or colliding.",
"setting_path": "Object layout (plate)",
- "suggested_action": "Open in Snapmaker Orca and check for too-close / collision warnings; use Arrange or move objects before slicing.",
+ "suggested_action": "Review the project in Snapmaker Orca and look for too-close / collision warnings before slicing.",
"evidence": "2 object(s) on the plate; spacing unchecked by Studio"
}
],