トレース待機中(再生ボタンを押してください)

モジュール構造 · 日本語完全版

ネオ秘書くん: 卓上Desk Pet & AI統合ブリッジ Showcase

スマホのワンタップやAI完了イベントが、Zero-Trust認証・LangGraph推論・SQLite WALを経て画面・音声リアクションへ同期する流れを追跡します。

📘 チートシート & 公式利用ガイドを開く ➔ 🇬🇧 English
Product Vision · PO Layer (v1.1.18)

🎯 北極星(プロダクトの存在意義・Why)

「自律AIに仕事を任せ、休日はリビングで家族と過ごす」。眠っていた古いスマホを生活空間のアンビエントな気付き装置に転生させ、必要な1秒だけをワンタップで救い上げることで、開発者の生命時間を最大化する。
Core Value Proposition

💎 確定したプロダクト三層構造(三位一体)

🔔

【核】遠隔承認リモコン

Claude Code/Cline等のコマンド承認をスマホでワンタップ。透過的フック(cancel_pending自動消去)とFastMCP標準ブリッジで、コーヒー片手にノールックで開発を進める本命コア。

🐾

【魂】ドット絵ペット&愛着スキン

16-bitピクセルペットが画面で呼吸し達成感を共有。0fps適応型省電力スリープでバッテリーを浪費せず、生活空間に溶け込むアンビエントな相棒。

📖

【床】手帳・習慣・iCal同期

承認リモコンを生活空間に常駐させる日常の居場所。TickTickと競合せず、必要なTODO・習慣・Googleカレンダー先回りで生活リズムを静かに支える。

真実の梯子 (Truth Ladder)

まずはシンプルに。そして隅々まで誠実に。

デスク脇に座り、ボスの集中を見守り、AIコーディング完了をハイタッチで一緒に喜んでくれる手のひらサイズの相棒マスコット。

モジュール構造

モジュール構成仕様

エントリーポイント

pwa-client

出力・リアクション

pc-mascot-ui

audio-feedback

参照ソース

local-server-srcmain-app-srcdatabase-src
シグナルトレース

システム内のデータの流れを追跡

トレース待機中(再生ボタンを押してください)

01

1. スマホPWA入力 & Zero-Trust端末認証

スマホPWAから送信されたアクション・承認要求を、端末個別256bit暗号トークンとHuman-in-the-Loop承認で完全検証。Jev安全審査バッジをリアルタイム描画します。

アクター

スマホ Desk Pet (PWA v1.1.0)

常時点灯の卓上スマートディスプレイ。適応型Canvas 0fps省電力、Jev安全審査ネオンバッジ、8bitシンセ音を搭載。

判定・分岐

同期サーバー & ゼロトラスト認証 (LocalSyncServer)

端末個別256bitトークン照合、未承認端末接続時の10秒カウントダウンHuman承認、およびJev安全審査スコア中継を強制する軽量デーモン。

影響範囲
未承認端末や同一LAN内の成りすまし要求が即座に遮断されます
発生する症状
サーバー側に HTTP 403 Forbidden が記録されFail-Closed遮断
縮退復旧 (フォールバック)
設定画面のQRコードまたはPC画面の承認ダイアログから端末を安全に認証・復帰します
02

2. LangGraph状態遷移 & Agentログ監視

ユーザー入力や外部AI(Antigravity/Codex)のタスク完了を、UI描画スレッドをブロックせず非同期処理します。

イベント

Agent監視デーモン

外部AIエージェントのログ出力をリアルタイム監視し、完了歓喜や承認要請を発火。

プロセス

LangGraph & LLM Factory

Gemini/Claudeとオフライン用ローカルGGUFをシームレスに切り替える思考エンジン。

影響範囲
クラウドAI推論が停止します
発生する症状
外部APIのタイムアウトまたはレート制限エラー
縮退復旧 (フォールバック)
ローカルGGUFモデルまたは定義済みキャラクター台詞へ即座に自動縮退復旧します
03

3. ローカル永続化 & 画面・音声リアクション

状態変更をSQLite WALへ安全に書き込み、デスクトップペットと音声合成へディスパッチします。

永続化ストア

SQLite WAL データベース

予定・タスク・習慣・ボスの知見をトランザクション安全に保存する永続化層。

アクター

デスクトップペット (Tkinter)

最前面透過ウィンドウでピクセルアニメーションと吹き出しを描画。

イベント

音声・SEシンセサイザー

8bitレトロ効果音とWeb Speech音声読み上げによるタスクナレーション。

System Architecture · Archify Edition

🏛️ 全体ランタイム・アーキテクチャ鳥瞰図

Archifyによる超高精細なシステム全体図です。ドラッグでパン移動、マウスホイールでズームできます。

⛶ 新しいタブで全画面表示 ↗
💡 主要コンポーネント詳細(タップで右スライド解説を開く):
Core Concepts

📚 押さえておくべきコア概念

🔒 ローカル完結・最小権限・承認必須

同一LAN内通信であっても全リクエストにBearer認証を要求し、外部クラウドリレーなしで完結させるセキュリティ設計。

📱 卓上承認リモコン (Desk Pet)

スマホを卓上常時点灯ディスプレイ化し、AIエージェントのコマンド実行許可をワンタップで遠隔承認できるPWA承認リモコン(Desk Pet)。

💾 SQLite WAL & 3層防衛

GUIとHTTPサーバー間のロック競合を防ぐ先行書き込みログと、自己承認禁止によるRCE遮断構造。