OpticalModeler 2.0 — Thorlabs Blender Optical Path
測定要件または 2D 光路図を、説明可能で独立監査可能な Blender 光学テーブルへ変換します。
2.0 の操作と納品境界
英語版を技術的な正本とします。写真・固定端点・限定移動・port/shutter state では再構築と改訂、材質・照明・画像再利用・UI/返信ではpresentation と納品、公開ではprivacyを読みます。6 つの英語対話と中国語対話は依頼、確認、拒否/修正、検査、最終成果物までを示す教育用編集であり、逐語 transcript や新 blind test ではありません。
- 新設計、写真/図の再構築、限定修正、presentation copy、read-only audit を区別します。新測定は空のシーン/新 topology から開始します。明示的に保持する再構築 baseline は新 revision で read-only 再利用できます。限定修正は既存 lineage、入力 lock、実 pending gate を維持します。
- Installed/user-confirmed identity、メーカー candidate、proposed part、geometry source、図面/モデル/実験室寸法、physical qualification は別軸です。実 holder は未知 optic prescription を証明しません。
- 完全な protected set、rigid 相対ベクトル、固定上段 pose、鏡数/順序、水平区間、編集自由度を事前に固定します。「Compact」は再設計許可ではありません。意図一致を幾何診断と別に確認します。
- 実 working-face 中心/法線を使い、他 node の足/ねじを含む whole family と changed-to-fixed/changed-to-changed を検査します。屋根下配置は全 device/support footprint と実 plate projection を比較します。Source plate 範囲、穴位相、slot/polygon index、広い bearing、盲孔底を検査し、null を zero gap、finite contact を retention/preload/load qualification にしません。
- 未確認内部は functional black box です。実外部開口と正確な selector を使い、2 exit を同時分光と仮定しません。各 state で evaluated transform/visibility を更新し、CLOSED axis は明示 closure で停止します。Proposed label を画像/説明で維持します。
- Presentation は別 copy です。保存後に全関連 mesh/topology、属性/normal、modifier、semantic、slot、visibility、state を比較します。実 shader users を調べ、必要時だけ対象 object/slot を独立化し sensor/optic を保護します。実画素/branch と decode 寸法/bit depth を確認します。Frame 内投影は非遮蔽の証明ではありません。
- 再利用画像は元 producer と完全な dependency bridge を残し、新 render receipt に偽装しません。Relight/recolor の影響画像は新規描画します。
- 既存写真/証拠を先に使い、必要な問いのみします。ユーザーが review candidate を先に望む場合、editable model、実 full-path views、guide、測定 checklist を未知項目付きで完成します。
READY_FOR_USER_REVIEWは physical PASS ではありません。 - 並行許可でも共有 writer は一人です。通常 feedback は checkpoint/idle にまとめ、進行中 render を繰り返し中断しません。明示 resource stop で再開状態を保存し、納品後の任意修正を止めます。
- 公開は機能 alias を使い、重要 SKU、実座標/動作値、private photos/scenes、メール/session、対応表を Git に含めません。既公開 independent example の出所は保持します。Private term policy は repository 外に置き、scanner と visual/container review を実施します。
最終成果物は absolute local target の clickable Markdown link で示し、適宜実 final image を表示します。UI 合格には実 task 完了状態の screenshot、visual recognition、対応 input が必要です。最終返信を capture できない場合は reply_visual_confirmation=incomplete とします。Skill/documentation/software release は新 model、hardware performance、cross-run qualification を付与しません。
英語版を技術的な正本とします。形状作業の前に ../../skills/thorlabs-blender-optical-path/references/physical-gates.md、合否判定の前に evidence-contract.md、既存シーンの改訂では history-derived-rules.md、実例では project-case-study.md、全系 run の前に end-to-end-workflow.md、複数 run の scale/release qualification 前に multi-run-qualification.md を読みます。
権限と改訂
- システム制約、最新のユーザー指示・注釈画像、active なプロジェクト規則、本 Skill、旧成果物・旧 PASS の順に優先します。
- 提出済み・合格済み成果物を凍結します。関連する修正は活動中の revision にまとめ、凍結した証拠を上書きせず、プレビューごとの版公開を避けます。
- 全系は一つの run ID、writer、revision、generator/Blend lineage、workflow ledger を使います。補助 agent は既定で read-only とし、別々に書かれた module を全系として結合しません。
- 画像指摘を object family、world-space geometry、数値ゲート、必要証拠へ変換します。
- 実形状で証明できない場合は
UNVERIFIEDまたはBLOCKEDとします。CAD の存在、process success、AABB 接触、自己申告は証拠ではありません。
コア手順
最初に、新しい測定設計、図の再構築、既存シーンの修正、描画のみの変更を区別します。「以前の例と同等の品質で別の光路」という依頼では、旧例は画質比較に限り、空のシーンから新しい topology・generator・asset map を作ります。optics-only は光検出器と機械支持を含み、回路・電気・データ配線の可視化を除きます。詳細は新設計と描画を参照してください。
- 新しい whole-system build で
scripts/workflow_ledger.pyにより run spec、state ledger、event hash chain を初期化します。限定修正では既存 lineage と未完了 gate の実状態を保持します。 schematic node -> experimental role -> real asset -> optical/fiber/electrical ports -> support pathを作成します。- 全 branch、部品、光線高さ、開口、検出端点を列挙します。
- manifest で固定したメーカー URL だけから公式 CAD を private cache に取得し、atomic placement 前に bytes と SHA-256 を検証します。型番、URL、scale、bbox、local axis/normal、aperture、provenance、redistribution boundary を記録し、明示許諾なしに vendor geometry を公開しません。
- source lock と全 hashed files を一つの atomic input bundle として扱います。形状作業前に producer-to-consumer artifact preflight を実行し、source bytes、canonical/part-qualified CAD cache keys、公式 drawing、runtime が次の script の実消費 path に存在することを確認します。lookup 前に structured authority input を typed exact-set contract として検証し、missing、duplicate、extra、legacy、malformed、identity mismatch は例外終了や重複の黙示的な折り畳みではなく、永続化された structured
BLOCKEDを生成しなければなりません。 - 公開 script から semantic lock を差分ゼロで再計算します。multi-state system では全 edge に正確な
active_statesまたは hashed deterministic expansion を持たせ、全 state に明示的 ray template を要求します。 - 光学中心、鏡面、分割面、反射、branch continuity を先に解きます。設計座標と再オープンした mesh/port の実測値を区別します。固定値のゼロ誤差や同じ部品 family への hit だけでは開口・first-hit の証明になりません。
- 実テーブル穴から fastener、clamp、holder、post、mount、device を post-first で組みます。
- 共通の配置原因を修正し、同じ run の代表 1 台を証明してから展開し、保存後に全コピーを再監査します。
- beauty render より先に明るい mechanical/axial/cutaway 監査画像を作ります。
- README/GATE 数値を machine evidence から導出し、同じ ledger で reopen、whole-system ray/BVH、OpenCV、GLB reimport、binary/PNG metadata sanitization、manifest、hash、active-rule matrix を完了します。
自由空間光、ガイドファイバー、電気ケーブルは別 family とし、依頼範囲内だけを生成します。開口は実際に開いている必要があります。低コスト preview で精細さ、光路可読性、構図を確認し、未完了物理検証を明示します。Physical-qualified claim は物理 gate の後です。許可された manual-review/presentation package は未知項目を明示し physical=false のまま完成できます。材質スロットと polygon index の意味を保ち、部品 close-up と全 branch を確認します。全画像の sharpness・edge density・色画素総数だけでは精度や連続性を証明できず、2K 出力は 4K 納品を満たしません。
要求と必須ゲートを満たした最初の候補を凍結し、一度の納品に進みます。公開は別途許可された範囲のみです。入力・依存・runtime の変化や検査失敗時に影響範囲を再検証します。Skill 文書で未合格モデルの教訓を記録しても model release credit は与えません。事例固有閾値を一般基準にしません。
PASS は全適用ゲートの新しい証拠、PARTIAL/SCOPED は blocker を列挙した限定範囲かつ final/release=false、UNVERIFIED は証拠不足、BLOCKED は既知の失敗を表します。Sanitization PASS は CAD conversion PASS を意味しません。
