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

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

繁體中文

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

本版重點

• 徹查並修復全身模式（v4 full-body）嘴型不跟語音動的根因：pose_atlas_assets.py 的 resolve_speech 原本是未完成 stub，只回傳 None，導致說話時全身渲染被 bypass、嘴型完全靜止。本次讓 resolve_speech 從 .hands.json 的 protected_regions.face 讀取臉部座標，產生程序化嘴型圖層，並讓 full_body_render_adapter.py 的 update_speech_layers 在嘴型閉合時回到靜態照片，杜絕嘴型殘留。
• 徹查並修復全身模式疊影仍未根除的根因：companion_face_animation.py 的 set_state 在全身模式下仍會切換 legacy 半身表情，重置 _adaptive_full_body_active 並讓被隱藏的半身 overlay 疊回全身照片。本次讓 set_state 在全身模式下跳過 legacy 表情切換，保留肢體動畫，杜絕疊影復發。
• 徹查並修復 webcam 走動／揮手無表情與肢體回應的根因：全身照片是靜態 PNG，沒有對應的表情變體，揮手只觸發語音寒暄而無視覺回應。本次讓全身模式在揮手／走動時透過肢體動畫（上下晃動）提供可見回應，同時保留語音寒暄。

相容性與平台邊界

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

維護交接

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

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

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

简体中文

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

本版重点

• 彻查并修复全身模式（v4 full-body）嘴型不跟语音动的根因：pose_atlas_assets.py 的 resolve_speech 原本是未完成 stub，只返回 None，导致说话时全身渲染被 bypass、嘴型完全静止。本次让 resolve_speech 从 .hands.json 的 protected_regions.face 读取脸部坐标，产生程序化嘴型图层，并让 full_body_render_adapter.py 的 update_speech_layers 在嘴型闭合时回到静态照片，杜绝嘴型残留。
• 彻查并修复全身模式叠影仍未根除的根因：companion_face_animation.py 的 set_state 在全身模式下仍会切换 legacy 半身表情，重置 _adaptive_full_body_active 并让被隐藏的半身 overlay 叠回全身照片。本次让 set_state 在全身模式下跳过 legacy 表情切换，保留肢体动画，杜绝叠影复发。
• 彻查并修复 webcam 走动／挥手无表情与肢体回应的根因：全身照片是静态 PNG，没有对应的表情变体，挥手只触发语音寒暄而无视觉回应。本次让全身模式在挥手／走动时通过肢体动画（上下晃动）提供可见回应，同时保留语音寒暄。

兼容性与平台边界

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

维护交接

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

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

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

English

These are the formal v4.2.1 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 (v4 full-body) mouth not following speech: resolve_speech in pose_atlas_assets.py was an unfinished stub that only returned None, so speech bypassed the full-body render and the mouth stayed completely still. resolve_speech now reads the face region from .hands.json protected_regions.face, produces a procedural mouth layer, and update_speech_layers in full_body_render_adapter.py restores the static photograph when the mouth closes, preventing a lingering mouth.
• Traced and fixed the root cause of the full-body double image not being fully eliminated: set_state in companion_face_animation.py still switched the legacy half-body expression in full-body mode, resetting _adaptive_full_body_active and stacking the suppressed half-body overlays back over the full-body photograph. set_state now skips the legacy expression switch in full-body mode while keeping the gesture animation, preventing the double image from returning.
• Traced and fixed the root cause of the missing expression and body response to webcam movement/waving: the full-body photograph is a static PNG with no expression variants, so a wave only triggered a spoken greeting with no visual response. Full-body mode now provides a visible response through a body animation (vertical bob) on wave/movement while keeping the spoken greeting.

Compatibility and platform boundaries

• This release only fixes three full-body runtime root causes found after v4.2.0 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.1 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.1 の正式な Release 説明です。Windows は正式サポートプラットフォームです。macOS と Linux は機能限定 Preview のみで、開発者の実機認証や Windows と同等の機能を主張するものではありません。

本リリースのポイント

• 全身モード（v4 full-body）で口元が音声に追従しない問題の根本原因を究明し修正しました。pose_atlas_assets.py の resolve_speech は未完成のスタブで None のみを返すため、発話時に全身レンダリングがバイパスされて口元が完全に静止していました。今回 resolve_speech は .hands.json の protected_regions.face から顔領域を読み取り、手続き的な口元レイヤーを生成し、full_body_render_adapter.py の update_speech_layers は口を閉じた際に静的写真へ戻すことで、口元の残像を防ぎます。
• 全身モードの二重像が完全に解消されない問題の根本原因を究明し修正しました。companion_face_animation.py の set_state は全身モードでも legacy 半身表情を切り替え、_adaptive_full_body_active をリセットして非表示の半身 overlay を全身写真に重ねていました。今回 set_state は全身モードで legacy 表情切り替えをスキップしつつジェスチャーアニメーションを維持し、二重像の再発を防ぎます。
• webcam での移動／手振りに表情と身体応答がない問題の根本原因を究明し修正しました。全身写真は静的 PNG で表情バリエーションがなく、手振りは音声挨拶のみをトリガーして視覚応答がありませんでした。今回全身モードは手振り／移動時に身体アニメーション（上下の揺れ）で可視応答を提供しつつ、音声挨拶を維持します。

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

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

メンテナンス引き継ぎ

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

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

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