IronQRをCursorと使用する方法

Curtis Chau
Curtis Chau
更新日: 2026年10月9日

ZXing.NetはZXingバーコードライブラリのオープンソース.NET移植版です。 AIエージェントに顧客の写真からQRコードを読み取るC#コードを依頼する際、IronQRを指定していても、ZXing.Netの規約を適用する場合があります。例えば、Result.Textを比較し、QR_CODEフォーマットをフィルタリングし、QrImageInputをusing文でラップするなどです。 IronQR 2026.10.1では、その方法で入力を破棄するとNotImplementedExceptionがスローされます。

CursorはVS Codeのコードベースに基づくAIコードエディターです。 IronQRコードを生成するか、ZXing.Netの翻訳を行うかは、2つの機能に依存します。 エージェントは提供したドキュメントリンクをたどり、.cursor/rulesからプロジェクトルールを適用します。 このガイドは、顧客の写真からシリアル番号と登録リンクを抽出する保証受け入れサービスを通じて、ZXing.NetからIronQRにサービスを移行する方法を説明します。 IronQRはQR、Micro QR、rMQRシンボルをサポートしています。

このガイドはCursorを使用してコードを書くことに焦点を当てています。 IronQRの読み取りオプションについての詳細は、スキャンモードガイド、QRタイプガイド、値と座標ガイドを参照してください。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronQR

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronQRをインストールします。

Cursorで受け入れプロジェクトを開き、エージェントパネルからこのリクエストを送信します。

@src/WarrantyIntake/ @TestData/claims/ Before writing code, fetch
https://ironsoftware.com/qr/csharp/llms.txt and the scan modes page it links.

Add the IronQR package to src/WarrantyIntake. Give Program.cs a second entry
point so that `dotnet run -- --modes <photo>` reads one photo three times, once
per QrScanMode value, and prints each result's QrType, Value, Url, and four
Points. Set License.LicenseKey from IRONQR_LICENSE_KEY at startup, never from
a literal. Leave Claims/StickerReader.cs and its ZXing.Net reference untouched.
Run the new mode on TestData/claims/claim-0004.jpg and show me what it printed.
Text

チャットメッセージにはライセンスキーを含めないでください。 エージェントはファイルを作成し、ターミナルコマンドを実行します。そのため、貼り付けられたキーがソースコード、コミット、またはログに含まれる可能性があります。 ライセンスキーガイドには、サポートされているストレージ場所が一覧表示されています。



QRコード作業にはどのCursorモデルを使用すべきですか?

ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 以下のテスト実行ではGrok 4.7を使用しました。

クレームレコードにフィールドを追加したり、写真フォルダを再実行したりといった通常の写真作業には高速モデルが適しています。 写真のバッチが明確な理由なしにデコードを停止した場合は、より長く理由を考えるモデルに切り替えます。 モデルはリクエストを異なって読み取るため、各リクエストで写真フォルダと出力が一致すべきシリアルを指定します。

IronQRのドキュメントをCursorにどう渡しますか?

IronQRのドキュメントリンクをリクエストに含めるか、コミットされたルールに保持して、誰も貼り付ける必要がないようにします。 llms.txt インデックスはガイドとAPIリファレンスをリンクし、llms-full.txtは44のドキュメントページを1つのファイルで要約します。2026年10月現在、Cursorの@メニューはファイル、フォルダ、ターミナル、チャット、Git差分、ブラウザーを添付するので、IronQRのドキュメントはリンクとしてエージェントに届きます。

IronQRの列挙型は誤って配置されがちです。 QrScanModeとQrEncodingはIronQr.Enumにあり、QrErrorCorrectionLevelはIronQrにあります。この誤りを含むコードはビルドに失敗します。

@src/WarrantyIntake/Program.cs Answer from https://ironsoftware.com/qr/csharp/llms.txt
and the pages it links, and leave every file as it is.

Which namespace declares QrScanMode and QrEncoding, and which declares
QrErrorCorrectionLevel? Which scan mode does a QrImageInput get when the
constructor is given only an image? What do IronQR's pages say OnlyDetectionModel
returns, and does that match the --modes output from the last turn? Put the
page URL under each answer.
Text
ヒント: ページの裏付けがない回答は、APIリファレンスでメンバーを見つけるまでは未確認と見なしてください。

IronQRの規約をエンコードするプロジェクトルールの書き方は?

プロジェクトルールは.mdcファイルで.cursor/rulesに保存されます。 これらはコードと一緒にコミットされるため、すべてのクローンが同じルールを取得します。 そのフォルダ内の単純な.mdファイルは、いつ適用されるかを示す前書きがないため無視されます。

このルールはglobsを設定し、alwaysApplyをオフにします。それは、リーダーやそのテストがコンテキストにあるときにのみアタッチし、写真にまったく触れないリクエストから除外します。 それを.cursor/rules/ironqr-photos.mdcとして保存します。

---
description: IronQR conventions for reading QR codes from customer photos
globs: src/WarrantyIntake/Claims/**/*.cs, tests/**/*.cs
alwaysApply: false
---

# Reading customer photos with IronQR

- Read and write QR codes with IronQR only. The NuGet package is IronQR, or
  IronQR.Linux for a Linux build, and the namespace is IronQr. Do not add
  ZXing.Net, QRCoder, or any other QR package, and remove them where they
  are already referenced.
- Documentation: https://ironsoftware.com/qr/csharp/llms.txt
- Never inline a license key. Read it from the IRONQR_LICENSE_KEY environment
  variable.
- Do not put QrImageInput in a using statement. Its IDisposable.Dispose throws
  NotImplementedException in IronQR 2026.10.1.
- Load only image files with AnyBitmap.FromFile. It throws on a CSV.
- Compare QrResult.Value with stored strings, never Url.ToString().
- Do not invent IronQR members. If one is uncertain, say so and cite the page.
Markdown
注意してください: カーソルもプロジェクトルートやサブディレクトリのAGENTS.mdを読み取ります。 そこには前書きがないため、ファイルパターンによる範囲指定ができません。 パターンに範囲指定されたIronQRルールを.cursor/rulesに保持します。

ルールはエージェントリクエストに適用されます。 Cursorのドキュメンテーションによると、それらはTabに影響を与えず、ユーザールールはインライン編集には適用されません。 それらの機能からの提案をルールに対して自分で確認してください。

ZXing.Netの呼び出しをIronQRにどのようにマッピングしますか?

「IronQRを使用する」とだけ述べるルールでは、モデルが各ZXing.Net呼び出しが何に変わるか推測することになります。 対応表をリストすることで、推測を排除します。

ZXing.NetまたはQRCoderIronQR
BarcodeReader デコード呼び出しQrReader Read 、これはすべてのコードを返します
Result.TextQrResult.Value
QR_CODE フォーマットチェックとフィルター読み取り後のQrResult.QrTypeに対するチェック
より深いスキャンオプション入力に対するスキャンモード
Result.ResultPoints、パターンの中心QrResult.Points、四隅
QRCoderのジェネレーターQrWriter.Writeとその保存呼び出し

ZXing.NetのBarcodeFormat列挙型にはMicro QRやrMQRメンバーがなく、そのREADMEにはQRコードは記載されているが、より小さなシンボルは記載されていないので、ZXing.NetのリーダーはMicro QRシリアルのみを含むステッカーには何も返しません。

ルールにテーブルを2行追加します。

- Translate ZXing.Net instead of porting it. Result.Text becomes QrResult.Value,
  BarcodeFormat checks become QrResult.QrType checks, and ResultPoints (finder
  pattern centres) become QrResult.Points (corners).
- Write test stickers with QrWriter.Write(...).Save().SaveAs(path), not QRCoder.
Markdown

IronQRへの移行をどのように計画し実行しますか?

Shift+Tabでチャットを計画モードに切り替えてからこのリクエストを送信します。Cursorは編集できるファイルとして計画を下書きします。

@src/WarrantyIntake/Claims/ @tests/WarrantyIntake.Tests/ @TestData/claims/expected.csv

StickerReader decodes claim photos with ZXing.Net and the tests draw stickers
with QRCoder. Newer products carry a Micro QR serial that ZXing.Net never
returns. Plan the move of both projects to IronQR. For each ZXing.Net or
QRCoder call, name the IronQR member that replaces it and the file it sits in,
state which QrScanMode the reader will use and why, and keep ClaimSticker and
the public Read(string) signature unchanged. No code until I approve.
Text

計画で間違った箇所を修正し、ビルドをクリックするか、次のリクエストをエージェントで送信します。

Build the approved plan and follow @ironqr-photos. Remove the ZXing.Net and
QRCoder package references, run dotnet build and dotnet test, then run the app
over TestData/claims and compare each printed row with
TestData/claims/expected.csv. Report how many rows matched before the change
and after it, and show the diff.
Text

@メニューから選択した@ironqr-photosは、グロブでファイルに届かない場合でも名前でルールを添付します。新たなビルドではMicro QRシリアルが戻ってくるかどうかは示されません。 マッチ数がそれを示します。

どのCursor機能が各変更に適していますか?

変更の到達範囲に基づいて1つを選びます。 Tabは予測可能な次の編集を処理し、インライン編集は1つの選択を処理し、1つの文がそれをカバーします。 変更が複数のファイル、ルール、またはビルドループを必要とする場合、エージェントは役立ちます。計画モードは、間違った変更を元に戻すコストが計画するコストを上回るときに有効活用され、Cloud Agentは誰も監視する必要のない作業に適しています。

新しい製品ラインはそのシリアルをrMQRコードに入れた長方形のケーブルタグを追加し、それをIronQRがQrEncoding.RMQRCodeとして報告します。 リーダーで結果ループを選択し、Ctrl+Shift+L(macOSではCmd+Shift+L)を押して選択をチャットに追加し、次にエージェントでこのリクエストを送信します。

In StickerReader.Read, treat a result whose QrType is QrEncoding.RMQRCode the
same way as a Micro QR result, so its Value becomes the serial.
Text

移行からのリーダーは、URLでない値をシリアルとして扱ったため、すでにタグ写真に対してSN-61518を返しました。 編集でその推測をシンボルタイプのチェックに置き換えるので、Micro QRやrMQRの値はそのテキストがURLに似ているときでもシリアルになります。

QRコード値が見つからない場合のデバッグ方法は?

各スキャンモードで戻される内容は変わります。

  • Auto はデフォルトです。 IronQRのAPIリファレンスでは、これは機械学習モデルで、モデルが何も発見できない場合にフォールバックとして基本的なバター力の読み取りを行うと説明されています。
  • 基本的なバター力の読み取りはモデルをスキップして、OnlyBasicScanの下で単独で実行されます。
  • OnlyDetectionModel はコードをデコードせずに特定します。 スキャンモードガイドには出力が座標としてリストされています。

モデルがデコードできないボックスを報告すると、フォールバックは実行されず、自動では値が返されません。 全体ボックスの写真はこれに該当し、4000x3000フレームの中で幅約110ピクセルのステッカーがあります。 戻ってくる値がない場合は、エージェントの修正がOnlyBasicScanでリトライしていることを確認してください。

@src/WarrantyIntake/Claims/StickerReader.cs @TestData/claims/far/

Customers who photograph the whole box send pictures like these. Since the move
to IronQR none of them returns a serial, though the ZXing.Net reader read every
one. Before changing code, read each photo with all three QrScanMode values and
show what each mode returned. Then fix StickerReader without losing any photo
it reads today, and report the match count for TestData/claims and for
TestData/claims/far against their expected.csv files.
Text

IronQRの印刷された出力から各シリアルを取り、生成されたコマンドを求めます。

四隅の順序もモードに依存します。 モデルがコードを見つけたときはスキャンモードガイドで述べているように、4つの点は左上、右上、左下、右下の順序で回ります。 OnlyBasicScanはステッカーと一緒に回転するコード自体の隅を時計回りに返します。 順序を仮定するのではなく、座標からアウトラインを計算します。

QR読み取りの回帰テストをどのように書くか?

既知のリストと比較するテストは、ライブラリのアップグレードに耐えますが、画像バイトを比較するテストはレンダリングの変更で失敗する可能性があります。 クラウドエージェントは、このプロンプトを隔離されたクラウドVMで実行できます。 Cloud AgentsダッシュボードでIRONQR_LICENSE_KEYをシークレットとして追加してから開始します。

@tests/WarrantyIntake.Tests/ @TestData/claims/ Write xUnit tests for StickerReader
that prove every row in TestData/claims/expected.csv and
TestData/claims/far/expected.csv matches, that a Micro QR and an rMQR sticker
made with QrWriter read back to their serials, that a photo with no code gives a
null serial and no exception, and that a link sticker's serial comes from Value,
not Url.ToString(). Copy TestData into the test output. Run dotnet test and
report passed and failed counts.
Text

ステッカーの全体値が裸のアドレスである場合、最後のアサーションが重要です。 IronQRのスキャンモードガイドからサンプル画像を読み取り、Valueがhttp://en.m.wikipedia.org、Urlは末尾のスラッシュ付きで印刷されたものを与えました。なぜならUriがアドレスを正規化するからです。 このサービスにおけるリンクが、シリアルが最後のパスセグメントにある場合、アサーションは失敗しえません。

IronQRのAIコーディングアシスタントガイドは、定義された合格基準を対に対して一から実行します。

どのIronQRパッケージを展開すべきですか?

IronQR.Slim はIronQr名前空間と基本スキャンを提供します。 フルIronQRパッケージは検出器とONNXランタイムを追加します。IronQRのNuGetパッケージガイドによれば、SlimのみのプロジェクトもそのオペレーティングシステムのためにIronSoftware.ReaderInternalsパッケージを必要とします。

@src/WarrantyIntake/WarrantyIntake.csproj @src/WarrantyIntake/Claims/StickerReader.cs

The service ships as a win-x64 folder, and someone asked whether IronQR.Slim
could replace IronQR. Settle it with numbers. Publish for win-x64 as things
stand and record the folder size. Then swap to IronQR.Slim plus the native
package its documentation says it needs, publish again, and rerun
TestData/claims and TestData/claims/far against their expected.csv files. Keep
the swap only if every row still matches, and list which QrScanMode values the
reader can still use afterward.
Text

IronQR.Slimだけでは、オートにはモデルがなく基本スキャンへ直行し、OnlyDetectionModelはIronQrExceptionをスローします。 IronQRのAPIリファレンスは、モデルなしで読むことのスピードと品質が低いことを警告しています。 パッケージを切り替える前に、独自の顧客写真でテストしてください。

プロンプトが実運用で生成したものは何ですか?

8つのプロンプトがサンプル保証受け入れリポジトリに対して順にCursorに送信されました。 それは、ZXing.Netリーダーを持つコンソールアプリ、QRCoderでステッカーを描くxUnitプロジェクト、および既知のシリアルを持つ12枚のクレーム写真を保持しています。 ルール、ケーブルタグ写真、および全体ボックスの写真はそれらを使用するプロンプトの直前に追加されました。 ライセンスキーは環境にのみ設定されました。 実行後、再読み込みされたフォトフォルダからのすべてのコミットの新しいリリースビルドがIronQRリーダーの一致カウントと以下のテスト結果を再現しました。

  • ZXing.Netリーダーで12枚中8枚をクレーム写真が一致し、IronQRに移行した後は12枚中12枚が一致しました。
  • 各スキャンモードごとに一度リードし、claim-0004はAutoとOnlyBasicScanで2つのコードを与え、OnlyDetectionModelで空の値を持つ2つの結果を与えました。
  • rMQRの変化により、移行前後で13枚中13枚となりました。
  • 修正前には、Autoは4枚中0枚の全体ボックスの写真を読み取りました。 OnlyDetectionModelは3、1、3、2のボックスを値なしで見つけ、OnlyBasicScanは4枚中4枚を読みました。
  • 修正後、全体ボックスの写真は4枚中4枚、クレーム写真は13枚中13枚を読み取りました。
  • xUnitスイートは22回中22回のテストに合格しました。
  • win-x64用に出版した結果、IronQRで75,624,980バイト、IronQR.Slimで19,510,306バイトになりました。 再ビルドにより、75,624,288と19,509,614を得ました。
  • IronQR.Slimでは、リーダーは13枚中13枚のクレーム写真と4枚中4枚の全体ボックス写真を引き続き一致させました。
  • 各リリースビルドには0エラーがあり、手動の編集は必要ありませんでした。
  • ここに書かれているように全てのステップが実行されたわけではありません。 プロンプトは手動で送信され、参照はテキストとして貼り付けられ、エージェントはその名前を検索することでルールファイルを見つけました。 ビルドが一度もクリックされないまま次のプロンプトを送信することで計画が承認され、Cloud AgentプロンプトはローカルでAgentモードで実行されました。

実行記録には、ガイドごとのパッケージバージョン、モデル、タイミングとテストマシンが含まれています。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 82,442バージョン:2026.11ちょうどリリースされました