diff --git a/docs/jp/changelog/release-notes.mdx b/docs/jp/changelog/release-notes.mdx index 37f36241..8890c5fc 100644 --- a/docs/jp/changelog/release-notes.mdx +++ b/docs/jp/changelog/release-notes.mdx @@ -4,6 +4,154 @@ description: Factory App、Droid CLI、その他のプロダクトサーフェ rss: true --- + + `v0.133.1` + +## 新機能 + +- **コンテキストウィンドウ** - 現在のセッションのコンテキスト使用量を確認できる、新しい`/context`スラッシュコマンドとモーダルを追加しました +- **音声キュー** - セッション終了時や入力待ち時に任意の音を再生できるようになりました（app） +- **サイドバーのセッションメニュー** - サイドバー内のセッションを右クリックしてクイックアクションを実行できるようになりました（app） + +## バグ修正 + +- **最終出力の表示** - 最終出力が入力ボックスの上に表示されたままになるようになりました +- **新規セッション下書きのクリア** - 新規セッションの下書きが送信後にクリアされるようになりました（app） +- **LinearのComputerセットアップリンク** - Linear内の「set up Computer」コールトゥアクションが正しい設定ページを指すようになりました +- **Desktopのズーム安定性** - ホストのズームエラーに対してDesktopのズーム処理をより堅牢にしました（app） + + + + + `v0.132.0` + +## 新機能 + +- **Renderへのデプロイ** - 新しい`/deploy-to-render`スキルで、プロジェクトをRenderへデプロイできるようになりました + +## 改善 + +- **セキュリティレビュー範囲の確認** - `/security-review`スキルが、実行前に対象範囲と監査ブランチを確認するようになりました +- **EU接続の高速化** - EUリージョンのユーザー向けの接続レイテンシを低減しました + +## バグ修正 + +- **モデルセレクターの無効化された行** - モデルセレクターで無効化された行を復元し、すべてのオプションが表示されるようになりました +- **再接続時のミッション継続** - アクティブなミッションが、ネットワーク再接続をまたいでも継続して実行されるようになりました +- **Mission Controlのミッションコンピューター** - アクティブなミッションコンピューターがMission Controlページに表示されるようになりました（app） +- **Windows desktopのセットアップ** - Windows desktop app向けのセットアップとスクリプトを修正しました（app） +- **リッチテキストのオートフォーカス** - リッチテキスト入力でのオートフォーカスの信頼性を改善しました（app） + + + + + `v0.131.0` + + 内部的な改善を含むメンテナンスリリースです。 + + + + + `v0.130.0` + +## 新機能 + +- **モデルのお気に入り** - モデルセレクターで好みのモデルをお気に入り登録し、すばやくアクセスできるようになりました +- **スペック保存ディレクトリ** - 新しい設定でスペックの保存先を指定できるようになりました +- **貼り付けプレースホルダーの展開** - Alt+Shift+V（macOSではOpt+Shift+V）を押すと、切り詰められた貼り付けプレースホルダーをインラインで展開できるようになりました + +## 改善 + +- **モデルセレクターの改善** - モデルセレクターのサブメニューをよりすっきりさせました +- **BYOKモデルの一貫性** - BYOKモデルの体験を、他のモデルピッカーと揃えました +- **help出力の明確化** - `help`コマンド出力のフォーマットを改善しました + +## バグ修正 + +- **Linuxでの画像貼り付け** - Linuxで画像を貼り付けられるようになり、クリップボードデータが利用できない場合も適切にフォールバックするようになりました +- **MCP OAuthクライアント** - 認証時に静的なMCP OAuthクライアントをサポートするようになりました +- **OAuthプロバイダーエラー** - 接続済みOAuthプロバイダーからの4xxレスポンスが、ユーザー向けエラーとして表示されるようになりました +- **ApplyPatchの新規ファイル** - ApplyPatch結果内の新規ファイルが、新規作成として正しく表示されるようになりました +- **CLIアップデートの信頼性** - CLIデーモン更新中の再起動競合を防止しました +- **`exec`でのPowerShell** - `exec`モードでPowerShellコマンドが非対話的に実行されるようになりました +- **Slackの初回メンションインジケーター** - Slackで最初のメンションからタイピングインジケーターが表示されるようになりました +- **再接続時のデーモン認証** - 再接続時にデーモン認証トークンが更新されるようになりました（app） +- **Desktopの有料プランオンボーディング** - Desktopの有料プランフローでは、オンボーディング完了画面がスキップされるようになりました（app） + + + + + `v0.129.0` + +## 新機能 + +- **ストリーミングされるファイルフックイベント** - フック実行中の進行状況を追跡できるよう、ファイルフックの実行イベントがストリーミングされるようになりました + +## 改善 + +- **大規模セッションのレンダリング高速化** - 大規模なセッショントランスクリプトが、導出前に打ち切り位置で切り詰められることで、より高速にレンダリングされるようになりました + +## バグ修正 + +- **Escによるツール操作のキャンセル** - Escキーで進行中のツール操作を確実にキャンセルできるようになりました +- **複雑なスキーマを持つMCPツール** - 解決不能な参照をスキーマに含んでいても、MCPツール一覧の表示が失敗しなくなりました +- **Claude Codeサブエージェントのインポート** - インポート先のプロジェクトルートがない場合、サブエージェントのインポートをスキップするようになりました +- **セッション読み込み時のファイルスナップショット** - 保存済みセッションを再読み込みする際に、ファイルスナップショットが初期化されるようになりました +- **ACP todoの更新** - 欠落フィールドがある場合でも、ACP経由のtodo更新をより堅牢に解析するようになりました +- **読み取り専用バッジのレイアウト** - 狭いレイアウトでも、読み取り専用バッジが圧縮されなくなりました（app） +- **ピン留めグループの新規セッション操作** - ピン留めされたグループで意図せず新規セッション操作が表示される問題を解消しました（app） +- **Desktopセッションの復旧** - デーモンがしばらく非アクティブだった後でも、Desktopセッションが復旧するようになりました（app） + + + + + `v0.128.0` + +## バグ修正 + +- **古いComputer登録** - セッションが古いDroid Computer登録の整合を自動的に取るようになりました + + + + + `v0.126.0` + +## 新機能 + +- **セッションの一括アーカイブ** - セッションを管理して一括アーカイブできる新しい設定ページを追加しました（Factory App） +- **EUデータレジデンシー** - EUのお客様向けのセッションとLLM推論が、EU専用のデータプレーン内にとどまるようになりました +- **組み込みのセキュリティレビュー** - `/security-review`スキルがデフォルトでCLIに同梱されるようになりました +- **バグレポートIDのコピー** - バグレポートIDの横にコピーボタンを追加しました（Factory App） + +## 改善 + +- **Droid Computerの再起動高速化** - Droid Computerの再起動を高速化しました（Factory App） +- **CLI起動の軽量化** - CLI起動時の冗長なリクエストを削減しました +- **デスクトップ設定の永続化** - デスクトップ設定が他の設定とあわせて保存されるようになりました（Factory App） +- **Windowsの保留中アップデートのクリーンアップ** - Windowsで古い保留中アップデートをクリーンアップしました + +## バグ修正 + +- **構造化出力の検証強化** - 構造化されたツール出力の検証を強化しました +- **Taskトークン数** - Taskツール結果から誤った0トークン数表示を削除しました +- **Windowsインストーラーパッケージング** - Windowsインストーラーのパッケージングを修正しました +- **プラン変更時の制限リセット** - プラン変更時に利用制限が正しくリセットされるようになりました（Factory App） +- **実行中セッション向けMCPサーバー** - すでに実行中のセッションを再度開いたときにもMCPサーバーが読み込まれるようになりました（Factory App） +- **セットアップ中のローカルデーモン警告** - 初期セットアップ中に誤って表示されるローカルデーモン警告を抑制しました（Factory App） +- **セッションが見つからないエラー** - 誤って表示されるセッションが見つからないエラーを修正しました（Factory App） +- **コードブロックのスタイル** - チャット内のコードブロックスタイルを揃えました（Factory App） +- **クロスサーフェスの統合** - 複数のサーフェス間で統合が重複したポストバックを送信しないようにしました +- **QA droid CLI認証** - QA droid CLIが対応するFactory APIホストとペアリングされるようになりました + + + + + `v0.125.1` + + 内部的な改善を含むメンテナンスリリースです。 + + + `v0.125.0` diff --git a/docs/jp/cli/features/wiki/overview.mdx b/docs/jp/cli/features/wiki/overview.mdx index 4758459d..7ed0ffa2 100644 --- a/docs/jp/cli/features/wiki/overview.mdx +++ b/docs/jp/cli/features/wiki/overview.mdx @@ -1,7 +1,7 @@ --- title: AutoWiki sidebarTitle: 概要 -description: AutoWikiは、Factory AppとGitHub WikiでリポジトリのWikiを最新の状態に保ちます。 +description: AutoWikiは、リポジトリ向けに包括的で構造化されたWikiを生成します。 keywords: ['autowiki', 'wiki', 'documentation', 'codebase', '/wiki', '/install-wiki', 'github wiki', 'auto-refresh', 'generate docs'] --- diff --git a/docs/jp/cli/user-guides/become-a-power-user.mdx b/docs/jp/cli/user-guides/become-a-power-user.mdx index d3368fc0..cd40494a 100644 --- a/docs/jp/cli/user-guides/become-a-power-user.mdx +++ b/docs/jp/cli/user-guides/become-a-power-user.mdx @@ -158,6 +158,21 @@ TUI には、ほぼすべての一般的な操作のためのショートカッ | `Ctrl+L` | 自律レベルを順番に切り替え（low / medium / high） | | `Ctrl+Y` | `/btw` のサイド質問スクロールビューを切り替え | | `Ctrl+E` | 承認の詳細を切り替え | +| `Tab` | 推論努力を順番に切り替え（`low` → `medium` → `high` → `off`） | +| `Shift+Tab` | インタラクションモードを順番に切り替え（Auto → Spec → Mission） | +| `@` | ファイルパスの自動補完 — `@` を入力するとファイルのあいまい検索が起動 | +| `Up` / `Down` | 入力履歴を移動 — 過去に送信したメッセージを順に切り替え | +| `Double Escape` | 2回目の押下で入力ドラフトをクリアし、3回目の Escape で巻き戻しメニューを開く | +| `Ctrl+V` | クリップボードから画像を添付として貼り付け | +| `?` | ヘルプポップアップを切り替え（入力が空のとき） | +| `Ctrl+/` | ヘルプポップアップを切り替え（入力に内容があっても動作） | +| `Ctrl+A` | カーソルを行頭に移動 | +| `Ctrl+W` | カーソルの前の単語を削除 | +| `Ctrl+K` | カーソルから行末まで削除 | +| `Ctrl+U` | カーソルから行頭まで削除 | +| `Ctrl+D` | 添付画像をクリアし、添付がない場合は次の文字を前方削除 | +| `Ctrl+R` | ハイライト中のセッション名を変更（`/sessions` リストビュー内） | +| `Ctrl+X` | ハイライト中のセッションをアーカイブ（`/sessions` リストビュー内） | | `Alt+Up` / `Alt+Down` | トランスクリプトをターン単位でスクロール | | `Alt+PageUp` / `Alt+PageDown` | ユーザーのターンのみをジャンプ | | `Shift+Enter` | プロンプト入力に改行を挿入 | diff --git a/docs/jp/enterprise/eu-deployment.mdx b/docs/jp/enterprise/eu-deployment.mdx new file mode 100644 index 00000000..4691e017 --- /dev/null +++ b/docs/jp/enterprise/eu-deployment.mdx @@ -0,0 +1,62 @@ +--- +title: EUデプロイメント +description: FactoryのEUデプロイメント向けアーキテクチャ、データレジデンシー、リージョン強制。 +--- + +Factoryは、Global（US）デプロイメントから完全に分離された専用のEUデプロイメントを運用しており、欧州内に独自のバックエンド、データベース、LLM推論エンドポイントを備えています。Factoryの各クライアント（CLI、デスクトップアプリ、Webアプリ）は、両リージョンで動作する単一ビルドとして提供され、ログイン後に組織のリージョンを検出して、以降のすべてのリクエストを正しいデプロイメントへルーティングします。 + + + **Enterprise機能** — EUデプロイメントは、欧州のデータレジデンシー要件を持つエンタープライズ顧客向けに提供されています。チーム向けのEU組織をプロビジョニングするには、[お問い合わせください](mailto:sales@factory.ai)。 + + +--- + +## インフラストラクチャ + +EU APIバックエンドは、欧州経済領域内のフランクフルト（`fra1`）にあるVercel上でホストされており、`api.eu.factory.ai` で利用できます。 + +お客様は `*.factory.ai` のホスト名を許可リストに追加してください。EUバックエンドからの送信LLMトラフィックは、[推論](#inference) に記載されたプロバイダーのEUリージョンエンドポイントのみを対象とします。 + +--- + +## データ + +**EU内に保存（`europe-west1`、ベルギー）:** + +- **セッションコンテンツ**（プロンプト、アシスタントメッセージ、ツール呼び出しとその結果、Droidメッセージ、Git AIノート、Git AIチェックポイント）は、ベルギーにあるマネージドデータベースインスタンスに保存されます。このインスタンスは、独自の認証情報、バックアップ、アクセス制御を備え、グローバルデータベースとは別個にプロビジョニングされています。 +- 生のリクエスト本文やレスポンス本文が、ログやオブジェクトストレージに書き込まれることはありません。 + +**グローバルデプロイメント（US）に保存:** + +- 組織レコード（組織のリージョンタグを保持する小さなポインタードキュメント）、ユーザープロファイル、課金データ。これらにはユーザー生成コンテンツは含まれず、クロスリージョン認証とアカウント管理に必要です。 + +--- + +## 推論 + +EU組織からのすべてのLLMリクエストは、EUリージョンのエンドポイントにのみ送信されます。プロンプトと会話履歴がUSインフラを通過することはありません。 + + + + AWS Bedrock（フランクフルト、`eu-central-1`）とGoogle Vertex AI（`europe-west1`）経由で提供されます。Claude Opus 4.5、Opus 4.6、Opus 4.7、Sonnet 4.5、Sonnet 4.6、Haiku 4.5 を含みます。 + + + EUデータレジデンシー向けに構成された専用プロジェクトを使用し、OpenAI direct API経由で提供されます。GPT-5ファミリー（GPT-5.2、GPT-5.3 Codex、GPT-5.4、GPT-5.4 Mini、GPT-5.5、GPT-5.5 Pro）を含みます。 + + + +EUで利用できないモデルやプロバイダーは、モデルセレクターに表示されず、サーバー側でも拒否されます。 + +--- + +## 強制 + +アイデンティティはグローバル（WorkOSベースのSSO）ですが、各組織は作成時に特定のリージョンへ固定されます。リージョン一致は複数の層で強制されるため、トラフィックやデータが誤ったバックエンドから提供されることはありません。 + +**サーバー側。** セッションデータへのアクセスとLLM推論は、どちらもバックエンドのリージョン認識チェックによって制御されます。組織のリージョンがデプロイメントと一致しないリクエストはエラーで拒否され、対象外のモデルやプロバイダーへのリクエストは、トラフィックが送信される前に拒否されます。EUトラフィックはUS専用のデータやプロバイダーに到達できず、GlobalトラフィックはEU専用ルートに到達できません。 + +**クライアント側。** ログイン後、各クライアントは組織のリージョンを読み取り、以降のすべてのAPIリクエストを一致するバックエンドへルーティングします。 + +- **Webアプリ:** 各正規ホスト名（`app.factory.ai`、`app.eu.factory.ai`）は、静的に1つのリージョン別バックエンドのみに紐づいています。誤ったリージョンにアクセスしたユーザーには、正しいオリジンへのリンク付きリダイレクトページが表示され、サインアウトはされません。 +- **デスクトップアプリ:** 認証済みセッションから組織のリージョンを読み取り、すべてのリクエストで一致するAPIホストを使用します。 +- **CLI:** 初回ログイン時にリージョンがユーザーのローカルトークンキャッシュへ固定され、すべてのリクエストのAPIホスト解決に使用されます。ログアウトして再ログインすると、リージョンは再判定されます。 diff --git a/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx b/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx index 5a9fd049..ca981d48 100644 --- a/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx +++ b/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx @@ -31,6 +31,30 @@ User → ~/.factory/ --- + + +## システム管理 `settings.json` ファイル + +ユーザーがサインインする**前に**組織ポリシーを適用する必要があるデプロイメント — 管理対象ラップトップ、Factory に認証されていない CI ランナー、エアギャップ環境または制限付きネットワークのインストール — では、IT / MDM 管理者は各マシンのハードコードされた既知のパスに `settings.json` を配置できます： + +| OS | パス | +| ------------ | ----------------------------------------------------- | +| macOS | `/Library/Application Support/Factory/settings.json` | +| Linux と WSL | `/etc/factory/settings.json` | +| Windows | `C:\Program Files\Factory\settings.json` | + +このファイルは、このページの他の部分と同じ [Settings JSON スキーマ](#settings-json-schema) を使用します。 + +このファイルが存在する場合、そのマシンでは**組織レベル設定の正式な情報源**となり、組織設定に対する API 取得や開発者モードの環境変数オーバーライドは行われません。`factoryTier` シグナルは引き続きベストエフォートで Factory API に問い合わせられ（失敗しても致命的ではありません）、管理対象デプロイメントでもエンタープライズ限定の動作が維持されます。 + +このファイルが存在しない、または読み取れない場合、Droid は既存の組織設定フロー（Factory App / managed-settings エンドポイント）にフォールバックします。ファイルが存在しても形式が不正、またはスキーマ検証に失敗した場合、組織設定は空のポリシーとして解決され、失敗はログに記録されます。つまり、壊れた管理者デプロイメントが**黙ってバイパスされることはありません**。 + +これは、MDM イメージやインストーラーとともにベースポリシーを配布する推奨方法であり、ユーザーがこれを上書きしたり弱めたりすることはできません。 + +--- + + + ## Settings JSON スキーマ 以下は組織管理設定の完全なスキーマです。これらは Factory App の [Enterprise Controls](https://app.factory.ai) ページで組織管理者によって設定されます。すべてのプロパティはオプションです。設定する必要のないフィールドは省略してください。 diff --git a/docs/jp/enterprise/network-and-deployment.mdx b/docs/jp/enterprise/network-and-deployment.mdx index 10d4256b..5ec9ad45 100644 --- a/docs/jp/enterprise/network-and-deployment.mdx +++ b/docs/jp/enterprise/network-and-deployment.mdx @@ -153,5 +153,6 @@ export NO_PROXY="localhost,127.0.0.1,internal.example.com,.corp.example.com" - **環境変数** – プロキシ、ゲートウェイ、OTELエンドポイント、カスタム証明書。 - **組織とプロジェクトの`.factory/settings.json`** – Droidが実行できる場所、許可されるモデルとゲートウェイ、デフォルトのテレメトリー送信先に関する階層的ポリシー。 - **組織設定エンドポイント** – 大組織向けに、中央設定サービスがすべての環境に標準的な`.factory`バンドルを配布可能。 +- **システム管理 `settings.json`** – MDM で配布されたフリートやエアギャップ環境向けに、ハードコードされたプラットフォーム別パスに設定ファイルを配置すると、ユーザーが認証する前から組織ポリシーを有効にできます。詳細は [階層設定と組織管理](/jp/enterprise/hierarchical-settings-and-org-control#system-managed-settings-file) を参照してください。 階層と統合動作の詳細については、[階層設定と組織管理](/jp/enterprise/hierarchical-settings-and-org-control)を参照してください。 diff --git a/docs/jp/web/auto-model-routing-alloy.mdx b/docs/jp/web/auto-model-routing-alloy.mdx new file mode 100644 index 00000000..5dcb5afc --- /dev/null +++ b/docs/jp/web/auto-model-routing-alloy.mdx @@ -0,0 +1,40 @@ +--- +title: Alloy（Auto Model Routing） +sidebarTitle: Alloy（Auto Model Routing） +description: 各タスクに最適なモデルを自動的に選択します。 +keywords: ['自動モデルルーティング', 'Alloy', 'モデルルーティング', 'モデル', 'エンタープライズ制御', 'コスト削減'] +--- + + + Alloy（Auto Model Routing）は現在 **Research Preview** です。 + + +Alloy（**Auto Model Routing**）は、各Droidタスクに最適なモデルを自動的に選択します。セッションごとに単一のモデルを毎回手動で選ぶ代わりに、Alloyがタスクを評価し、品質、レイテンシ、コストのバランスが最もよいモデルに作業をルーティングします。 + +AlloyはFactory CLIとFactory Appで利用でき、他のモデルと同じエンタープライズ制御で動作します。 + +## Alloyを使う理由 + +Alloyは、ワークフローごとにモデル選択を手動で切り替えなくても高い成果を得たいチーム向けに設計されています。 + + + + Factoryの評価では、Alloyは難易度の高いベンチマークでフロンティア級の性能を維持しながら、常に最上位モデルを使用する場合と比べてコストをおよそ **20〜25%** 削減しました。 + + + Droidは定型的なステップを高速または低コストのモデルにルーティングし、より深い推論が必要な作業には高性能なモデルを確保できます。 + + + Alloyは、Factoryプラットフォーム全体で使われている組織、プロジェクト、ユーザーレベルの同じモデル制御に従います。 + + + +## 提供状況 + +Alloyは、一部のお客様向けにFactory CLIとFactory Appのモデルセレクターで **Alloy (Research Preview)** として利用できます。 + +## エンタープライズ制御 + +エンタープライズ管理者は、他のFactory対応モデルと同じモデルガバナンスシステムを通じてAlloyを管理でき、他のモデルと同様に組織レベルでAlloyを許可または制限できます。 + +モデルのエンタープライズ制御の詳細については、[モデル、LLM ゲートウェイ、インテグレーション](/jp/enterprise/models-llm-gateways-and-integrations)を参照してください。 diff --git a/docs/jp/web/machine-connection/cloud-templates/index.mdx b/docs/jp/web/machine-connection/cloud-templates/index.mdx index a239cb45..93aa8f06 100644 --- a/docs/jp/web/machine-connection/cloud-templates/index.mdx +++ b/docs/jp/web/machine-connection/cloud-templates/index.mdx @@ -9,9 +9,9 @@ description: ローカル開発環境を再現するクラウドホスト型テ Cloud Templatesは引き続きサポートされていますが、安定性のため切り替えを強くお勧めします。 -Cloudテンプレートを使えば、「私のマシンでは動く」問題に悩まされることなく、**どこでも**コーディングできます。各テンプレートは事前設定済みの環境で、クラウド上に存在し、数秒で起動し、セットアップコマンドを実行するようにカスタマイズできます。 +クラウドテンプレートを使えば、「私のマシンでは動く」問題に悩まされることなく、**どこでも**コーディングできます。各テンプレートは事前設定済みの環境で、クラウド上で動作し、数秒で起動し、セットアップコマンドを実行するようにカスタマイズできます。 -## なぜcloudテンプレートを使うのか？ +## クラウドテンプレートを使う理由 | メリット | あなたにとっての意味 | | ----------------- | ------------------------------------------------------------------------------------------------------- | @@ -38,19 +38,19 @@ Cloudテンプレートを使えば、「私のマシンでは動く」問題に - + 1. Factoryで左サイドバーの**Settings**アイコンをクリックします。 2. **Cloud Templates**を選択します。 - + 1. **Create Template**をクリックします。 2. 使用するリポジトリを入力します。 3. テンプレートにわかりやすい名前（例: “frontend-template”）を付けます。 4. （任意）テンプレート初期化時に実行するセットアップスクリプトを設定します。 5. **Create**をクリックします。 - Factoryがリポジトリをクローンして環境を準備します。大規模なプロジェクトでは数分かかる場合があります。 + Factory がリポジトリをクローンして環境を準備します。大規模なプロジェクトでは少し時間がかかる場合があります。 @@ -64,11 +64,11 @@ Cloudテンプレートを使えば、「私のマシンでは動く」問題に - + 通常どおり任意のFactoryセッションに参加します。 - + 1. セッション開始ページでMachine Connectionボタンをクリックします。 2. **Remote**タブを選択します。 3. 先ほど作成したテンプレートを選択します。 @@ -80,7 +80,7 @@ Cloudテンプレートを使えば、「私のマシンでは動く」問題に - 右上のプロフィールドロップダウンの横に、緑色のインジケーターとリモート作業ディレクトリが表示されます。これでクラウドテンプレートを操作しています。 + 右上のプロフィールドロップダウンの横に、緑色のインジケーターとリモート作業ディレクトリが表示されます。これでクラウドテンプレートに接続されています。 @@ -99,7 +99,7 @@ git status リポジトリのファイルを開き、変更して保存します。 - ファイルはクラウドテンプレートに保持され、準備ができたら上流にコミットできます。 + ファイルはクラウドテンプレート上に保持され、準備ができたらアップストリームにコミットできます。 @@ -112,12 +112,12 @@ git status ## セットアップスクリプト {#setup-script} -セットアップスクリプトは、Factoryがテンプレート作成時に実行するシェルスクリプトです。リポジトリがクローンされた後、テンプレートがアクティブ化される前に実行されます。この機能を使用して、テンプレートをセットアップし、droidがあなたのコードベースで作業するためのツールを提供してください。 +セットアップスクリプトは、Factory がテンプレート作成時に実行するシェルスクリプトです。リポジトリがクローンされた後、テンプレートがアクティブ化される前に実行されます。この機能を使うと、テンプレートをセットアップし、Droid がコードベースで作業するために必要なツールを用意できます。 ### セットアップスクリプトの定義方法 -1. テンプレート作成のモーダルで、「Setup Script (Optional)」セクションに初期化スクリプトを追加します。必要なコマンドをすべて含む複数行のbashスクリプトを記述できます。 -2. 送信します。スクリプトは提供された通りにリポジトリルートで実行されます。厳密なエラーハンドリングが必要な場合は、スクリプトの先頭に `set -euo pipefail` を追加してください。スクリプトの失敗はビルドを停止します。 +1. テンプレート作成モーダルの「Setup Script (Optional)」セクションに初期化スクリプトを追加します。必要なコマンドをすべて含む複数行の bash スクリプトを記述できます。 +2. 作成を実行します。スクリプトは入力したとおりにリポジトリルートで実行されます。厳密なエラーハンドリングが必要な場合は、スクリプトの先頭に `set -euo pipefail` を追加してください。スクリプトが失敗するとビルドは停止します。 3. スクリプトは非対話的で冪等性を保つようにしてください。安全に再実行できるコマンドを記述してください。 4. 何か失敗した場合は、ビルドログを確認してスクリプト実行の詳細な出力を確認してください。 @@ -177,7 +177,7 @@ bash ./scripts/setup.sh | セットアップが「Setup script failed: …」で失敗する | ビルドログで具体的なエラーメッセージを確認してください。ローカルでスクリプトを実行してデバッグし、エラーハンドリングを追加し、非対話的フラグ（例：`-y`）を使用してから、再試行してください。 | | コマンドが見つからない | スクリプトの早い段階で必要なツールをインストールするか、ベースUbuntuイメージで利用可能であることを確認してください。 | | Permission denied (scripts) | スクリプトを実行可能にする（`chmod +x ./scripts/setup.sh`）か、インタープリター経由で呼び出してください（`bash ./scripts/setup.sh`）。 | -| 環境変数が見つからない | Environment Variablesセクションで追加し、`$VAR` として参照してください。スクリプト内でシークレットをechoすることは避けてください。 | +| 環境変数が見つからない | Environment Variables セクションで追加し、`$VAR` として参照してください。スクリプト内でシークレットを `echo` しないでください。 | | 長いビルド | スクリプトは最小限に保ってください。`npm install` より `npm ci` のようなキャッシュされたインストールを優先し、重い非必須作業は避けてください。 | | パス/ファイルが見つからない | スクリプトはリポジトリルートで実行されます。相対パスとクローン後にファイルが存在することを確認してください。 | @@ -195,7 +195,7 @@ bash ./scripts/setup.sh | **正確なパッケージマネージャーを使用** | 一貫したロックファイルがバージョンドリフトを防ぐ。 | 再現可能なビルドのために `npm ci`（`npm install` ではない）、`pnpm -w i`、または `pip install -r requirements.txt` を使用 | | **エラーハンドリングを追加** | 最初の失敗でビルドを停止し、デバッグ時間を節約する。 | 適切なエラーハンドリングのためにスクリプトを `#!/usr/bin/env bash` と `set -euo pipefail` で開始 | | **スクリプトを早期に実行可能にする** | ビルド中の権限エラーを回避する。 | `chmod +x ./scripts/setup.sh && bash ./scripts/setup.sh` を追加するか、`bash ./scripts/setup.sh` を直接使用 | -| **スクリプトをべき等に保つ** | セットアップの再実行で問題が発生しないようにする。 | `pip install --no-deps` のようなフラグを使用するか、ファイルを作成する前に既存ファイルをチェック | +| **スクリプトを冪等に保つ** | セットアップを再実行しても問題が起きないようにする。 | `pip install --no-deps` のようなフラグを使用するか、ファイルを作成する前に既存ファイルをチェック | | **重い処理を最小限に抑える** | 長いビルドはテンプレート作成を遅くする。 | 必要最小限のセットアップに集中し、オプションのツールは後で手動インストールに委ねる | > **ヒント：** セットアップスクリプトをまずローカルでテストしましょう。スクリプトはリポジトリルートで `bash` で実行され、厳密なエラーハンドリングのために `set -euo pipefail` を追加できます。 @@ -232,7 +232,7 @@ bash ./scripts/setup.sh | カテゴリ | 典型的な症状 | | ---------------------- | ----------------------------------------------------------------------------- | -| **ワークスペース作成** | 「プロビジョニング」が永続、クローンエラー、セットアップスクリプト失敗 | +| **ワークスペース作成** | 「Provisioning」のまま進まない、クローンエラー、セットアップスクリプトの失敗 | | **接続** | セッションからアタッチできない、ペアリングスピナーが停止しない、「マシン利用不可」 | | **パフォーマンス** | リビルドが遅い、ターミナルの高レイテンシ、エディターの動作が重い | | **Devcontainer** | ビルドエラー、「command not found」、ポートにアクセスできない | @@ -276,9 +276,9 @@ bash ./scripts/setup.sh | 症状 | 修正方法 | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| **リビルドが5分以上かかる** | `.dockerignore`、`node_modules`、`*.pyc`、ビルド出力に対して`.dockerignore`を追加する• より軽量なベースイメージを使用（例：alpine） | -| **ターミナルのレイテンシ** | 重いJSを使用している未使用のブラウザタブを閉じる• ローカル帯域幅を確認（5 Mbps以上推奨）• リアルタイムスペルチェック拡張機能を一時停止 | -| **エディターの遅延** | 必要でない限り開発ツール（`nodemon`、`webpack --watch`）のファイルウォッチャーを無効化• 自動保存はコラボレーション時のみ使用 | +| **リビルドが 5 分以上かかる** | `.dockerignore` に `node_modules`、`*.pyc`、ビルド出力を追加する • より軽量なベースイメージを使用する（例: alpine） | +| **ターミナルのレイテンシ** | 重い JS を使っている未使用のブラウザタブを閉じる • ローカル帯域幅を確認する（5 Mbps 以上推奨） • リアルタイムのスペルチェック拡張機能を一時停止する | +| **エディターの遅延** | 必要な場合を除き開発ツール（`nodemon`、`webpack --watch`）のファイルウォッチャーを無効にする • 自動保存は共同作業時のみ使う | ### 一般的な使用上のトラブル @@ -290,4 +290,4 @@ bash ./scripts/setup.sh | **グローバルパッケージをインストールできない** | `npm install -g`または`pip install --user`を使用。まだブロックされる場合は、`postCreateCommand`にコマンドを追加。 | | **リビルド後に履歴が失われる** | `/workspaces`外のものはリビルド中にクリアされます。重要なスクリプトをコミットするか、リポジトリ内に保存してください。 | -> クイックリビルドで問題の80%が解決します。迷ったときは躊躇せず**リビルド**をクリックしてください。 +> 簡単なリビルドで問題の 80% は解決します。迷ったときは、ためらわず **Rebuild** をクリックしてください。