Skip to content

原文(日本語に翻訳)

/plugin marketplace add owner/repo@ref@記号の解析を修正しました。以前は#のみがrefのセパレーターとして機能しており、@を使用した際にstrictKnownMarketplacesで診断困難なエラーが発生していました。

原文(英語)

Fixed /plugin marketplace add owner/repo@ref incorrectly parsing @ — previously only # worked as a ref separator, causing undiagnosable errors with strictKnownMarketplaces

概要

/plugin marketplace addコマンドでリポジトリのrefを指定する際に、@記号をセパレーターとして使用できなかった問題が修正されました。これまでは#のみがrefセパレーターとして認識されており、一般的な@を使用した書式(owner/repo@ref)ではrefが正しく解析されず、strictKnownMarketplaces設定時に意味のあるエラーメッセージなしに失敗していました。修正後は@記号もrefセパレーターとして正しく機能します。

基本的な使い方

bash
# @記号を使用したref指定(修正後は正常に動作)
/plugin marketplace add owner/repo@main
/plugin marketplace add owner/repo@v1.2.3
/plugin marketplace add owner/repo@feature-branch

# #記号を使用したref指定(以前から動作)
/plugin marketplace add owner/repo#main

実践例

特定バージョンのマーケットプレイスを追加

リリースタグを使用して特定バージョンのマーケットプレイスをピン留めする場合。

bash
# バージョンタグにピン留め(@記号を使用)
/plugin marketplace add myorg/my-plugins@v2.0.0

# 修正前: @記号が正しく解析されず、マーケットプレイスの追加が失敗することがあった
# 修正後: v2.0.0タグのマーケットプレイスが正しく追加される

開発ブランチのマーケットプレイスを追加

社内開発ブランチのプラグインマーケットプレイスを追加する場合。

bash
# 開発ブランチを指定(@記号)
/plugin marketplace add myorg/internal-plugins@develop

# ブランチの最新状態が使用される

コミットSHAで特定コミットを指定

特定のコミットに正確にピン留めする場合。

bash
# 特定コミットを@で指定
/plugin marketplace add myorg/plugins@abc1234def5678

# 再現性の高い環境を構築できる

strictKnownMarketplacesとの組み合わせ

セキュリティ設定が有効な環境でのマーケットプレイス管理。

bash
# strictKnownMarketplacesが有効な環境
# 修正前: @記号を使用するとundiagnosableエラーが発生していた
# 修正後: 適切なエラーメッセージまたは正常な追加が行われる

/plugin marketplace add known-org/known-plugins@stable

注意点

  • この修正はv2.1.71以降で適用されます。
  • @#の両方がrefセパレーターとして使用できるようになりました。
  • GitHub等のGitホスティングサービスでは@による指定が一般的なため、より直感的な操作が可能になります。
  • 関連する修正として、ブランチ/タグrefへのピン留め時のマーケットプレイス更新失敗の修正(2.1.71-plugin-marketplace-update-fix.md)もv2.1.71で対応されています。

関連情報