🔔
【核】遠隔承認リモコン
Claude Code/Cline等のコマンド承認をスマホでワンタップ。コーヒー片手にノールックで開発を進める本命コア。
モジュール構造 · 日本語完全版
ネオ秘書くん: 卓上Desk Pet ＆ AI統合ブリッジ Showcase
スマホのワンタップやAI完了イベントが、Zero-Trust認証・LangGraph推論・SQLite WALを経て画面・音声リアクションへ同期する流れを追跡します。
Product Vision · PO Layer
🎯 北極星（プロダクトの存在意義・Why）
「席を外してもAIコーディングが止まらない」。眠っていた古いスマホを卓上遠隔承認リモコン＆相棒ペットに転生させ、開発者の生命時間を最大化する。
Core Value Proposition
💎 確定したプロダクト三層構造（三位一体）
🐾
【魂】ドット絵ペット＆自作Mod
16-bitピクセルペットが画面で呼吸し達成感を共有。推しキャラ画像を置くだけで動く自由拡張Mod基盤。
📖
【床】手帳・習慣・iCal同期
承認リモコンを机上に常駐させるための日常の居場所。TickTickと競合せず、必要なTODO・習慣を静かに支える。
真実の梯子 (Truth Ladder)
まずはシンプルに。そして隅々まで誠実に。
デスク脇に座り、ボスの集中を見守り、AIコーディング完了をハイタッチで一緒に喜んでくれる手のひらサイズの相棒マスコット。
TkinterデスクトップオーバーレイとスマホPWAを、Zero-Trust Bearer認証・SQLite WAL・asyncioループで非ブロッキング結合した完全ローカル設計。
端末間同期は同一LANまたは暗号化Tailscaleメッシュ内で完結し、外部クラウドリレーへの依存やデータ漏洩は一切ありません。
モジュール構造
モジュール構成仕様
エントリーポイント
pwa-client
出力・リアクション
pc-mascot-ui
audio-feedback
参照ソース
local-server-srcmain-app-srcdatabase-srcシグナルトレース
システム内のデータの流れを追跡
トレース待機中（再生ボタンを押してください）
1. スマホPWA入力 ＆ Zero-Trust認証
スマホPWAから送信されたアクション要求を、ローカルPythonサーバーがBearerトークンで検証して受け付けます。
スマホ Desk Pet (PWA)
常時点灯の卓上スマートディスプレイ。8bitシンセ音とオフラインキャッシュを搭載。
同期サーバー (LocalSyncServer)
Bearerトークン認証とCORS隔離を強制する軽量HTTPデーモン。
- 影響範囲
- スマホからの遠隔操作が遮断されます
- 発生する症状
- サーバー側に HTTP 401 Unauthorized が記録されます
- 縮退復旧 (フォールバック)
- 設定画面のQRコードからペアリングトークンをワンタップ再発行します
2. LangGraph状態遷移 ＆ Agentログ監視
ユーザー入力や外部AI（Antigravity/Codex）のタスク完了を、UI描画スレッドをブロックせず非同期処理します。
Agent監視デーモン
外部AIエージェントのログ出力をリアルタイム監視し、完了歓喜や承認要請を発火。
LangGraph ＆ LLM Factory
Gemini/Claudeとオフライン用ローカルGGUFをシームレスに切り替える思考エンジン。
- 影響範囲
- クラウドAI推論が停止します
- 発生する症状
- 外部APIのタイムアウトまたはレート制限エラー
- 縮退復旧 (フォールバック)
- ローカルGGUFモデルまたは定義済みキャラクター台詞へ即座に自動縮退復旧します
3. ローカル永続化 ＆ 画面・音声リアクション
状態変更をSQLite WALへ安全に書き込み、デスクトップペットと音声合成へディスパッチします。
SQLite WAL データベース
予定・タスク・習慣・ボスの知見をトランザクション安全に保存する永続化層。
デスクトップペット (Tkinter)
最前面透過ウィンドウでピクセルアニメーションと吹き出しを描画。
音声・SEシンセサイザー
8bitレトロ効果音とWeb Speech音声読み上げによるタスクナレーション。
System Architecture · Archify Edition
🏛️ 全体ランタイム・アーキテクチャ鳥瞰図
Archifyによる超高精細なシステム全体図です。ドラッグでパン移動、マウスホイールでズームできます。
💡 主要コンポーネント詳細（タップで右スライド解説を開く）:
Core Concepts
📚 押さえておくべきコア概念
🔒 ローカル完結・最小権限・承認必須
同一LAN内通信であっても全リクエストにBearer認証を要求し、外部クラウドリレーなしで完結させるセキュリティ設計。
📱 卓上承認リモコン (Desk Pet)
スマホを卓上常時点灯ディスプレイ化し、AIエージェントのコマンド実行許可をワンタップで遠隔承認できるPWAコックピット。
💾 SQLite WAL & 3層防衛
GUIとHTTPサーバー間のロック競合を防ぐ先行書き込みログと、自己承認禁止によるRCE遮断構造。