墨寒桌面助理 v4.2.0／墨寒桌面助手 v4.2.0／MoHan Desktop Assistant v4.2.0／墨寒デスクトップアシスタント v4.2.0

墨寒桌面助理 v4.2.0 發行說明／墨寒桌面助手 v4.2.0 发布说明／MoHan Desktop Assistant v4.2.0 Release Notes／墨寒デスクトップアシスタント v4.2.0 リリースノート

繁體中文

這是 v4.2.0 的正式 Release 說明。Windows 為正式支援平台；macOS 與 Linux 僅提供功能受限 Preview，不宣稱開發者實機認證或 Windows 功能同等。

本版重點

• 徹查並修復啟動時全身與半身視角疊影的根因：companion_face_animation.py 的 _set_expression 與 _render_speech_pixmap 在 _adaptive_full_body_active 為真時提前返回，不再無條件重置旗標並覆寫畫布，杜絕啟動寒暄語音觸發 legacy 半身圖層回寫所造成的疊影。
• 徹查並修復 webcam 揮手無回應、不主動寒暄的根因：flagship/vision.py 的相機啟動改依 camera_presence.available() 進行，不再被 vision readiness（FaceDetectorYN／FaceRecognizerSF 與 ONNX 模型載入）綁架；gesture_controller.py 新增 _effective_configuration，在視覺感知啟用時以 enabled=True 供應 runtime，避免被 configuration.enabled=False 擋住手勢與寒暄流程。
• 徹查並修復控制台「主動陪伴與關懷」設定本機實機測試無感的根因：三級設定 proactive_mode（安靜／平衡／積極）原本只被背景代理消費，未進入主動寒暄與關心的語音派送鏈。本次讓 proactive_mode 經 ProactiveAppState 與 NormalizedCompanionEnvironment 流入 ProactiveCompanionRuntime：quiet 只保留排程與健康提醒、balanced 維持 45 分鐘 check-in 門檻、active 縮短至 15 分鐘更頻繁主動關心。

相容性與平台邊界

• 本版僅修正 v4.1.1 之後的三項執行期根因，不變更既有功能邊界；Windows 為正式支援，macOS Arm／x86 與 Linux 維持功能受限 Preview。
• 不新增外部相依套件，不改變任何授權、隱私或可回退驗證原則。

維護交接

本節作為 v4.2.0 後續維護的交接基線；每次變更均應更新可重現證據、四語文件與本 Release 說明。

• 發行來源：分支、合併後的 main、版本、標籤與 GitHub Release 必須指向同一不可變提交。
• 平台邊界：Windows 正式支援；macOS 與 Linux 維持 Preview，維持同版號、四語及封裝 smoke 驗證。
• 發行證據：維持完整回歸、安裝／升級、SBOM、SHA-256、秘密防護、四語治理與原生證據的可重現檢查。

下一位維護者應先閱讀本說明、工作流程與證據檔，再修改版本、封裝或發布程序。

简体中文

这是 v4.2.0 的正式 Release 说明。Windows 是正式支持平台；macOS 与 Linux 仅提供功能受限 Preview，不声明开发者实机认证或 Windows 功能同等。

本版重点

• 彻查并修复启动时全身与半身视角叠影的根因：companion_face_animation.py 的 _set_expression 与 _render_speech_pixmap 在 _adaptive_full_body_active 为真时提前返回，不再无条件重置标志并覆写画布，杜绝启动寒暄语音触发 legacy 半身图层回写所造成的叠影。
• 彻查并修复 webcam 挥手无响应、不主动寒暄的根因：flagship/vision.py 的相机启动改依 camera_presence.available() 进行，不再被 vision readiness（FaceDetectorYN／FaceRecognizerSF 与 ONNX 模型载入）绑架；gesture_controller.py 新增 _effective_configuration，在视觉感知启用时以 enabled=True 供应 runtime，避免被 configuration.enabled=False 挡住手势与寒暄流程。
• 彻查并修复控制台「主动陪伴与关怀」设置本机实机测试无感的根因：三级设置 proactive_mode（安静／平衡／积极）原本只被后台代理消费，未进入主动寒暄与关怀的语音派发链。本次让 proactive_mode 经 ProactiveAppState 与 NormalizedCompanionEnvironment 流入 ProactiveCompanionRuntime：quiet 只保留排程与健康提醒、balanced 维持 45 分钟 check-in 门槛、active 缩短至 15 分钟更频繁主动关怀。

兼容性与平台边界

• 本版仅修正 v4.1.1 之后的三项运行时根因，不改变既有功能边界；Windows 为正式支持，macOS Arm／x86 与 Linux 保持功能受限 Preview。
• 不新增外部依赖包，不改变任何授权、隐私或可回退验证原则。

维护交接

本节作为 v4.2.0 后续维护的交接基线；每次变更均应更新可重现证据、四语文档与本 Release 说明。

• 发行来源：分支、合并后的 main、版本、标签与 GitHub Release 必须指向同一不可变提交。
• 平台边界：Windows 正式支持；macOS 与 Linux 保持 Preview，保持同版本号、四语及封装 smoke 验证。
• 发行证据：保持完整回归、安装／升级、SBOM、SHA-256、秘密防护、四语治理与原生证据的可重现检查。

下一位维护者应先阅读本说明、工作流程与证据文件，再修改版本、封装或发布程序。

English

These are the formal v4.2.0 Release Notes. Windows is the formally supported platform; macOS and Linux are limited Previews, with no claim of developer physical certification or Windows feature parity.

Highlights

• Traced and fixed the root cause of the full-body/half-body overlay ghosting at startup: _set_expression and _render_speech_pixmap in companion_face_animation.py now return early when _adaptive_full_body_active is true, no longer unconditionally resetting the flag and overwriting the canvas. This prevents the startup greeting speech from triggering the legacy half-body layer write-back that caused the ghosting.
• Traced and fixed the root cause of the unresponsive webcam wave and missing proactive greeting: camera startup in flagship/vision.py now follows camera_presence.available() instead of being blocked by vision readiness (FaceDetectorYN/FaceRecognizerSF and ONNX model loading); gesture_controller.py adds _effective_configuration, which supplies the runtime with enabled=True when visual perception is enabled, so configuration.enabled=False can no longer block the gesture and greeting flow.
• Traced and fixed the root cause of the ineffective "proactive companionship and care" console setting in local on-device testing: the three-level proactive_mode (quiet/balanced/active) was only consumed by background agents and never reached the proactive greeting-and-care speech dispatch chain. proactive_mode now flows through ProactiveAppState and NormalizedCompanionEnvironment into ProactiveCompanionRuntime: quiet keeps only scheduled and wellbeing reminders, balanced keeps the 45-minute check-in threshold, and active shortens it to 15 minutes for more frequent proactive care.

Compatibility and platform boundaries

• This release only fixes three runtime root causes found after v4.1.1 and does not change existing feature boundaries; Windows remains formally supported, while macOS Arm/x86 and Linux remain limited Previews.
• No new external dependency is added, and no authorization, privacy, or fallback verification principle is changed.

Maintenance handoff

This section is the v4.2.0 handoff baseline for future maintenance; every change must update reproducible evidence, four-language documentation, and these Release Notes.

• Release source: the branch, merged main, version, tag, and GitHub Release must point to the same immutable commit.
• Platform boundaries: Windows is formally supported; macOS and Linux remain Previews with the same version number, four languages, and package smoke verification.
• Release evidence: maintain reproducible checks for full regression, install/upgrade, SBOM, SHA-256, secret isolation, four-language governance, and native evidence.

The next maintainer should read this document, the workflows, and the evidence files before changing versions, packaging, or the publication process.

日本語

これは v4.2.0 の正式な Release 説明です。Windows は正式サポートプラットフォームです。macOS と Linux は機能限定 Preview のみで、開発者の実機認証や Windows と同等の機能を主張するものではありません。

本リリースのポイント

• 起動時の全身と半身の視点の重なりの根本原因を究明し修正しました。companion_face_animation.py の _set_expression と _render_speech_pixmap は、_adaptive_full_body_active が真の場合に早期リターンし、フラグを無条件にリセットしてキャンバスを上書きしなくなりました。これにより、起動時の挨拶音声が legacy 半身レイヤーの書き戻しを引き起こして重なりが発生するのを防ぎます。
• webcam への手を振る動作に応答しない、積極的に挨拶しない問題の根本原因を究明し修正しました。flagship/vision.py のカメラ起動は vision readiness（FaceDetectorYN／FaceRecognizerSF と ONNX モデル読み込み）にブロックされず、camera_presence.available() に従うようになりました。また、gesture_controller.py に _effective_configuration を追加し、視覚認識が有効な場合は enabled=True で runtime に供給するため、configuration.enabled=False がジェスチャーと挨拶の流れを妨げなくなりました。
• コンソールの「積極的な寄り添いとケア」設定が本機実機テストで効果を感じられなかった問題の根本原因を究明し修正しました。3段階設定 proactive_mode（安静／平衡／積極）は元々バックグラウンドエージェントだけが消費し、積極的な挨拶とケアの音声配信チェーンには到達していませんでした。今回 proactive_mode を ProactiveAppState と NormalizedCompanionEnvironment を通じて ProactiveCompanionRuntime へ流し込みます：quiet はスケジュールと健康リマインダーだけを残し、balanced は 45 分の check-in 閾値を維持し、active は 15 分に短縮してより頻繁に積極的ケアを行います。

互換性とプラットフォーム境界

• 本リリースは v4.1.1 以降に見つかった3つのランタイム根本原因のみを修正し、既存の機能境界は変更しません。Windows は正式サポート、macOS Arm／x86 と Linux は機能制限付き Preview のままです。
• 新しい外部依存パッケージは追加せず、認可、プライバシー、フォールバック検証の原則は変更しません。

メンテナンス引き継ぎ

このセクションは v4.2.0 の今後のメンテナンスのための引き継ぎベースラインです。すべての変更は、再現可能な証拠、4言語ドキュメント、本 Release 説明を更新する必要があります。

• リリースソース：ブランチ、マージ後の main、バージョン、タグ、GitHub Release は同じ不変コミットを指す必要があります。
• プラットフォーム境界：Windows は正式サポート。macOS と Linux は Preview のままで、同じバージョン番号、4言語、パッケージ smoke 検証を維持します。
• リリース証拠：完全な回帰、インストール／アップグレード、SBOM、SHA-256、秘密の分離、4言語ガバナンス、ネイティブ証拠の再現可能なチェックを維持します。

次のメンテナは、バージョン、パッケージング、公開プロセスを変更する前に、本説明、ワークフロー、証拠ファイルを読む必要があります。