mascot-render-server

デスクトップマスコット（の簡易版）。Rustで書かれています。

特徴

• かんたんインストール。zipを置くだけ。
• らくらくエディット。TUIで直感的に着せ替えやポーズ変更ができます。
• ゆかいなリアクション。頭をクリックすると…
• しゃべる : voicevox-playground-tui
• 全員集合 : TUIでfavorites登録したメンバーの立ち絵を並べて遊べます。全員並べることも可能。簡易版
• 簡易版です。機能は少ないので遊び心が必要です。

install

Rustが必要です。

cargo install --force --git https://github.com/cat2151/mascot-render-server mascot-render-server psd-viewer-tui mascot-render-status-tui

準備

次の3つのzipファイルを C:/Users/<YOUR NAME>/AppData/Local/mascot-render-server/assets/zip/ に配置してください。

坂本アヒル様作

• ずんだもん立ち絵素材2.3.zip
• ずんだもん立ち絵素材V3.2.zip
• ずんだもん立ち絵素材改1.1.1.zip

実行

psd-viewer-tui

• 以下が自動で行われます：
  • zipファイルの展開
  • zipに入っているpsdファイルの分析
  • psdに入っているレイヤーの分析
  • デスクトップマスコットの表示
    • デフォルトのレイヤーで表示されます
• 服装やポーズのレイヤーを変更すると見た目が変わります

• TUIでお気に入りを登録しておくと、server側がキャッシュを参照して1分ごとに別のお気に入りへshuffle再生します

• 詳しい機能は画面のhelpを参照ください

設定

• mascot-render-server.toml
  • always_idle_sink
    • 初期値は true です。
    • trueにすると、UX検証用に小さな IdleSink 呼吸風モーションを常時再生します。
  • always_bend
    • 初期値は true です。
    • trueにすると、UX検証用の左右 bend を常時再生します。
  • bend
    • amplitude_ratio で bend 幅をマスコット画像幅に対する比率で指定できます。デフォルトは 0.0075 です。
  • idle_sink
    • always_idle_sink 専用の IdleSink 呼吸設定です。
    • デフォルトでは通常の squash_bounce より穏やかに沈み込み・持ち上がり、まばたき interval の中央値のゆらぎに合わせて少しずつテンポが変わります。
    • sink_amount と lift_amount で、呼気側と吸気側の pose を個別に調整できます。

アーキテクチャ

• モジュラー
  • 再利用性を重視し、責務ごとの小さなクレートに分割して実装してあります。
• server
  • visual-render-serverに徹する。セリフとmotionのオーケストレーション等の責務は、別の上位階層のアプリに持たせる考えです。
• Sixel
  • デスクトップマスコットが万一動かない場合のフォールバック用で、terminalにマスコットのpreviewが表示されます。
• PSDTool
  • PSDToolの拡張フォーマット「ラジオボタン化」「強制表示化」に対応し、快適なeditを実現しています。
• format
  • ghostやshellなどの管理formatの実現はできていません
    • 現状、坂本アヒル様作ずんだもん立ち絵素材でのみtestをしています
      • tomlファイルを書き換えれば汎用で使える可能性はありますが未確認です

vendor/ について

• vendor/rawpsd は rawpsd ライブラリの不具合に対して、AI支援で修正を入れた vendored copy です。
• mascot-render-serverで取り扱うpsdを読もうとするとpanicしていたので、そこをCodex CLIに修正させたものです。
• CIの都合でリファクタリングしました。PR 17

前提

• 自分用のアプリですので、他の人が使うことを想定していません。似たような機能がほしいときはcloneや自作をおすすめします。
• 頻繁に破壊的変更を行います。万一誰かが関連機能を作ったとしても翌日には使えなくなっているかもしれません。

このアプリが目指すもの

• PoC。Codex CLI（Codex Plus 30日間無料お試し版）で自分用にあると助かるアプリが作れることを実証する（実証した）
• psd。Rustで楽にpsdを扱えること
• デスクトップマスコット。Rustで楽にデスクトップマスコットを実現できること
• 目パチと口パク
• server。HTTP REST APIで、楽に他のアプリからデスクトップマスコットを操作できること

目指さないもの（スコープ外）

• 新たな高機能汎用デスクトップマスコット共通規格の策定、それに向けたガバナンス体制の整備、継続的な運営
• サポート。要望や提案に応える