ErisPulse ErisPulse
インタラクティブ版で開く →
このページのセクション
フィールドの説明 必須フィールド 任意フィールド 重大度の分類 タイプの分類 条目テンプレート 統計概要 修正済みのバグ [BUG-001] イベントハンドラーの重複登録によりイベントが複数回処理される [BUG-002] Init コマンドのアダプター設定パス型エラー [BUG-003] 再起動後にコマンドイベントが機能しなくなる [BUG-004] ライフサイクルイベントハンドラーがクリーンアップされない [BUG-005] Event.is_friend_add/is_friend_delete の detail_type が OB12 標準と一致しない [BUG-006] adapter.clear() が _started_instances をクリーンアップせず、再起動後に状態が不正になる [BUG-007] command.wait_reply() が非推奨の asyncio.get_event_loop() を使用している [BUG-008] Bot オフラインイベントが shutdown プロセス中に重複送信される [BUG-009] LazyModule による BaseModule への同期アクセスで初期化が未完了のままになる [BUG-010] 設定システムのマルチスレッド書き込みによるデータ消失 [BUG-011] Windows で CTRL+C でプログラムを停止できない [BUG-012] ホットリスタート後に更新済みモジュールの Python コードが反映されない [BUG-013] モジュールロード戦略のソートロジックエラー [BUG-014] アダプターのミドルウェアが None を返すことでイベントデータが失われる [BUG-015] 設定ファイルパスが作業ディレクトリに依存する [BUG-016] BaseStorage が格納値 None とキー不存在を混同する [BUG-017] WebSocket ルートの auto_accept フラグがサービス再起動後に失われる [BUG-018] HTTP/WS クライアントの並行呼び出しによるクラッシュと接続リーク [BUG-019] アダプターのホットリロード時にルート競合によりリロードが失敗する [BUG-020] 子プロセスモード ep run <script> がスクリプト所在ディレクトリのサブパッケージを見つけられない [BUG-021] SQL クエリビルダーが正当なワイルドカードと列式を拒否する [BUG-022] _resolve_account() のアカウント解決リグレッション(_accounts_data 未設定) [BUG-023] アカウント設定変更後にアダプターのキャッシュが更新されず、アカウント解決が失敗する [BUG-024] storage.set() で大きな数値 ID キーを書き込む際に OOM Kill が発生する [BUG-025] on_config_update コールバックがコアによってルーティングされない [BUG-026] notice/request イベントの reply 宛先推論エラー [BUG-027] ルートレートリミットのクリーンアップタスクが固定ウィンドウを使用し、長期ウィンドウのレートリミットルールが機能しない [BUG-029] 設定監視タスクが未完成の TOML をブロードキャストし、例外を静かに握りつぶす [BUG-030] 設定 watcher の競合により setConfig の遅延書き込みがデータを静かに失う [BUG-032] 設定の遅延フラッシュ中の「書き込み後即時読み取り」で旧値が読まれる [BUG-033] wait_reply の保留中の返信が高優先度ハンドラーによりスターベーション(飢餓)状態に陥る [BUG-034] スコープ persist=False での実行時バインディングが任意の後続の設定書き込みによって静かに上書きされる [BUG-035] 設定パネルの select 項目と辞書型フィールドが [object Object] と表示される [BUG-036] 複数インスタンスが共有する設定ディレクトリで設定書き込みが偶発的に失敗する(ENOENT) [BUG-037] 空白文字を含むコマンド名で登録されたサブコマンドが決してトリガーされない [BUG-038] persist=False で実行時バインディングが永続化書き込みによってディスクに落とされ、モジュールのアンロード後にディスクから「復活」する [BUG-039] 整節書き込みと点分書き込みが共存する場合の読み書きの不整合(点分覆写が失われる) [BUG-040] プラットフォームがメッセージをセグメントに分割した際、コマンドの末尾引数が静かに失われる [BUG-041] 拒否されたコマンドが alt_message 整链で再実行される:重複返信と権限関数の副作用が両方発動する [BUG-042] コマンドハンドラ内で登録された wait_reply が同一条のトリガーメッセージで即座に消費される [BUG-043] select() 同キーの複数ルートが後者で前者を静かにキャンセルする [BUG-044] BaseConverter.at() が OB11 の「at」セグメントを生成し、全フレームワークのメンション判定が認識しない [BUG-045] alt_message が存在しない适配器ではインタラクション原語が永久にタイムアウトし、コマンドが貫通しない [BUG-046] 宣言的設定テンプレートのネストされたサブテーブルヘッダーがトップレベルに漂移する [BUG-047] サービスディレクトリの全量列挙が遅延ロードモジュールを漏らす [BUG-048] 会話受信箱のクエリ API はメッセージの帰属(sender とイベントメタデータ)を失う [BUG-049] 入力 bot 自発メッセージのエコーが user として記録され、受信箱の帰属を汚染する [BUG-050] コンテナ内で epsdk restart を実行するとコンテナが直ちに終了する
静的ミラーです。内容はインタラクティブ版が正となります インタラクティブ版で開く →

バグトラッカー

このドキュメントは、ErisPulse SDK の既知のバグとその修正状況を記録したものです。修正されたバージョンの日付順に並べられています。

読者の皆様へ どんなソフトウェアにも完璧さは存在せず、どんなに注意深く開発しても小さな間違いが残ります。本トラッカーに記録されているのは、実行に実際に影響を与える問題のみです。あまりにも些細で「軽度」のレベルにも達しないような欠陥は、ここには含まれません。リストに「重大」の項目が多めに見えるかもしれませんが、公開されている目的は、トラブルシューティングと再現をスムーズにすることであり、不安を煽ることではありません。目にする、記録する、修正する問題こそが、プロジェクトが常に良くなっている証拠です。このリストを見て不安になる必要はありません。これはトラブルシューティングのためのツールであり、恐怖の原因ではありません。

読み方とメンテナンスの規約

  • 各バグの記録には、問題の説明、根本原因分析、影響を受けたバージョンの範囲、修正方法などの構造化されたフィールドが含まれています。アップグレードする前に、「影響バージョン」が現在使用しているバージョンをカバーしているか確認することを推奨します。
  • 新しいバグの条目を追加する場合は、対応する位置に内容を追加し、以下のフィールド規格と重大度/タイプの分類に従ってください。

フィールドの説明

必須フィールド

フィールド 説明
問題 バグの外的な現象、ユーザーが観察できる異常現象。エラーメッセージや典型的なシナリオをできるだけ記述してください
原因 具体的なコードの欠陥を指す根本原因分析(複雑な場合に「根本原因の経路」図示)
影響バージョン 影響を受けたバージョンの範囲、形式 導入バージョン - 修正バージョン(両端の dev バージョンを含む)
修正バージョン このバグを修正した具体的なバージョン番号
修正内容 修正方法の簡潔な説明、重要なコード変更点を含む
修正日 対応する修正バージョンのリリース日、YYYY/MM/DD 形式
重大度 下記「重大度の分類」に従って記載
タイプ 下記「タイプの分類」に従って記載、複数選択可能(例: アダプタ / ルーティング)

任意フィールド

フィールド 説明 適用場面
再現手順 このバグを引き起こす最小限の再現手順 複雑なバグ、偶発性バグには推奨
関連 関連する Issue / PR / Commit リンク 外部の議論記録がある場合に追加
リグレッションテスト 修正を検証し、再発を防ぐためのテストケースの位置 pytest 用のテストケースが書かれている場合に追加

重大度の分類

記号 級別 判定基準 典型的な表現
🔴 重大 プロセスのクラッシュ、データの損失/破損、コア機能の完全不可用、セキュリティの脆弱性 OOM Kill、メッセージの送信不可、モジュールのロード不可、ホットリロードの失敗
🟡 中等 機能の異常だが回避方法がある、コア機能以外の機能が失敗、偶発的な問題 状態の判断の誤り、重複実行、キャッシュの期限切れ、エラーメッセージの不正確
🟢 軽度 コア機能に影響しない、コード品質や体験の問題、潜在的なリスクが未発生 非推奨のAPI、死んだコード、警告ログの欠如

タイプの分類

タイプ 覆う範囲
設定システム ConfigManager、設定の読み書き、設定のSchema、ホット更新
イベントシステム Event モジュール(command/message/notice/request/meta)、イベントの配信、ハンドラの登録
アダプタ AdapterManager、BaseAdapter、アカウントの解析、Botの状態、ミドルウェア
ルーティング RouterManager、HTTP/WebSocket/SSEルーティング、リクエスト制限、CORS
クライアント HttpClient、ClientWebSocket、aiohttpのラッパー
ストレージ StorageManager、SQLite、SQLビルダー、ネストされたキー
加載システム Loader、LazyModule、ModuleInitializer、厳密モード、モジュールの発見
CLI epsdk コマンド、init/run/install、パラメータの解析、シグナルの処理
実行時 sdk.run/restart/uninit、ライフサイクル、シグナル、サブプロセス

条目テンプレート

新しいバグの条目は以下のフォーマットに従ってください:

### [BUG-XXX] タイトル

**問題**: 問題の説明(エラーメッセージや典型的な現象)
**原因**: 根本原因分析
**影響バージョン**: 導入バージョン - 修正バージョン
**修正バージョン**: x.x.x
**修正内容**: 修正方法
**修正日**: YYYY/MM/DD

<!-- 任意フィールド -->
**再現手順**: (複雑なバグには推奨)
**関連**: (Issue/PR リンク)
**リグレッションテスト**: (検証用のテストケースのパス)

**重大度**: 🔴 重大 | 🟡 中等 | 🟢 軽度
**タイプ**: 設定システム / イベントシステム / アダプタ / ルーティング / クライアント / ストレージ / 加載システム / CLI / 実行時

統計概要

重大度 数量
🔴 重大 17
🟡 中等 28
🟢 軽微 3
合計 48
タイプ 数量
イベントシステム 13
設定システム 14
アダプタ 5
CLI 4
ストレージ 4
ローディングシステム 4
ルーティング 2
クライアント 1
実行時 1

注:1 件のバグは複数のタイプに属する可能性があります。上表は主タイプに基づいて集計しています。
注:BUG-028 / BUG-031 の番号は空欄です(登録時に廃棄され、既存の番号の安定性を維持するため再利用されません)。


修正済みのバグ

[BUG-001] イベントハンドラーの重複登録によりイベントが複数回処理される

問題: 複数の @message / @notice などのデコレーターでハンドラーを登録する際、同一イベントが複数回重複して発火し、コマンドが複数回実行されたり、ログが重複出力されたりする。

原因: BaseEventHandler がアダプターのイベントバスにハンドラーを登録する際に重複排除ロジックが欠けており、各デコレーターがバスに一度ずつマウントされるため、イベント配信時に複数回呼び出される。

影響バージョン: 2.2.0-dev.0 - 2.2.1-dev.0

修正バージョン: 2.2.1-dev.0

修正内容: BaseEventHandler を最適化し、各イベントタイプごとにアダプターへ一度だけハンドラーを登録するようにし、重複発火を回避。

修正日: 2025/08/18

深刻度: 🔴 深刻

タイプ: イベントシステム


[BUG-002] Init コマンドのアダプター設定パス型エラー

問題: ep init コマンドで対話式初期化を行う際、アダプター設定を選択すると型エラーが発生する:

対話式初期化に失敗: unsupported operand type(s) for /: 'str' and 'str'

原因: 2.3.7 バージョンで設定ファイルのパスを調整した際、メソッドのパラメーター型に不整合があった。_configure_adapters_interactive_sync は str 型のパラメーターを受け取るが、内部では Path の / 演算子を使用してパスを連結している。

影響バージョン: 2.3.7 - 2.3.9-dev.1

修正バージョン: 2.3.9-dev.1

修正内容: _configure_adapters_interactive_sync メソッドのパラメーター型を str から Path に変更し、呼び出し時に直接 Path オブジェクトを渡すようにした。

修正日: 2026/03/23

深刻度: 🟡 中程度

タイプ: CLI


[BUG-003] 再起動後にコマンドイベントが機能しなくなる

問題: sdk.restart() を呼び出した後、@command で登録されたコマンドがトリガーされなくなり、コマンド送信後にボットが応答しない。

原因: adapter.shutdown() がイベントバスをクリアした後も、BaseEventHandler の _linked_to_adapter_bus 状態が False にリセットされず、_process_event メソッドが既にアダプターバスにマウント済みと判断し、再マウント処理をスキップするため。

影響バージョン: 2.2.x - 2.4.0-dev.2

修正バージョン: 2.4.0-dev.3

修正内容: _linked_to_adapter_bus 状態追跡を導入し、_clear_handlers() でバス接続を切断した後、次回の register() で自動的に再マウントされるようにし、shutdown/restart シナリオに対応。

修正日: 2026/04/09

深刻度: 🔴 深刻

タイプ: イベントシステム


[BUG-004] ライフサイクルイベントハンドラーがクリーンアップされない

問題: sdk.restart() の後、古いライフサイクルイベントハンドラーが残存して重複発火し、同一イベントが複数回処理される。

原因: lifecycle._handlers 辞書が uninit() 時に一切クリーンアップされず、restart 後に古いハンドラーと新しいハンドラーが同時に存在する。

影響バージョン: 2.3.0 - 2.4.0-dev.2

修正バージョン: 2.4.0-dev.3

修正内容: Uninitializer のクリーンアップフローの最後(すべてのイベント送信後)に、lifecycle._handlers をクリアする。

修正日: 2026/04/09

深刻度: 🟡 中程度

タイプ: ランタイム


[BUG-005] Event.is_friend_add/is_friend_delete の detail_type が OB12 標準と一致しない

問題: Event.is_friend_add() は detail_type == "friend_add" をチェックし、Event.is_friend_delete() は detail_type == "friend_delete" をチェックしているが、OneBot12 標準で定義されている detail_type の値は "friend_increase" と "friend_decrease" である。notice.py の on_friend_add/on_friend_remove デコレーターが使用する値と一致せず、デコレーターで登録されたハンドラーが発火した際に、対応する is_friend_add()/is_friend_delete() 判定メソッドが False を返してしまう。

原因: wrapper.py では非標準の命名が使用されており、一方 notice.py では正しい OB12 標準の命名が使用されている。

影響バージョン: 実装当初から現在まで

修正バージョン: 2.4.2-dev.1

修正内容: is_friend_add() のマッチング値を "friend_add" から "friend_increase" に、is_friend_delete() を "friend_delete" から "friend_decrease" に変更。

修正日: 2026/04/13

深刻度: 🟡 中程度

タイプ: イベントシステム


[BUG-006] adapter.clear() が _started_instances をクリーンアップせず、再起動後に状態が不正になる

問題: AdapterManager.clear() メソッドは _adapters、_adapter_info、ハンドラー、_bots をクリアするが、_started_instances 集合が見落とされている。アダプターが実行中に clear() を呼び出すと、_started_instances にダングリング参照が残り、再起動後の状態判定が誤る。

原因: 2.4.0-dev.1 で _started_instances を導入した際に、clear() 内での同時クリーンアップが行われなかった。

影響バージョン: 2.4.0-dev.1 - 2.4.2-dev.0

修正バージョン: 2.4.2-dev.1

修正内容: clear() メソッドに self._started_instances.clear() を追加。

修正日: 2026/04/13

深刻度: 🟡 中程度

タイプ: アダプター


[BUG-007] command.wait_reply() が非推奨の asyncio.get_event_loop() を使用している

問題: CommandHandler.wait_reply() メソッドが asyncio.get_event_loop() を使用して future を作成し、タイムスタンプを取得している。このメソッドは Python 3.10+ で非推奨であり、非同期コンテキストでは asyncio.get_running_loop() を使用すべきである。同一ファイルの wrapper.py の wait_for() メソッドが使用している get_running_loop() と一貫していない。

原因: 開発時に旧 API が使用され、その後追加された wait_for() では正しい API が使用されたが、旧コードへの遡及修正が行われなかった。

影響バージョン: 2.3.0-dev.0

修正バージョン: 2.4.2-dev.1

修正内容: command.py 内の 2 か所の asyncio.get_event_loop() を asyncio.get_running_loop() に置き換えた。

修正日: 2026/04/13

深刻度: 🟢 軽微

タイプ: イベントシステム


[BUG-008] Bot オフラインイベントが shutdown プロセス中に重複送信される

問題: adapter.shutdown() を呼び出してすべてのアダプターをシャットダウンする際、_update_bot_status() がシャットダウンフロー中に繰り返し Bot オフラインイベントを送信し、同一の Bot が複数回オフラインとしてマークされ、adapter.bot.offline ライフサイクルイベントが複数回発火する。

原因: 2.4.0-dev.1 で導入された Bot 状態追跡システムが shutdown() 中に「シャットダウン中」フラグを設定しておらず、_update_bot_status() が通常のオフラインとシャットダウンフロー中の連鎖的オフラインを区別できない。

影響バージョン: 2.4.0-dev.1 - 2.4.2-dev.1

修正バージョン: 2.4.2-dev.1

修正内容: AdapterManager に _is_being_shutdown フラグを新設し、shutdown() 開始時に True に設定、終了時にクリアする。_update_bot_status() はこのフラグをチェックした後、シャットダウンプロセス中の重複送信をスキップする。

修正日: 2026/04/21

深刻度: 🟡 中程度

タイプ: アダプター


[BUG-009] LazyModule による BaseModule への同期アクセスで初期化が未完了のままになる

問題: ユーザーが同期コンテキストで遅延ロードされた BaseModule の属性にアクセスする際、モジュールは loop.create_task() で非同期初期化を行うが待機しないため、属性アクセス時に初期化が未完了の可能性があり、競合状態が発生する。

原因: _ensure_initialized() が BaseModule に対して loop.create_task(self._initialize()) を使用した後すぐに戻り、初期化完了を保証していなかった。

影響バージョン: 2.4.0-dev.0 - 2.4.2-dev.1

修正バージョン: 2.4.2-dev.2

修正内容: 同期コンテキストでは、BaseModule の初期化を asyncio.run(self._initialize()) を使用するように変更し、初期化完了後に戻るようにした。透過プロキシ特性を維持し、ユーザーは同期/非同期の差異を意識する必要がない。

修正日: 2026/04/21

深刻度: 🟡 中程度

タイプ: ロードシステム


[BUG-010] 設定システムのマルチスレッド書き込みによるデータ消失

問題: マルチスレッド環境で、複数のスレッドが同時に config.setConfig() を呼び出す際、_flush_config() の読み取り-修正-書き込み操作がアトミックではなく、一部の書き込みが失われる可能性がある。

原因: _flush_config() は RLock を使用しているものの、ファイルの読み取りと書き込みの間にファイルロックによる保護がなく、_schedule_write の Timer が複数回発火して上書きされる可能性があった。

影響バージョン: 2.3.0 - 2.4.2-dev.1

修正バージョン: 2.4.2-dev.2

修正内容:

  1. ファイルロック機構(_file_lock)を追加し、ファイル操作のアトミック性を確保
  2. 一時ファイルへの書き込み後、アトミックにリネーム(os.replace/os.rename)
  3. _schedule_write の Timer キャンセルおよび再スケジュールロジックを改善

修正日: 2026/04/21

深刻度: 🔴 深刻

タイプ: 設定システム


[BUG-011] Windows で CTRL+C でプログラムを停止できない

問題: Windows 上で直接 python main.py を実行すると、CTRL+C を押してもプログラムを終了できない。プログラムは正常に起動し、ルーティングサーバー情報を出力した後、CTRL+C にまったく反応せず、タスクマネージャーでプロセスを強制終了するしかない。一方、epsdk run で起動した場合は正常に停止できる——ただし epsdk run は子プロセスモデルで実行されている。

原因: Hypercorn ASGI サーバーの serve() 関数が内部で signal.signal(SIGINT, handler) により独自の SIGINT ハンドラーを登録し、Python のデフォルトの KeyboardInterrupt 処理機構を上書きしている。asyncio.create_task() で Hypercorn をバックグラウンドタスクとして起動した場合、Hypercorn の内部 shutdown フローが正常にトリガーされず(worker_serve モードを想定しているため)、CTRL+C シグナルが Hypercorn に飲み込まれ、いかなるクリーンアップ処理も実行されない。

影響バージョン: 2.3.6 - 2.4.2

修正バージョン: 2.4.3-dev.0

修正内容:

  1. ASGI サーバーを Hypercorn から Uvicorn に切り替え(pyproject.toml の依存関係変更)
  2. uvicorn.Server._serve() を使用してサーバーを直接起動し、capture_signals() シグナル処理コンテキストマネージャーをバイパス
  3. server.should_exit = True によるグレースフルシャットダウンを実装し、タイムアウト時はバックグラウンドタスクをキャンセル
  4. 子プロセス実行モデルと runtime/cleanup.py クリーンアップモジュールを同時に削除(子プロセスクリーンアップ機構が不要になったため)

修正日: 2026/04/28

深刻度: 🔴 深刻

タイプ: CLI / ランタイム


[BUG-012] ホットリスタート後に更新済みモジュールの Python コードが反映されない

問題: sdk.restart() によるソフト再起動の実行後、epsdk install でアップグレード済みのモジュール/アダプターの新コード(新規 API ルートなど)が反映されず、旧バージョンのロジックが実行され続ける。最新コードをロードするにはプロセスの完全な再起動が必要。

原因: _do_restart() が再初期化時に entry_point.load() を呼び出すが、この関数は sys.modules からキャッシュされた旧バージョンのモジュールオブジェクトを返し、ディスクから再ロードしないため。

影響バージョン: 初期バージョン - 2.4.3-dev.1

修正バージョン: 2.4.3-dev.1

修正内容: uninit() の後、init() の前に、sys.modules 内のロード済みモジュール/アダプターパッケージのキャッシュをクリーンアップし、entry_point.load() がディスクから最新コードをロードするようにした。_collect_top_level_modules() と _invalidate_module_cache() のヘルパーメソッドを新設し、top_level.txt または entry-point value からトップレベルモジュール名を導出する。

修正日: 2026/05/03

深刻度: 🔴 深刻

タイプ: ロードシステム / ランタイム


[BUG-013] モジュールロード戦略のソートロジックエラー

問題: ModuleLoadStrategy はモジュールの初期化優先度を宣言するための priority フィールドを提供しているが、ロード戦略の実装にミスがあり、モジュールが期待される優先度順に初期化されず、実際には entry_points() のデフォルト順でロードされていた。モジュール間にロード依存関係がある場合、priority によって正しい初期化順序を保証できない。

原因: ロード戦略の実装においてソートロジックに誤りがあり、initialize_modules() が priority を使用してモジュールリストをソートしていなかった。

影響バージョン: 2.3.4 - 2.4.5-dev.2

修正バージョン: 2.4.5-dev.3

修正内容: initialize_modules() の走査前に、priority の降順でモジュールリストをソートする。同一 priority のモジュールは元の相対順序を維持する(安定ソート)。

修正日: 2026/05/15

深刻度: 🟡 中程度

タイプ: ロードシステム


[BUG-014] アダプターのミドルウェアが None を返すことでイベントデータが失われる

問題: adapter.emit() が OneBot12 ミドルウェアチェーンを実行する際、いずれかのミドルウェアが None を返した場合(例:return data を忘れた場合)、後続のミドルウェアとすべてのイベントハンドラーが受け取る processed_data が None となり、イベント処理が完全に機能しなくなる。

原因: ミドルウェアチェーンの実装 processed_data = await middleware(processed_data) が戻り値が None かどうかをチェックせず、前段の処理結果を直接上書きしていた。

影響バージョン: unknown - 2.4.5-dev.3

修正バージョン: 2.4.5-dev.4

修正内容: ミドルウェアが None を返した場合はその戻り値を無視し、元のデータを保持して伝搬を継続し、warning レベルのログを出力する。

修正日: 2026/05/15

深刻度: 🔴 深刻

タイプ: アダプター / イベントシステム


[BUG-015] 設定ファイルパスが作業ディレクトリに依存する

問題: ConfigManager の設定ファイルパスはデフォルトで相対パス "config/config.toml" であり、実行時に os.getcwd() に依存して解決される。作業ディレクトリが実行中に変更された場合(例:os.chdir() による)、設定ファイルの読み書き操作が誤った場所を指すようになり、設定の消失や旧データの読み込みが発生する。

原因: __init__ 内で相対パスをそのまま保存し、初期化時に絶対パスへ解決していなかった。

影響バージョン: 2.3.7 - 2.4.5-dev.3

修正バージョン: 2.4.5-dev.4

修正内容: ConfigManager.__init__() において、渡されたパスが相対パスの場合、os.path.abspath() により自動的に絶対パスへ解決する。

修正日: 2026/05/15

深刻度: 🟡 中程度

タイプ: 設定システム


[BUG-016] BaseStorage が格納値 None とキー不存在を混同する

問題: BaseStorage.get_multi() / __getattr__() は「キーが存在しない」と「キーの値が None である」という 2 つの場合を区別できず、ユーザーが明示的に None を格納した後に読み取ると、キーが存在しないものとして扱われる。

原因: 値の取得ロジックが value is None で直接キーの存在を判定しており、独立した「欠落」マーカーが欠けていた。

影響バージョン: 初期バージョン - 2.4.6-dev.6

修正バージョン: 2.4.6-dev.6

修正内容: _SENTINEL センチネル値を導入して「キーが存在しない」と「値が None である」を区別し、両者が混同されないようにした。

修正日: 2026/06/07

深刻度: 🟡 中程度

タイプ: ストレージ


[BUG-017] WebSocket ルートの auto_accept フラグがサービス再起動後に失われる

問題: サービス再起動(例:sdk.restart())後、すべての WebSocket ルートの auto_accept 設定が False に戻り、自動 accept を期待していた接続が保留状態となり、クライアントが長時間応答を受け取れず、WS 接続がハングアップする。

原因: _restore_routes_from_records() が永続化レコードからルートを復元する際に auto_accept を False にハードコードし、元のレコード内の値を読み取っていなかった。また、ルート保存タプルが 2 要素から 3 要素に拡張された際に、復元ロジックが同時に更新されなかった。

影響バージョン: 2.3.8-dev.0 - 2.4.6-dev.6

修正バージョン: 2.4.6-dev.6

修正内容: ルート保存タプルを (handler, auth_handler, auto_accept) に拡張し、_restore_routes_from_records() がレコードから実際の auto_accept 値を読み取るようにし、ハードコードされた False ではなくした。

修正日: 2026/06/07

深刻度: 🔴 深刻

タイプ: ルーティング


[BUG-018] HTTP/WS クライアントの並行呼び出しによるクラッシュと接続リーク

問題: Core/client.py の HTTP および WebSocket クライアントには、並行シナリオにおいて複数の安定性の欠陥があり、接続リークやプロセスクラッシュを引き起こす:

  • 複数コルーチンが ClientWebSocket.receive() を並行呼び出しした際に aiohttp が Concurrent call to receive() is not allowed を送出する
  • _get_http_session() / _get_ws_session() の並行呼び出しにより複数の session が作成される可能性があり、_drain_sessions() が旧接続を閉じないため、接続リークが発生する
  • request() の例外キャッチ順序が誤っている:except ClientConnectionError(ErisPulse 例外)が決して発火せず、aiohttp の接続エラーが汎用の except Exception で捕捉され、「接続リトライ + session 再構築」ロジック(デッドコード)が一度も実行されない
  • send_json() が mode="binary" パラメーターを無視する。_get_ws_session() がデフォルトリクエストヘッダーを渡していない

原因: クライアントの初回実装(2.4.6-dev.5)において並行保護と例外分類が欠けており、aiohttp の例外階層と ErisPulse カスタム例外の継承関係の扱いが不適切だった。

影響バージョン: 2.4.6-dev.5 - 2.4.8

修正バージョン: 2.4.8

修正内容:

  1. _recv_lock を新設し、すべての receive() / receive_text() / receive_bytes() 呼び出しを直列化
  2. _session_lock を新設して session 作成を保護。_drain_sessions() を非同期メソッドに変更し、実際に旧 session をクローズ
  3. request() の例外キャッチ順序を再構築:asyncio.TimeoutError → aiohttp.ClientConnectionError(session 再構築をトリガー)→ aiohttp.ClientError → ClientError(透過)→ Exception
  4. send_json() の mode 処理、_get_ws_session() のデフォルトリクエストヘッダー透過、close() の並行競合、HttpResponse.__aexit__ の重複 release() を修正

修正日: 2026/06/12

深刻度: 🔴 深刻

タイプ: クライアント


[BUG-019] アダプターのホットリロード時にルート競合によりリロードが失敗する

問題: サードパーティモジュール(Dashboard など)がアダプターのホットリロードをトリガーした際、またはアダプターの起動失敗リトライ時に、前回登録された旧ルート(onebot11_default など)がクリーンアップされておらず、WebSocketパス ... は既に登録されています の競合が送出され、リロードが失敗する。回復にはプロセスの完全な再起動が必要。

原因: AdapterManager.shutdown() が unregister_all_by_namespace(platform) だけでルートをクリーンアップしているが、アダプター(OneBot11 など)は onebot11_{account_name} を名前空間として WS ルートを登録しており、粒度が一致しないためクリーンアップが空操作となる。起動失敗リトライのパスでも前回の残存ルートがクリーンアップされていなかった。

影響バージョン: 初期バージョン - 2.4.9

修正バージョン: 2.4.9

修正内容:

  1. ルート登録時に current_owner ContextVar により owner → namespace の帰属関係を自動追跡
  2. unregister_all_by_owner(owner) を新設し、停止/再起動時に owner ごとにもクリーンアップし、細粒度の名前空間をカバー
  3. _stop_adapter(platform) プリミティブを新設(「停止=クリーンアップ」)。アダプターの停止とその登録リソースの回収を 1 回の呼び出しに結び付け、restart() と起動失敗リトライの両方がこのエントリーを経由する
  4. フレームワークレベルの adapter.restart(platform) API を新設。サードパーティモジュールはアダプターインスタンスを直接操作するのではなく、このメソッドを呼び出すべき

修正日: 2026/06/12

深刻度: 🔴 深刻

タイプ: アダプター / ルーティング


[BUG-020] 子プロセスモード ep run <script> がスクリプト所在ディレクトリのサブパッケージを見つけられない

問題: ep r .\main.py の非ホットリロードモードでスクリプトを実行する際、スクリプトに相対インポート(例:from qg import ...)があると、No module named 'qg' エラーが発生する。一方 --reload モードでは正常に動作する。

原因: 非ホットリロードモードは runpy.run_path() を直接呼び出してスクリプトを実行するが、この関数はスクリプトの所在ディレクトリを自動的に sys.path に追加しない。一方 --reload モードは subprocess.Popen の子プロセスで実行され、子プロセスは現在の作業ディレクトリを自動的に継承し、sys.path[0] がスクリプトの所在ディレクトリとなるため正常に動作する。

影響バージョン: 2.5.0 - 2.5.2-dev.0

修正バージョン: 2.5.2-dev.0

修正内容: runpy.run_path() 呼び出しの前に、スクリプトの所在ディレクトリを手動で sys.path[0] に挿入する。

修正日: 2026/06/27

深刻度: 🟡 中程度

タイプ: CLI


[BUG-021] SQL クエリビルダーが正当なワイルドカードと列式を拒否する

問題: SQLiteQueryBuilder の _build_select_sql() がすべての SELECT 列に対して _validate_identifier() を呼び出しており、この関数は厳格なホワイトリスト正規表現 ^[a-zA-Z_][a-zA-Z0-9_]*$ を使用するため、正当な SQL 構文が安全でない列名と誤判定される:

  • SELECT * — * は SQL 標準のワイルドカード
  • SELECT COUNT(*) — 集計関数
  • SELECT users.name — 修飾列名
  • SELECT col AS alias — 列エイリアス

このうち Select("*") は Cron などのモジュールで使用されており、モジュールの on_load 実行が失敗し、モジュールをロードできなくなる。

原因: 2.4.6 バージョンで SQL インジェクション対策が強化され、_validate_identifier() ホワイトリスト検証が導入された。この検証はすべての列名に適用されたが、読み取り側(SELECT/ORDER BY)と書き込み側(INSERT/UPDATE)が区別されていなかった。SELECT 列は複雑な SQL 式を許容するものであり、単純な識別子ホワイトリストの制約を受けるべきではない。

影響バージョン: 2.4.6 - 2.5.2-dev.1

修正バージョン: 2.5.2-dev.2

修正内容: SELECT/ORDER BY の列検証をホワイトリスト方式からブラックリスト方式に変更:

  1. _validate_select_column() 関数を新設し、SQL インジェクションの危険文字(; ' " -- /* */ \x00 改行文字)のみを遮断
  2. 任意の正当な SQL 列式(*、table.*、table.column、COUNT(*)、col AS alias など)を許可
  3. INSERT/UPDATE 列名は引き続き厳格なホワイトリスト検証を維持(単純な識別子のみ許可)

修正日: 2026/06/29

深刻度: 🔴 深刻

タイプ: ストレージ


[BUG-022] _resolve_account() のアカウント解決リグレッション(_accounts_data 未設定)

問題: 2.5.2 の設定システムリファクタリング後、AccountConfigClass を宣言しているマルチアカウントアダプターが、wait_reply、reply などメッセージ送信を必要とするメソッドを呼び出す際、ValueError("AccountConfigClass が宣言されていないため、アカウントを解決できません") エラーが発生する。アダプターがマルチアカウント情報を正しく設定していても、アカウント解決が失敗する。

原因: 2.5.2-dev.5 で _load_accounts()(設定の読み取り + 検証 + _accounts_data の設定を担当)が _ensure_accounts_exist()(設定テンプレートの生成のみ)にリファクタリングされたが、_resolve_account() は依然として self._accounts_data is None をチェックしている。_ensure_accounts_exist() が _accounts_data を設定しなくなったため、この属性は常に None となり、_resolve_account() が早期に (None, None) を返し、アカウント解決が完全に機能しなくなる。

根本原因の連鎖:

_load_accounts() が削除された
  → __init__ が _accounts_data を設定しなくなる
    → _accounts_data が常に None になる
      → _resolve_account() が _accounts_data is None をチェック → return (None, None)
        → _resolve_account を呼び出す下流箇所(call_api など)が None を受け取る
          → エラーが発生

影響バージョン: 2.5.2-dev.5 - 2.5.2

修正バージョン: 2.5.3

修正内容: BaseAdapter.__init__ において、_ensure_accounts_exist() の後に _accounts_data の設定を復元:

if self.AccountConfigClass is not None:
    self._ensure_accounts_exist()
    self._accounts_data = self.accounts  # 設定を復元。データソースはリアルタイムで読み取られる accounts 属性

_resolve_account() のロジックは変更されず、完全に後方互換:

  • AccountConfigClass を宣言しないアダプター:_accounts_data は None のまま → (None, None) を返す
  • AccountConfigClass を宣言しているアダプター:_accounts_data が設定される → 正常に解決
  • _load_accounts をオーバーライドまたは _accounts_data を手動設定するアダプター:super().__init__() の後に上書きされ、最優先

修正日: 2026/07/07

深刻度: 🔴 深刻

タイプ: アダプター / 設定システム


[BUG-023] アカウント設定変更後にアダプターのキャッシュが更新されず、アカウント解決が失敗する

問題: ユーザーが Dashboard でマルチアカウントアダプターのアカウント設定(token の入力など)を変更した後、アダプターは依然として旧キャッシュを使用し、メッセージ送信関連メソッドの呼び出し時に 利用可能なアカウントが見つかりません (account_id=default) エラーが発生する。新設定を有効にするにはプロセスの再起動が必要。

原因: _accounts_data は BaseAdapter.__init__ 時に設定ストアから一度読み取られるだけで、その後更新されない。AdapterManager._run_adapter() と restart() が adapter.start() 呼び出し前にアカウント設定を再読み取りしないため、キャッシュと実際の設定が乖離する。

影響バージョン: 2.4.6 - 2.5.4

修正バージョン: 2.5.4

修正内容: AdapterManager._run_adapter() と restart() において、adapter.start() 呼び出し前に adapter._accounts_data = adapter.accounts を更新し、起動のたびに最新の設定が使用されるようにした。

修正日: 2026/07/09

深刻度: 🔴 深刻

タイプ: アダプター / 設定システム


[BUG-024] storage.set() で大きな数値 ID キーを書き込む際に OOM Kill が発生する

問題: storage.set() を呼び出して大きな純数値セグメント(QQ グループ番号 871684833 など)を含むネストされたキーパスを書き込む際、プロセスがコンテナにより OOM Kill され(終了コード -9)、サービスが直接クラッシュして回復できなくなる。

原因: _set_nested_value の再帰実装において、ネストされたキーパス内の純数値セグメントが isdigit() によりリストインデックスと誤判定され、current.extend([None] * (index - len(current) + 1)) がトリガーされて数億要素のリストを割り当てようとし、瞬時にメモリを使い果たす。

根本原因の連鎖:

キーパスに純数値セグメントが含まれる(グループ番号 871684833 など)
  → isdigit() が配列インデックスと誤判定
    → extend([None] * (871684833 - len(current) + 1))
      → 数億要素の割り当てを試みる
        → メモリ枯渇 → コンテナによる OOM Kill(終了コード -9)

影響バージョン: 2.5.1 - 2.5.5

修正バージョン: 2.5.5

修正内容:

  1. 中間層の事前作成時には常に辞書を使用し、次のセグメントが数値かどうかでコンテナタイプを推測しない
  2. 最終値の設定時には、コンテナ自体が既にリストであり、かつインデックスが STORAGE_MAX_LIST_INDEX(10000)未満の場合にのみインデックスとして処理し、過大なインデックスは安全にスキップ
  3. 再帰実装を反復実装に変更し、元のコードに潜在していた無限再帰のリスクを解消
  4. STORAGE_MAX_LIST_INDEX 定数を Core/constants.py に新設し、インデックスの安全上限を一元管理

修正日: 2026/07/10

再現手順:

# 大きな数値セグメント(QQ グループ番号など)を含むネストされたキーパスを書き込むとトリガーされる
await sdk.storage.aset("groups.871684833.name", "あるグループ")
# → プロセスのメモリが瞬時に急上昇し、OOM Kill される

回帰テスト: tests/unit/test_unit_storage.py に回帰テストケースを 4 件追加

  • test_nested_key_numeric_segment_as_dict_key — OOM シナリオを正確に再現
  • test_nested_key_numeric_segment_multiple — 複数の連続する数値セグメントがすべて辞書キーとして扱われる
  • test_nested_key_existing_list_index_set_within_limit — 既存リストへの妥当なインデックス書き込み
  • test_nested_key_list_index_safety_limit — 過大インデックスの安全制限の検証

深刻度: 🔴 深刻

タイプ: ストレージ


[BUG-025] on_config_update コールバックがコアによってルーティングされない

問題: on_config_update(old, new) コールバックは基底クラス(BaseModule / BaseAdapter)で定義済みだが、フレームワークコアがこれを設定変更イベントと関連付けていない。実際の挙動:設定管理パネルから設定を変更した場合はトリガーされるが、config.toml を手動編集したりコードから setConfig() を呼び出したりした場合は on_config_update がトリガーされない。

原因: ConfigManager は設定変更時に config.set / config.updated ライフサイクルイベントを送出するが、これらのイベントを各コンポーネントの on_config_update メソッドへ転送するサブスクリプションロジックが欠けていた。

根本原因の連鎖:

コアが config.set / config.updated を購読していない
  → 設定変更イベントが転送されない
    → on_config_update が呼び出されない
      → 手動ファイル編集 / コードからの setConfig でホットアップデートコールバックが発火しない

影響バージョン: 全バージョン

修正バージョン: 2.6.2

修正内容: ModuleManager / AdapterManager が config.set(コードからの setConfig() パスをカバー)と config.updated(手動ファイル編集パスをカバー)のイベント購読を登録し、設定キーのプレフィックスでマッチングした後、対応するコンポーネントの on_config_update を呼び出し、型安全な設定オブジェクトを渡す。同時に、_flush_config() がファイル書き込み後に _config_mtime を同期していなかった問題を修正し、フレームワーク自身の書き込みがファイル監視タスクに外部変更と誤判定されて config.updated が重複発火することを回避。

互換性に関する注意: 設定のホットアップデートは現在フレームワークコアにより一元的に管理されている。以前設定管理パネルが代行してトリガーしていたロジックは削除されたため、フレームワークをアップグレードした後は設定管理パネルも併せてアップグレードする必要がある。さもないと重複トリガーが発生する(コアとパネルがそれぞれ 1 回ずつ呼び出す)。on_config_update メソッドのシグネチャとセマンティクスは変更されず、サブクラスの変更は不要。

修正日: 2026/07/23

深刻度: 🟡 中程度

タイプ: 設定システム


[BUG-026] notice/request イベントの reply 宛先推論エラー

問題: グループ通知イベント(メンバーのグループ参加 group_member_increase など)で event.reply() を呼び出すと、メッセージがイベントの発生元ユーザーとのプライベートチャットに送信され、イベントが発生したグループには送信されない。フレンド通知イベントも同様で、返信先が誤る可能性がある。

原因: infer_receive_type() がイベントの detail_type を直接セッションタイプとして返している。message イベントについてはこれは正しい(detail_type の値 private/group がそのままセッションタイプ)が、notice/request イベントの detail_type はセマンティックサブタイプ(group_member_increase、friend_increase など)であり、セッションタイプではない。後続の convert_to_send_type() と get_id_field() がマッピングテーブルでその値を見つけられず、デフォルトの "user" / "user_id" にフォールバックし、返信先が誤る。

根本原因の連鎖:

notice イベント detail_type="group_member_increase"
  → infer_receive_type() が直接 "group_member_increase" を返す
    → convert_to_send_type("group_member_increase") がマッピングテーブルにない → "user" にフォールバック
    → get_id_field("group_member_increase") がマッピングテーブルにない → "user_id" にフォールバック
      → target_id = event["user_id"]  ← 新メンバーとのプライベートチャット(グループではない)

影響バージョン: 全バージョン

修正バージョン: 2.7.0-dev.3

修正内容: infer_receive_type() に判定を追加——detail_type は既知のセッションタイプ(標準タイプまたはカスタムタイプ)である場合にのみ直接返す。それ以外の場合は ID フィールド(group_id / channel_id / user_id など)から正しいセッションタイプを推論する。

回帰テスト: tests/unit/test_unit_session_type.py → TestNoticeRequestTypeInference(10 テストケース)

修正日: 2026/07/29

深刻度: 🟢 軽微

タイプ: イベントシステム


[BUG-027] ルートレートリミットのクリーンアップタスクが固定ウィンドウを使用し、長期ウィンドウのレートリミットルールが機能しない

問題: ルートのレートリミットを長期ウィンドウルール(100/hour、{"requests": 100, "window": 3600} など)に設定すると、レートリミットがほぼ無意味になる——実際の挙動は 100/minute に近く(1 時間あたり最大約 6000 リクエストまで通過)、期待された時間単位の保護機能がまったく果たせない。

原因: _apply_rate_limit はルートごとの実際の window(最大 3600 秒)を解析して取得し、per-request チェックも実際にそのウィンドウを使用している。しかし、バックグラウンドのクリーンアップタスク _cleanup_expired_rate_limits は固定定数 DEFAULT_RATE_LIMIT_WINDOW_SECS(60 秒)をすべてのルートの統一クリーンアップ閾値として使用していた。その結果、100/hour ルートで 60 秒より前のタイムスタンプがクリーンアップタスクにより早期に削除され、1 時間ウィンドウ内に 100 件近いレコードが決して蓄積されず、レートリミットが著しく弱体化する。

根本原因の連鎖:

_apply_rate_limit が window=3600(100/hour)を解析
  → per-request チェックは 3600 秒間タイムスタンプを保持(正しい)
  → しかし _cleanup_expired_rate_limits が固定 max_window=60 秒でクリーンアップ
    → 60 秒前のタイムスタンプがすべて削除される
      → 1 時間ウィンドウには常に直近 1 分間のレコードしか残らない
        → 100/hour が実際には ~100/minute に退化(約 60 倍に緩和)

影響バージョン: 2.6.0-dev.0 - 2.7.0-dev.4

修正バージョン: 2.7.0-dev.5

修正内容: _rate_limit_windows: dict[str, int] を新設し、store key ごとに各ルートの実際のウィンドウを記録。_apply_rate_limit は初回エントリー作成時にウィンドウを書き込む。_cleanup_expired_rate_limits は各 key 自身のウィンドウに従ってクリーンアップするように変更(欠落時はデフォルト値にフォールバック)。クリーンアップによるエントリー削除時と stop() 時に両方の辞書を同期して管理。

修正日: 2026/07/31

回帰テスト: tests/unit/test_unit_router.py → TestRateLimit::test_cleanup_respects_per_route_window

深刻度: 🔴 深刻

タイプ: ルーティング


[BUG-029] 設定監視タスクが未完成の TOML をブロードキャストし、例外を静かに握りつぶす

問題: ユーザーが config.toml を手動編集して保存途中(一時的な構文エラーが発生)の際、設定監視バックグラウンドスレッドが mtime 変化を検出して設定を再ロードするが、ロード失敗後も空の設定 {} で config.updated イベントを送出し、アダプター/モジュールの on_config_update が空の設定を受け取り、すべての設定項目がクリアされたと誤認してデフォルト値にフォールバックしてしまう。さらに監視ループは except Exception: pass ですべての例外を静かに握りつぶしており、watcher の障害を調査する手掛かりがない。

原因: 2 つの欠陥の重複:

  1. _load_config が TOML 構文エラー/権限エラー時に self._cache を {} で上書きするが、バックグラウンド監視スレッド _watch_loop とキャッシュタイムアウトパス _check_cache_validity の両方が _load_config() 呼び出し後に無条件に _emit_config_updated() を実行し、「ロード失敗によって生じた空のキャッシュ」を実際の変更としてブロードキャストする。
  2. _watch_loop の except Exception: pass が一切のログを記録しない。

根本原因の連鎖:

ユーザーが保存途中 → TOML 構文エラー
  → _load_config() が _cache = {} で上書き
    → _watch_loop が無条件に _emit_config_updated(new_config={}) を実行
      → アダプター/モジュールの on_config_update が空の設定を受け取る
        → 設定がクリアされたと誤判定し、デフォルト値にフォールバック

影響バージョン: 2.6.2-dev.1 - 2.7.0-dev.4

修正バージョン: 2.7.0-dev.5

修正内容:

  1. _load_config を bool を返すように変更。TOML 構文エラー/権限/その他のエラー時には前回の有効なキャッシュを保持し({} で上書きしない)、診断ログの記録と False の返却のみ行う
  2. _watch_loop と _check_cache_validity は _load_config() が True を返した場合にのみ config.updated を送出
  3. _watch_loop の except Exception を warning レベルでの記録に変更(i18n キー core.config.watcher_error を新設、5 言語同期)

修正日: 2026/07/31

回帰テスト: tests/unit/test_unit_config.py → test_malformed_toml_preserves_last_valid_cache、test_permission_denied_logs_clear_message(キャッシュ保持 + False 返却の検証に更新)

深刻度: 🟡 中程度

タイプ: 設定システム


[BUG-030] 設定 watcher の競合により setConfig の遅延書き込みがデータを静かに失う

問題: 複数のユーザーから、config.setConfig(key, value)(デフォルト immediate=False)を使用した後、自分のモジュールの設定が config.toml に書き込まれず、他のモジュールの設定は正常であるという報告がある。immediate=True(強制フラッシュ)を設定すれば回避できる。挙動としては:実行時に書き込まれた設定が次回の再起動後に失われ、起動時にテンプレートから生成された設定は保持される。

原因: 2 つの重複する欠陥:

  1. ロジック欠陥:_watch_loop が _check_file_change() が True を返した際に無条件に _dirty_keys.clear() ですべての書き込み待ちキーを破棄する。しかし _check_file_change() は mtime を != で比較しているだけで、フレームワーク自身の _flush_config のディスク書き込みも mtime を変更する——_flush_config は書き込み後に _config_mtime を更新するものの、watcher スレッドはファイル書き込みと mtime 代入の間に(また粒度の粗いファイルシステム上でも)mtime の差分を観測する可能性があり、「外部変更」と誤判定してすべての書き込み待ちキーをクリアしてしまう。
  2. スレッド欠陥:_watch_loop が _write_timer/_dirty_keys を操作する際に _lock を保持しておらず、setConfig(ロックを保持して _dirty_keys に書き込む)、_schedule_write(ロックを保持して _write_timer に書き込む)との間でデータ競合が存在する。

根本原因の連鎖:

モジュールA setConfig(immediate=True) → フラッシュでディスク書き込み、mtime 変化
  → ユーザーモジュール setConfig(immediate=False) → _dirty_keys に入り、5 秒後にフラッシュ
    → watcher がポーリングし、_check_file_change が先前の自身の書き込みによる mtime 差分を観測
      → _dirty_keys.clear() → ユーザーモジュールの書き込み待ちキーが静かに破棄される
        → 再起動後に設定が欠落

影響バージョン: 2.6.0 - 2.7.0

修正バージョン: 2.7.1

修正内容:

  1. _last_self_write_mtime フィールドを新設し、_flush_config のディスク書き込み後に同時記録。_check_file_change は mtime 変化時にまずこの値と比較し、一致すれば自身の書き込みと判定して False を返す
  2. _watch_loop は全体を _lock で保護。実際の外部変更時には _dirty_keys を保持し(merge セマンティクス)、次回 flush 時に外部内容とマージする(ダーティキー優先)。clear() は行わない
  3. getConfig/_check_cache_validity パスは影響を受けない(その reload はもともとダーティキーをクリアしない)

修正日: 2026/08/06

回帰テスト: tests/unit/test_unit_config.py → test_self_write_not_detected_as_external、test_external_change_preserves_dirty_keys、test_flush_merges_dirty_with_external

深刻度: 🔴 深刻

タイプ: 設定システム


[BUG-032] 設定の遅延フラッシュ中の「書き込み後即時読み取り」で旧値が読まれる

問題: config.setConfig()(デフォルト immediate=False で約 5 秒遅延フラッシュ)でドット区切りキーを書き込んだ後、直ちにその親/祖先ノードを読み取ると(例:set_erispulse_section("scope.actions.MyModule", {...}) の後に get_erispulse_config() を呼び出す)、旧値が返され、書き込んだ子キーが「消失」し、フラッシュ後まで可視にならない。スコープ設定のホットアップデートなどの「書き込み-読み取り-書き込み」シナリオが影響を受ける(2.8.0 テストプラグイン /t_section のケースで発覚)。

原因: setConfig がドット区切りキーをフラット形式で書き込み待ちキュー _dirty_keys に保存し、getConfig の完全一致キー検索のみが書き込み待ちキューにヒットする。ツリーパス検索(getConfig("ErisPulse.scope"))はキャッシュツリーのみを参照し、書き込み待ち値をオーバーレイしない——遅延フラッシュ期間中(_flush_config がダーティキーをキャッシュにマージしてキューをクリアするまで)、「リード・ユア・ライト(自身の書き込みの可視性)」の断絶が生じる。

影響バージョン: 2.6.0 - 2.8.0-dev.1

修正バージョン: 2.8.0-dev.1

修正内容: getConfig に書き込み待ちオーバーレイセマンティクスを導入——① 書き込み待ちキーに完全一致した場合は直接返す(既存の挙動は変更なし);② 書き込み待ちキーが検索キーの祖先である場合 → 最長の書き込み待ち祖先を取り、その値のサブツリー内で残りのパスを解決;③ 書き込み待ちキーが検索キーの子孫である場合 → オーバーレイサブツリー(_dirty_overlay)を構築し、キャッシュサブツリーと深くマージ(_deep_merge、override 優先、元のキャッシュオブジェクトは変更しない)。書き込み待ちキーがない場合は元の高速パスを通り、追加オーバーヘッドゼロ。

修正日: 2026/09/04

回帰テスト: tests/unit/test_unit_config.py → test_get_config_overlays_dirty_descendant、test_get_config_overlay_merges_with_cache_siblings、test_get_config_overlay_new_branch、test_get_config_dirty_ancestor_query、test_get_config_dirty_exact_key_still_wins

深刻度: 🟡 中程度

タイプ: 設定システム


[BUG-033] wait_reply の保留中の返信が高優先度ハンドラーによりスターベーション(飢餓)状態に陥る

問題: モジュールが wait_reply() でユーザーの返信を待っている間に、その返信メッセージがより高い優先度のイベントハンドラーにクレームされ(mark_processed())、コマンドディスパッチャーがエントリーで _processed マークを見て即座に戻るため、ディスパッチャーの末尾に配置された返信マッチングロジックが永遠に実行されない——待機側は返信を受け取れず、タイムアウトまで None が返るのをただ待つしかない。典型的なトリガーシナリオ:高優先度メッセージハンドラー(ロギング/監査/インターセプト系)を使用しているボットで、すべての会話型インタラクションがランダムに機能しなくなる。

原因: 返信マッチング _check_pending_reply が _handle_message の末尾に配置されており(コマンドがマッチしなかった場合にのみ実行)、_processed チェックがその前にある——クレームチェックと返信ヒット判定の順序が逆転している。インタラクション待機はフレームワークレベルのセッション継続機構であり、競合するハンドラーではないため、他のハンドラーによるクレームの影響を受けるべきではない。

影響バージョン: 2.2.0-dev.0 - 2.8.0-dev.1

修正バージョン: 2.8.0-dev.2

修正内容: 返信ヒット判定を _handle_message のエントリー(_processed チェックの前、message イベントのみ)に前倒し:まず保留中の会話の完了を試み、ヒットした場合はイベントが処理済みとしてマークされ、下方のチェックは自然に短絡する。ヒットしなかった場合は元のコマンドマッチングフローを継続する。同時に判定チェーンを新しいインタラクションセッションマネージャー(Core/Event/interaction.py)に委譲し、帰属ごとのキャンセルと権限再チェックの機能も併せて獲得。

修正日: 2026/09/08

回帰テスト: tests/unit/test_unit_interaction.py(TestRegisterResolve のヒット/非ヒット/クレームマーク)、tests/unit/test_unit_event.py(wait_reply フルフロー)

深刻度: 🟡 中程度

タイプ: イベントシステム / コマンドシステム


[BUG-034] スコープ persist=False での実行時バインディングが任意の後続の設定書き込みによって静かに上書きされる

問題: scope.set_module(..., persist=False) などの実行時書き込みはメモリ self._data のみを変更します。しかし、scope は config.set / config.updated イベントをサブスクライブしており、任意のコードが設定を書き込む(例えば、あるモジュールがロード時に独自のデフォルト設定を書き込む)と、scope は設定ファイルから全体の設定ツリーを再構築し、以前のすべての実行時バインディングが静かに失われます(デフォルト許可に戻り、ログも出力されません)。実行時バインディングに依存するシナリオ(ダッシュボードの「実行時のみ」スイッチ、モジュールの実行時動的無効化)は、無関係なモジュールが設定を書き込んだ後に動作が元に戻ります。

原因: 根本的な原因:scope.set/delete(persist=False) はメモリのみに書き込みます(Core/scope.py)→ 任意の setConfig は config.set イベントをトリガーします → _on_config_updated は _load_config() を無条件に呼び出します → _apply_tree() は self._data = {...} で全体を置き換えます → 設定ファイルに存在しない実行時バインディングは破棄されます。

影響バージョン: 2.8.0-dev.1 - 2.8.0-dev.2
修正バージョン: 2.8.0-dev.2
修正内容: 実行時オーバーライド層 _runtime_overrides(削除サイン)を導入:persist=False の書き込み/削除はオーバーライド層に記録され、_apply_tree() は永続層を再構築した後、書き込み順序で再適用し、任意の設定書き込み後も実行時ルールが有効に保たれます。persist=True の書き込み/削除は対応するオーバーライド記録をクリアします(ユーザーの永続化の意味を優先)。config.set はイベントのキーで正確にフィルタリングされ、config.updated は新旧の scope 節を比較し、scope が実際に変化した場合にのみ再構築されます(関連する書き込みが LRU キャッシュの判定を破壊しないように)。unregister_by_owner() を追加し、モジュールのアンロード時に呼び出すことで、リソースのクリーンアップを保証します。Core.Event.overrides の persist=False の実行時オーバーライドも同様にオーバーライド層アーキテクチャで修正されます。
修正日: 2026/09/09

再現手順:
① scope.set_module("testplat", blocked=["TestB"], persist=False) → 判定 False;
② 任意のモジュールで config.setConfig("HelpModule", {...}) を実行 → scope の再構築がトリガーされる;
③ scope.is_allowed("testplat", None, "TestB") が True を返す(期待値は False)。

関連: Issue #432
回帰テスト: tests/unit/test_unit_scope.py::TestRuntimeOverrideSurvival(無関係な書き込みの生存/ツリー再構築の再適用/削除サイン/永続化のクリア/正確な無効化/owner によるクリーンアップ)

重大度: 🟡 中等
タイプ: 設定システム / 実行時


[BUG-035] 設定パネルの select 項目と辞書型フィールドが [object Object] と表示される

問題: WebUI の設定パネルで、select フィールドのオプションが下書き表示で [object Object] と表示されます(動的に生成された配色スタイルのオプションなど)。stalker_mode、knowledge_base などのネストされた設定セクションを含む、コントロールタイプが宣言されていない dict フィールドは、テキストボックスで [object Object] と表示され、正しく表示・編集できません。

原因: 2 つの独立した不具合:① 框架の i18n 解析器 _resolve_i18n_text は i18n キーを持つ辞書のみを復元し、default キーのみを持つ動的テキストのオプションラベルはそのまま渡され、前端の esc(label) 文字列強制変換により [object Object] になります。② Dashboard のレンダリング分岐は array 型のみ JSON textarea として扱い、dict 値は純粋なテキスト入力分岐に落ちて String() 強制変換されます。さらに、モジュールが _schema_meta を普通の dataclass フィールドとして誤って宣言(ClassVar 注釈なし)すると、設定フィールドとして schema に含まれ、混乱が悪化します。

影響バージョン: 2.7.0 - 2.8.0-dev.2
修正バージョン: 2.8.0-dev.2
修正内容:
① _resolve_i18n_text は default キーのみを持つ辞書をテキストとして復元するようになります。
② 框架の schema/テンプレート/デフォルト値/埋め込み/検証の 5 カ所で、アンダースコアで始まるフィールドを一律除外(誤った宣言は無害化)。
③ Dashboard の select 選択肢のラベルオブジェクトはデフォルト値を優先的に解析し、dict/table フィールドは JSON textarea としてレンダリングされます(保存パスは tp=object で JSON.parse で再書き込みされ、完全な往復が保証されます)。
修正日: 2026/09/09

回帰テスト: tests/unit/test_unit_config.py::TestResolveI18nDefaultOnlyDict、TestSchemaUnderscoreFieldExclusion

重大度: 🟡 中等
タイプ: 設定システム


[BUG-036] 複数インスタンスが共有する設定ディレクトリで設定書き込みが偶発的に失敗する(ENOENT)

問題: Docker 部署環境(複数のコンテナが同一ホストの設定ディレクトリをマウント)で、ログに偶発的に 2 行連続で Failed to write configuration file ... [Errno 2] No such file or directory: '...config.toml.tmp' -> '...config.toml' が表示されます。今回の設定書き込みは破棄され(旧設定は完全に保持され、設定の喪失は観察されません)、機能に影響はありませんが、アラートが繰り返し表示され、トラブルシューティングを妨げます。また、書き込まれる設定項目は、次の書き込みまでディスクに反映されません。

原因: 根本的な原因:_flush_config / setConfigTemplate は固定名の临时ファイル config.toml.tmp を使用して新内容を保持し、write() 後に fsync せずに rename() を行います。2 つの ErisPulse インスタンスが同一の設定ディレクトリを共有する場合、B インスタンスの open("w") が A インスタンスが書き込んでいる临时ファイルを truncate する可能性があります → A の rename 時に、ターゲットが B によって既に取られたり、内容が切断されている可能性があります。ログに表示される連続した 2 件のエラーは、この ENOENT です。報告されたケースでは、書き込み失敗のアラートのみが表示され(旧設定は保持)、極端なシーケンスが交差した場合、rename は空または半分の config.toml を出力する可能性があります(潜在的なリスクですが、実環境ではまだ発生していません)。単一インスタンス環境では、ext4 の遅延割り当てにより、rename のメタデータがデータブロックの落盤前に発生するクラッシュウィンドウ(SIGKILL / 電源切断)が存在します。_file_lock はプロセス内 threading.RLock であり、プロセス間/コンテナ間の書き込みには制約がありません。

影響バージョン: 2.2.0-dev.0 - 2.8.0
修正バージョン: 2.8.1
修正内容: 設定書き込みはすべて _atomic_write_text() に統合されます:同ディレクトリに mkstemp でプロセス固有の临时ファイルを生成(固定名の競合を排除し、複数インスタンスではラスト・ライター・ウィンに退化し、ENOENT は発生しません)→ 書き込み後 flush + fsync で強制的にデータを落盤(「rename が有効化されたが、データが落盤していない」のウィンドウを排除)→ os.replace で原子的にターゲットを置き換え(POSIX/Windows ともに原子的、いずれの時点でもディスク上は旧内容または新内容のいずれかが存在します);POSIX 環境では設定ディレクトリも追加で fsync します。_flush_config、setConfigTemplate、ルートディレクトリの設定移行の 3 か所の書き込みポイントをすべて切り替えます。異常時のパスクリーンアップロジックは、一意の临时ファイル名の再構築に伴い再構築されます。複数インスタンス検出を追加:起動時にアドバイザリーロック(POSIX では flock、Windows では msvcrt.locking)で設定ディレクトリのロックファイル .erispulse_config.lock を独占的に保持し、占有されている場合は i18n アラートを出力(起動をブロックしません)、ロックは OS がプロセス終了時に自動的に解放され、幽霊ロックはありません。
修正日: 2026/09/13

再現手順:
① 2 つのコンテナが同一のホスト config/ ディレクトリをマウントし、同時に ErisPulse を実行する。
② いずれかのインスタンスが設定書き込みをトリガーする(モジュールのデフォルト設定の登録など)。
③ ログに ENOENT の書き込み失敗アラートが表示され、今回の書き込みは破棄され(旧設定は保持される)。

関連: ユーザーからの報告(1Panel 容器 ×2)

回帰テスト: tests/unit/test_unit_config_atomic_write.py(内容の完全な書き込み/临时ファイルの残留なし/書き込み失敗時の元ファイルの保持/2 つのインスタンスによる並行書き込みが常に合法である/ロックファイルの作成/複数インスタンスのアラート/移行の原子的な書き込み)

重大度: 🟢 軽微
タイプ: 設定システム


[BUG-037] 空白文字を含むコマンド名で登録されたサブコマンドが決してトリガーされない

問題: 空白文字で区切られた複数トークンのコマンド名でサブコマンドを登録した場合(例:@command("admin add"))、コマンドは正常に登録され、ヘルプリストにも表示されますが、ユーザーが /admin add を送信しても、ロボットは決して応答しません。入力は親トークンコマンドとして admin + 引数 ["add"] に一致します。親トークンも登録されていない場合、完全に応答しません。ピリオド区切りの命名(admin.reload、全体が単一トークン)を使用する場合にのみ回避できます。

原因: 根本的な原因:CommandHandler.__call__ は任意のコマンド名(空白形式を含む)をそのまま平滑な self.commands ディクショナリに保存します → 分配段階の _try_execute_command はメッセージの最初のトークンのみを一致させます(cmd_name = parts[0])→ 多トークンのコマンド名はディクショナリのキーとして決して一致しません。登録段階と一致段階のコマンド名の空間の仮定が一致しておらず、登録時にアラートも出力されません(静かに無効化されます)。

影響バージョン: コマンドシステム導入から 2.8.0 まで
修正バージョン: 2.8.1
修正内容: 分配層を最長プレフィックス一致に変更します:" ".join(parts[:n])(n の上限は登録されたコマンド名/エイリアスの最大トークン数キャッシュ _max_name_tokens)で候補を最長から段階的に降格して試行し、一致すれば残りのトークンを引数として実行します。下流の作用域/ACL/オーバーライド/master/権限チェーンはコマンドの全名に対して自然に有効になります。併用する意味:親子が共存する場合、未登録の子コマンドの入力は親コマンドに降りる(歴史的な動作は変更なし);子コマンドが permission を宣言していない場合、直近に宣言された祖先コマンドの権限を継承します(親コマンドを保護すれば、その下のすべての子コマンドも保護されます);単一トークンのコマンドのみが登録されている場合、最初の段階で一致し、分配のオーバーヘッドは以前と同等です。unregister / unregister_by_owner / 全量クリーンアップもトークン数キャッシュを維持します。
修正日: 2026/09/13

再現手順:
① モジュール内で @command("admin add") を登録する。
② /admin add x を送信する。
③ 修正前は応答がなく(または /admin が引数として受け取る)、修正後は admin add がトリガーされ、get_command_args() は ["x"] になります。

回帰テスト: tests/unit/test_unit_command_subcommand.py(最長プレフィックス一致/子コマンドのみがトリガーされる/3段階ネスト/大文字小文字の2モード/単一と複数トークンのエイリアス/イベントペイロードの全名/ライフサイクルフックの全名/権限継承の6例/ACL グロブの全名/master/アンロード時の降りる動作とキャッシュの再計算)

重大度: 🟡 中等
タイプ: イベントシステム


[BUG-038] persist=False で実行時バインディングが永続化書き込みによってディスクに落とされ、モジュールのアンロード後にディスクから「復活」する

問題: scope.set(path, value, persist=False) で書き込まれた実行時バインディング(ドキュメントに記載されているように、ディスクに落とされず、プロセスの再起動で無効化され、モジュールのアンロード時にクリーンアップされる)は、任意の無関係な persist=True 書き込み(デフォルト値、例えばモジュールの set_module / WebUI での設定保存)によって差分書き込みされ、ユーザーの config.toml に落とされます。その後、モジュールがアンロードされて実行時バインディングが解除されても、設定の再ロード時にそのバインディングはディスクから「復活」し、継続的に有効になります。プロセスの再起動後も依然として存在します。これは「実行時バインディングはディスクに落とされない」という文脈の契約に反し、非常に難解です。

原因: 根本的な原因:ScopeManager.set() は値をメモリの設定ツリー _data に直接書き込みます(実行時バインディングも _data に直接書き込まれます)→ 永続化の分岐は全体の _data を深コピーしたスナップショットを update_erispulse_config に差分書き込みに渡します → スナップショットには persist=False のバインディングの値が混入しています。delete(persist=True) も同様の原因です:_data の有効な参照(parent ノード)を遅延書き込みのダirtyキューに渡し、ダirtyキュー滞留中に兄弟キーの実行時変更が一緒に書き込まれ、ダirtyキュー滞留中に跨写汚染の窓が存在します。

影響バージョン: 2.8.0-dev.2 - 2.9.0-dev.0
修正バージョン: 2.9.0-dev.2
修正内容: 永続化ベースライン _persisted_tree(設定ツリーの再構築時にディスクから読み込まれ、検証後のツリーで更新される)を導入し、磁盤の真実のミラーとして使用します:set(persist=True) はベースラインに今回の変更を適用した後、差分を書き込みに渡します。実行時バインディングは永続化内容に含まれません。"書き込んだ後すぐに読み込む"は、メモリの最終状態のスナップショットを直接復元するように変更され、_apply_tree による再構築を経由しないようにベースラインを汚染しません。delete(persist=True) も同口径で、ベースラインに削除を適用し、ベースラインのサブツリーの深コピーを永続化層に渡します。set_action の全体的な置換の意味は、同口径で削除してから書き込むことで、旧ルールのキーが永続化内容に残らないようにします。
修正日: 2026/09/27

再現手順:
① モジュール内で scope.set("bots.p.debug_mode", {"blocked": ["X"]}, persist=False) を実行する。
② 任意の永続化書き込み(他のモジュールが set_module を呼び出すなど)をトリガーする。
③ config/config.toml を開くと、debug_mode が書き込まれている(修正前)。
④ モジュールをアンロード(実行時バインディングが解除される)した後、設定の再ロードをトリガーする。scope.get("bots.p.debug_mode") はバインディング値を返す。

回帰テスト: tests/unit/test_unit_scope.py::TestPersistBaseline(実行時バインディングが無関係な永続化書き込みに伴ってディスクに落とされない / アンロード後に設定の再ロードで復活しない / delete でベースラインのサブツリーを送る際に実行時の兄弟キーを含まない / set_action で置換しても残留キーが残らない / cache_size 設定が有効化される)

重大度: 🔴 重大
タイプ: 設定システム


[BUG-039] 整節書き込みと点分書き込みが共存する場合の読み書きの不整合(点分覆写が失われる)

問題: 遅延書き込みのウィンドウ内で、同じセクションに整節書き込み(setConfig("Mod", {...})、例:BaseModule.cfg の書き戻し)と点分書き込み(setConfig("Mod.key", v)、例:設定のホットアップデート / テストツールでの覆写)が共存する場合、2 つのバリエーションがあります:バリエーション A(読み取り経路)——getConfig("Mod") は整節読み取りで旧の整節待書きスナップショットを返し、後続の点分覆写(点分読み取り経路は正常)は見えません;バリエーション B(書き込み経路、より重大)——点分書き込みが先、整節書き込みが後、テストツールが注入した覆写 → モジュール self.cfg = ... が書き戻す一般的な時系列で、flush は挿入順にダirtyキーを適用し、整節書き込みが点分書き込みの後に来ると、点分覆写はディスク上で永久に失われます。プロダクション環境では「設定のホットアップデート + モジュールの実行時書き戻し」の組み合わせがトリガーされ、テスト環境とは無関係です(ErisPulse-DailyCard テストフィードバックが暴露)。

原因: getConfig 第①段(正確に _dirty_keys にヒット)は return self._dirty_keys[key] で早めに返り、第④段の _dirty_overlay 後代の加算は完全に回避されます。_flush_config は _dirty_keys の挿入順にダirtyキーを適用し、整節書き込みが点分書き込みの後に来ると、点分値が全体的に置き換えられます。また、第①段で返されるダirtyキューは元のオブジェクト参照を返し、呼び出し元が返り値の dict を原地で変更すると、待書き状態が直接変更されます。

影響バージョン: 2.6.0 - 2.9.0-dev.2
修正バージョン: 2.9.0-dev.2
修正内容: ダirtyウィンドウ内では特異性優先の意味に統一します——点分(より具体的)の待書き値が整節(より広い)の待書き値よりも優先されます。読み取り経路と落盤経路は同口径です:① getConfig は正確に待書きキーにヒットした後、_dirty_overlay 後代の待書き値を加算します(dict 値以外は子ツリーを加算し、③+④のスカラーエッジは同口径);② _flush_config はダirtyキーをパスの深さ順に適用します(整節/祖先が先、点分/後代が後、安定ソートで同深さの書き込み順序を保持)。代償:同一ダirtyウィンドウ内(約 5 秒)では、整節書き戻しはまだ保留中の点分書き込みを上書きできません——読み取り経路が修正された後、読み-変更-書き込みは自然に点分値を保持します。実際の影響範囲は非常に小さいです。③ 待書き値に関連する getConfig の返り値(正確にヒット / 祖先のサブツリー / 加算結合)は copy.deepcopy で隔離コピーされ、ダirtyキューの内部参照を漏洩しなくなります。ダirtyキーのない高速パスと純粋なキャッシュ読み取りの動作は変更なし。

修正日: 2026/09/28

再現手順:
① setConfig("FB.y", 1)
② setConfig("FB", {"z": 2})
③ force_save()——修正前はディスクに [FB] z = 2 しか残らず(y は失われる)、修正後は {"y": 1, "z": 2} になります。
バリエーション A:ステップ①②の後、落盤せずに getConfig("FB") を実行する——修正前は y を含まず、修正後は含まれます。

回帰テスト: tests/unit/test_unit_config.py::TestSectionAndDottedDirtyConsistency(バリエーション A の2つの挿入順序 / バリエーション B は落盤と順序に関係なく / 3段階混合で生き残る / 隔離コピー / 祖先のサブツリーの隔離)

重大度: 🟡 中等
タイプ: 設定システム

[BUG-040] プラットフォームがメッセージをセグメントに分割した際、コマンドの末尾引数が静かに失われる

問題: プラットフォームがメッセージを複数のテキストセグメントに分割した場合(例:/kick と引数の間にメンションセグメントが挟まっている、または入力法のセグメント化)、コマンドの分発は最初のテキストセグメントのみを一致させます——/艾特 @xxx 123 は引数のない 艾特 に解析され、args= を宣言したコマンドは「引数不足」を報告し、何の痕跡も残りません。 原因: command.py のテキスト抽出ループは、最初の type=="text" セグメントを取得して break し、残りのセグメント(すべての非テキストセグメント)は破棄されます。 影響バージョン: 2.6.0(コマンド分発の導入)- 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: コマンドテキストはセグメント順にすべての text セグメントを空格で連結して取得するように変更します。メンション/画像の挟層はコマンドの全体解析を妨げなくなります。また、不正なセグメントの容錯を補完します(message が None/文字列/非 dict セグメントの場合も分発器を破綻させません)。 回帰テスト: tests/unit/test_unit_command_multiseg.py

重大度: 🟡 中等 タイプ: イベントシステム

[BUG-041] 拒否されたコマンドが alt_message 整链で再実行される:重複返信と権限関数の副作用が両方発動する

問題: 适配器の alt_message とメッセージセグメントのテキストが一致しない場合(例:alt に @ 付きのテキストプレフィックスがある)、スコープ/ACL/master/permission で拒否されたコマンドは、分発器が alt_message を使って整条のチェーンを再実行します——ユーザーは2つの「権限不足」の返信を受け取り、カスタム権限関数(通常はデータベース/カウントの副作用を伴う)が2回呼び出されます。 原因: 拒否経路 return False と「コマンドが一致しない」は同じ返り値を使用し、分発器はこれに基づいて alt フォールバックを試みます。しかし、イベントは拒否前に既に認領されており、再実行は返信と権限判定の実行を追加するだけです。 影響バージョン: 2.9.0(ガバナンス/権限チェーンの形成)- 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: テキスト処理を3状態契約に変更します(unmatched/consumed/rejected)——コマンドが登録された後(拒否の有無に関わらず)は alt フォールバックを試みません。コマンドが一切一致しない場合にのみ alt フォールバックを保持します。 回帰テスト: tests/unit/test_unit_command_multiseg.py::test_denied_command_not_rerun_via_alt

重大度: 🟡 中等 タイプ: イベントシステム

[BUG-042] コマンドハンドラ内で登録された wait_reply が同一条のトリガーメッセージで即座に消費される

問題: コマンド実行体内で wait_reply / 交互待ちを登録した場合、待ちは同一条のコマンドメッセージで即座に一致します——インタラクションフローの最初の質問がスキップされ、「ユーザーの返信」は実際にはコマンドテキストそのものです(質問と回答が一致しない/データ汚染)。 原因: _handle_message はメソッドの先頭と末尾で interaction.resolve を1回ずつ呼び出します。コマンド実行後の末尾の2回目の resolve は、実行中に新しく登録された待機を一致させます。cmdpass が閉じられた場合、alt が欠如した状態は空文字列と判定され、即座に許可され、この問題を悪化させます。 影響バージョン: 2.8.0(インタラクションセッションシステムの導入)- 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: 分発チェーンを1回の interaction.resolve(メソッド先頭)に収束し、末尾の2回目の呼び出しを削除します。待ちはすべて次のメッセージで消費されます。 回帰テスト: tests/unit/test_unit_command_multiseg.py::test_wait_reply_not_consumed_by_command_trigger

重大度: 🟡 中等 タイプ: イベントシステム

[BUG-043] select() 同キーの複数ルートが後者で前者を静かにキャンセルする

問題: event.select() の複数の希望が同一のセッションキー(同じ user で異なる pattern、複数の session 期待など)を生成する場合、後で登録されたルートが先に登録されたルートを「競合」としてキャンセルし、select は InteractionCancelled を直接投げ、ドキュメントに記載されているタイムアウトの (None, None) ではなくなります。 原因: 各ルートは独立して interaction.register を呼び出し、その排他的な意味は同一キーの旧待機に REASON_CONFLICT を送信してキャンセルします。注釈は「同一 user の複数ルートはイベントのコピーで独立し、互いに競合しない」と述べていますが、コピーは user_id を変更するだけで、同一 user の複数ルートのキーは完全に同じです。 影響バージョン: 2.9.0(select の導入)- 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: select は待ちの集約に変更されます——すべての希望をカスタムマッチャーの単一エントリに統合(キー集合を登録、同一 future を共有)、いずれかのルートが一致すると対応するインデックスを返します。同一キーの複数ルートは自然に共存します。 回帰テスト: tests/unit/test_unit_command_multiseg.py::test_select_same_user_multi_branch

重大度: 🟡 中等 タイプ: イベントシステム

[BUG-044] BaseConverter.at() が OB11 の「at」セグメントを生成し、全フレームワークのメンション判定が認識しない

問題: 适配器が BaseConverter.at() を使ってインバウンドイベントを組み立てる場合、must_at_bot / has_mention() / on_at_message はすべて認識しません——群組で @ ロボットコマンドは静かに無効になります。 原因: at() は {"type": "at"}(OB11 形式)を生成し、フレームワークのすべてのメンション判定と構築側(MessageBuilder/送信修飾子)は OB12 の "mention" を使用しており、2軌道が並存し、アラートもありません。 影響バージョン: 導入バージョンは 2.5.0 以降 - 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: at() は {"type": "mention", "data": {"user_id": ...}}(メソッド名は別名として保持、mention 別名を追加)を生成するように変更します。 回帰テスト: tests/unit/test_unit_command_multiseg.py::test_converter_at_produces_mention

重大度: 🟡 中等 タイプ: 适配器

[BUG-045] alt_message が存在しない适配器ではインタラクション原語が永久にタイムアウトし、コマンドが貫通しない

問題: 适配器が message セグメントを記入するだけで alt_message を記入しない場合、confirm / choose / collect はユーザーの明文返信(例:「はい」)を永久に待機します。待機中の登録されたコマンドは決して貫通して実行されません。Event.get_text() は空文字列を返すため、スクリプトの例は静かに無効になります。 原因: 上記の経路はすべて alt_message 文字列を直に取り、メッセージセグメントの降りる戻りがないため、フレームワークの「alt_message は适配器のオプションフィールドである」という契約の下、セグメントの記入だけが合法な形態です。 影響バージョン: 各インタラクション原語の導入バージョン - 2.10.0 修正バージョン: 2.10.1-dev.0 修正内容: すべてのインタラクション原語の5つの値/検証ポイント、cmdpass 判定、Event.get_text()/get_message_text() は alt_message が優先され、text セグメントが降りる extract_text の口径に統一されます。 回帰テスト: tests/unit/test_unit_command_multiseg.py

重大度: 🟡 中等 タイプ: イベントシステム

[BUG-046] 宣言的設定テンプレートのネストされたサブテーブルヘッダーがトップレベルに漂移する

問題: 嵌套 dataclass で宣言された設定(ConfigClass 内に dataclass フィールドを含む)で、初めて設定テンプレートを生成する場合、サブテーブルヘッダー [Nested] がファイルのトップレベルに落ち、コンポーネントセクション内にない——适配器が cfg.嵌套フィールド を読み取ると値が取得できない;config.full.example でも同様に誤位する。 原因: テンプレート生成器はネストされた dataclass を相対テーブルヘッダー([Nested])としてレンダリングし、TOML のテーブルヘッダーの意味はルートからの絶対パスです;setConfigTemplate の旧実装は解析後のテーブルオブジェクトをコンポーネントセクションに移し、full.example は直接テキストを組み合わせるため、2つの経路とも相対テーブルヘッダーをコンポーネントパスに再アンカーしていない。 影響バージョン: 2.10.0 - 2.10.1(ネストされた dataclass テンプレートのレンダリングはこのバージョンで導入される) 修正バージョン: 2.10.2 修正内容: setConfigTemplate はテンプレートの解析されたサブテーブルパスの集合に正確に再アンカーする([Nested] → [コンポーネント名.Nested]);config.full.example の生成側は _prefix を渡すことで絶対テーブルヘッダーを直接生成する。 回帰テスト: tests/unit/test_unit_config.py::TestTomlclassEngineMigration::test_template_write_idempotent_and_nested_anchored

重大度: 🟡 中等 タイプ: 設定システム / 适配器


[BUG-047] サービスディレクトリの全量列挙が遅延ロードモジュールを漏らす

問題: sdk.module.services() の全量ディレクトリは、未インスタンス化(遅延ロード)のモジュールを一律にスキップする——モジュールが meta.services を宣言してもディレクトリに表示されず、ディレクトリを発見エントリとする消費者(AI インテリジェントエージェント、help モジュールなど)はそのサービスを発見できない。単一モジュールの正確なクエリ services("Name") とトポロジー get_topology() は影響を受けない。 原因: ModuleManager.services() の全量列挙の分岐は、契約キャッシュがない(未ロード)モジュールを現地で契約を解析した後も無条件に continue する——意図は「サービスを宣言していないモジュールをスキップする」だが、実際には未ロードモジュールを全体的にスキップしてしまう;ロード済みモジュールはロード時に契約キャッシュを書き込むため影響を受けない。 影響バージョン: 2.9.0 - 2.10.1(モジュール RPC とサービスディレクトリは 2.9.0 で導入される) 修正バージョン: 2.10.2 修正内容: 無条件のスキップを削除し、"解析結果が空ならスキップ"で裁決するようにする;未ロードモジュールは現地で get_meta().services を解析する(module.call() のホワイトリストと同口径)、サービスを宣言したものは照常ディレクトリに進む。 回帰テスト: tests/unit/test_unit_module_rpc.py::TestServicesDirectory::test_lazy_declared_module_in_full_directory

重大度: 🟡 中等 タイプ: ローディングシステム

[BUG-048] 会話受信箱のクエリ API はメッセージの帰属(sender とイベントメタデータ)を失う

問題: 受信箱のすべてのクエリインターフェース(get() / get_by_trace() / event.history())が返すレコードには role/text/ts/event_id しか含まれない——ストア階層に既存の sender 列はクエリ階層で捨てられ、グループチャットのリプレイでは異なるメンバーのメッセージが API 階層で区別できない(AI は前回の対話者 A と誤ってメンバー B を認識する);入力記録にはイベントの瞬間のニックネームなどのメタデータがアーカイブされず、事後リバースチェックでは「現在のニックネーム」ではなく「当時のニックネーム」が取得される。 原因: 2.8.0 で sender 列を追加した際のコメントは「リプレイ時にメッセージの送信元を復元する」ために書かれていたが、Select と返り値の構造はそれを含んでいない(実装の漏れ);メタデータのアーカイブは設計されていない——append() に meta チャネルがなく、テーブル構造に該当する列がない。 影響バージョン: 2.8.0 - 2.11.0(sender 列は 2.8.0 で導入される) 修正バージョン: 2.11.1-dev.0 修正内容: 新たな meta 列を追加する(ホワイトリスト契約:入力時の nickname/self_id/sub_type/message_id、出力時の送信コンテキストと module;旧テーブルは自動的にマイグレーションされ、バックエンドが ALTER をサポートしない場合は静かに {} に回退);append() に meta パラメータを追加し、メモリバッファとバッチ落盤に貫通する;get / recent / get_by_trace / event.history は sender + meta を統一して返す(JSON 損傷は {} に回退)。 関連: #467(同批 #468 / #469 / #470) 回帰テスト: tests/unit/test_unit_transcript_attribution.py::TestSenderMetaReadback / TestMetaMigration

重大度: 🟡 中等 タイプ: 会話受信箱 / ストレージシステム

[BUG-049] 入力 bot 自発メッセージのエコーが user として記録され、受信箱の帰属を汚染する

問題: メッセージエコーを有効にしたプラットフォーム/プロトコル端末(OneBot v11 report-self-message、Telegram outgoing など)は、bot 自身がメッセージをイベントとして報告する際に、受信箱は一律 role="user" として記録する——ロボット自発言と実際のユーザー入力は区別できないため、下流のモジュールは bot 自発言をユーザー入力として処理し(AI はこれに基づいて「ユーザー」が言ったことを応答する)、role の統計が歪む。 原因: 入力自動記録ポイント(Core/adapter.py)は、event_type == "message" のすべてに対して無条件で role="user" を記録し、self フィールドを bot エコー判定に使用していない——しかし、直後に bot 自動発見ロジックが同一フィールドを消費している(記録の瞬間に利用可能だが、記録ロジックは使用していない)。 影響バージョン: 2.8.0 - 2.11.0(受信箱自動記録は 2.8.0 で導入される) 修正バージョン: 2.11.1-dev.0 修正内容: 記録前に self.user_id == user_id でエコーを識別し、ErisPulse.transcript.self_echo の 3 モードで処理する:"bot"(デフォルト)は role="bot" + sender=self_id + meta.self_echo=true として記録;"skip" は記録しない;"user" は旧動作を保持。エコーではないプラットフォーム(self が欠落しているか一致しない)は逐文字元に戻る。 関連: #470(#467 の meta 列が self_echo マーカーを保持する必要がある) 回帰テスト: tests/unit/test_unit_transcript_attribution.py::TestSelfEcho

重大度: 🟡 中等 タイプ: 适配器 / 会話受信箱

[BUG-050] コンテナ内で epsdk restart を実行するとコンテナが直ちに終了する

問題: フレームワークがコンテナのメインプロセス(PID 1)として実行されている場合(公式イメージ CMD ["epsdk", "run"] または直起動スクリプト)、ep i <パッケージ> でコンポーネントをインストールした後、指示に従って epsdk restart を実行すると、コンテナが直ちに終了し、再起動しない——インストールされた新しいコンポーネントは有効にならず、サービスが中断される。 原因: epsdk restart の実装は「実行中のインスタンスを終了 + 元のパラメータで再起動」である——再起動は epsdk CLI プロセスが管理する。コンテナ環境では、対象インスタンスは PID 1(コンテナのメインプロセス)であり、SIGINT/SIGTERM で終了すると PID namespace が破棄され、CLI 自身と再起動されるべき子プロセスが一緒に殺され、再起動は決して起こらない。 影響バージョン: 2.11.0 - 2.11.2(runtime.json インスタンス制御は 2.11.0 で導入される;それ以前のバージョンには restart コマンドがない)
修正バージョン: 2.12.0-dev.0
修正内容: epsdk restart は状態ファイル pid == 1(コンテナのメインプロセスの特徴)を検出すると、終了と再起動を行わず、代わりにフレームワークプロセスに SIGUSR1 を送信し、フレームワーク内でコンポーネントレベルのソフトリスタート(sdk.restart():モジュールと適応器のホットリロードパイプライン、実行中に新しくインストールされた適応器の entry-point が即座に有効化)を実行する。sdk.run() はこのチャネルを保持する SIGUSR1 ハンドラを登録する。プロセス全体のリスタートは、コンテナのリスタート(docker restart / restart ポリシー)に任せる。
回帰テスト: tests/unit/test_unit_cli_runtime.py::TestRestartContainerHot

重大度: 🔴 重大(コンテナデプロイのリスタートでサービスが中断する)
タイプ: CLI / 部署