# シロネ Assistant v1.10.1

## v1.10.1の起動方法

- 通常版: `起動.cmd`
- 軽量版: `起動（軽量版）.cmd`

軽量版は常駐部分を.NET Framework製の46KB EXEへ移し、付箋・ToDo・設定・
クリップボード・AI連携を開いている間だけPowerShellを起動します。
実測の常駐プライベートメモリは約30.8MBです。

PC負荷はCPUとメモリを別々のバーで表示します。設定画面の「PC負荷の判定」で、
CPU注意／高負荷、メモリ注意／高負荷、監視間隔を個別に変更できます。
ToDoなどの別窓を常に手前へ出すかどうかも設定できます。

アニメーションは表示サイズに合わせた256pxのランタイム画像を使います。
実際に参照する画像容量を86.8MBから8.74MBへ削減し、見た目を維持したまま
読み込み・配布サイズを軽くしました。

銀髪ぱっつんミディアムショートのデスクトップ常駐キャラクターです。  
ショートカット検索、アプリ起動、付箋、ToDo、集中タイマーをまとめています。

## 起動と終了

1. `起動.cmd` をダブルクリックします。
2. シロネをクリックするか、`Ctrl + Alt + Space` で検索パネルを開きます。
3. 終了するときは、通知領域のシロネを右クリックして「終了」を選びます。

シロネ本体を右クリックすると、検索、極小モード、非表示、設定、終了を選べます。
「隠す」は検索フォーム内には表示しません。

起動しない場合は `起動（診断）.cmd` を実行してください。エラーは
`startup.log` に記録されます。

通常のアプリとして入れる場合は `Install.cmd` を実行します。管理者権限は不要で、
`%LOCALAPPDATA%\Programs\ShironeAssistant` とスタートメニューへ登録します。
削除はWindowsのアプリ一覧、または `Uninstall.cmd` から行えます。

## ショートカット検索

- Windows・Mac・Word・Excel・PowerPoint・Outlookに対応
- 入力途中から180ms間隔で候補を更新
- 使用中のOfficeアプリを優先
- お気に入り、履歴、キー表記のコピー
- 自分用ショートカットの追加、編集、上下移動、削除
- 独自ショートカットのJSON読み込み／書き出し

## 起動パネル

メインパネルの「起動」、通知領域、または `Ctrl + Alt + R` で開きます。

- アプリ、フォルダ、URL、コマンドを登録
- ファイル／フォルダ選択から登録
- 登録名、パス、検索ワードをメイン検索から部分一致検索
- お気に入りと最近使った順で表示
- 上部の実行欄はWindowsの `Win + R` に近い用途

実行例：

- `notepad`
- `calc`
- `https://example.com`
- `C:\作業フォルダ`
- `"C:\Program Files\App\App.exe" --option`

入力内容はシェル文字列として展開せず、実行ファイルと引数へ分けて起動します。

## 付箋とToDo

メインパネルまたは通知領域の「付箋・ToDo」から開きます。

- 付箋：自由入力、複数作成、フォーカスを外すと保存
- ToDo：Enterまたは追加ボタンで登録
- 期限日、通知時刻、毎日／毎週の繰り返し
- 10分スヌーズ、Windows通知、削除後のUndo
- 朝と夕方に1回だけ、残件数を短く振り返る
- 完了チェック、未完了件数、削除
- 本文はWindowsの現在ユーザー用暗号化でローカル保存

## クリップボード履歴

メイン画面または通知領域の「クリップボード履歴」から開きます。

- コピーしたテキストを新しい順に最大40件保存
- 履歴から再コピー、1件削除、全件削除
- 入力中検索、ピン留め、削除後のUndo
- 同じ内容の連続保存を防止
- 1件あたり最大4000文字、画像やファイルは取得しない
- 設定画面または履歴画面から機密モードへ切り替え
- 1～90日の自動削除期間と、除外するアプリのプロセス名を設定
- 本文はWindowsの現在ユーザー用暗号化でローカル保存

## 生活モーション

固定キャンバス上で状態別アンカーを固定し、動作に必要な枚数だけを使います。同じ絵を枚数合わせで連続登録しません。

- 通常待機：24フレーム。両足と胴体を固定し、まばたきと手振りを中割り
- 朝の散歩：24実フレーム。12キーポーズ＋12中間姿勢で、接地線、胴体、頭部を安定
- 昼間の勉強：8枚の完成ポーズを14ステップで往復。両足を固定して本・視線・まばたきだけを変更
- 昼休み：普段着で座り、おにぎりを食べる8枚の完成ポーズを14ステップで往復。クッション底面と骨盤を固定
- 3時のおやつ：24フレーム。クッション・座面・マグを固定して腕を中割り
- 夕方のくつろぎ：固定ソファ上の6姿勢を12ステップで往復。ヘッドホンで音楽を聴きながら、両手でスマホを操作
- 夜の睡眠：24フレーム。ベッド・枕・頭位置を固定した控えめな呼吸

夕方はソファを独立した固定レイヤーとして全フレームで再利用し、シロネだけをソファ基準へ整列した完成キーポーズへ切り替えます。歩行を含め、半透明の補間や二重手足、家具を動かす処理は使いません。
固定対象は時間帯ごとに分け、接地線、骨盤、座面、家具外周、枕を検査します。
着せ替え待機は脚を止め、胸と髪だけを2.4px以内で呼吸させます。

設定で「動かさない／控えめ／標準」と省電力を選べます。隠している間は
アニメーションタイマーも停止します。

## 着せ替えと表情

- 着せ替え：時間帯におまかせ、通常服、部屋着、パジャマ
- 表情：おまかせ、通常、笑顔、眠そう
- 設定画面から保存前に仮表示

時間帯におまかせでは、日中と昼休みは普段着、就寝前だけパジャマです。
散歩、おやつ、夕方のスマホ、睡眠中は専用モーションが優先されます。

## PC負荷モニター

- CPUとメモリ使用率を5秒間隔で表示
- 余裕／しっかり稼働／全力稼働の3段階
- 高負荷時も「全力でがんばってる！」という前向きな表示
- 高負荷が10秒続くと、端末を高速操作する18ステップの専用アニメーションへ切り替え
- 頭・胴体・足元を固定し、左右の手、まばたき、画面エフェクト、完了ポーズだけを変化
- 負荷が下がった状態が10秒続くと、現在の時間帯モーションへ自動復帰
- Windowsの軽量なネイティブ取得を使い、WMIの定期照会や追加プロセスは不使用
- アニメーション画像は表示用256pxで読み込み、最近使った26枚だけをキャッシュ

## Codex・Claude連携

メイン画面または通知領域の「AI連携」から開きます。

- インストール済みのCodex CLI／Claude Codeとバージョンを確認
- 作業フォルダと指示を渡し、対話型ターミナルを開く
- CLIだけを開く操作にも対応
- Codexは公式Usage画面を開き、残量を安全に確認
- Claudeは対話CLIを開いて正式な`/usage`をクリップボードへ準備
- シロネ経由で開いた当日の回数をローカル表示
- 権限確認を省略する危険モードは使用しない

残量そのものは独自推定しません。Codexは公式Usage画面、Claude Codeは
対話画面内の`/usage`を使います。Slash commandを初期プロンプトとして送信しないため、
残量確認だけのつもりでAIへ通常質問が送られることもありません。

## そのほか

- 25分／50分の集中タイマーと休憩案内
- コピー成功時などのリアクション
- 70%／85%／100%／115%のサイズ変更
- ドラッグ移動と位置保存
- 通知領域へ隠す、通知領域／ホットキーから復帰
- シロネを右クリックして完全非表示へ切り替え
- タスクバー直上へ状態・PC負荷・未完了ToDoだけを残す極小常駐モード
- 極小バーの「戻す」、左クリック、通知領域から通常表示へ復帰
- 表情・効果音・ボイスの個別オン／オフ
- Windowsログイン時の自動起動
- 基本機能はオフライン動作（AI連携だけ各CLIの通信を使用）
- ToDoの未完了件数をメイン画面と通知領域へ表示
- バッテリー、ネットワーク、システムドライブ空き容量を負荷表示のツールチップで確認

## データ保護と復旧

- 設定を一時ファイルへ書いてから置換する原子的保存
- 更新前ファイルを`.bak`へ残し、JSON破損時は自動復旧
- 付箋、ToDo、クリップボード、ランチャー、独自ショートカット、AI統計をDPAPIで暗号化
- 1日1回、直近7日分の自動バックアップ（クリップボード本文は既定で除外）
- 設定画面から手動バックアップ、復元、個人本文を含まない診断ZIPを作成
- `Apply-Update.cmd`へ更新ZIPをドラッグして適用。SHA-256を指定した検証にも対応

暗号化データとバックアップは、作成したWindowsユーザーでだけ復号できます。

## 画面デザイン

- ラベンダー、白、濃紺を基調にした共通テーマ
- 入力欄、ドロップダウン、チェック、タブ、ボタンを専用部品へ統一
- 入力中の項目を紫のフォーカス枠で表示
- メイン検索は空入力のまま「なんでも聞いてね。」と案内
- パネルを開いた直後のおすすめ回答は設定からオン／オフ可能
- おすすめ回答をオフにすると待機文と結果領域を消し、160px高のコンパクト表示
- 検索、おすすめ、お気に入り、最近、集中を開くと必要な高さへ自動復帰
- 検索OSは設定画面で選択し、メイン入力欄は横幅を広く確保
- 検索パネルは設定からキャラクターの上・下・左・右へ配置可能
- 結果表示は上配置なら上へ、下・左・右配置なら下へ展開
- セリフ吹き出しはフォーム、シロネ本体、PC負荷表示と重ならない候補位置へ自動退避
- 生活状態、CPU・メモリ負荷バーはキャラクターの下へ固定
- メイン機能は長いラベルの上段4列、短いラベルの下段5列で配置
- 空の一覧には次の操作が分かる案内カードを表示
- UI診断用プレビューには実際のクリップボード内容を含めない
- 初回ガイド、設定内検索、キーボード巡回、読み上げ用の操作名を追加
- Windows高コントラスト時はシステム配色へ切り替え、Per-Monitor DPI v2を要求
- 付箋は画面幅に応じて1列／2列を自動切り替え
- 長文の付箋とToDoはカード内で折り返し、操作ボタンと重ならない

## 保存場所

`%LOCALAPPDATA%\ShironeAssistant` 以下へ保存します。

- 設定：`settings.json`
- 独自ショートカット：`custom-shortcuts.json`
- アプリ・フォルダ登録：`launchers.json`
- 付箋・ToDo：`tasks.json`
- クリップボード履歴：`clipboard-history.json`

クリップボード履歴を有効にした場合だけ、コピーしたテキストを暗号化して保存します。
画像・ファイルは取得しません。除外アプリ判定では現在前面にあるプロセス名だけを参照し、
プロセス名自体は履歴へ保存しません。







