原文(日本語に翻訳)
/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で対応されています。