科学図解の再構築と描画 (Scientific Figure Reconstruction & Drawing)
プロバイダに依存しない独立したスキルです。呼び出し元ホストが何を描くかを決定し、エンジンは宣言されたジオメトリ、ペイント、レイヤー、編集、エクスポートを実行します。SVGと、そのSVGからレンダリングされたPNGを提供します。AnacondaのScientificFigure_skillとインストール済みのfigure-cliを使用します。
0.10 ガイド: 2つのタスク、1つのホストとScene
現在のEngine 0.10.0は、0.9に加えて決定論的なレイアウトQA (layout-audit)、制限付きレイアウト修復(--fix)、フォントプロファイル事前チェックを追加します。FigurePlan 0.1とScene 0.3は変更されておらず、0.8の実行、編集、レンダリングの基盤は維持されています。呼び出し元ホストはすでに解釈とビジュアルレビューを行うモデルです。2つ目のモデルやエージェントを追加しないでください。0.10計画とQA契約を参照してください。0.9計画、0.8機能、セマンティック計画/新しいCLIワークフローは以下のすべてに対して引き続き有効です。ワークフローページは実装されたエントリポイントと正確なファイル契約を定義します。配信ノートは実際の検証と制限を記録しています。
複雑な図を作成する前に、タスクガイドを選択してください:
- 参考文献の再構築: reference-reconstructionを読んでください。ジオメトリの前に情報構造と読み取り順序、必須部分、関係、特定の未知数を確立します。エンティティ、プロセス矢印、注釈リーダー、拡大図、凡例、装飾を分離します。読み取れない領域をトピック知識で埋めないでください。
- 自然言語デザイン: text-designを読んでください。ユーザーが明示したコンテンツ、デザインの選択、科学的な仮定を分離します。要求されたメカニズムに基づいて階層を設計します。準備、管理、実験条件を発明しないでください。
- 両方のタスク: 方法が不明な場合はconstruction-selectionを使用してください。必要な形状、部品、繰り返し、穴、オクルージョン、スタイルで選択し、実際の利用可能なリソースを比較します。単純な平面オブジェクトは、短い意図/不明なメモから直接ジオメトリとプレビューに進むことができます。必須の検索や複数の計画ファイルは必要ありません。
デフォルトで自律的に作業し、要求された場合のみ一時停止
| モード | 開始タイミング | ホストの動作 |
|---|---|---|
autonomous (デフォルト) | ユーザーが図を要求するか、完了するよう指示した場合 | 描画、検査、修正、納品。各ステップで承認のために一時停止しない |
interactive | ユーザーがサンプルを見るか、各ページを確認するか、参加するよう要求した場合 | 合意されたチェックポイントを公開し、フィードバックまたは承認を待つ |
- レビューページを開いても一時停止は強制されません。自律モードでは、次の安全なチェックポイントで新しいフィードバックを読み取ります。ユーザーが停止を要求した場合は、候補の公開を停止し、まずユーザーの編集を処理します。
- インタラクティブモードでは、最初に合意されたページを完了して公開し、待ってから続行します。マルチページ作業の場合、最初に承認されたページが共有のタイポグラフィ、間隔、カードスタイル、パレットルールを修正します。以降のページはそれらのルールを共有しますが、強制的に同一のレイアウトにすることはありません。
- 画像を読み取れないホストは、ジオメトリと構造チェックを使用できますが、ビジュアルレビューは
not_executedのままにしておく必要があります。 - 1つのSVGバージョンを承認することは科学的レビューではなく、後のバージョンを承認するものではありません。
デフォルト: 理解、選択、構築、検査、修正
- 目的、意図された表示サイズ、モジュール、読み取り順序を述べます。オブジェクト、必須の内部部品、編集可能なユニット、ラベル、色の意味、関係をリストアップします。未解決のコンテンツは明示的に残します。複雑な図の場合、広範なジオメトリを書く前にこのドラフトを検査可能にします。既存のFigurePlanモジュール/オブジェクト/関係を有用な場合に使用します。選択されていない構築は
unresolvedのままにできます。これらは別のSceneツリーではなく、1つの計画入力の段階です。 - 決定に影響するローカルの質問のみを尋ねます。例: 淡い領域が開口部か表面か、リーダーがどこで終わるか。元の画像と関連するクロップを検査します。必要な場合のみソースに基づく証拠を使用します。ROIと座標マッピングを保持します。測定値と類似度スコアは観測値であり、オブジェクトの同一性や科学的信頼度ではありません。暗黙のOCRはありません。
- 構造とスタイルに基づいてレシピ/アセット/直接/プログラムを選択します。実際のレシピパラメータ、編集可能なパートキー、アセット権限、インポート制限を確認します。カタログには15のレシピファミリ、2つのシンボルファミリメタデータエントリ、1つのTwemojiレモンアセットがあります。マウス/フラスコ/アバターのレシピを発明しないでください。レシピが必要な部品を省略している場合、その構築を拒否し、適切なサブパーツを組み合わせてフリープログラムにフォールバックします。ローカル座標、曲線、変換、既存の描画関数、成熟したライブラリを使用します。直接Scene、レガシーセマンティックPlan 0.3、
SceneBuilderは引き続き有効です。描画前に大きな手書きJSONを必要としません。 - まずメイン構造と必要な内部部品を構築し、次にコネクタとラベルを構築します。安定したオブジェクト/パートIDを保持します。塗りつぶし面、ストローク、真の穴、境界マスク/オクルージョン、繰り返し、グラデーションを適切に使用します。フラットアートにボリュームライティングを追加しないでください。ホストは通常のツールを通じてプログラムを明示的に実行し、生成されたSceneフラグメントを提供します。チェック/コンパイルとプロジェクトのロードは保存されたソースを実行しません。新しい候補は編集されたプロジェクトとは別に保ち、受け入れ前にB/U/Cマージを使用します。
- 意図された表示サイズで実際の
preview.pngを読み取り、主要な拡大領域を検査します。モジュールと接続 → シルエット/プロポーション/穴 → 必要な内部構造 → 色/レイヤー → テキストを確認します。同じスケールで参考文献と比較します。以前の描画を置き換える場合は、参考文献/古い/新しいを一緒に比較します。有効な計画、名前付きパス、合格テストは、意図された構造が正しく描画されたことを確立できません。 - 各発見をIDと具体的なアクションに結び付けます: 構築方法の変更、候補の置き換え、ジオメトリ/パラメータの調整、ローカル証拠の取得、または不確実性の保持。現在のリビジョンに対してパッチを適用するか、候補を再生成してマージし、再レンダリングして検査します。デフォルトで最大3回の対象を絞った修正ラウンド。受け入れられたオブジェクトとユーザー編集を保持します。ビジュアル評価を現在のScene/プレビューにバインドします。変更されたジオメトリ、リソース、レンダリングは古い評価を期限切れにします。省略と未実行のレビューを報告します。科学的レビューは別個のものであり、要求されない限り実行されません。
成功とは、適切に描画され、構造的に明確で、主要なパーツが独立して編集可能な図を意味します。テストはエンジニアリングの動作を確立し、描画品質を確立するものではありません。独立ホストのアブレーション、保留ベンチマークキャンペーン、人間のパネル、ドメイン認証、ランタイム統合、クロスバージョンテンプレート移行、実験的なオフセット/可変幅開発は現在の作業範囲外です。それらを前提条件や求められていない次のタスクにしないでください。実際の再利用を外部アートワーク、描画コードの再利用、ジオメトリ/レンダリングライブラリの再利用として別途報告します。レジストリにアセットがあっても、この描画がそれを使用したことを意味するわけではありません。
ホストはPythonまたはJavaScriptの描画プログラムを書くことができます。通常の変数、関数、ローカル座標、変換、繰り返し、成熟したジオメトリライブラリを使用して形状を計算します。利用可能な場合は安定したエンジンヘルパーを使用します。図固有の描画プログラムは許可されています。いくつかの参照図をトピック固有のエンジンアルゴリズムに変えたり、サンプル計画を科学的テンプレートライブラリとして扱ったりしないでください。生成されたScene/Plan候補をエンジン検証、レンダリング、プロジェクトトランザクションに送信します。編集されたプロジェクトに対して再実行する場合、最後に生成されたベースライン、現在のScene、新しい候補を変更を受け入れる前に比較します。ユーザー編集を保持し、競合を報告します。利用可能な構築ヘルパーと生成プロトコルを使用します: generation diff PROJECT --candidate SOURCE --output DIFF、提案されたプレビューと競合を検査し、その後 generation accept PROJECT --candidate DIFF --base-revision N。保存されたソースは不活性です。acceptはマージを再計算し、現在のリビジョン/コンテンツ/領収書をチェックします。編集されたプロジェクトを純粋なスクリプト出力で上書きしないでください。ラスター画像を埋め込んだり、すべてのテクスチャを細かいパスにトレースしたり、欠落した構造を魅力的な塗りつぶしで置き換えたりしないでください。
描画前に、提供された参考文献からの再構築と許可されたリソース再利用のどちらかを選択します。以下の項目を別途開示します: 外部アートワーク(ソース、ライセンス、バージョン/ハッシュ、変更点); 再利用された描画コード(自身の関数を含む)(ファイル/バージョン、再利用部分、変更点); ジオメトリ/レンダリングライブラリ(実際のライブラリ/バージョンと役割)。ローカルで作成された関数は外部アセットではなく、ライブラリ呼び出しは借用アートワークではありません。メソッドのインスピレーションはコピーされたコードとは別に記録します。コピーされた外部コードには、固定されたソースリビジョン、ファイル、ライセンス、通知が必要です。明示的に固定されたラスター比較の場合、公式ソースSVGを決して代用しないでください。同じ修正予算内で、実際のプレビューでメイン構造、ジオメトリ/穴/オクルージョン、スタイル/テキストを検査します。背景色で覆われたカバーパッチは、実際の穴や編集可能なインターレースを確立しません。プログラムソースは再現性のための入力であり、受け入れられたSceneのみが現在の唯一の編集可能な権威です。プロジェクトまたはバンドルを開くときに描画プログラムを実行してはいけません。
モデルサービスなしでファイルを実行
conda run -n ScientificFigure_skill figure-cli doctor --json
inspect reference.pngを使用してソースサイズ/ハッシュを取得します。ソースバウンドの計画はSHA-256、サイズ、ROIを宣言します。レガシーPlan 0.3のセマンティック実行は、暗黙的にカラーセグメンテーション、ピクセル候補検索、スケルトン分析を実行しません。古いPlan 0.1/0.2入力はその動作を保持します。
conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure
ドラフトプレビューループとステージタイミング
drawとreconstructは--previewを受け入れます: これはfigure.svg、preview.png、preview.jsonのみを書き込み、--scaleで指定がない限りスケール1でレンダリングし、自身の前のプレビューを置き換えることができます。これはプロジェクトや納品物ではありません(領収書、オブジェクトマニフェスト、QAレコード、レビューバインディング、参照比較はありません)。そのため、最初の確認と各修正ラウンドで使用し、構造が正しくなったら同じコマンドを--previewなしで実行します。
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
両方のパスは秒単位のtimingsを返します: validate、to_svg、render、inventory、qa、publish、total。プレビューは配信段階を省略し、領収書は同じ公開前段階を記録します。このホストでは、501オブジェクトのSceneはプレビューで約0.33秒、フルプロジェクトで約1.16秒かかります。ほとんどの差はスケール1と3でのPNGレンダリングです。エンジンはモデル側の時間を認識できません。再構築を測定する場合、ホストの最初の推論、出力トークン、修正ラウンドをこれらの数値と一緒に記録し、エンジン秒をモデルレイテンシに、またはその逆に決して帰属させないでください。
複雑な構築前にテキストとフォントを確認
図が描画するすべての文字列(ラベル、数式、単位、軸テキスト、凡例)を1つのリクエストに収集し、ジオメトリの前にこれを実行します:
{"schema_version": "0.1", "texts": ["細胞膜", "H₂O → O₂", "Cell membrane"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts
status: okは1つの実際のローカルフォントを選択し、font-probe.jsonとfont-probe-sample.pngを書き込みます。needs_inputは欠落文字とフェイスごとのカバレッジをリストします。--font PATHは特定のファイルを追加します。--profile(デフォルト名scientific-default)は、パッケージ化された推奨(Times New Roman / Microsoft YaHei / Cambria Math)をインストール済みフォントに対して解決し、各ロールのパス、フェイス、ダイジェスト、欠落サンプル文字を報告します。存在しないファミリーは欠落として報告され、決して代用されません。エンジンは1つのファミリーをレンダリングするため、混合フォントフォールバックを主張しないでください。SCIENTIFIC_FIGURE_FONTを選択したパスに自分で設定するか、テキストを簡略化します。複数ページの場合、すべてのページの和集合をページ1の前に1回プローブします。欠落グリフは構築上の決定であり、最後の瞬間のエクスポートエラーではありません。
描画中に図を表示
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は、127.0.0.1でランダムなトークンとともに最新の正常に公開されたfigure.svgを提供し、ブロックする前にURLを出力します。ページはリロード間でズーム、パン、未送信のピンを保持し、ユーザーがオブジェクトIDまたは空のスペースにコメントをピン留めできるようにします。review-statusはフィードバックログを読み取ります。--wait --timeout Nを追加して新しいラウンドが到着するまでブロックします。それ以外の場合はCtrl-Cで停止します。サーバーは図を読み取り、フィードバックを書き込むだけです。プロジェクトを編集することはありません。
フィードバックは<preview>-review/feedback.jsonに保存され、置き換え可能なプレビューディレクトリの外にあります。各送信は、表示されていたSVG SHA256とリビジョンにバインドされます。古いバージョンからの送信はHTTP 409で拒否され、決して静かに適用されません。受け入れられたコメントは通常のパッチまたは生成マージを通じて適用し、その後新しいプレビューを公開します。ローカルページはブラウザフォールバックです。VS Codeサイドバーを作成せず、埋め込みホストはこのバージョン管理されたファイルとしてフィードバックを処理する必要があります。
グラフィックスのみの最終SVGを納品
conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure
これは1つの検証済みプロジェクトを読み取り、figure.final.svgとfigure.graphics.svg(テキストなし)、およびvariants.jsonを書き込みます。どちらも同じSceneから生成されるため、共有IDは同一のジオメトリとスタイルを保持します。何も再描画されません。
テキスト...(truncated for translation)