Workflows

ワークフローと manifest.json

ワークフローは、Web アプリの起動や検索コマンドを conduit に追加するパッケージです。manifest.json をひとつ書いて zip にし、ウィンドウへドロップするだけでインストールできます。

インストール

1. manifest.json を含むフォルダを zip 圧縮する
2. conduit のウィンドウに zip をドラッグ＆ドロップする

manifest.json は zip のルート直下か、1 階層下にあれば認識されます。GitHub の「Code → Download ZIP」で落としたアーカイブ（repo-main/manifest.json の形）もそのまま使えます。

• インストール先: %APPDATA%\com.conduit.launcher\workflows\<id>\
• 同じ id を再ドロップすると上書き（更新）されます
• 再起動は不要です。インポート直後から検索に載ります

manifest.json の仕様

トップレベル:

apps[] の各要素:

フルサンプル

{
  "id": "web-essentials",
  "name": "Web Essentials",
  "description": "よく使う Web アプリ集（サンプル）",
  "icon": "🌐",
  "apps": [
    { "name": "GitHub", "url": "https://github.com", "icon": "🐙" },
    {
      "name": "YouTube 検索",
      "url": "https://www.youtube.com/results?search_query={query}",
      "keyword": "yt",
      "icon": "▶️",
      "description": "yt <キーワード> で YouTube 検索"
    },
    {
      "name": "Google 翻訳",
      "url": "https://translate.google.com/?sl=auto&tl=ja&text={query}",
      "keyword": "tr",
      "icon": "🌏"
    }
  ]
}

このサンプルはリポジトリの docs/workflows-example にもあります。インストールすると:

• github → GitHub をブラウザで開く（名前のあいまい一致）
• yt lofi → YouTube で「lofi」を検索（キーワード一致・最上位表示）
• tr hello → Google 翻訳で「hello」を日本語へ

検索での振る舞い

• キーワード一致は常に最上位（スコア 1.0）。検索語が空でも（yt 単体でも）ヒットし、{query} は空文字で置換されます
• 名前のあいまい一致で開いた場合も {query} は空文字になります
• アクションは 開く（既定ブラウザ）と URL をコピーの 2 つ

バリデーション

次のいずれかに当てはまる zip はインポート時にエラーになります:

• manifest.json が見つからない（ルートにも 1 階層下にもない）
• JSON の形式が不正
• id または name が空
• id に英数字と - _ . 以外の文字がある
• apps が空
• apps 内に name が空の要素がある
• url が http(s):// で始まらない