メインコンテンツへスキップ
Windsurf JetBrains プラグインは maintenance モードであり、Cascade は非推奨となりました。新しい JetBrains IDE のリリースでは、レガシー プラグインが動作しなくなる可能性があります。Cascade またはプラグインが動作しなくなった場合は、ACP 経由の Devin に切り替えてください。JetBrains ACP セットアップガイド を参照してください。

対応バージョン

バージョン 2022.3 以降。

拡張機能のログの収集

診断情報ファイルをダウンロードするには、次のいずれかの方法を利用します。
  • Cascade パネルで右上の三点メニューをクリックし、Download Diagnostics をクリックします。
  • IDE のメニューで Tools > Windsurf > Download Windsurf Diagnostics を選択します。
IDE の完全なログは idea.log ファイルに記録されています。
  1. このファイルの場所を確認するには、Help > Show Log in Finder/Explorer を選択します。
  2. ログをエクスポートまたはコピーします。

IDE の既知の問題と解決策

Cascade が表示されない

通常、ログに次のエラーが表示されます。
または
JCEF は、Cascade を表示するために必要なブラウザーです。これを解決するには、Help > Find Actions > Choose Java Boot Runtime に移動し、JCEF が同梱されたランタイムを選択してください。 すでにランタイムに JCEF が同梱されている場合は、レジストリまたはプロパティで JCEF が無効になっている可能性があります。 プロパティを編集します: Help > Edit Custom Properties に移動し、次のフラグを追加して IDE を再起動してください:

証明書の問題

次のエラーが発生した場合:
このエラーは、Windsurf プラグインが貴社のエンタープライズポータルまたは APIサーバーへの TLS 接続を信頼していないことを示しています。プラグインは、受け取った証明書を信頼していません。この証明書は、貴社のエンタープライズデプロイ、または企業のプロキシによって提示されている可能性があります。 いずれの場合も、もっとも望ましい解決策は、この証明書に署名したルート証明書が、エンドユーザーのマシン上の適切な場所に正しくインストールされていることを確認することです。JetBrains IDE とその他ほとんどの IDE は、オペレーティングシステムのデフォルトの場所から証明書を読み込みます。 証明書は、社内の IT チームまたは Admin チームによって発行・管理されています。システムに必要な証明書をインストールする際は、そちらにお問い合わせください。 TLS が終端される箇所では、完全な証明書チェーンが提示されていることが重要です。提示されるのがリーフ証明書だけの場合、JetBrains IDE やその他の IDE はその真正性を検証できないことがよくあります。これは、リーフ証明書を検証し、さらにルート証明書によって検証される中間証明書を認識できないためです。ブラウザーでは、この問題を回避できることがよくあります。ユーザーが以前に完全な証明書チェーンを提示する別の Web サイトにアクセスしており、その結果、中間証明書が認識・キャッシュされている可能性が高いためです。しかし、JetBrains IDE のようなアプリケーションにはこの利点がありません。 注: JetBrains ファミリー製品の 2024.3 では、IDE が OS の証明書を受け付けられなくなる bug が導入されました (JetBrains の issue レポート) 。これを解決するには、users は次のいずれかを実行できます。
  • JB 製品を以前のバージョンにダウングレードする
  • 2024.3.1 のプレビュー版 (ベータ版) を利用する
  • カスタム JVM オプションとして -Djavax.net.ssl.trustStoreType=Windows-ROOT を追加する

カスタムワークスペース

Cascade の使用時に次のエラーが表示される場合:
これは、Cascade が正常に動作するためにカスタムワークスペースへのアクセスを必要としていることを示しています。これを解決するには、次の手順を実行します。
  1. File > Settings (macOS では IntelliJ IDEA > Preferences) に移動して、JetBrains IDE の設定を開きます
  2. Tools > Windsurf Settings に移動します
  3. Windsurf Settings パネルで、カスタムワークスペース セクションを見つけます。ローカルプラグインでは、Enterprise 以外のユーザーには Tracked Workspaces と表示されます。リモートプラグインでは、このセクションは Enterprise ユーザーにのみ表示されます。
  4. “Add Workspace” ボタンをクリックして、プロジェクトのワークスペースを追加します
  5. プロジェクトに適したワークスペース ディレクトリを選択します
  6. “OK” をクリックして設定を適用します
  7. 変更を反映するため、IDE を再起動します

Enterprise と非 Enterprise での動作の違い

カスタムワークスペースの動作は、ユーザー種別によって異なります。

Enterpriseユーザー

Enterpriseユーザーは、インデックス化するワークスペースを個別に選択できます。
  • ローカルプラグインでは、各ワークスペースに Tracked チェックボックスがあり、これを選択するとインデックス化が有効になります
  • インデックスされるのは、チェックボックスが選択されているワークスペースのみです
  • チェックボックスが選択されていないワークスペースはインデックスされませんが、ツール呼び出しでは利用できます
  • リモートプラグインには Tracked チェックボックスがなく、カスタムワークスペースはインデックス化されません
  • これにより、インデックス化のリソースをどのワークスペースに使うかを制御できます

Enterprise以外のユーザー

Enterprise以外のユーザーでは、ワークスペースのインデックス化は自動で行われます。
  • 追加したワークスペースは、チェックボックスをオンにしなくても自動的にインデックスされます
  • 追加したすべてのワークスペースは、すぐにCascadeで利用可能になります
  • このモデルでは、選択的インデックス化機能は関係ありません

ツール呼び出しの制限

Team 設定の Restrict Cascade to workspace は、デフォルトではオフです。レガシーの Team ポータルでは、この設定は Restrict Tool Calls to Workspace (Alpha) という名前になっています。チーム管理者がこの設定をオンにすると、ツール呼び出しで利用できるのはアクティブなワークスペースとカスタムワークスペースのみになります。 これらのステップを完了すると、Cascade があなたのワークスペースにアクセスできるようになります。

Windows の Rider でキーボード ショートカットが機能しない

Windows で JetBrains Rider を利用している際に、Cascade で Shift+Enter を押しても改行されない、または Delete キーが機能しない場合は、Rider の Unit Test Tool Window とのキーバインドの競合が原因です。 これは Rider の AI プラグインに影響する既知の問題です。これを解決するには、次の手順に従ってください。
  1. File > Settings を開いて、JetBrains IDE の Settings を開きます
  2. Keymap に移動します
  3. “Unit Test Tool Window Action” を検索します
  4. 競合しているキーバインド (Shift+Enter と Delete) を無効にするか、別のキーに再割り当てします
  5. 変更を反映するため、IDE を再起動します