editaplot

EditaPlot

科学的な質問と読み取り専用の表をもとに、監査可能で編集可能なOriginの図を作成します。初心者にも使いやすい会話形式を保ちながら、検査、計画、レンダリング、エクスポート、読み戻しには決定論的なエンジンを使用します。

Windowsで必要な権限だけを要求する

• リポジトリ全体、選択した表、任意のローカル参照画像を読み取ります。
• EditaPlotのリポジトリ、現在のユーザーのCodex Skillディレクトリ、およびソースファイルと同じフォルダーに成果物を作成する場合に限り、選択したソースファイルの親フォルダーに書き込みます。
• ローカルランチャー、PowerShell／Pythonのサブプロセス、およびEditaPlotが所有するOriginインスタンスを、同じアクティブな対話型Windowsユーザーセッション内で実行します。
• 通常のCodexコマンドは、最初に隔離されたアカウントで実行される場合があります。Originワーカーが origin_codex_sandbox_context を返した場合は、その origin-smoke または render コマンドに限定した、正式なローカル実行リクエストを送信します。そのコマンドを再実行するのは、ユーザーがプロンプトで承認した場合、または設定済みのCodex自動レビュアーが承認した場合に限ります。承認される保証はありません。また、この引き継ぎはサンドボックスの回避ではありません。ユーザーにコマンドを別のPowerShellウィンドウへコピーするよう求めたり、管理者権限やシステム設定へのアクセスに要求範囲を広げたりしないでください。
• ネットワークアクセスは、リポジトリのダウンロード／更新と、ロックされた依存関係の取得に限って使用します。ユーザー範囲へのwingetによるPythonインストールは別個のシステム変更として扱い、明示的な同意を得てください。
• 管理者権限、マウス操作、ドライブ全体への書き込み権限、非公開の入力データのクラウドへのアップロード、またはDCOM、レジストリ、ファイアウォール、ユーザーグループ、Originのインストールに関する変更を要求しないでください。コントロールされたフォルダーアクセス、組織のポリシー、クラウド同期、または読み取り専用の場所によって書き込みがブロックされる場合は、影響を受けるフォルダーに限ってアクセスを要求するか、出力先として使用する別のフォルダーを明示的に指定してもらってください。

初心者向けの手順から始める

1. 何かをインストールする前に、サポート対象外のプラットフォームを除外してください。CLI／依存関係レイヤーのサポート対象は、物理 Windows 10/11 x64 と 64 ビット CPython 3.10～3.12 のみです。外部 originpro を介して Origin/OriginPro 2021 以降を対象とします。この方法では Origin 2020b 以前はサポートされません。完全に検証済みのライブベースラインは CPython 3.10 + Origin 2024b / 10.15 です。別の 2021 以降のバージョンは、スモークテストと完全な成果物が合格するまでは自動的に検証済みとはせず、機能ゲートの対象として扱ってください。macOS（Intel/Apple Silicon）、Linux、WSL、Wine/CrossOver、Parallels、その他の VM は V1 ではサポート対象外であることを明確に伝えてください。doctor ではすべての VM を確実に検出できないため、その事実が不明な場合は、物理 Windows ホストであることをユーザーに確認してください。
2. インストール済みの Skill ディレクトリで editaplot.cmd を探してください。クローンしたリポジトリから作業する場合は、リポジトリルートの editaplot.cmd を使用してください。コマンドではランチャーの絶対パスを使用してください。初心者に Python 実行ファイルを選ばせたり、scripts/editaplot.py を直接実行させたりしないでください。
3. 初回インストールにはリポジトリ全体が必要です。リポジトリルートで editaplot.cmd setup を実行してください。ランタイムが含まれないため、skill/editaplot だけをコピーするようユーザーに指示してはいけません。セットアップ、検出、コマンドの詳細については references/runtime.md を読んでください。
4. 既存の互換性のある Python を再利用してください。該当するものがない場合は、Python のインストールがシステムレベルの変更であることを中国語で説明してください。まず winget show を実行し、正確な発行元、ソース、使用許諾条件を説明してください。ユーザーが明示的に確認した場合に限り、その後 Python.Python.3.12 をユーザースコープ、x64 アーキテクチャで非対話的にインストールできます。winget が利用できない場合は、python.org 公式の Windows インストール手順を提示し、ユーザーの返答を待ってください。信頼できないミラーを使用したり、Python を黙ってインストールしたりしてはいけません。
5. 新しいワークフローごとに editaplot.cmd doctor を実行してください。doctor --repair は、報告されたプロジェクトローカルの Python 依存関係の修復に限って許可してください。すべての Python パッケージを .editaplot-venv に保持してください。Origin はローカルにインストールされ、ユーザーが管理するアプリケーションとして扱ってください。修復中にインストールまたは変更してはいけません。
6. 新しいテーブルには editaplot.cmd start <data-file> を実行してください。ユーザーが目標を述べた場合は --intent "<user intent>" を追加してください。検査結果と推奨内容のペイロードは内部作業状態として扱ってください。添付ファイルから提示された元のローカルソースパスを使用してください。ホストから一時コピーされた添付ファイルしか提供されず、元のフォルダーを特定できない場合は、レンダリング前に意図するローカルのソース／出力フォルダーを一度だけ確認してください。無関係なワークスペースの保存先を推測してはいけません。
7. 候補テンプレートを選んだ後、計画に使用するものと同じ確認済みのマッピングで editaplot.cmd understand <data-file> --template-id <id> を実行してください。結果は次の短いチェックリストにまとめます。データ型、描画する列、補助または検証にのみ使用する列、描画せずに保持する列、提案する図の要素、実行しない計算。各ソース列は必ず一度だけ記載してください。項目に uncertain がある場合は、修正したマッピングを確認して、再度 understand を実行してください。確認や計画を進めてはいけません。
8. 初心者には、認識された内容、最適なグラフ候補を1～3個、それらが適している理由、まだ必要な最小限の科学的判断だけを伝えてください。技術的な詳細を求められない限り、inspect → recommend → understand → plan の一連の処理や生の JSON を表示してはいけません。
9. 科学的な目的を一文で示したものと簡潔な要素チェックリストの両方について、ユーザーに確認を求めてください。正確な proposal_hash、承認済みの派生項目 ID、解決済みの曖昧さに関する選択を --semantic-confirmation-json で固定してください。ソース、マッピング、目的、または提案ハッシュが変わった場合、確認を再利用してはいけません。信頼度が低い場合、候補間の差が小さい場合、役割や単位が曖昧な場合、または表示変換を提案する場合は、必要な追加質問だけに絞って確認してください。
10. ユーザーが参照図を提供した場合は、まず reference-inspect を実行してください。その後、Codex が説明できるのは、厳密な ReferenceFigureSpec JSON で表されるパネル／マーク／エンコーディング／レイアウト／スタイルの文法のみです。さらに reference-review を実行してください。ランタイムは OCR もモデル推論も実行しません。採用した特徴と却下した特徴を示し、すべての必須マークを確認済みの描画可能なユーザーデータに対応付け、ハッシュに紐付いた別個の確認を得てください。参照図の値、ラベル、フィット、相の割り当て、著者テキスト、ロゴ、透かし、ビットマップを Origin プロジェクトにコピーしてはいけません。検証済みの template_adaptation を優先してください。正確な構成が完全な Origin エビデンスゲートに合格するまでは、controlled_composition をブロック状態にしてください。参照図によって不足しているエビデンスを補ったり、確認済みの科学的要素一覧を変更したりしてはいけません。 参照図から推定したスタイルは、ユーザーの指示ではなく提案として扱ってください。次の3つのモードからユーザーに選んでもらってください。検証済みテンプレートの既定値を維持する、参照図が提案する確認済みの許可リスト内の近似スタイルを使用する、正確なカスタム値を指定する。正確な値を指定するモードでは、色、物理的な線幅、塗りつぶしの透明度、ページサイズ、凡例の表示／枠／位置を個別に確認してください。ユーザーの明示的な選択は、矛盾する参照トークンより優先されます。参照図からの各提案は applied、retained_template_default、または rejected として固定してください。選択したテンプレートが同じ検証済みプレビュー／Origin 経路を備え、必要な Origin オブジェクトの読み戻しが確認されていない限り、要求が適用されたと主張してはいけません。
11. 色をユーザーが選択できる場合は、editaplot.cmd palettes を実行し、assets/palettes/palette-selector-public.zh-CN.png を提示して、互換性のある palette_id を2つまで推奨してください。1つを固定する前に references/palettes.md を読んでください。
12. 確認済みの選択は editaplot.cmd plan を使って内部で固定してください。プランを手動編集したり、決定内容をソースファイルに書き戻したりしてはいけません。正確な XPS の要求では、確認済みの値を別の JSON オブジェクトに書き込み、そのパスを --visual-style-json で渡してください。対応する正確なフィールドは series_colors、line_width_pt、fill_transparency_percent、page_size_cm、legend_visible、legend_position、legend_frame です。明示されたフィールドまたは値が無効な場合は即座に失敗させ、ユーザーとともに修正してください。黙って破棄したり、参照スタイル／既定スタイルにフォールバックしたりしてはいけません。レンダーコマンドは、承認済みプランを最終出力フォルダーに render-plan.json としてコピーします。
13. Origin の準備状況は技術的な状態としてのみ扱ってください。Doctor は Origin.Application、Origin.ApplicationSI、インストール済み候補、Python、originpro、OriginExt を読み取り専用で検出します。Origin を起動することはありません。また、ready_for_render はライブ接続が成功したことを意味しません。既定の起動登録が存在する場合は、ユーザーに Origin を開くよう求めたり、再確認を求めたりせず、実際の事前レンダリングのスモークテストに進んでください。初心者向けの出力は平易な言葉で1～3文にとどめてください。CLSID、レジストリビュー、候補、段階は JSON に記載してください。 編集済みの origin_execution_context は ready_for_render とは別に読み取ってください。codex_sandbox 状態では COM を呼び出す前に、上記の正確なコマンド承認の引き継ぎが必要です。承認された要求のみ再実行できます。自動レビューはその個別要求を評価するものであり、Origin アクセスを事前に許可するものではありません。Windows の実行コンテキストが unknown の場合はフェイルクローズとし、承認要求として扱わないでください。COM 呼び出しの前に停止し、現在の Windows ID を確認できなかったことを報告してください。
14. launch_isolated を使用して editaplot.cmd origin-smoke --output-dir <unique-smoke-directory> を実行してください。専用の Origin インスタンスを起動して管理し、ライブスモークテストとバージョンハンドシェイクを実行した後、テンプレートの機能判定を行います。このコマンドは計画後、正式なレンダリング前に必ず実行してください。attach_existing は明示的な上級者向けモードに限ります。ユーザーが所有するプロジェクトをリセット、上書き、終了してはいけません。終了する代わりにデタッチしてください。障害は、推測を交えず、技術的な段階と次の手順を示して報告してください。 マウス自動化を使用したり、アプリケーションパッチや回避手順を提示したりしてはいけません。ランタイムは EditaPlot が所有するアクティベーションの部分的な状態をクリーンアップしなければなりません。また、クリーンアップが成功した場合に限り、再試行可能な起動コードに対して新しい分離インスタンスを一度試すことができます。クリーンアップに失敗した場合は origin_activation_cleanup_failed を返して停止してください。その後、sec -poc 30 で待機し、バージョンの読み取りやプロジェクトの作成前に run.isOCready() を確認してください。ループしたり、ApplicationSI に切り替えたり、DCOM／レジストリのアクセス許可を編集したり、ワークフロー全体を管理者として実行するよう初心者に指示したりしてはいけません。自動試行が尽きた後、同じアクティブな Windows ユーザーコンテキストでの再試行は最大1回まで承認を求めてください。その際、最初のレポートを保持するため、新しい空の兄弟スモークディレクトリを使用してください。origin_com_class_not_registered と origin_com_activation_access_denied の場合は、自動再試行せずに停止してください。長時間実行されているという理由だけで Python ワーカーを強制終了してはいけません。非表示の Origin インスタンスを所有している可能性があります。診断情報を保持し、ユーザーが制御するキャンセルを提案する前に最後の進捗段階を報告してください。 サンドボックスの承認引き継ぎとアクティベーションの再試行は、別個の処理として扱ってください。前者は COM 呼び出し前に行い、後者は制限付きのアクティベーション／クリーンアップポリシーを実行した後にのみ利用できます。プライマリアクティベーションとクリーンアップの両方が失敗した場合は、primary_activation_code、primary_activation_stage、cleanup_error_code、cleanup_error_stage のみを公開してください。この構造化診断ペイロードに Windows アカウント名、ローカルパス、生の HRESULT、生の COM テキストを含めてはいけません。また、両方の情報ペアが存在することを理由に再試行してはいけません。 現在の EditaPlot ワーカーは、同じサインイン済み Windows セッション内で、実行中の origin-smoke／render の Origin セクションのみを直列化します。データ検査、推奨、計画は並行して実行してもかまいません。待機中に即時に出力され、その後約30秒ごとに出力される origin_job_queue の進捗に従ってください。順序が厳密な FIFO である保証はありません。30分の制限は待機中のジョブにのみ適用されます。タイムアウトしても、その待機ジョブのみが停止し、実行中のジョブは終了も中断もしません。キューメッセージが表示されている間は、重複ジョブを送信しないでください。手動スクリプト、旧バージョンの EditaPlot、無関係なプログラムは、この調整の対象外です。
15. このスモークテストに合格した後にのみ、editaplot.cmd render <plan> で許可されたテンプレート経路をレンダリングしてください。ユーザーから別の要望がない限り、成功後も EditaPlot が所有する Origin インスタンスは開いたままにしてください。既定では、ランタイムがソースファイルと同じ階層に <source_stem>_EditaPlot_YYYYMMDD_HHMMSS という名前のフォルダーを作成します。すべての正式な成果物をそのフォルダーに保存してください。通常の実行先をリポジトリ、Skill ディレクトリ、現在の作業ディレクトリ、共有のグローバル出力フォルダーに変更してはいけません。ユーザーが別の場所を明示的に要求した場合のみ --output-dir を使用してください。
16. ソースファイルと同じ階層にあるフォルダーに対して editaplot.cmd verify <output-directory> を実行し、人による目視 QA を行ってください。スモークテストまたはレンダリングが失敗した場合、Python プレビューや単体の PNG/PDF/SVG はプレビューにすぎず、Origin での作業が完了したものとして提示してはいけません。正式な成功には、編集可能な OPJU、PNG、PDF、TIF、オブジェクトの読み戻し、人による目視 QA がすべて必要です。 レンダリングを行う前に、references/origin-safety.md、references/figure-contract.md、references/verification.mdを読んでください。新しい表やグラフの判断を行う場合は、references/data-contracts.md、references/chart-selection.md、references/semantic-understanding.mdも読んでください。参照画像が提供されている場合は、references/reference-figures.mdも読んでください。

科学的な判断はユーザーに委ねる

• 元のデータファイルは不変として扱います。上書きしたり、欠落しているソース列を補ったり、測定値をでっち上げたりしないでください。ヘルパー列はメモリ内または編集可能な Origin プロジェクト内でのみ許可されます。
• 計画前に、すべてのソース列を、primary render、secondary render、support-only、retain-not-render、uncertain のいずれかに分類してください。support-only および保持された列は、参照画像を通じて可視化することはできません。未知の数値列は問いであり、もう一つの自動曲線ではありません。
• 科学分析と表示変換を区別してください。正規化、スムージング、フィッティング、外れ値の除去、エラーバーの計算、相の同定、物質ピークの推測を暗黙に実行しないでください。
• GSAS/GSAS-II の Rietveld データでは、Observed、Calculated、オプションの Background、提供された Difference、明示的な Phase positions、およびレンダリングされない control/diagnostic 列を区別してください。上流の Publication Diff を正確に保持し、2 回目の表示オフセットを適用しないでください。
• XPS では、見た目の好みを科学的契約から分離してください。ユーザーは、正確なシリーズ色、物理的な線幅、塗りつぶしの透明度、安全なページ/アスペクト比、および凡例の表示/非表示、境界線なし、位置の選択を明示的に要求できます。選択された検証済み XPS レンダラーがサポートし、読み戻すフィールドのみを適用してください。そうでない場合は、デフォルトを保持するか、そのフィールドを目に見える形で拒否してください。ユーザーのスタイル要求も参照画像も、ソース値や列の役割、高結合エネルギーから低結合エネルギーへの軸の契約、成分の同一性、残差の扱い、または検証済みの単一領域 set_fill_area(..., type=9) / -pfm 3 塗りつぶし実装を変更することはできません。
• SHAP では、外部で事前計算されたサンプルごとの寄与のみを受け入れます。モデルを学習したり、SHAP を呼び出したりしないでください。Mean |SHAP| およびオプションのグループパーセンテージは、semantic proposal に記録され明示的に承認された allow-list の式を用いて、提供された行を要約することのみができます。寄与をでっち上げたり、特徴量を暗黙に並べ替えたりしないでください。
• ユーザーが個別の重要度バー、beeswarm、および 2 レベルの寄与リングを要求した場合は、shap_dashboard を選択してください。明示的な Feature Group を必須とし、1 つの合計 Mean |SHAP| 分母を使用して特徴量/グループのパーセンテージを確認し、blue–white–wine、purple–green–yellow、または red–yellow–blue を提供してください。選択内容を mapping plot_mode dashboard_blue_red、dashboard_viridis、または dashboard_red_blue として固定してください。この連続スケールに一般的なカテゴリカルパレットを代用しないでください。
• 未知の単位、誤差の意味、パーセンテージの分母、意味のある順序、二重軸、および主張を変えうるその他すべての選択について確認してください。
• 見た目だけでなく、科学的主張とデータ構造から推奨してください。技術的にレンダリング可能であっても、誤解を招くグラフは拒否してください。
• テンプレートのルートステータス（verified、experimental、または unsupported）を、現在のホスト互換性（verified、compatible_unverified、または blocked）から分離して保持してください。compatible_unverified の Origin バージョンを verified として再ラベル付けしないでください。その smoke が成功し、選択したテンプレートに必要な機能が利用可能な場合にのみ続行してください。
• 装飾的な 3D は拒否してください。科学的に意味のある第 3 軸を必須としてください。新しい 3D ルートは、Z 軸、カメラ、OpenGL タイプ、ソースマッピング、4 つのエクスポート、編集可能な OPJU、読み戻し、およびビジュアル QA が合格するまで experimental として扱ってください。
• 検証済みの density_ridgeline3d については、2～6 個の実在する単位付き条件を持つ mixed-wide 六角色テーブルのみを受け入れます。上流が同義かつ同一単位の実線/破線の事前計算密度を提供し、各グループにちょうど 1 つの Focal X を提供します。焦点は Z=0 ベースライン locator に固定します。KDE、ピーク、しきい値、交点、焦点を計算しないでください。現在のホストは、リアルタイム smoke と OPEN_GL_3D 機能チェックにも先に合格する必要があり、テンプレートが検証済みであるという理由だけでホストゲートをスキップすることはできません。
• 選択したファイルを追加のネットワークサービスに送信したり、公開成果物に含めたりしないでください。Codex を通じて明示的に提供されたファイルは、ユーザーの Codex アカウント、組織、および保持ポリシーに引き続き従います。Skill がそれらのポリシーを上書きできると主張しないでください。
• 医療データまたは参照画像を検査する前に、その資料が所属機関のルールに従っていること、匿名化されていること、および焼き込みテキストがないか確認済みであることをユーザーに確認してもらってください。
• panel-plan は、匿名化を考慮したレイアウトおよびエビデンスゲートとして扱い、OCR、PHI 検出器、医療画像エディタ、または統合された編集可能な Origin プロジェクトとして扱わないでください。検証済みの各サブプロジェクトを保持してください。

出版物を参考にした契約を適用する

• 各グラフが、明確な結論またはエビデンスとしての役割を 1 つ示すようにします。
• 白い背景、Arial、控えめな色の組み合わせ、明確な階層を使用し、虹色の配色、装飾的な 3D 表現、根拠のないグリッドは使用しません。
• グラフの種類、データ密度、系列数、ラベルの長さに基づいて、Origin の物理的な寸法を決めます。従来の固定 C 1s など、プロファイルで明示的に求められる場合に限り、固定サイズを維持します。
• ドキュメントに記載されたポイント、線幅、ページサイズの単位を正しく換算します。小さな学術誌ページ向けのフォント値を Origin API フィールドにそのままコピーしないでください。結果の軸オブジェクトとテキストオブジェクトを読み戻して確認します。
• 関連するパネル間で、各条件の色を統一します。パレット ID と正確な HEX 値、許可されるモード、安全に使用できるカテゴリ数、アクセシビリティ上の制約を計画に固定します。
• ユーザーによる明示的なスタイル指定は、参照画像から推測したスタイルトークンより優先します。色、線幅、透明度、ページ／アスペクト比、凡例の指定は、いずれも機能の対応状況を確認したうえで適用可否を判定し、描画前に「適用」「既定値を維持」「却下」のいずれかに分類します。
• 参照画像や未検証の外観上の好みによって、XPS の成分、符号付き効果、ヒートマップ、診断線、混同行列、その他類似するエビデンスにおける意味的な色の対応関係を、暗黙のうちに変更しないでください。明示的な置き換えは、その経路で独立に検証されたオーバーライドを通じてのみ許可し、系列の正確な対応付けと読み戻しを必須とします。
• 医療用パネルには、それぞれ異なるエビデンス上の役割を持たせます。定量パネルを組み立てる前に、条件と色の共通マップを固定し、凡例を共有する場合は意味上の確認を明示的に求めます。
• 編集可能なラベルと Origin オブジェクトを優先します。Python のプレビューや埋め込みビットマップは、Origin の納品物ではありません。
• 結果は「出版物を参考にした」と表現し、「Nature 準拠」や学術誌の承認済みとは決して表現しないでください。

結果を平易な言葉で報告する

認識したデータ形状と役割、選択したグラフと代替案、信頼度と確認済みの変換、ソースに隣接する出力フォルダー、コピーした計画、OPJU／PNG／PDF／TIF のパス、検証／読み戻しのパス、未完了の人による確認事項を報告します。初心者向けには、内部識別子を自然な言葉に置き換え、環境の状態を 1～3 文で要約し、簡潔な結果の後に技術的なパスを記載します。

詳細な参考資料は必要に応じて読み込む

• references/runtime.md：ランチャー、セットアップ、Python の検出、CLI コマンド、成果物。
• references/chart-selection.md：グラフの種類、ランキングルール、サポートレベル。
• references/data-contracts.md：受け付けるレイアウト、列の意味、修正の指針。
• references/semantic-understanding.md：列ごとの用途、要素チェックリスト、派生データの系譜、ハッシュに紐づいた確認ゲート。
• references/reference-figures.md：安全な参照文法、対応付け、適応の制限、個別の確認。
• references/figure-contract.md：エビデンスの論理、視覚的階層、タイポグラフィ、色のルール。
• references/origin-safety.md：ローカル Automation と検証済み API のガードレール。
• references/verification.md：必須成果物、読み戻し、視覚的 QA。
• references/showcase.md：中立的なデモデータとギャラリーの方針。
• references/palettes.md：中国語のパレットセレクター、互換性、アクセシビリティ上の制限。