dsh-Friend Live2D stage

@wishp3/dsh-friend-stage provides the standalone companion viewer at /friend/pet. Built-in models are 奶龙 (first-party Cubism 4.2 runtime zip extracted to vendor/nailong/) and official Hiyori Momose - FREE (downloaded after the user accepts Live2D terms). Rendering uses PixiJS and pixi-live2d-display.

First run

1. Start DSH with this package mounted.
2. Open http://127.0.0.1: /friend/pet.
3. Read and accept the applicable official Live2D terms in the page, then select 下载并启用 Live2D.

The page downloads the Hiyori FREE model and the official Cubism 5 R5 Core to $DSH_HOME/friend/vendor/ (or ~/.dsh/friend/vendor/ when DSH_HOME is not set). They are deliberately excluded from this package, Git, and npm. The original model ReadMe.txt and an attribution NOTICE.txt remain alongside the local files.

Progress is pushed as reentrant SSE snapshots on GET /friend/events (event: asset-progress). A matching GET /friend/live2d/progress returns the same snapshot so an EventSource reconnect can catch up.

Frame rate defaults to 30 FPS and is read from the friend-stage settings namespace (targetFps).

Updating official asset hashes

Install verifies sha256 before writing vendor/. Expected digests live in vendor-integrity.json so they can be updated without changing TypeScript.

The checked-in values are TODO placeholders until someone hashes the real official files (this environment cannot download them). A placeholder does not pretend to be a real digest: install may still finish, but the JSON result reports integrity: "hash-pending" / hashPending: true. A mismatch never writes vendor/ and leaves a retryable tree (only vendor/hiyori and vendor/cubism-core are auto-cleaned).