封じ込めから始める
AutoQuill が間違った場所に入力しているか、有害な入力を生成している場合は、調査する前にセッションを停止してください。影響の大きいアプリケーションを閉じるか最小化し、作業を保存して、テストを空のローカル エディターに移動します。
可能な限り短いテキストと低速で再生します。複数のオプションを一度に変更すると、原因の特定が困難になります。
ターゲットが間違っているか、フォーカスが盗まれています
症状としては、別のウィンドウに入力する、検索フィールドに出力が表示される、Tab または Enter の後にフォーカスが移動する、またはダイアログが開いたときに入力が停止するなどがあります。
- AutoQuill を停止します。
- 意図したターゲットを前方に運びます。
- 正確なフィールドをクリックしてキャレットを確認します。
- ターゲットを再選択または確認します。
- Tab、Enter、修飾子、およびファンクション キーのコマンドを削除します。
- 5 つの単純な文字を実行します。
- フォーカスを奪う通知やダイアログに注意してください。
すべてのフォーカス遷移を新しいターゲット検証ポイントとして扱います。
文字の欠落、重複、または置換
| Symptom | 考えられる原因 | 最初のテスト |
|---|---|---|
| 不足している文字 | 速度が高すぎるかターゲットの遅れ | 速度を大幅に下げる |
| 繰り返される文字 | キー状態/タイミングの相互作用 | 遅延とプレーンテキストを修正しました |
| 間違ったケース | Caps Lock、Shift、または入力方法 | ロック状態をリセットし、ASCII をテストします。 |
| アクセント付きのテキストが破損しています | レイアウトまたは IME の動作 | 正確なターゲット内の短い Unicode サンプル |
| 注文変更 | アプリケーションのイベント処理またはロード | 速度を落として人間味を取り除く |
タイミングが一貫していない
人間によるタイミングを無効にし、固定の低速レートを使用します。それが成功したら、少しずつ変化を加えていきます。システム負荷、省電力、リモート デスクトップ、ブラウザ レンダリング、ウイルス対策スキャン、ターゲット アプリケーションはすべてタイミングに影響を与える可能性があります。要求された WPM だけではなく、実際に完了した出力と合計時間を測定します。
コマンドが予期しない動作を引き起こす
コマンドはテキストではなくキーです。 Tab でフォーカスを移動でき、Enter で送信でき、Backspace/Delete でコンテンツを削除でき、修飾キー/ファンクション キーでショートカットをトリガーできます。
- シーケンスをプレーンテキストに置き換えます。
- コマンドを 1 つ追加します。
- 使い捨てターゲットでテストします。
- 前後でフォーカスを確認します。
- 繰り返し回数を確認します。
- ドキュメントターゲットのショートカット。
アプリケーション固有の動作は、プロファイルだけから推測することはできません。
クリップボードと動的トークン
クリップボードには、古いデータ、リッチなデータ、機密データ、画像データ、またはファイル データが含まれている可能性があります。実行直前に目的のプレーン テキストをコピーし、手動で検査します。日付/時刻トークンは、システム クロック、タイムゾーン、ロケール、および形式によって異なります。再現性が重要な場合は、最終的な拡張出力をキャプチャします。
ホットキーの競合
グローバル ホットキーは、Windows、アクセシビリティ ツール、キーボード ソフトウェア、またはターゲット アプリケーションと競合する可能性があります。未使用の組み合わせを選択し、AutoQuill を表示および非表示にしてテストし、競合するユーティリティを閉じて、表示される停止コントロールを保持します。
起動とプロファイルの保存の問題
ZIP または保護されたシステム ディレクトリ内ではなく、抽出された書き込み可能なフォルダーから AutoQuill を実行します。セキュリティソフトでファイルが隔離されていないか確認してください。更新後にプロファイルが失敗する場合は、すべての設定に互換性がないと考える前に、新しい最小限のプロファイルを作成してください。
現在のリリースのコンテキストについては、AutoQuill 変更ログ を参照してください。
最小限の再現可能なケースを構築する
空白のエディターに 10 個の ASCII 文字。
人間化、コマンド、トークンはありません。
失敗したコマンドまたはトークンのみを追加します。
問題がアプリケーション固有のものであるかどうかを判断します。
バージョン、Windows ビルド、設定、予想される出力と実際の出力。
トラブルシューティングを中止するタイミング
ターゲットが不可逆的なアクションを実行できる場合、自動化が許可されていない場合、または信頼できる停止メカニズムがない場合に停止します。代わりに、貼り付け、テンプレート、アプリケーションでサポートされている API、または手動入力を使用してください。
意図しない入力後の回復
- AutoQuill を停止し、ターゲットをさらなる自動アクションから切断します。
- 安全な場合は、ターゲット アプリケーションのアンドゥまたはバージョン履歴を使用してください。
- Enter、ショートカット、またはコマンドがデータを送信したかどうかを確認します。
- ログ、送信されたメッセージ、コミット、または変更されたレコードを確認します。
- 必要に応じて既知のバージョンから復元します。
- プロファイルを修正し、使い捨て環境でのみ再現します。
表示されるテキストだけが効果であるとは考えないでください。キーボード ショートカットが非表示状態の変更をトリガーした可能性があります。
サポートレポートテンプレート
バージョン、Windows ビルド、キーボード レイアウト/IME、ターゲット アプリケーションとバージョン、プロファイル設定、正確な最小入力、予想される出力と実際の出力、再現率、メモ帳または別の単純なエディターで発生するかどうかが含まれます。スクリーンショットやプロフィールを共有する前に、秘密や個人データを削除してください。
よくある質問
フォーカスまたはターゲットの状態が変更されました。停止し、正確なフィールドに焦点を合わせ、ターゲットを再確認し、ナビゲーション コマンドを削除し、いくつかの文字をテストします。
速度を下げ、人間化を無効にし、重いアプリケーションを閉じて、シンプルなエディターでテストします。
現在のクリップボードを使用します。実行直前にプレーンテキストを検査して再コピーします。
AutoQuill バージョン、Windows バージョン、ターゲット、最小プロファイル、入力、期待される出力、実際の出力、および空のエディターで再現されるかどうか。
出典と参考文献
- AutoQuillXXQPH0002QXZJivaro · ファーストパーティ
- AutoQuill 変更ログXXQPH0002QXZJivaro · ファーストパーティ
- AutoQuill セットアップ ガイドXXQPH0002QXZJivaro · ファーストパーティ