Rekonstruktion & Zeichnung wissenschaftlicher Figuren
Ein unabhängiger, anbieterneutraler Skill. Der aufrufende Host entscheidet, was gezeichnet wird; die Engine führt deklarierte Geometrie, Farben, Ebenen, Bearbeitungen und Exporte aus. Liefert SVG sowie ein daraus gerendertes PNG. Verwenden Sie Anaconda ScientificFigure_skill und die installierte figure-cli.
0.10 Leitfaden: zwei Aufgaben, ein Host und Scene
Die aktuelle Engine 0.10.0 fügt deterministische Layout-Qualitätssicherung (layout-audit), begrenzte Layout-Reparaturen (--fix) und eine Schriftart-Profil-Vorprüfung auf Basis von 0.9 hinzu. FigurePlan 0.1 und Scene 0.3 sind unverändert, und die Ausführungs-, Bearbeitungs- und Rendering-Grundlage von 0.8 bleibt erhalten. Der aufrufende Host ist bereits das Modell, das die Interpretation und visuelle Überprüfung durchführt; fügen Sie kein zweites Modell oder keinen Second Agent hinzu. Siehe 0.10 Plan und QA-Vertrag; 0.9 Plan, 0.8 Fähigkeiten und semantische Planung / neuer CLI-Workflow bleiben für alles Folgende aktuell. Die Workflow-Seite definiert die implementierten Einstiegspunkte und genauen Dateiverträge; Lieferhinweise dokumentieren die tatsächliche Verifikation und Grenzen.
Wählen Sie die Aufgabenanleitung, bevor Sie eine komplexe Figur konstruieren:
- Referenz-Rekonstruktion: Lesen Sie Referenz-Rekonstruktion. Stellen Sie Informationsstruktur und Lesereihenfolge, wesentliche Teile, Beziehungen und spezifische Unbekannte vor der Geometrie fest. Trennen Sie Entitäten, Prozesspfeile, Anmerkungsführungslinien, vergrößerte Ansichten, Legenden und Dekoration. Füllen Sie unlesbare Bereiche nicht mit thematischem Wissen.
- Natürlichsprachliches Design: Lesen Sie Textdesign. Trennen Sie benutzerexplizite Inhalte, Designentscheidungen und wissenschaftliche Annahmen. Entwerfen Sie die Hierarchie um den gewünschten Mechanismus; erfinden Sie keine Vorbereitung, Verwaltung oder experimentellen Bedingungen.
- Beide Aufgaben: Verwenden Sie Konstruktionsauswahl, wenn die Methode unsicher ist. Wählen Sie basierend auf erforderlicher Form, Teilen, Wiederholung, Löchern, Verdeckung und Stil und vergleichen Sie dann die tatsächlich verfügbaren Ressourcen. Ein einfaches flaches Objekt kann direkt von einer kurzen Absicht/unbekannte Notiz zur Geometrie und Vorschau übergehen; keine obligatorische Suche oder mehrere Planungsdateien.
Standardmäßig autonom arbeiten; nur anhalten, wenn danach gefragt wird
| Modus | Start, wenn … | Host-Verhalten |
|---|---|---|
autonomous (Standard) | Der Benutzer nach der Figur fragt oder sagt, sie fertigzustellen | Zeichnen, prüfen, korrigieren und ausliefern; nicht zur Genehmigung bei jedem Schritt anhalten |
interactive | Der Benutzer nach einer Probe fragt, jede Seite bestätigen oder teilnehmen möchte | Den vereinbarten Checkpoint veröffentlichen und auf Feedback oder Genehmigung warten |
- Das Öffnen einer Überprüfungsseite erzwingt keine Pause. Im autonomen Modus lesen Sie neues Feedback beim nächsten sicheren Checkpoint; wenn der Benutzer bittet anzuhalten, stoppen Sie die Veröffentlichung von Kandidaten und bearbeiten Sie zuerst seine Änderungen.
- Im interaktiven Modus beenden und veröffentlichen Sie die erste vereinbarte Seite, warten Sie, und fahren Sie dann fort. Bei mehrseitiger Arbeit legt die erste genehmigte Seite gemeinsame Typografie, Abstände, Kartenstil und Palettenregeln fest; spätere Seiten teilen diese Regeln, kein erzwungenes identisches Layout.
- Ein Host, der keine Bilder lesen kann, kann Geometrie und strukturelle Prüfungen verwenden, muss aber die visuelle Überprüfung als
not_executedbelassen. - Das Genehmigen einer SVG-Version ist keine wissenschaftliche Überprüfung und genehmigt keine spätere Version.
Standard: verstehen, auswählen, konstruieren, prüfen, korrigieren
- Zweck, beabsichtigte Anzeigegröße, Module und Lesereihenfolge angeben. Objekte, unverzichtbare interne Teile, editierbare Einheiten, Beschriftungen, Farbbedeutungen und Beziehungen auflisten. Nicht aufgelöste Inhalte explizit halten. Bei einer komplexen Figur diesen Entwurf vor dem Schreiben umfangreicher Geometrie prüfbar machen. Vorhandene FigurePlan-Module/-Objekte/-Beziehungen verwenden, wo nützlich; nicht ausgewählte Konstruktionen können
unresolvedbleiben. Dies sind Stufen einer Planungseingabe, kein weiterer Scene-Baum. - Nur die lokalen Fragen stellen, die eine Entscheidung beeinflussen: zum Beispiel, ob eine blasse Fläche eine Öffnung oder eine Oberfläche ist, oder wo eine Führungslinie endet. Das Original und relevante Ausschnitte prüfen; quellgebundene Beweise nur nach Bedarf verwenden. ROI und Koordinatenzuordnungen beibehalten. Messungen und Ähnlichkeitswerte sind Beobachtungen, keine Objektidentitäten oder wissenschaftliches Vertrauen; es gibt keine implizite OCR.
- Rezept/Asset/Direkt/Programm nach Struktur und Stil wählen. Tatsächliche Rezeptparameter und Schlüssel editierbarer Teile oder Asset-Rechte und Importgrenzen prüfen. Der Katalog hat 15 Rezeptfamilien, zwei Symbolfamilien-Metadateneinträge und ein Twemoji-Zitronen-Asset; erfinden Sie keine Maus-/Kolben-/Avatar-Rezepte. Wenn ein Rezept erforderliche Teile auslässt, lehnen Sie diese Konstruktion ab und fallen Sie auf ein freies Programm zurück, gegebenenfalls unter Kombination geeigneter Unterteile. Verwenden Sie lokale Koordinaten, Kurven, Transformationen, vorhandene Zeichenfunktionen und ausgereifte Bibliotheken. Direct Scene, Legacy Semantic Plan 0.3 und
SceneBuilderbleiben gültig; erfordern Sie kein großes handgeschriebenes JSON vor dem Zeichnen. - Hauptstruktur und erforderliche Interna zuerst aufbauen, dann Verbinder und Beschriftungen. Stabile Objekt-/Teil-IDs beibehalten. Gefüllte Oberflächen, Striche, echte Löcher, begrenzte Masken/Verdeckungen, Wiederholungen und Verläufe nach Bedarf verwenden; kein Volumenlicht zu flacher Kunst hinzufügen. Der Host führt Programme explizit über gewöhnliche Werkzeuge aus und liefert generierte Scene-Fragmente; Check/Kompilierung und Projekt laden führen keine gespeicherte Quelle aus. Neue Kandidaten getrennt von einem bearbeiteten Projekt halten und B/U/C-Merging vor der Annahme verwenden.
- Das tatsächliche
preview.pngin der beabsichtigten Anzeigegröße lesen und wichtige vergrößerte Bereiche prüfen. Module und Verbindungen → Silhouette/Proportionen/Löcher → notwendige interne Struktur → Farben/Ebenen → Text prüfen. Referenz im gleichen Maßstab vergleichen; beim Ersetzen einer früheren Zeichnung Referenz/alt/neu gemeinsam vergleichen. Ein gültiger Plan, benannter Pfad oder bestandener Test kann nicht belegen, dass die beabsichtigte Struktur korrekt gezeichnet wurde. - Jeden Befund mit einer ID und einer konkreten Aktion verknüpfen: Konstruktionsmethode ändern, Kandidaten ersetzen, Geometrie/Parameter anpassen, lokale Beweise einholen oder Unsicherheit beibehalten. Gegen die aktuelle Revision patchen oder einen Kandidaten neu generieren und zusammenführen; erneut rendern und prüfen. Standardmäßig höchstens drei gezielte Korrekturrunden. Akzeptierte Objekte und Benutzerbearbeitungen beibehalten. Visuelle Bewertung an die aktuelle Scene/Vorschau binden; geänderte Geometrie, Ressourcen oder Rendering machen alte Bewertungen ungültig. Auslassungen und nicht ausgeführte Überprüfungen melden. Wissenschaftliche Überprüfung bleibt getrennt und unausgeführt, wenn nicht angefordert.
Erfolg bedeutet eine gut gezeichnete, strukturell klare Figur mit unabhängig editierbaren Hauptteilen. Tests legen technisches Verhalten fest, nicht Zeichenqualität. Unabhängige Host-Ablationen, zurückgehaltene Benchmark-Kampagnen, menschliche Gremien, Bereichszertifizierung, Laufzeitintegration, versionsübergreifende Vorlagenmigration und experimentelle Offset-/variablenbreiten Entwicklung liegen außerhalb des aktuellen Arbeitsumfangs. Machen Sie sie nicht zu Voraussetzungen oder unaufgeforderten nächsten Aufgaben. Tatsächliche Wiederverwendung separat als externe Kunstwerke, Zeichencode-Wiederverwendung und Geometrie-/Rendering-Bibliothekswiederverwendung melden; ein Asset im Registry zu haben bedeutet nicht, dass diese Zeichnung es verwendet hat.
Der Host kann Python- oder JavaScript-Zeichenprogramme schreiben. Verwenden Sie gewöhnliche Variablen, Funktionen, lokale Koordinaten, Transformationen, Wiederholungen und ausgereifte Geometriebibliotheken, um Formen zu berechnen; stabile Engine-Helfer verwenden, wenn verfügbar. Ein figurspezifisches Zeichenprogramm ist erlaubt; machen Sie nicht aus ein paar Referenzfiguren themenspezifische Engine-Algorithmen oder behandeln Sie Beispielpläne als wissenschaftliche Vorlagenbibliothek. Generierte Scene/Plan-Kandidaten durch Engine-Validierung, Rendering und Projekt-Transaktionen senden. Beim erneuten Ausführen gegen ein bearbeitetes Projekt die letzte generierte Baseline, die aktuelle Scene und den neuen Kandidaten vergleichen, bevor Änderungen akzeptiert werden; Benutzerbearbeitungen beibehalten und Konflikte melden. Verwenden Sie die verfügbaren Konstruktionshilfen und Generierungsprotokoll: generation diff PROJECT --candidate SOURCE --output DIFF, die vorgeschlagene Vorschau und Konflikte prüfen, dann generation accept PROJECT --candidate DIFF --base-revision N. Gespeicherte Quelle ist inert; Akzeptieren berechnet den Merge neu und prüft aktuelle Revision/Inhalt/Beleg. Überschreiben Sie niemals ein bearbeitetes Projekt mit reinem Skriptoutput. Betten Sie keine Rasterbilder ein, verfolgen Sie nicht jede Textur in winzige Pfade, oder ersetzen Sie fehlende Struktur durch eine attraktive Füllung.
Entscheiden Sie zwischen Rekonstruktion aus der gelieferten Referenz und erlaubter Ressourcenwiederverwendung vor dem Zeichnen. Trennen Sie separat: externe Kunstwerke (Quelle, Lizenz, Version/Hash und Änderungen); wiederverwendeter Zeichencode, einschließlich Ihrer eigenen Funktionen (Datei/Version, wiederverwendete Teile und Änderungen); und Geometrie-/Rendering-Bibliotheken (tatsächliche Bibliothek/Version und Rolle). Eine lokal geschriebene Funktion ist kein externes Asset, und ein Bibliotheksaufruf ist kein ausgeliehenes Kunstwerk. Methodeninspiration separat von kopiertem Code aufzeichnen; kopierter externer Code benötigt seine feste Quellrevision, Dateien, Lizenz und Hinweise. Für einen explizit eingefrorenen Rastervergleich niemals eine offizielle Quell-SVG ersetzen. Hauptstruktur, Geometrie/Löcher/Verdeckung, dann Stil/Text in tatsächlichen Vorschauen innerhalb desselben Korrekturbudgets prüfen. Hintergrundfarbene Abdeckpatches belegen keine echten Löcher oder editierbare Verflechtung. Programmquellen sind Reproduzierbarkeitseingaben; die akzeptierte Scene ist die einzige aktuelle editierbare Autorität. Das Öffnen eines Projekts oder Bündels darf kein Zeichenprogramm ausführen.
Mit Dateien ausführen, ohne einen Modellservice
conda run -n ScientificFigure_skill figure-cli doctor --json
Verwenden Sie inspect reference.png für Quellgröße/Hash. Quellgebundene Pläne deklarieren SHA-256, Größe und ROI. Legacy Plan 0.3 semantische Ausführung führt nicht implizit Farbsegmentierung, Pixelkandidatensuche oder Skelettanalyse aus. Alte Plan 0.1/0.2-Eingaben behalten ihr Verhalten.
conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure
Vorschau-Schleife und Phasenzeitmessung
draw und reconstruct akzeptieren --preview: es schreibt nur figure.svg, preview.png und preview.json, rendert im Maßstab 1, es sei denn, --scale sagt etwas anderes, und kann seine eigene vorherige Vorschau ersetzen. Es ist kein Projekt oder Liefergegenstand — kein Beleg, Objektmanifest, QA-Aufzeichnung, Überprüfungsbindung oder Referenzvergleich — also verwenden Sie es für den ersten Blick und für jede Korrekturrunde, dann führen Sie denselben Befehl ohne --preview aus, sobald die Struktur stimmt.
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
Beide Pfade geben timings in Sekunden zurück: validate, to_svg, render, inventory, qa, publish, total; eine Vorschau lässt die Lieferphasen aus, und der Beleg zeichnet dieselben Phasen vor der Veröffentlichung auf. Auf diesem Host dauert eine Scene mit 501 Objekten etwa 0,33 s als Vorschau und 1,16 s als vollständiges Projekt, wobei der meiste Unterschied auf das PNG-Rendering im Maßstab 1 gegenüber 3 zurückzuführen ist. Die Engine kann die modellseitige Zeit nicht sehen: Wenn Sie eine Rekonstruktion messen, zeichnen Sie die erste Inferenz des Hosts, Ausgabe-Token und Korrekturrunden neben diesen Zahlen auf, und schreiben Sie Engine-Sekunden niemals der Modelllatenz zu oder umgekehrt.
Text und Schriftarten vor komplexer Konstruktion prüfen
Sammeln Sie jede Zeichenfolge, die die Figur zeichnen wird — Beschriftungen, Formeln, Einheiten, Achsentexte, Legenden — in einer einzigen Anfrage und führen Sie diese vor der Geometrie aus:
{"schema_version": "0.1", "texts": ["Zellmembran", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts
status: ok wählt eine echte lokale Schriftart aus und schreibt font-probe.json plus font-probe-sample.png; needs_input listet fehlende Zeichen und Abdeckung pro Schriftart auf. --font PATH fügt eine bestimmte Datei hinzu. --profile (Standardname scientific-default) löst zusätzlich die paketierte Empfehlung (Times New Roman / Microsoft YaHei / Cambria Math) gegen installierte Schriftarten auf und meldet für jede Rolle Pfad, Schriftart, Digest und fehlende Beispielzeichen; eine Schriftfamilie, die nicht vorhanden ist, wird als fehlend gemeldet, niemals ersetzt. Die Engine rendert eine Familie, also behaupten Sie keine gemischte Schriftart-Rückfallebene: setzen Sie SCIENTIFIC_FIGURE_FONT selbst auf den ausgewählten Pfad, oder vereinfachen Sie den Text. Bei mehreren Seiten prüfen Sie die Vereinigung aller Seiten einmal, vor Seite 1. Ein fehlendes Glyph ist eine Konstruktionsentscheidung, kein Exportfehler in letzter Minute.
Zeigen Sie die Figur, während Sie zeichnen
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review
review-serve serviert das neueste erfolgreich veröffentlichte figure.svg auf 127.0.0.1 mit einem zufälligen Token und gibt die URL aus, bevor es blockiert. Die Seite behält Zoom, Schwenken und nicht gesendete Pins über Neuladungen hinweg bei und ermöglicht es dem Benutzer, einen Kommentar an eine Objekt-ID oder einen leeren Raum zu heften. review-status liest das Feedback-Protokoll. Fügen Sie --wait --timeout N hinzu, um zu blockieren, bis eine neue Runde eintrifft; ohne es, stoppen Sie mit Strg-C. Der Server liest nur die Figur und schreibt Feedback; er bearbeitet niemals das Projekt.
Feedback wird in <preview>-review/feedback.json gespeichert, außerhalb des ersetzbaren Vorschauverzeichnisses, und jede Einreichung ist an den SVG-SHA256 und die Revision gebunden, die angezeigt wurden. Eine Einreichung von einer älteren Version wird mit HTTP 409 abgelehnt, niemals stillschweigend angewendet. Akzeptierte Kommentare durch einen normalen Patch oder Generierungs-Merge anwenden, dann eine neue Vorschau veröffentlichen. Die lokale Seite ist ein Browser-Fallback; sie erstellt keine VS Code-Seitenleiste, und ein eingebetteter Host muss Feedback weiterhin als diese versionierte Datei behandeln.
Nur Grafiken und finale SVGs ausliefern
conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure
Dies liest ein validiertes Projekt und schreibt figure.final.svg plus figure.graphics.svg (kein Text) und variants.json. Beide stammen von derselben Scene, daher behalten gemeinsame IDs identische Geometrie und Stil; nichts wird neu gezeichnet. Text …
[gekürzt zur Übersetzung]