プラグインパネルを開かなくても、FigmaのQuick ActionsからCryptoのよく使うタスクを実行できます。以下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。
Quick Actionを実行する
どのショートカットも、有効なライセンスが確認できているか、トライアル回数が残っている必要があります。確認に失敗した場合やトライアルの期限が切れた場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはその場合でも開けます。
- ショートカットが選択範囲を使う場合は、作業したいレイヤーを選択します。
- MacではCommand + /、WindowsではCtrl + / でFigmaのQuick Actionsを開きます。
- プラグインを検索し、以下の名前付きショートカットを選びます。
- 表示された欄に入力します。任意の欄は省略でき、Tabキーで編集できます。ショートカットを実行し、結果を確認するか、保存ダイアログを完了します。
作成系のショートカットは、名前やサイズを直接尋ねます。選択レイヤー系のショートカットは、現在の選択範囲を自動的に使います。これらの日常的なショートカットでは、TargetやJSONは求められません。通常のプラグインパネルを開くにはOpen Cryptoを選びます。
| ショートカット | 入力 |
|---|---|
| Upload Selected Designs | なし（すぐに実行） |
| Export Selected Designs as PDF (Custom Settings…) | Password protection（任意）、PDF quality（任意） |
選択肢が決まっている欄には、わかりやすいラベルが表示されます。表示されたラベルでも内部の値でも検索できます。エージェントの入力には、引き続きコマンドリファレンスに記載された値を使います。
コンテキストメニューから実行する
対象のレイヤーを選択して右クリックし、Plugins → Cryptoを選びます（開発中のプラグインはDevelopmentの下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。
各プリセットは、その名前のオプションを設定します。省略した互換オプションには、プラグインに保存された設定が引き継がれます。明示的に選んだアクションやオプションは、矛盾する保存済みの動作より優先されます。その実行で保存済みの設定を上書きするのは、明示的に入力した欄か、選んだメニュー項目だけです。一度も保存されていない設定には、通常の設定か、ドキュメントに記載されたフォールバックが適用されます。エクスポート時の上書きは設定に保存されません。保存済みの形式がショートカットで使えない場合は、対応する形式を明示的に選ぶか、通常のパネルを使ってください。オプションを組み合わせるには、アクション内でCustom Settings… を選び、パラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須欄の入力を求められます。Open Cryptoを選ぶと通常のパネルが開きます。
| メニュー項目 | 次のステップ |
|---|---|
| Upload Selected Designs | すぐに実行 |
| Export Selected Designs as PDF → Use Saved Settings | すぐに実行 |
| Export Selected Designs as PDF → Export Selected Designs as PDF (Custom Settings…) | Password protection（任意）、PDF quality（任意）を入力 |
詳細な編集
詳細な設定、長い内容、一括での作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上記の日常的なコマンドしかありません。
貼り付ける各欄は150文字未満にしてください。Figmaデスクトップでは、貼り付けた入力がその長さで切り詰められることがあります。それより長い入力は通常のパネルで行います。
古いバージョンのプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新してこれらの名前付きショートカットを使ってください。Targetの値はレイヤーIDか選択範囲であり、新しく作る項目の名前ではありません。
Cryptoのアクション
| アクション | 内容 | 対象 |
|---|---|---|
publish | 選択したフレームを、保護された新しいデザインバージョンとしてアップロード | 対象となる1つ以上のレイヤー |
pdf | 保存済みの保護設定を使って、選択したフレームをPDFとしてエクスポート | 対象となる1つ以上のレイヤー |
publish
選択したフレームを、保護された新しいデザインバージョンとしてアップロードします。対象となるレイヤーを1つ以上選択してください。
このショートカットには入力欄がありません。
これは、プラグインの既存のHypermaticサービスへの明示的な外部書き込みです。保存済みのアカウント設定を再利用し、既存のワークフローでアカウントが作成される場合があります。アップロードでエラーが発生しても自動で再試行しないでください。リモートの保存先に一部だけ出力されていないか確認してください。
Upload Selected Designsを選びます。現在の選択範囲を使ってすぐに実行されます。
エージェントホストの入力
{"command":"shortcut-publish","parameters":{}}pdf
保存済みの保護設定を使って、選択したフレームをPDFとしてエクスポートします。対象となるレイヤーを1つ以上選択してください。
| オプション | 型 | 必須／デフォルト | 意味と指定できる値 |
|---|---|---|---|
protection | string | フォールバック："saved" | 以前に保存したパスワードを使うか、保護なしでのエクスポートを明示的に指定します。saved、none |
dpi | string | フォールバック："ebook" | 既存のPDF品質プリセット。screen、ebook、printer、prepress、default |
ネストされた必須欄は、その親オブジェクトや配列の項目を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の操作の動作が使われます。
Export Selected Designs as PDF (Custom Settings…) を選びます。次のプレーンな欄に入力します。JSONは不要です。
- Password protection：Use Saved Password
- PDF quality：eBook (150 dpi)
エージェントホストの入力
{"command":"shortcut-pdf","parameters":{"protection":"saved","dpi":"ebook"}}エージェントでショートカットを使う
下のリンクにある機械可読のレジストリを読み、インストール済みプラグインのQuick Actionsの一覧にあるアクションを選びます。レジストリは標準のJSON Schemaではなく、Hypermaticのオプション定義を使います。minとmaxは、欄の型に応じて文字列の長さ、配列の長さ、数値を制限します。ネストされた定義にはfieldsとitemを使います。不明な欄は拒否されます。
エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによってRESTやMCPのランチャーが追加されるわけではありません。展開できる例は、対応ホスト向けの入力データであり、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含め、parametersにプレーンな文字列を使います。準備した入力だけを根拠に、ショートカットが実行されたと判断しないでください。
目に見える結果を確認します。変更されたFigmaのレイヤー、保存されたエクスポート、公開されたページです。通常の成功・エラー通知と、一部のみのエクスポートに関する警告を読んでください。必要に応じてネイティブの保存ダイアログを完了します。ダウンロードが始まっても、ファイルが保存されたとは限りません。ユーザーが開発者ツールを開いたり、コンソールを読んだりする必要はありません。
トラブルシューティング
| 症状 | 次のステップ |
|---|---|
| アクションが使えない | プラグインを更新し、Quick Actionsの一覧を確認します。アクションが使えない場合は通常のパネルを使います。 |
| オプションが無効、または切り詰められた可能性がある | 各欄にはそのショートカットが受け付ける欄だけを使い、プレーンな値を150文字未満で入力します。 |
| 対象がない、または対象外 | 正しいページを開き、アクションのレイヤー要件を確認してから、対象のレイヤーを選択し直します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを要求したのに保存されたファイルが見当たらない | ネイティブの保存ダイアログとダウンロード先を確認します。実際のファイルを確認してください。 |
| コマンドが失敗、タイムアウト、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの保存先を確認します。それまでの変更やアップロードがすでに反映されている場合があります。 |
コマンドの制限時間は5分です。エラーが起きても、すべてがロールバックされるとは限りません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。
機械可読のコマンドレジストリには、同じアクションIDとオプション定義が含まれています。
現在の制限
publishは、既存のアカウント設定とアップロード機能を使って、保護された新しいデザインバージョンを作成します。リモートのアカウントが作成される場合があります。プロトタイプの公開、既存バージョンの更新、パスワードの変更は、引き続き対話形式で行います。PDFエクスポートでは、保存済みのパスワード保護の状態と品質が使われます。protectionにnoneを選ぶと、そのエクスポートに限って保護が無効になります。保護を有効にした設定が保存されている場合は、保存済みのパスワードが必要です。Use Saved Passwordを明示的に選んだ場合も保存済みのパスワードが必要で、その実行では保護が有効になります。