5efa9c37d6
- Created detailed documentation for the device_manager, model, model_extra, osc, overlay, overlay_image, transcription, translation, transliteration, utils, watchdog, and websocket modules. - Added a comprehensive run events payloads document outlining the payloads sent during various run events in the controller. - Included runtime instructions and dependencies for setting up the project in a Windows environment. - Introduced a mypy configuration file to manage type checking and ignore errors in specific modules temporarily.
2.0 KiB
2.0 KiB
CHANGELOG
2025-10-09 — 型チェック整備と安全性向上
-
修正:
controller.pyController.chatMessageの戻り値注釈をdictに明示（関数は JSON 系の応答オブジェクトを返します）。Controller.checkSoftwareUpdatedが実際に応答を返すようにreturnを追加。
-
修正:
model.pystartCheckMicEnergy/startCheckSpeakerEnergyのコールバック引数を Optional に変更し、呼び出し前にcallableチェックを追加。これにより None を渡しても安全に扱えるようになりました。convertMessageToTransliterationの返り値を常に list に統一。hiragana/romaji が False の場合は空リストを返します。createOverlayImageLargeLog等の Overlay 作成関数でtarget_languageを dict で受けた場合に内部で言語リストへ正規化する挙動を明確化。
-
目的: mypy の型チェックの警告/エラーを削減し、ランタイムでの None 呼び出しによるクラッシュを防止するための低リスクな変更です。
-
注記:
- 追加で
types-requestsをプロジェクト仮想環境にインストールし、mypy の外部型スタブ不足を解消しました。 - 本チェンジは内部の型注釈とガードを中心としており、動作ロジックの大きな変更は行っていません。動作確認は mypy（型チェック）と ruff（lint）を通過したことをもって行っています。
- 追加で
1.0.0 (initial)
- 初回ドキュメント作成: ソースコードに基づく仕様書 / 詳細設計書を docs 配下に追加。
- 対象: utils, model, controller, device_manager, config, translation, transcription, overlay, websocket, osc, transliteration, watchdog
今後の作業候補:
- requirements.txt の自動生成とテストスイート追加
- ドキュメントの API サンプル（リクエスト/レスポンス）追加
- UML 図/シーケンス図の画像化