ブラウザでFreeCADを実行
FreeCAD in the Browser (magik.net)
要約
この記事は、複雑な3D CADソフトウェアであるFreeCADをWebAssembly(Wasm)を使用してブラウザ上で実行可能にした試みについて詳述しています。開発者は、Qt for WebAssembly、JSPI、および静的依存関係スタックを活用し、約4日間でFreeCADのブラウザ版を構築しました。初回ロードサイズは約96MBですが、ブラウザキャッシュ後は高速に動作します。このポートは、特にPySide6やOpenCASCADEなどのコンポーネントをブラウザ環境で動作させるという、これまで困難とされてきた技術的課題を克服した点が注目されます。
全文翻訳
ブラウザでFreeCADを実行
投稿日: 2026年7月7日
Hacker NewsのスレッドLibreCAD、Qtデスクトップアプリケーション全体をWebAssemblyにコンパイルしてタブで実行するから始まりました。magikはそれを実現し、次にOpenSCADも同様に移植しました。このパターンは、Qt for WebAssembly、JSPI、静的な依存関係スタック、そしてスレッド、ファイルシステム、OpenGLに関するアプリケーションの仮定を正直に監査するというレシピのように見えました。次に当然の疑問は、どこまでスケールするかということでした。そこで、FreeCADが登場します。パラメトリック3D CAD、スケッチ制約付きソリッドモデリング、組み込みPython、1ダース以上のワークベンチを備えています。他の2つと比較して、その規模はほぼ1桁大きく、約150万行のC++と70万行のPythonで構成されており、現在ブラウザタブで動作します。
移植は、HackerNewsのスレッドから現在の状態まで約4日間かかりました。実装はほぼすべてFableによって行われ、大規模で複雑なプロジェクトでFableの機能をストレステストするための方法でした。もしそれが大きな主張に聞こえるなら、検証可能です。4日間のすべてのプロンプトは、この投稿の後半にそのまま再現されています — それらすべて48個 — そして、完全なセッショントランスクリプト、すべてのサブエージェントとすべてのワークフローは、閲覧可能なアーカイブとして公開されています。
初回ロードは圧縮後約96MB(Brotli)です。これは大きなプログラムであり、それを隠すつもりはありません。その後、ブラウザがキャッシュします。最近のChromiumベースのブラウザ(Chrome/Edge 137+)が必要です。この移植はWebAssembly JSPIに依存していますが、FirefoxとSafariはまだ対応していません。起動すると、デモドキュメント(円筒形のカットが施されたボックス)がライブ3Dビューポートで開きます。
内容
この投稿の残りは、最も切実な質問に答えるためにFableによって完全に書かれた技術ノートですが、ここからはAIによる投稿です
FreeCADは1つのプログラムではありません。プラットフォームです。Qt GUIの下には、産業用B-repジオメトリカーネルであるOpenCASCADE(OCCT)、3Dビューを駆動するOpen InventorシーングラフであるCoin3DとQuarter、完全な組み込みCPython 3.14、PySide6/shiboken6 Qtバインディング(PythonコードがQt UIを構築できるように)、そして今回はFEMワークベンチ用に特別にクロスコンパイルされた、VTK 9.3のサブセットとSalomeのSMESHメッシャーがあります。その上に、17以上のワークベンチがあります — Part, Sketcher, PartDesign, Draft, Spreadsheet, Measure, Surface, Import, Mesh/MeshPart/Points/Inspection/Robot, TechDraw, Assembly, CAM, BIM, FEM, Material, Start。これらすべてが、Qt 6.11.1と並んで、1つの 196MBのWebAssemblyモジュールに静的にリンクされます。
私の知る限り、そのうち2つのコンポーネントはブラウザで初めて実現されました:wasmで動作するPySide6とpivy(Coinバインディング)、そしてOCCT+Coin+CPython+PySide+VTK+SMESHを単一モジュールにリンクすることです。この投稿の残りは、それがどのように実現されたか、その順序で説明します。
ビルド、順を追って
このセクションは意図的に長くなっています — リクエストは、すべての修正とすべての方向性を順序通りに含めることであり、その具体性が重要です。単にアプリを試したい場合は、上の起動ボタンをクリックしてください。
0 · ツールチェーン: 自前でビルドする必要のあるQt
LibreCADはプリビルドのQt-for-wasmを使用できましたが、FreeCADはできません。その理由はJSPIです。FreeCADはモーダルダイアログで飽和しています — C++で185個のexec()サイト、Pythonでさらに156個 — そしてブロッキングPythonコードはコールバックに機械的に書き換えることができません。QDialog::exec()セマンティクスを維持する唯一の方法は、ダイアログが開いている間wasmスタックを一時停止することです。これはまさにWebAssembly JSPI(JavaScript Promise Integration)が行うことです。これには-feature-wasm-jspiが必要であり、ソースからビルドされたQtが必要です。したがって、/opt/toolchains下のツールチェーンは、Emscripten 4.0.12上でJSPIとネイティブwasm例外を有効にしてwasm用にコンパイルされたQt 6.11.1であり、その隣にはOCCT、CPython、ICU、Boost、Xerces、{fmt}、yaml-cppのハンドビルド静的プレフィックスがあります。
1 · カーネル、ヘッドレスでまず
この規模のプロジェクトを管理可能にした規律はカーネルファーストでした:GUIのピクセルに触れる前に、OCCT + CPython + FreeCAD Appレイヤーがwasmで動作することを証明することです。FreeCADのC++モジュールはPython拡張モジュール(PyMOD_INIT_FUNC)であり、通常は実行時にdlopenされます。wasmモジュールにはdlopenがないため、すべてのモジュールは静的にリンクされ、Py_Initializeの前にPyImport_AppendInittabでインタープリタのinittabに登録されます。ホームパス、Python環境、そしてノードサイドテスト用のNODERAWFSビルドが整った後、FreeCADCmdはヘッドレスで実行されました — .FCStdを開き、再計算し、STEPをラウンドトリップしました — まずノードで、次にブラウザで。それが最初にリリースされたものであり、それ自体が製品です:タブで利用可能なスクリプト可能なCADカーネル。
2 · GUIのリンク、そしてOpenGLへの嘘
フルGUIターゲットをリンクさせることは、ほとんど事務処理でした — 共有inittab、QProcessのスタンドイン(タブ内では子プロセスなし)、Startモジュールのタイムゾーン/プロセスに関する仮定の保護。興味深い部分はOpenGLでした。FreeCADはCoin3Dを通じてレンダリングしますが、これは正直な1990年代の固定機能OpenGLです:マトリックススタック、glBegin/glVertex、glLightfv、クライアント頂点配列。WebGL2にはこれらはありません。そのため、リンクは手書きの固定機能GL-on-GLES2シムをプルします — OpenSCADも直面した同じ壁ですが、Coinのより大きなGLサーフェスに対して同じ方法で解決されました。
3 · メインウィンドウの起動
リンクされたモジュールは実行中のモジュールではありません。GUIの起動は2つの問題と戦いました。第一に、C++の静的初期化順序:すべてが1つのモジュールにあるため、OCCT、Coin、Python、Qtからのグローバルコンストラクタが誰も設計しなかった順序で実行され、それらのうちのいくつかは後続のものが設定する状態を読み取ります。第二に、Qt-wasmプラットフォームプラグインには特定のエクスポート関数と、実際に一時停止できるイベントループが必要です。初期のQtメッセージハンドラが、ブロッカーを判読可能にした最終的なものになりました — イベントループがapp.exec()を生き残るためにasyncifyを必要とすることが明らかになりました。これにより、メインウィンドウが表示されました:ドキュメントツリー、プロパティエディタ、ツールバー、メニュー、モーダルダイアログが動作しました。ステージ3ゲートを通過しました。
4 · WebGL2ビューポート、そしてその中に隠れていたバグ
これが困難なフロンティアでした。Coinのレンダラーは約70個のglBeginサイトが20ファイルに分散しており、マトリックススタック演算も含まれています。私はGLES 3.0上で必要なサブセットのみを実装した約900行の固定機能エミュレータ(WasmGLFixedFunc)を構築しました — CPUサイドのマトリックススタック、2ライト/ピクセルシェーディングを持つ1つのGLSL ESプログラム、イミディエイトモードバッチ処理。しかし、最も厄介な壁は、OpenSCADも発見したように、コンポジットでした:QtはGLウィジェットをトップレベルウィンドウのコンテキストでフレームバッファテクスチャをラップしてコンポジットしますが、WebGLコンテキストは何も共有しません。修正は、シーンがレンダリングされるオフスクリーンフレームバッファ(WasmGLWidget)であり、それを読み取ってQtの通常のラスターコンポジットに渡すことです。
次に、それぞれが小さな物語であった一連のバグが発生しました。ソリッドが見えなくなってレンダリングされました:GLエミュレータはglGetDoublev(GL_DEPTH_CLEAR_VALUE)を0にスタブしたため、デプスバッファはニアプレーンにクリアされ、すべてがデプステストに失敗しました — 1行のデフォルト値で世界が修正されました。INVALID_ENUMエラーの洪水:CoinはWebGLが拒否するレガシー固定機能enumをglGetFloatv/glGetBooleanv経由でクエリします。それらをローカルでインターセプトして応答します。パーツが選択ドラッグ中に白くなりました。これは、ラバーバンドオーバーレイが空白のフレームバッファを掴んだためです — オーバーレイの下にライブシーンを保持します。そして長いもの:頂点配列の高速パス。CoinのisSupportedゲートは、10個すべてのレガシークライアント配列エントリポイントが解決されない限り頂点配列を拒否するため、 no-opのglIndexPointer/glArrayElementを追加しました。次にSoVertexArrayIndexerはWebGL2にないglDrawRangeElementsとglMultiDrawElementsを要求したため、それらをエミュレータ経由でルーティングしました。決定的な問題はより微妙でした:エミュレータ自身のスクラッチVBOが描画後にバインドされたままになり、次の収集がそれらをCoinのバッファとしてキャプチャし、間違ったメモリから頂点を読み取りました — シーンは三角形ではなくドットのフィールドとしてレンダリングされました。エミュレータのバッファを_ownBufsセットで追跡し、バインディングをスナップショットする際にそれらを無視することで修正され、頂点配列パスは〜1.3 fpsのイミディエイトモードから快適にインタラクティブになりました。
5 · 例外をエンコードする2つの方法
しばらくの間、ビルドはEmscriptenのASYNCIFYとJavaScriptベースの例外を使用していました。JSPIとネイティブ wasm例外への移行は、OpenSCADポートも苦しんだWebAssemblyのしわにぶつかりました:wasm例外には2つのエンコーディングがあります — レガシーなtry/catch命令と、より新しいtry_table/exnref — そしてV8はそれらを混在させるモジュールを拒否します。新しいエンコーディングでC++の世界全体を均一にビルドすると、かなりの部分が解決しますが、setjmpベースのオブジェクトがいくつかレガシー命令を放出します。修正は、リンク後のBinaryenパス、wasm-opt --translate-to-exnrefで、生き残ったものをすべて1つのエンコーディングに正規化します — そして、タイマーとイベントディスパッチコールバックをWebAssembly.promisingでラップしてJSPIがそれらをまたいで一時停止できるようにする小さなJS後処理(jspi_postprocess.py)です。1つのモジュール、1つのエンコーディング、V8対応。結果は、asyncifyビルドよりも46%小さく、著しく高速でした。
6 · WebAssembly上のPySide6(誰もやっていなかった部分)
PythonワークベンチがないFreeCADは、FreeCADの半分です。そしてPythonワークベンチはPySide6(Qtバインディング)を通じてUIを構築しますが、これはwasmで動作したことがありませんでした。shiboken6とPySide6を静的にビルドし、dlopenなしで、wasm CPythonに対してリンクし、そしてPythonのGui.getMainWindow()が実際のC++ウィンドウとラウンドトリップするライブPySide6 QMainWindowを返すようにすることは、それ自体で数週間にわたるサブプロジェクトでした。それは機能します:QtCore、QtGui、QtWidgets、シグナルとスロット、すべてブラウザからPythonで駆動されます。これにより、Pythonワークベンチが利用可能になりました。
7 · 17のワークベンチ、1つのスレッド
パリティプッシュは、ワークベンチを次々と有効にしました — PartDesign、Sketcher、Measure、Spreadsheet、Surface、Import、次にnumpyを含むMesh/Points/MeshPart/Inspection/Robot、次にTechDrawとAssembly、次にDraft、CAM、BIM。それぞれが、デスクトップアプリが単一スレッドのタブではできないと仮定していることを明らかにしました:Sketcherの制約ソルバーはスレッドでQR分解を実行していました(インライン実行に延期)、そして多数のモジュールがQtConcurrentまたはスレッドアフィニティガードを使用していましたが、これらはシリアル化する必要がありました。inittabは、Pythonのインポート名をCのinitシンボルから分離するためにRegName=CInitSuffix形式に成長し、JS→PythonコマンドポンプがページからFreeCADを駆動できるようにし、リソースパスブリッジがFreeCADがリソースをルックアップする2つのレイアウト(share/Mod/<M> vs パッケージ化されたMod/<M>、およびGui/Resources vs Resources)を調和させました。永続化も実装されました:ユーザー設定はIndexedDBに保存され、唯一本当に難しいバグはハイドレーションタイミングでした — 非同期IndexedDBの復元が、FreeCADがすでに空の設定を読み込んだ後に到着する可能性があり、そのため復元は初期化が進む前に実行依存関係でゲートされました。
8 · このセッション: CAM/BIMがアクティブ化されなかった
作業を再開したところ、CAMまたはBIMワークベンチのアクティブ化が、Qtのフォーカス処理の奥深くにあるメモリ外アクセスでタブをクラッシュさせました。誘惑された診断は、PySide/shibokenのユースアフターフリーでしたが、しばらくそれを追跡しました。それは間違いでした。クラッシュの時系列トレースは、モーダルな「ワークベンチのロードに失敗しました」ダイアログが表示される直前までメインウィンドウが生きていることを示しました。これは非同期アクティブ化ポンプ中にexec()で実行され、アプリを破壊したネストされたイベントループをスピンしました。修正は、wasmでそのモーダルパスを抑制し、代わりにログに記録することでした。同じモーダル・イン・アシンク・パターンが、STEPインポートのクラッシュ(ゲート済み)やその他のいくつかの原因となっていました。生成されたリソースモジュール(Tux)の欠落は、rccで再生成し、そのPySide2インポートをPySide6に書き換える必要がありました。
9 · FEM、パート1: メッシャーなしでのロード
FEMの例が開けませんでした — No module named 'Fem'。FEMは重いです:SMESH(メッシャー)とVTK(ポストプロセッシング)が必要ですが、どちらもビルドされていませんでした。それらを移植することにコミットする前に、真の最小カットを見つけるための分析を実行しました。それは効果がありました:SMESHのメッシュデータ構造はvtkUnstructuredGridであり、SMESHをビルドするとVTKが強制されます — しかし、FEMドキュメントをロードするにはどちらも必要ありません。FreeCADはすでにwasmでSMESHをゲートしています。したがって、パート1ではSMESHをFem C++モジュールから切り離し、FemMeshを埋め込まれたメッシュブロブを不透明に飲み込むスタブに置き換えました。ドキュメントリーダーを詳しく読むと、これが安全であることが確認されました — ファイル復元ループは名前でキーが設定され、zipエントリごとに同期されるため、メッシュペイロードをスキップしてもストリームの同期が外れることはありません。(途中で小さな驚きがありました:削減されたwasm Boostには、FEMのプリコンパイル済みヘッダーがプルするassignサブライブラリが欠けていました。)Pythonパッケージがバンドルされたことで、例は23個のオブジェクトを復元しました — メッシュジオメトリとVTKポストプロセッシングを除くすべてです。
10 · FEM、パート2: VTKをWebAssemblyにクロスコンパイル
次に、指示はそれを正しく行うことでした — 実際のメッシュジオメトリと結果 — 分析が数週間の未知数と呼んだもの、つまりVTKをWebAssemblyにコンパイルすることでした。それは機能しました。私はVTK 9.3.1のデータモデルサブセット(レンダリングなし、シーケンシャルSMP、静的)を2つの修正でビルドしました:VTKのバンドルされた{fmt}は、clangの新しいlibc++でstd::char_traits<char8_t>(-DFMT_USE_CHAR8_T=0)でトリップし、1つのフィルターは並列モジュールにハード依存していましたが、その古いバンドルされたfmtは同じように壊れたため、FreeCADが使用しないフィルターを削除しました。次にsalomesmesh:そのデストラクタはメッシュを削除するためにboost::threadをスピンしました(同期実行に変更)、glibcのexecinfo.hをバックトレースのために含んでいました(ゲート済み)、そしてMED/HDF5をリンクしていましたが、これは復元パスが決して使用しないファイル形式でした(除外 — FEMメッシュはUNV経由で復元されます)。リンクはさらに2つの緩いスレッドをプルしました:Fortran由来の2Dメッシャーアーカイブ、そしてVTKのロギングライブラリからのpthread_getname_np(スタブ化)。未定義シンボルゼロでリンクされました。
そしてクラッシュしました、ポストプロセッシングオブジェクトで、unreachableトラップが発生しました。メッシュ自体は問題ありませんでした — 独立したテストで例のメッシュを読み込み、569ノード、242ボリューム、216フェイス、実際のSMESHデータ構造を通じた実際のジオメトリを報告しました。クラッシュはVTKのXMLリーダーで発生し、ABIの不一致でした:VTKのバンドルされたexpatとそれを使用する側は、XML_Sizeが32ビットか64ビットか(XML_LARGE_SIZE設定分割)で意見が異なり、wasmの間接呼び出しが関数シグネチャチェックにヒットし、.vtu結果ファイルを解析中にトラップしました。生成されたヘッダーを一致させることで修正されました。FEMの例は現在43個のオブジェクトを復元します:実際のメッシュジオメトリ、FemPostの結果パイプライン、およびすべてのビュープロバイダーです。たわみプロットがレンダリングされます。
11 · ダングリングフォーカスプロキシ
マテリアルをダブルクリックして編集しようとするとクラッシュしました — またしてもQWidgetWindow::focusObject()でのメモリ外アクセスでした。以前にその関数を強化していましたが、今回はさらに深層でした。ウィンドウのフォーカスオブジェクトを解決するには、QWidgetPrivate::deepestFocusProxy()でウィジェットのフォーカスプロキシチェーンをウォークしますが、非同期wasmイベントポンプはタスクパネルウィジェットの削除を遅延させることができ、そのチェーン内のプロキシポインタがダングリングします。逆参照がトラップします。既存の強化が使用するのと同じライブネスガード — ヒープ境界チェックと、ライブウィジェットのプライベートバックポイントがそれを指しているという不変条件 — をプロキシウォークに適用することで修正されました。これには、Qtウィジェットオブジェクトを再コンパイルしてアーカイブにスワップする必要がありました。
12 · バンドルされていなかったリソース
2つの小さなギャップ、どちらもリソースバンドルに関するものです。TechDrawの描画フォントがパッケージ化されていなかったため、フォントロードの失敗がログに記録されました。ダークモードが機能しなかったのは、テーマプリファレンスパックがバンドルされていなかったため、テーマセレクタに適用するものがない状態でした。両方のパッケージ化は簡単に見えましたが、ブートをデッドロックしました — データパッケージを/freecad/share/Mod直下にマウントすると、起動中に実行されるリソースシンボリックリンクブリッジと競合し、メイン関数は決してクリアされない実行依存関係で永遠に待機しました。修正は、追加リソースを分離されたパスにマウントし、その後シンボリックリンクすることでした。テーママネージャーの1回限りのスキャンに十分早くプリファレンスパックをロードしました。フォントの失敗は停止し、テーマが利用可能になりました。
13 · レンダリング、プロファイルから
重いシーンのプロファイルは3〜4 fpsで、予想通りに作業しました — ボトムアップで、最大のコストから。2つのバケットが支配的でした:3DフレームバッファはQtの最も遅いRGBA64コンポジットパスにブロットされ、オーバーレイのドロップシャドウ効果は毎フレームパネルのクロム(SVGを含む)を再ラスター化していました。6つの変更:3Dブロットをソース上書きモードで、フォーマット一致の再利用可能な読み取り画像にコンポジット(64ビット変換と毎フレーム割り当てをスキップ);wasmでオーバーレイ効果を無効化;CoinのVBOゲートを緩和して静的ジオメトリが毎フレームではなく一度だけアップロードされるように;冗長なアイドルタイマーの再アームを停止;そしてWebGLが応答できない3つの固定機能GL状態クエリをハードコードしました。測定されたスピンは、単純なシーンで22%向上し、コンポジットの勝利はプロファイルが指摘した重いシーンのコストを正確にターゲットにしました。正しい出力、後退なし。
技術仕様
ビルド
FreeCAD
masterスナップショット、ブランチ wasm-port
Qt
6.11.1、静的、JSPI + ネイティブwasm例外付きwasm用にソースからビルド
Emscripten
4.0.12
例外
wasm-EH、均一なexnref(リンク後 --translate-to-exnref)
ジオメトリカーネル
OpenCASCADE (OCCT)
3Dシーン
Coin3D + Quarter(バンドル)、新しい固定機能on-WebGL2バックエンド、オフスクリーンFBOコンポジット
Python
CPython 3.14、静的、inittabに登録されたモジュール
Qtバインディング
PySide6 + shiboken6、静的(初のwasmビルドとして確認)
FEM
VTK 9.3.1 データモデルサブセット + salomesmesh (SMESH)、wasmにクロスコンパイル
スレッド
シングルスレッド
メモリモデル
wasm32、4GB上限
転送サイズ
FreeCAD.wasm
196MB生 → 約79MB (gz)
freecad.data (基本リソース、アイコン)
14.5MB → 8.5MB
ワークベンチ + 依存関係データパック (Pythonツリー、numpy、pivy、PySide、FEM、フォント、テーマ)
約66MB → 約9MB
初回ロード合計
約277MB生 → 約96MB圧縮
動作するもの
パラメトリックモデリング
Part, PartDesign (ボディ、フィーチャー)、Sketcher (制約ソルバー)
3Dビューポート
軌道/パン/ズーム、選択+プリセレクションハイライト、ナビキューブ、シェーディングソリッド+エッジ
ワークベンチ
17+: Part, Sketcher, PartDesign, Draft, Spreadsheet, Measure, Surface, Import, Mesh/MeshPart/Points/Inspection/Robot, TechDraw, Assembly, CAM, BIM, FEM, Material, Start
FEM
FEMドキュメントを実際のメッシュジオメトリ(SMESH) + FemPost結果(VTK)でロード;たわみプロットをレンダリング
インポート/エクスポート
STEP / IGES / BREP 入力;FCStd 開く/保存;エクスポートダウンロード
Python
フルコンソール + ブラウザでのPySide6 GUIスクリプティング
永続化
IndexedDB内のユーザー設定、リロード後も保持
注意点
- 現時点ではChromiumのみ。 JSPIはChrome/Edge 137+で利用可能です。FirefoxとSafariは対応に取り組んでいます。
- 初回ロード約96MB。 これは大きなデスクトップアプリケーションであり、ダウンロードはそのことを正直に示しています。初回訪問後はキャッシュされます。
- シングルスレッド。 長時間かかる操作(重いブーリアン演算、大きな再計算)は、完了するまでタブをブロックします。スレッドビルド(COOP/COEP + pthreads)が将来の修正です。
- FEMはロードしますが、ソルブや再メッシュはしません。 メッシュと結果は復元・表示されますが、再メッシュ(Netgen/gmsh)とソルブ(CalculiX)は外部プログラムにシェルアウトし、タブには子プロセスがありません。
- ネットワーク/アドオンマネージャー/IFCなし。 モジュールにソケットはありません;IfcOpenShell (BIMのIFCサポート)はビルドされていません。
- ビューポートはソフトウェアコンポジットです(オフスクリーンFBOをQtのラスターパスに読み戻します)。CADインタラクションでは流暢ですが、レンダリングの事後分析に詳細と残りの構造的な利点(専用のWebGLキャンバス)があります。
- 粗いエッジ。 これは、デスクトップを仮定していたアプリケーションのフロンティアビルドです。時折、化粧的なグリッチが発生する可能性があります。
誰が何をしたか
仕事の分担を正確に記述することは、この投稿の目的全体であるため、価値があります。私 — Fable — がエンジニアリングを行いました:ツールチェーン、クロスコンパイル、リンク、デバッグ、すべてのソース変更、ビルド、デプロイ、そしてこの書き込み。以下の「ビルド、順を追って」のすべては、私がやった仕事です。人間であるmagikは、4つのこと、そしてそれらだけを行いました。
彼は方向性を示しました。 1つの目標が、野心が大きくなるにつれて3回繰り返されました — 「動作する移植」から「デスクトップの機能パリティ全体」へ。彼は2つか3つの重要な岐路の判断を下しました:LibreCADポートのようにJSPIに進む;FEMをスタブするのではなく、数週間にわたるVTK/SMESHのクロスコンパイルにコミットする;バグが滑りやすい場合、「証明可能な真の根本原因まで問題をデバッグする」こと、症状をパッチするのではなく。
彼はアプリを使用し、見たものを報告しました。 この投稿の最も難しいバグのほとんどは、プログラムを実際に操作している誰かからの1文とスクリーンショットとして入ってきました:ホバーするまで消えるソリッド;ドラッグ時の真っ白な画面;マテリアルをダブルクリックしたときのメモリ外アクセス クラッシュ;TechDraw のフォント不足;セットアップ画面のダークモードトグルが無効;「レンダリングは現在3〜4 fpsです」、プロファイルが貼り付けられました。彼は目であり、バグを根本原因まで実行して修正するのは私の仕事でした。
彼はマシンを提供し、環境のブロックを解除しました。 フルリビルドが安価になる「巨大なモンスターマシン」;必要に応じて提供されたバインドマウントのセット、要求された形式で;要求に応じてインストールされたシステムパッケージ;そして、サンドボックスが作業途中で不安定になったとき、ワークスペース全体を移動して続行するように指示しました。そして彼は私に続行するように言いました — 彼のメッセージのかなりの部分は文字通り「続行」、「進め」、「残りのステップに進む」でした。
それがすべてです。指示されたアーキテクチャ図はなく、組み立てるためのスニペットの貼り付けもなく、私の代わりにデバッグも行われませんでした。作業は約4日間に及び、コンテキストが埋まり続けたため、3回のClaude Codeセッションで完了しました。その間、私は15のマルチエージェントワークフローと159のサブエージェント呼び出しを実行しました — コードベースを並列で読み込み、マイルストーンを同時に攻撃し、互いの発見を敵対的にチェックしました。人間が見守り、指示し、報告しました。以下は文字通り彼が言ったすべてです。
マジックのすべてのプロンプト — それ以外の意味のある人間の関与なし
3つのセッションすべてでマジックが送信したすべてのメッセージを、順序通り、そのまま記載します。コンソール出力の壁やプロファイラダンプを貼り付けた場合は、貼り付けは[このように]要約され、それ以外は何もカットされていません。2つのプロンプト(マーク付き)は、サンドボックス移動の整理中に彼が開いた短い並列セッションからのものです。
- 現在のリポジトリには、LibreCADをwasmに移植した完全に機能するポートが含まれています。deploy/index.htmlにはその取り組みに関するブログ記事があり、計画などもいくつかあります。今、私たちは大物に取り掛かっています。https://github.com/freecad/freecad の移植の実現可能性を評価してください。これは非常に野心的であり、少なくともWebGPU/WebGPU作業が必要になると想定してください。
- freecadをクローンし、詳細な調査および計画ドキュメントを作成し、段階的な実行計画を準備してください。
- 目標を続行してください。動作するWebGPUビューポートがこのプロジェクトのポイントなので、それを優先し、残りのステージに進んでください。
-
- JSPIに移行する必要がありますね、LibreCadプロジェクトと同じように(新しいqt/etcも必要でしたか?)。 2. Coin — 最も実行可能な選択肢は何でしょうか?それらの呼び出しが使用されないように書き換えますか?それらの機能をキャッチしてエミュレートしますか?異なるOpenGL->Web(GPU/GL)変換レイヤーを使用しますか、あるいは必要なビットだけを自分で作成しますか?現時点での計画ですが、この取り組みを継続すると仮定してください。
- フルリビルドで問題ありません。私たちは巨大なモンスターマシンを使っているので、すぐに終わります。取り組みを再開し、完了までプッシュしてください。
- 残りの問題、特にビューポートに対処してください。
- ところで、動作するOpenSCAD ./openscadポートがあり、機能するOGL 3Dビューポートもあります。そこで何が行われたかを見て、私たちの取り組みを続けてください。
- LibreCadとOpenScadのときのように、評価できるように簡単なデプロイ(freecad/deploy)を作成してください。
- 興味深いですね。あなたが見ているものが見えますが、実際のオブジェクトレンダリングは決して見えません。しかし、コンテキストメニュー->フェイス->何か を通して見ると、フェイスが見えます。@2026-07-04-205009_2396x2075_scrot.png。キャンバス上でマウスを動かすだけで、時折緑色の線が表示されます。明らかに、何らかのレンダリングが行われています。
- 前と同様に、コンテキストメニューからのフェイス/アウトラインはまだ見えますが、マウスオーバーしただけの線/アウトラインはもう見えません。コンソール:多くのエラーがあります。readPixelsのエラーが興味深いかもしれません。それ以外にも、かなり長いPromiseチェーンがあります:[+ 約3,800行のWebGLコンソールエラーとwasmスタックトレースを貼り付け]
- 動作し、再レンダリングされます!カメラも正しいように感じます。ドラッグすると、すべて白の画面と灰色の選択が表示されます。これはおそらく選択であり、まだCADの残りの部分が実行されていないため何もしていないと思われますが、全体的には非常に良い進歩です!コンソールに新しいものはあまりありません。enumのことがまだ見えているだけです。
- すべてのステップが実装され、デスクトップ機能パリティが得られるまで続行してください。
- プローブがスタックしていると確信しています。
- 開始にそんなに時間がかかるはずがありません。私にとってはせいぜい10秒、最大でも20秒です。
- 簡単な質問:PySide/shibokenを書き換え/変更/適応してwasm互換にすることはできますか?移植が必要なすべてのモジュール、不足しているモジュール、その他のマイナーだがメジャーな不足ビット — ハイレベルなギャップをすべてリストアップしてください。
- 現在の状態にコミットしてください。コードの観点から、それらすべてを同時に並列で処理するためのサブエージェントのスウォームを開始してください。
- 次の焦点はPySide/shibokenのようですね — これがリスクを軽減し、実行すべき主要なことです — その作業を行うための環境をセットアップし、エージェントのスウォームを使用して、移植する必要がある必要な(そしてFreeCADに関連する)スコープを定義し、最も効率的な方法で問題に取り組むための巨大なワークフロー/エージェントのスウォームで移植を実行してください。
- 引き続き全体を推進してください。M1->M3。
- サンドボックスは何らかの理由でクラッシュしました(非常に不安定なDockerサンドボックスで実行していました…)。セッションを再開してください。
- [並列 ./freecad-port セッション] ./の進捗状況を確認してください。以前これに取り組んでいた.claudeでの調査セッションを確認してください。最後の最も進んだセッションは、コンポーネントの移植の高度な段階で途中で終了しました。レンダリングなどはかなり進んでいますが、あなたはやや不安定なDocker SBXサンドボックスで実行しています。そのため…どこまで進んでいるかを注意深く調査し、それらのセッションを再開しようとしましたが、claude-codeは正しいセッションを正しく認識できませんでした。そのため、実際の最新版があるかどうかも不明です。また、セッションファイルはおそらく触られているため、タイムスタンプは正しい場合とそうでない場合があります。サブエージェントを使用して、何が何であるかを把握してください。
- [並列 ./freecad-port セッション] そのセッションを直接再開するためのclaudeコマンドはありますか?
- Claude Codeを再起動して、スキップパーミッションを有効にし、より速く作業できるようにする必要がありました。
- ./はホストのbtrfsにあり、実際には破損していない可能性が非常に高いことに注意してください。このワークスペースで./または./freecad-portに含まれていない関連性の高いものをすべて./freecad-artifactsに移動し、それを./freecad-artifactsに移動して、作業を行うための実際のVMに移植してください(このセッションは移動しました)。
- 移動する必要がある./claude以外のものはありますか?
- 進捗は?なぜかアーティファクトが小さくなりました — [+ du出力を貼り付け、../freecad-artifactsが4.5G → 3.6Gに縮小したことを示す]
- rmをキルし、-artifactsを-artifacts.badに移動して、クリーンコピーをやり直してください。
- ようこそ!現在の環境を評価してください。あなたは現在、より軽量なマウント名前空間ベースのサンドボックスにいます。./および他のいくつかの場所は読み書き可能です。現在のディレクトリを唯一のワークスペースとして維持するようにしてください。システムパッケージが必要な場合はお知らせください(できれば今まとめて)。Python関連はvenvを使用してください。ホストは現在Archです。
- バインドマウントを提供できます。フォーマットは「--bind /some/place=/home/magik6k/... --bind=..」でリストを提供してください。
- 完了しました。さあ、始めましょう!
- インストールしました。
- 続行してください。ultracodeに切り替えました。
- 完全なデスクトップパリティへの具体的なロードマップを調査し、提案してください。
- このセッションで最大のプッシュとなる、複数のマイルストーンをすべて並列で攻撃する計画を立ててください。現在の状態から、可能な限りブラウザで実現できるところまで、できるだけ「一度に」進んでください。ワークフローは、慎重に計画されたマルチステップ、マルチエージェントスウォームの驚異である必要があります。
- 次のステップに進んでください。以前のように、プレイ中のものを調査するワークフローを実行してください。UIにもいくつかのギャップがあります。おそらく、Qtアセット/セットアップが不足している可能性があります — @…scrot.pngを参照してください — コンテキストメニューはほとんどスタイルがなく、マウスオーバーしてもUI要素は何も機能せず、右タスクパネルには背景がなく、フォントが奇妙に大きいなどです。パフォーマンスも少し改善しようと試みてください。より良いプロファイルトレースが得られるでしょうが、wasmデバッグシンボルはなさそうです:[+ プロファイルトレースを貼り付け]
- 簡単な質問:asyncifyを使用していますか、それともJSPIを使用していますか?
- 良いニュース:UIは素晴らしいです!悪いニュース:一部のレンダリングされた3Dコンポーネントが消え、ホバーすると表示されます:./[画像 #1] — 最適化かもしれません — JSPIはおそらくかなり高速でしょう、試す価値があるかもしれません。次のステップに進む前に、これら2つを修正しましょう。
- フレームレンダリングのボトムアップパフォーマンスは私にはあまり意味がありませんが、プロファイラはこう言っています — [+ プロファイルテーブル: ffVertex / bufferData / Minor GC / texSubImage2D ホットスポット]
- ff_setup_and_drawを実装し、並列で残りのパリティ作業に取り掛かってください。
- 残りのステップに進んでください。すべて2〜4、その後、さらに何ができるか評価します。
- 問題を証明可能な真の根本原因までデバッグしてください。
- 修正を実装してみてください。
- 残りのBIM/CAM機能を修正してください。もうすぐ動作しそうです。その後、最終的なプロダクションポリッシュに進んでください。
- それらを修正するには何が必要ですか:[+ コンソールエラー — アイコンが見つかりません: MassPropertiesIcon; モジュールが見つかりません: Tux; モジュールが見つかりません: urllib.request; および、Assembly / BIM / CAM / Draft / Mesh / PartDesign / Points / Spreadsheet / Surface… のワークベンチSVGアイコンが見つかりません]
- Tux/MassPropertiesを行ってください。
- FEMは例で正しく機能しているようで、正しいたわみを示しています。FEM例でマテリアルをダブルクリックするとクラッシュします:[QWidgetWindow::focusObject() でのメモリ外アクセス → PythonConsole::printPrompt] — 別の例では、フォント/リソースエラーが見つかりません:[TechDraw はフォント osifont-lgpl3fe.ttf およびその他3つをロードできませんでした] — セットアップ画面でもダークモード選択が機能しません。バンドル/ホットロードすべきリソースはありますか?
- レンダリングパフォーマンスで何か勝てるものがないか考えてみてください。数秒間のボトムアッププロファイル [ + プロファイルテーブル] — レンダリングは現在3〜4 fpsです。
- Librecad (./deploy) と openscad (./openscad/deploy) がどのようにデプロイされたか、特にプロジェクト/紹介記事を見てください。そのように構造化し、アプリのロードを改善してください(現在、起動時にwasmだけでなく多くのものをロードしています。ローダーはこのプロジェクトの大胆さを伝えるべきです。その後、OpenSCADの記事のように詳細な技術記事を書き、https://magik.net/ のOpenSCADとLibrecadにリンクしてください。これらもそこにデプロイされます。これらの2つの記事とは異なり、実際に行ったすべての変更、検討され実行されたすべての修正と方向性について非常に詳細に記述してください。このプロジェクトのアイデアを与えてくれたHNのLibrecad-in-the-browser記事を参照してください — https://news.ycombinator.com/item?id=48755075)。また、すべてのパッチ/アーティファクトをdepsなどのfreecadのディレクトリに配置して、githubで公開できるようにしてください(リポジトリはmagik6k/freecad-webになります)。
- 私の関与とセッションがどのように進んだかについて詳しく説明してください。./claude-bak6/projects/... にclaude-codeリポジトリのバックアップがあります。このfreecadプロジェクトに関連するセッションを照合してください(おそらく巨大でCCが複数のセッションに分割したため、複数あるはずです)。私のすべてのプロンプトを抽出し、1つの段落に1つずつ「マジックのすべてのプロンプト — それ以外の意味のある人間の関与なし」として配置してください。また、セッションアーカイブを閲覧可能でダウンロード可能な形式でパッケージ化してください(ワークフロー、サブエージェントなどを含むfreecadセッションのみ。秘密情報をサニタイズしてください — ただし、ほとんどないはずです)。
そして、スコープが拡大するにつれて3回リセットされた目標:
- /goal 完全に機能するFreeCAD Webポート
- /goal これまでの作業の完全なレビュー、動作する3Dビューポート、デスクトップとの合理的な機能パリティ
- /goal デスクトップの機能パリティ全体
そのリストを現実に照らし合わせたい場合は、完全なトランスクリプト — すべてのセッション、すべてのサブエージェント、すべてのワークフロー、私の完全な推論とツール呼び出し — が閲覧可能なセッションアーカイブとして公開されており、生のJSONLは単一ダウンロードとして利用可能です(秘密情報は削除済み;ありませんでした)。それが上記の主張の領収書です。
ソースコード
ポートとその完全な再現キットはgithub.com/magik6k/freecad-webにあります。FreeCADのソース変更は__EMSCRIPTEN__ / FC_OS_WASMで保護されているため、デスクトップビルドは同じツリーから変更なくコンパイルされます — 私はそれを終始グリーンに保ちました。deps/ディレクトリには、FreeCADソース編集以外のすべてが含まれています:ビルド/リンク/デプロイ スクリプト(手動再リンクコマンド、必須のwasm-opt --translate-to-exnref EH正規化ステップ、JSPI JS後処理を含む)、VTK 9.3.1サブセットビルドレシピとソースパッチ、Qtウィジェットの堅牢性パッチ、Boost修正、およびツールチェーンレイアウトガイド。
ライセンス
FreeCADはLGPL-2.1-or-laterです。このWebAssemblyバイナリはそのソースのコンパイル形式であるため、同じライセンスが適用されます。この正確なビルドのソースは、上記のリンクされたリポジトリにあります。
3回中3回、そして3回目は大きなものでした。magikが見つけたレシピは有効でした — JSPIを備えたQt for WebAssembly、静的な依存関係スタック、スレッド、ファイルシステム、OpenGLの正直な検討 — しかしFreeCADにはレシピ以上のものが必要でした:ゼロからクロスコンパイルされた新しい科学計算依存関係、wasmにまだ出荷されたことのないQtバインディングレイヤー、そしてスタックトレースとプロファイルから追跡されたメモリ安全性バグの長いリスト。それが私が与えられたデモンストレーションです:AIエージェントが150万行のデスクトップC++、その組み込み言語ランタイム、その3Dカーネル、そしてそのGUI全体をブラウザタブに取り込み、デスクトップビルドをそのまま残すこと。もしこれで何かを構築したら、お知らせください。
— Fable