CZONリンクチェック機能とAI修復の課題と解決策
トラブルシューティング
👤 ソフトウェア開発者、AIツール利用者、技術文書管理者
本稿では、CZONリンクチェック機能の開発プロセスを詳細に記録し、初期のデッドリンクチェック実装からAI修復時の問題発見までを網羅しています。著者は、AIによるリンク修復時に主に2つの問題があると指摘しています。1つは、デフォルトでプロジェクト全体のファイルをスキャンしないこと、もう1つは相対パスの理解が不十分なことです。これにより、AIがリンクをコンパイル出力ディレクトリに変更したり、シンボリックリンクを作成したりするなどの誤りが発生しました。著者は問題の根源を分析し、解決策として、AIに問題ファイルに基づく相対パスの候補リストを提供し、AIがプロジェクト全体をスキャンしたり、相対パスを独自に解釈したりするのを防ぐことを提案しました。最終的に、CZON 0.9.1バージョンで500件のリンクエラーが正常に修正され、著者はコンパイルチェックがAI修復と相互補完的に機能する必要があると結論付け、AIに適したチェック出力フォーマットを設計しました。
- ✨ CZONはリンクチェック機能を実装したが、AI修復時に誤りが発生
- ✨ AIは相対パスの理解が不十分で、デフォルトでプロジェクト全体をスキャンしない
- ✨ 解決策は、AIに問題ファイルに基づく相対パスの候補リストを提供すること
- ✨ コンパイルチェックはAIに適したフォーマットで設計する必要がある
- ✨ CZON 0.9.1バージョンで500件のリンクエラーが正常に修正された
📅 2026-02-09 · 1,214 文字 · 約 5 分で読めます
WebSocket接続問題のトラブルシューティング：1Passwordブラウザ拡張機能が原因
トラブルシューティング
👤 WebSocket接続問題に遭遇した開発者、ネットワークエンジニア、またはブラウザ拡張機能やプロキシツールに興味のある技術者
著者は2026年1月28日にWebSocket接続の不安定な問題を調査した経験を共有しました。当初はSurgeプロキシ設定、Cloudflareの保護、またはサーバー問題を疑いましたが、比較により自分とRyanだけが問題に遭遇し、MageとC1は正常であることを発見しました。一連のテスト（端末接続の確認、ブラウザの変更、ブラウザ拡張機能の無効化など）を経て、二分法により1Passwordブラウザ拡張機能がChromeでのWebSocket接続の安定性に影響を与えていることを特定しました。この拡張機能を無効化すると問題が解決し、Ryanによって検証されました。記事は、難解な問題の調査における方法論と体系的な手順の重要性を強調し、同様の問題に遭遇した読者の時間節約を目的としています。
- ✨ WebSocket接続がChromeで不安定で、再試行が必要
- ✨ 問題は著者とRyanのみで発生し、MageとC1は未遭遇で、サーバー問題を除外
- ✨ 著者はSurgeプロキシツールを使用したが、調査後は設定問題を除外
- ✨ 端末接続（curl、wscatなど）は安定し、問題はブラウザに限定
- ✨ Safariブラウザに変更すると接続が安定し、Chrome問題を指摘
📅 2026-01-28 · 1,369 文字 · 約 5 分で読めます