ドキュメント
ソースマップ
動作を追跡し、焦点を絞った変更を行うための実装エントリ ポイント。
英語から自動翻訳されています。 英語の原文を見る
CADと図面
から始める packages/core/src/index.ts ネームスペースのエクスポートを表示します。 packages/core/src/cad/index.ts cAD API をリストします。 packages/core/src/drawing/index.ts 描画操作をリストします。
cad/sketch.ts,sketch-shapes.ts,snap.ts,intersect.ts: データ、形状、スナップ、交差をスケッチします。cad/history.ts,history-edit.ts,history-brep.ts: 機能履歴、編集、B-rep 再構成。cad/brep/,solid.ts,tessellate.ts: ソリッド トポロジ、モデリング、レンダリング可能なメッシュ。cad/import-step.ts,dxf.ts、 そしてimport-drawing.ts: 境界を交換およびインポートします。cad/scene-analysis.ts,scene-evidence.ts,dfm.ts: シーン分析、証拠、製造可能性のチェック。
表示の問題を追跡するときは、インポートの解析、正確なジオメトリ、テッセレーション、およびビューポートの選択を別々にしてください。表示されているメッシュは、編集可能なパラメトリック フィーチャとは異なる原点を持つ場合があります。
CAMとGコード
packages/core/src/cam/index.ts: パブリック CAM 名前空間とエクスポート。cam/operations/そしてcam/generator/: 操作の実装と生成パイプライン。cam/setup.ts,indexing.ts,ir.ts: セットアップフレーム、インデックス加工、中間モーション表現。cam/post/index.ts,emitter.ts、および方言ファイル: 登録された投稿と共有プログラムの出力。cam/post/convert.ts: nC 変換カーネル: G コードまたは Klartext を再生し、任意のポストで書き換え、再生によってモーションを証明します。cam/verify/,kernel/,model/、 そしてviewer/: 検証、カーネル、モデル、ビューア ヘルパーの加工。
永続的な加工をトレースします。 apps/sidecar/src/http/toolpaths.ts そして src/services/cam-program.ts、次にデスクトップ CAM 機能に移ります。の セットアップリファレンス では、ポータブル プログラム ドキュメントが保存されたツールパスとどのように関連するかを説明します。
HTTP と永続性
packages/api/src/index.ts,groups/,errors.ts,auth.ts: エンドポイント契約、ワイヤエラー、認可宣言。packages/api/src/client.ts: ベアラーミドルウェアを備えた完全なコントラクトベースのエフェクトクライアント。packages/api/scripts/generate-clients.ts: ターゲット出力と明示的な世代の除外。packages/httpapi-codegen/src/index.ts: コントラクトのリフレクション、検証、およびクライアント エミッター。apps/sidecar/src/main.ts,config.ts,layers.ts: サーバーのライフサイクル、構成、依存関係の配線。apps/sidecar/src/http/,services/,repos/: プロトコル アダプター、アプリケーション操作、永続性アクセス。packages/db/src/index.ts,schema.ts,upgrade.ts,migrate.ts: データベース サービス、テーブル、アップグレードの安全性、および CLI。packages/db/drizzle/: デスクトップに同梱される、生成された移行とメタデータ。
デスクトップとモバイル
apps/desktop/src/app/App.tsx, Shell.tsx、 そして routes.tsx ワークベンチとルートを組み立てます。 client.ts そして sidecar.ts aPI アクセスとネイティブ接続状態を処理します。製品の動作は以下に基づいて行われます src/features;共有コントロールと状態は以下に存在します src/shared.
ビューポートは下にあります apps/desktop/src/viewport、に分割 editor2d, view3d、 そして spatial。ネイティブコマンドとライフサイクルは次のとおりです apps/desktop/src-tauri/src;梱包構成は src-tauri/tauri.conf.json.
モバイルルートは次のとおりです apps/mobile/app、以下の再利用可能なコンポーネント components、および以下のクライアント/ペアリング ロジック lib。ネイティブソケットモジュールは次のとおりです。 modules/companion-net。サーバー上で、次の場所でコンパニオン トレースを開始します。 apps/sidecar/src/http/companion.ts そして services/companion.ts.
AI、プラグイン、歴史、ワークフロー
packages/ai/src/actionsそしてtools: アクション宣言とアシスタントツールの統合。packages/ai/src/nikcli,prompts、 そしてskills: 埋め込みホスト統合とアシスタント ガイダンス。apps/sidecar/src/services/ai.ts: ライブ AI の依存関係とホストの選択。packages/nikcli-plugin/src/index.ts: 外部 nikcli HTTP ブリッジ。packages/plugin-sdk/src/index.tsそしてapps/sidecar/src/plugins/host.ts: プラグイン オーサリング サーフェスとランタイム ホスト。packages/vcs/src/index.ts,apps/sidecar/src/services/project-vcs.ts、 そしてrepos/project-vcs-repo.ts: 履歴ライブラリ、オーケストレーション、永続性。packages/workflow/src/index.ts,apps/sidecar/src/services/workflow-runner.ts、 そしてworkflow-service-steps-live.ts: ワークフローの契約、実行、およびサービス ステップの登録。
バージョン管理が存在する packages/vcs/src: object.ts (git オブジェクト形式)、 repository.ts (参照とコミット)、 snapshot.ts, diff.ts, store.ts, transport.ts、 そして github.ts。ワークフローが存在する packages/workflow/src: schema.ts, trigger.ts (グロブとトリガーのマッチング)、および run.ts。ワークフロー ファイルの読み取り元 .cadcamfun/workflows/ プロジェクトツリー内。
書類と納品
packages/web/src/pages/docs ドキュメント記事が含まれています。 src/layouts/DocsLayout.astro 共有記事シェルを提供します。ナビゲーションと検索コピーは次のとおりです。 src/data/docsSidebar.ts そして docsIndex.ts;共有パッケージの説明は次のとおりです architecture.ts.
src/lib/docsMarkdown.ts レンダリングされた記事を Markdown に変換します src/pages/llm.ts そしてドキュメントアシスタント。取得中です docsRetrieval.ts;アシスタント執行中です src/pages/api/docs-assistant.ts。アーティファクトの解析とストレージのヘルパーが含まれています src/lib/docsArtifact.ts.
packages/web/script/dev.ts astro とローカル Studio プロセスを開始します。 studio-server.ts ローカル SQLite 概要 API を所有しています。 astro.config.mjs プリレンダリングインフラストラクチャとローカルプロキシを構成します。 wrangler.toml ワーカーバインディングを宣言します。
デスクトップ コンパイルとリリース ステージングが開始される scripts/build.ts。 CI とリリースのワークフローは次のとおりです .github/workflows。見る リリースとアップデート アーティファクトの生成と署名の要件について。
境界を越えて行動を追跡する
- でエンドポイントを特定します。 リソース参照 そして、そのパラメーター、本文、応答、およびエラーのスキーマを読み取ります。
- API ルート構成でその HttpApi 宣言を見つけます。プロジェクトなどの一部の基本リソースは、以下の直下にあります。
packages/api/src;他のグループは以下に住んでいますsrc/groups. - 以下でそのハンドラーを見つけます
apps/sidecar/src/http。サービスまたはリポジトリの呼び出しに従う前に、現在のユーザーとリソースのチェックを読み取ります。 - 計算するには、コアに進みます。ストレージの場合は、リポジトリを続行し、
Database.query。プロバイダー/ネットワークの動作については、構成されたアダプターを検査してください。 - デスクトップまたはモバイルの発信者に戻り、そのエンベロープ処理、セッション状態、キャンセル、およびエラー表示を検査します。
たとえば、プロジェクト作成時に名前が欠落していると、プロジェクトでは拒否されます。 apps/sidecar/src/http/projects.ts;これは SQLite エラーではありません。ポータブル CAM ドキュメントの不一致は、次の方法でチェックされます。 apps/sidecar/src/services/cam-program.ts;ビューポートで NC を解析する場合、これをバイパスすることはできません。ペアの電話ルートの拒否は、コンパニオン ゲートウェイのメソッド/パス ポリシーに起因します。
ファイル数を含むディレクトリ ツリー
apps/
desktop/src/ app/ 13 features/ 280 pages/ 68 shared/ 44 viewport/ 25 i18n/ 1
desktop/src-tauri/src commands.rs lib.rs main.rs menu.rs secrets.rs sidecar.rs tray.rs updater.rs
sidecar/src/ http/ 34 repos/ 24 services/ 29 plugins/ 3 (+ main.ts, config.ts, layers.ts)
mobile/ app/ 13 components/ 30 lib/ 21 hooks/ 2 modules/ 2
packages/
core/src/ cad/ 80 cam/ 110 drawing/ 7
ai/src/ actions/ 14 nikcli/ 27 tools/ 26 prompts/ 5 skills/ 2
api/src/ groups/ (one file per group) sdk/generated/ client/generated/
db/ src/ (index, schema, upgrade, migrate) drizzle/ (4 migrations)
vcs/ workflow/ plugin-sdk/ httpapi-codegen/ nikcli-plugin/ web/
scripts/ build.ts compile-sidecar.ts stage-release.ts updater-manifest.ts
release-helpers.ts release-ref.ts signing-config.ts smoke-sidecar.ts
.github/workflows/ ci.yml release.yml build-platforms.yml ios.yml デスクトップ機能フォルダー
以下の各フォルダ apps/desktop/src/features/ 1 つの製品領域のコンポーネント、状態、および API 呼び出しを所有します。
admin ai analytics auth billing cad cam chat companion costs dashboard
legal library marketplace mcp organizations plugins profile projects settings toolpaths 機能は共有 API クライアントを通じてサイドカーを呼び出します。共有ウィジェットが存在する shared/ そして、3D シーン viewport/.
CAD の概念がコアに存在する場所
| コンセプト | package/core/src/cad/ 内のファイル |
|---|---|
| スケッチ解決 | sketch.ts, sketch-shapes.ts |
| 機能履歴と再構築 | history.ts, history-brep.ts, history-edit.ts |
| 正確な B 担当者 | brep/ |
| メッシュ上のブール値 | csg.ts |
| 式とパラメータ | expr.ts |
| STEPとDXFのインポート | import-step.ts, dxf.ts, import-drawing.ts |
| フィレとブレンド | edge-blend.ts |
| ギア、ファスナー、板金 | gear.ts, fasteners.ts, smart-fasteners.ts, sheet-metal.ts |
| 組み立てとシーンの分析 | assembly-analysis.ts, scene-analysis.ts, scene-step.ts |
| 製造性 | dfm.ts |
| コンセプト | package/core/src/cam/ 内のファイル |
|---|---|
| ネイティブ カーネル (スナップショット、実行、クレーム) | kernel/ |
| ポストプロセッサ | post/ |
| オペレーションとジェネレーター | operations/, generator/, cycles/ |
| セットアップとインデックス作成 | setup.ts, indexing.ts, five-axis.ts |
| リプレイと検証 | verify/, program-evidence.ts |
| 機械と工具 | machine.ts, tool.ts |
| サブプログラム | subprogram-text.ts |