ui-chan-mcp 0.5.0 → 0.5.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-chan",
   "displayName": "ういちゃんデスクトップマスコット",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "デスクトップマスコット「うい」を MCP で操作するプラグイン。吹き出し・表情・ポーズ・リップシンク・VoiSona Talk 音声合成に対応。セッション開始時にういちゃんの人格を自動読み込みする。"
 }

package/LICENSE

@@ -19,18 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
----
-
-このライセンスは **このリポジトリのソフトウェアにのみ** 適用されます。
-
-本プロジェクトは**非公式のファン制作物**であり、下記の権利者とは一切関係がありません。
-キャラクターを扱う以上、**二次創作のガイドラインおよび各利用規約は、この MIT ライセンスより
-優先されます**。公序良俗に反する利用、誹謗中傷、権利者の名誉・ブランドを毀損する利用、
-公式を騙る行為は固くお断りします。
-
-- 立ち絵素材「雨衣（うい）」（坂本アヒル様）はこのリポジトリに含まれておらず、
-  MIT ライセンスの対象ではありません。利用は雨衣キャラクターガイドライン
-  (https://www.ui-roid.com/guidelines/) の範囲で、各自が入手してください。
-- VoiSona Talk（テクノスピーチ社）も同梱していません。各自でインストールし、
-  同社の利用規約に従ってください。

package/NOTICE.md

@@ -0,0 +1,31 @@
+# 権利表記（NOTICE）
+
+> **本ソフトウェアが依存している、第三者の素材・製品についての表記です。**
+> MIT ライセンス（[LICENSE](LICENSE)）が適用されるのは、このリポジトリのソフトウェアだけです。
+
+---
+
+このライセンスは **このリポジトリのソフトウェアにのみ** 適用されます。
+
+本プロジェクトは**非公式のファン制作物**であり、下記の権利者とは一切関係がありません。
+キャラクターを扱う以上、**二次創作のガイドラインおよび各利用規約は、この MIT ライセンスより
+優先されます**。公序良俗に反する利用、誹謗中傷、権利者の名誉・ブランドを毀損する利用、
+公式を騙る行為は固くお断りします。
+
+- 立ち絵素材「雨衣（うい）」（坂本アヒル様）はこのリポジトリに含まれておらず、
+  MIT ライセンスの対象ではありません。利用は雨衣キャラクターガイドライン
+  (https://www.ui-roid.com/guidelines/) の範囲で、各自が入手してください。
+- VoiSona Talk（テクノスピーチ社）も同梱していません。各自でインストールし、
+  同社の利用規約に従ってください。
+
+---
+
+## 本プロジェクトの位置づけ
+
+本プロジェクトは**非公式のファン制作物**であり、上記の権利者とは一切関係がありません。
+キャラクターを扱う以上、**二次創作のガイドラインおよび各利用規約は MIT ライセンスより優先されます**。
+
+公序良俗に反する利用、特定の個人・団体への誹謗中傷、権利者の名誉・ブランドを毀損する利用、
+公式・公認を騙る行為は固くお断りします。
+
+詳細は [README.md](README.md#ライセンスと権利表記) を参照してください。

package/README.md

@@ -108,7 +108,8 @@ ui-chan
 | 🔊 | 声だけ止める（ミュート） |
 | ⊘ | いま喋ってるのを止める |
 | ♡ | どのくらい仲良しか見る・変える |
-| ⌂ | 定位置に戻して起き直す |
+| ⟳ | 起動しなおす（定位置にも戻る） |
+| ⬇ | 更新する（**更新があるときだけ出る**） |
 | ⏻ | 終了する（呼ばれても起きない） |
 
 <sub>複数のセッションから繋がってるときは、そこに一覧が出るよ（どのツールの、どのプロジェクトか）。
@@ -162,6 +163,7 @@ VoiSona Talk が起きてないか、REST API が有効になってないか、
 | 新しい表情を作りたい | [docs/CUE_AUTHORING.md](docs/CUE_AUTHORING.md) |
 | わたしの性格を変えたい | [docs/PERSONA.md](docs/PERSONA.md) |
 | **中のコードを直したい** | [docs/](docs/README.md) — 開発者向けの資料はこっちに全部ある |
+| 手伝ってくれるなら | [CONTRIBUTING.md](CONTRIBUTING.md) — 歓迎するもの／お断りするもの |
 
 ---
 
@@ -173,6 +175,7 @@ VoiSona Talk が起きてないか、REST API が有効になってないか、
 ### 本ソフトウェア
 
 MIT License（[LICENSE](LICENSE)）。Copyright (c) 2026 Uncle-Peke。
+第三者の素材・製品についての表記は [NOTICE.md](NOTICE.md) にもまとめてあります。
 
 MIT が適用されるのは**このリポジトリのコードと、同梱の設定・Cue 定義・ドキュメントのみ**です。
 以下の2つは同梱しておらず、MIT の対象外です。

package/dist/app/main.js

@@ -90,7 +90,10 @@ let nextAgentId = 1;
  *  every failure — "can't tell" and "up to date" look the same on screen, and
  *  neither is worth a warning. */
 function checkForUpdate() {
-    const child = (0, node_child_process_1.spawn)(process.execPath, [path.join(projectRoot, 'tools', 'setup', 'update-check.mjs'), projectRoot], { stdio: ['ignore', 'pipe', 'ignore'] });
+    // `process.execPath` は Electron 本体を指す（ここは Electron のメインプロセス）。
+    // それで .mjs を起動すると Electron がアプリとして立ち上がろうとして、
+    // 更新チェックは一度も成功しない。node を探すランチャ経由で起動する。
+    const child = (0, node_child_process_1.spawn)(path.join(projectRoot, 'bin', 'ui-chan-node'), [path.join(projectRoot, 'tools', 'setup', 'update-check.mjs'), projectRoot], { stdio: ['ignore', 'pipe', 'ignore'] });
     let out = '';
     child.stdout?.on('data', (d) => {
         out += d;
@@ -215,6 +218,18 @@ function handleDebug(_ws, req) {
                 state.onInteraction(action.kind ?? 'poke');
                 return { id: req.id, ok: true, result: { ok: true } };
             }
+            case 'panel': {
+                return { id: req.id, ok: true, result: panelAction(action.kind, action.value) };
+            }
+            case 'fake_update': {
+                sendToRenderer({
+                    type: 'update',
+                    available: action.available,
+                    behind: action.behind ?? 3,
+                    blocked: null,
+                });
+                return { id: req.id, ok: true, result: { ok: true } };
+            }
             default: {
                 return { id: req.id, ok: false, error: `unknown debug action` };
             }
@@ -368,14 +383,103 @@ function scheduleExitIfIdle() {
         electron_1.app.quit();
     }, sec * 1000);
 }
-function createWindow() {
+/** 定位置＝主ディスプレイの作業領域の右下。起動時とリセット時の両方が
+ *  ここを見るので、「起動し直さないと位置が戻らない」ということはない。 */
+function homePosition() {
     const { width, height, margin } = config.window;
     const wa = electron_1.screen.getPrimaryDisplay().workArea;
+    return { x: wa.x + wa.width - width - margin, y: wa.y + wa.height - height - margin };
+}
+/** パネルのボタンの実体。IPC からも、デバッグ用の WS アクションからも同じ
+ *  ものを呼ぶ——押した結果を確かめる方法が無いと、今回のように
+ *  「押したのに何も起きない」不具合を見つけられない。 */
+function panelAction(kind, value) {
+    switch (kind) {
+        case 'affinity':
+            // The panel is the only place a human can move affinity directly; the
+            // agent's own adjust_affinity stays direction+magnitude, so this can't
+            // be used to sneak past the asymmetric curve on her behalf.
+            if (typeof value === 'number')
+                state.setAffinity(value);
+            return state.affinitySnapshot();
+        case 'affinity:get':
+            return state.affinitySnapshot();
+        case 'mute':
+            muted = true;
+            return { muted };
+        case 'unmute':
+            muted = false;
+            return { muted };
+        case 'clear':
+            state.clear();
+            return { ok: true };
+        case 'restart':
+            electron_1.app.relaunch();
+            electron_1.app.quit();
+            return { ok: true };
+        case 'update': {
+            // 更新はこのプロセスが読んでいるファイルそのものを書き換えるので、
+            // 自分より長生きする子プロセスにやらせる（取得 → npm install →
+            // build → 起動しなおし）。
+            //
+            // ただし **投げっぱなしにはしない**。更新が無かった場合や失敗した
+            // 場合、子は何もせず終わるので、「着替えてくる」と言ったまま彼女が
+            // 戻ってこないように見える。結果を受け取って必ず言い直す。
+            const child = (0, node_child_process_1.spawn)(path.join(projectRoot, 'bin', 'ui-chan-node'), [path.join(projectRoot, 'bin', 'ui-chan.mjs'), 'update'], { detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
+            let out = '';
+            child.stdout?.on('data', (d) => {
+                out += d;
+            });
+            child.stderr?.on('data', (d) => {
+                out += d;
+            });
+            child.on('close', (code) => {
+                // 更新できた場合、子が stop → start するのでこの行には来ない
+                // （来たとしても、そのときは何も起きていない）。
+                // 理由は言わない。git が汚れているとか追跡先が無いとかは、使う人には
+                // 意味の無い話で、npm で入れた人には git の概念すら無い。**結果だけ**
+                // 言い、詳細は stderr へ落とす。
+                if (code === 0) {
+                    state.setCue({
+                        cue: 'emo_joy_lo',
+                        text: '更新するものなかったよ。',
+                        reading: 'こうしんするものなかったよ。',
+                    }, 'panel');
+                }
+                else {
+                    console.error(`[ui-chan] update failed:\n${out}`);
+                    state.setCue({
+                        cue: 'sys_awkward',
+                        text: 'うまく更新できなかった。',
+                        reading: 'うまくこうしんできなかった。',
+                    }, 'panel');
+                }
+            });
+            child.unref();
+            state.setCue({
+                cue: 'sys_think',
+                text: '着替えてくる。ちょっと待ってて。',
+                reading: 'きがえてくる。ちょっとまってて。',
+            }, 'panel');
+            return { ok: true };
+        }
+        case 'quit':
+            // Nothing to coordinate: a bridge only launches the app at its own
+            // startup, so quitting stays quit until a person starts her again.
+            electron_1.app.quit();
+            return { ok: true };
+        default:
+            return { ok: false };
+    }
+}
+function createWindow() {
+    const { width, height } = config.window;
+    const home = homePosition();
     win = new electron_1.BrowserWindow({
         width,
         height,
-        x: wa.x + wa.width - width - margin,
-        y: wa.y + wa.height - height - margin,
+        x: home.x,
+        y: home.y,
         transparent: true,
         frame: false,
         resizable: false,
@@ -417,52 +521,7 @@ else {
     /** The panel's buttons. Deliberately few and all reversible-or-obvious:
      *  anything destructive belongs in the CLI, not in a window that pops open
      *  on its own. */
-    electron_1.ipcMain.handle('ui-chan:panel-action', (_ev, kind, value) => {
-        switch (kind) {
-            case 'affinity':
-                // The panel is the only place a human can move affinity directly; the
-                // agent's own adjust_affinity stays direction+magnitude, so this can't
-                // be used to sneak past the asymmetric curve on her behalf.
-                if (typeof value === 'number')
-                    state.setAffinity(value);
-                return state.affinitySnapshot();
-            case 'affinity:get':
-                return state.affinitySnapshot();
-            case 'mute':
-                muted = true;
-                return { muted };
-            case 'unmute':
-                muted = false;
-                return { muted };
-            case 'clear':
-                state.clear();
-                return { ok: true };
-            case 'restart':
-                electron_1.app.relaunch();
-                electron_1.app.quit();
-                return { ok: true };
-            case 'update': {
-                // The update rewrites the very files this process is running from, so
-                // it happens in a detached child that outlives us: pull, npm install,
-                // build, then start the app again on the new build.
-                const child = (0, node_child_process_1.spawn)(path.join(projectRoot, 'bin', 'ui-chan-node'), [path.join(projectRoot, 'bin', 'ui-chan.mjs'), 'update'], { detached: true, stdio: 'ignore' });
-                child.unref();
-                state.setCue({
-                    cue: 'sys_think',
-                    text: '着替えてくる。ちょっと待ってて。',
-                    reading: 'きがえてくる。ちょっとまってて。',
-                }, 'panel');
-                return { ok: true };
-            }
-            case 'quit':
-                // Nothing to coordinate: a bridge only launches the app at its own
-                // startup, so quitting stays quit until a person starts her again.
-                electron_1.app.quit();
-                return { ok: true };
-            default:
-                return { ok: false };
-        }
-    });
+    electron_1.ipcMain.handle('ui-chan:panel-action', (_ev, kind, value) => panelAction(kind, value));
     electron_1.ipcMain.handle('ui-chan:get-init', () => {
         const psdFile = findPsd();
         return { config, psdAvailable: psdFile !== null, psdFile };

package/dist/renderer/bundle.js

@@ -17896,7 +17896,7 @@
             if (typeof res?.muted === "boolean") {
               muted = res.muted;
               btn.classList.toggle("on", muted);
-              btn.title = muted ? "\u58F0\u3092\u3082\u3069\u3059" : "\u3057\u305A\u304B\u306B\uFF08\u58F0\u3060\u3051\u6B62\u3081\u308B\uFF09";
+              btn.title = muted ? "\u58F0\u3092\u3082\u3069\u3059" : "\u58F0\u3060\u3051\u6B62\u3081\u308B";
             }
           });
         }

package/dist/renderer/index.html

@@ -235,44 +235,12 @@
       margin-top: 2px;
       letter-spacing: 0.02em;
     }
-    /* 操作はアイコン1行。文字を置かないぶん最も「アプリのUI」に見えにくく、
-       高さも1行で固定なので、接続が増えて縦に伸びる見え方を邪魔しない。
-       意味はすべて title（ツールチップ）で補う。 */
-    /* 好感度スライダー。歯車で開くまで存在しない（普段のパネルは「誰がいるか」
-       だけを答える場所で、設定はそのついでに触れればいい）。 */
-    #panel-affinity {
-      margin-top: 6px;
-      border-top: 1px solid rgba(78, 91, 181, 0.2);
-      padding: 6px 4px 2px;
-    }
-    #panel-affinity[hidden] {
-      display: none;
-    }
-    .aff-head {
-      display: flex;
-      align-items: baseline;
-      gap: 6px;
-      color: #6b6577;
-      font-size: 11px;
-    }
-    .aff-head b {
-      color: #2e2a35;
-      font-size: 13px;
-      margin-left: auto;
-    }
-    .aff-head small {
-      font-size: 10.5px;
-      color: #4e5bb5;
-    }
-    #aff-range {
-      width: 100%;
-      margin: 4px 0 0;
-      accent-color: #4e5bb5;
-    }
+    /* 操作はアイコン1行。文字を置かないぶん「アプリのUI」に見えにくく、
+       高さも固定なので、接続が増えて縦に伸びる見え方を邪魔しない。 */
     #panel-actions {
       display: flex;
+      justify-content: space-between;
       align-items: center;
-      gap: 2px;
       margin-top: 6px;
       border-top: 1px solid rgba(78, 91, 181, 0.2);
       padding-top: 6px;
@@ -283,8 +251,13 @@
       background: transparent;
       border: none;
       border-radius: 8px;
-      padding: 4px;
-      line-height: 0;
+      /* 当たり判定を全部そろえる。図形の大小で押しやすさが変わらないように */
+      width: 30px;
+      height: 26px;
+      padding: 0;
+      display: flex;
+      align-items: center;
+      justify-content: center;
       color: #4a4560;
     }
     #panel-actions button:hover {
@@ -296,31 +269,74 @@
       height: 17px;
       fill: none;
       stroke: currentColor;
-      stroke-width: 1.6;
+      stroke-width: 1.5;
       stroke-linecap: round;
       stroke-linejoin: round;
     }
-    /* ミュート中は「音が消えている」形（波→斜線）に変わり、色でも分かる。 */
+    /* ミュート中は「音が消えている」形（波→斜線）に変わり、色でも分かる。
+       詳細度が上がる順に並べる（下がる順だと、あとの規則が効かない事故を招く）。 */
     #panel-actions .i-slash {
       display: none;
     }
-    #panel-actions .i-fill {
-      fill: currentColor;
-      stroke: none;
-    }
     #panel-actions button.on {
       color: #4e5bb5;
       background: rgba(78, 91, 181, 0.16);
     }
-    #panel-gear.on svg path {
-      fill: currentColor;
-    }
     #panel-actions button.on .i-wave {
       display: none;
     }
     #panel-actions button.on .i-slash {
       display: inline;
     }
+    #panel-gear.on svg path {
+      fill: currentColor;
+    }
+    /* 終了だけは押し間違えると困るので、触れたときだけ赤くして手を止めさせる。 */
+    #panel-actions button[data-action='quit'] {
+      color: #8a8497;
+    }
+    #panel-actions button[data-action='quit']:hover {
+      color: #b4515e;
+      background: rgba(180, 81, 94, 0.12);
+    }
+    /* 更新は「あるときだけ」出す。常設すると平常時の情報がひとつ増える。 */
+    #panel-update[hidden] {
+      display: none;
+    }
+    #panel-update {
+      color: #4e5bb5;
+    }
+    /* 好感度スライダー。歯車で開くまで存在しない（普段のパネルは「誰がいるか」
+       だけを答える場所で、設定はそのついでに触れればいい）。 */
+    #panel-affinity {
+      margin-top: 6px;
+      border-top: 1px solid rgba(78, 91, 181, 0.2);
+      padding: 6px 4px 2px;
+    }
+    #panel-affinity[hidden] {
+      display: none;
+    }
+    .aff-head {
+      display: flex;
+      align-items: baseline;
+      gap: 6px;
+      color: #6b6577;
+      font-size: 11px;
+    }
+    .aff-head b {
+      color: #2e2a35;
+      font-size: 13px;
+      margin-left: auto;
+    }
+    .aff-head small {
+      font-size: 10.5px;
+      color: #4e5bb5;
+    }
+    #aff-range {
+      width: 100%;
+      margin: 4px 0 0;
+      accent-color: #4e5bb5;
+    }
     /* 更新の入口は「あるときだけ」出す。常設すると平常時の情報がひとつ増える。 */
     #panel-update[hidden] {
       display: none;
@@ -354,50 +370,46 @@
           <input id="aff-range" type="range" min="0" max="100" step="1" value="0" />
         </div>
         <div id="panel-actions">
-          <button type="button" data-action="mute" title="しずかに（声だけ止める）" aria-label="しずかに">
+          <!-- 並びは左から「よく押す → 設定 → 起き直す → 終了」。手が滑って隣を
+               押しても軽い操作にしか当たらないよう、終了は必ず右端。
+               「定位置に戻す」は独立したボタンにしない——再起動すれば位置は戻るし、
+               好感度は持ち越すので、再起動に副作用が無いから。
+               説明はブラウザ標準のツールチップ（title）に任せる。 -->
+          <button type="button" data-action="mute" title="声だけ止める" aria-label="声だけ止める">
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <path d="M4 8h3l4-3.5v11L7 12H4z" />
-              <path class="i-wave" d="M13.5 7.2a3.6 3.6 0 0 1 0 5.6" />
-              <path class="i-slash" d="M13.2 7.4l4.4 5.2M17.6 7.4l-4.4 5.2" />
+              <path d="M4.4 8h2.8L11 4.8v10.4L7.2 12H4.4z" />
+              <path class="i-wave" d="M13.6 7.4a3.4 3.4 0 0 1 0 5.2" />
+              <path class="i-slash" d="M13.4 7.6l4 4.8M17.4 7.6l-4 4.8" />
             </svg>
           </button>
-          <button type="button" data-action="clear" title="ひといき（いま喋っていることを止めて Idling に戻す）" aria-label="ひといき">
+          <button type="button" data-action="clear" title="いま喋っているのを止める" aria-label="喋るのをやめる">
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <!-- 丸に斜線（禁止・停止）。■ は ▶/⏸ と並んでいないと停止に
-                   見えず、単独ではただの四角になるため。 -->
-              <circle cx="10" cy="10" r="6.4" />
-              <path d="M5.5 14.5L14.5 5.5" />
+              <circle cx="10" cy="10" r="6.2" />
+              <path d="M5.6 14.4L14.4 5.6" />
             </svg>
           </button>
           <button type="button" id="panel-gear" title="好感度" aria-label="好感度">
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <!-- ハート。ここに入っているのは好感度だけなので、「設定」を名乗る
-                   歯車より、中身をそのまま指すほうが正直（設定が増えたら歯車に
-                   戻す）。 -->
-              <path d="M10 16.2S3.4 12.3 3.4 7.9a3.5 3.5 0 0 1 6.6-1.6 3.5 3.5 0 0 1 6.6 1.6c0 4.4-6.6 8.3-6.6 8.3z" />
+              <path d="M10 15.8S3.8 12.2 3.8 8.1a3.3 3.3 0 0 1 6.2-1.5 3.3 3.3 0 0 1 6.2 1.5c0 4.1-6.2 7.7-6.2 7.7z" />
             </svg>
           </button>
-          <button type="button" data-action="restart" title="リセット（定位置に戻して起動しなおす）" aria-label="リセット">
+          <button type="button" data-action="restart" title="起動しなおす（定位置に戻る）" aria-label="起動しなおす">
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <!-- 家＝定位置。再起動はウィンドウを作り直すので位置も既定に戻る
-                   （createWindow がワークエリアから毎回座標を計算する）。 -->
-              <path d="M3.4 9.3L10 3.6l6.6 5.7" />
-              <path d="M5.2 8.4v7.4h9.6V8.4" />
-              <path d="M8.4 15.8v-4.1h3.2v4.1" />
+              <path d="M16 7.6A6.4 6.4 0 1 0 16.3 12" />
+              <path d="M16.6 3.6v4.2h-4.2" />
             </svg>
           </button>
-          <button type="button" data-action="update" id="panel-update" title="更新があります（取得して入れ替える）" aria-label="更新" hidden>
+          <button type="button" data-action="update" id="panel-update" title="更新があります" aria-label="更新する" hidden>
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <!-- 下向き矢印＋受け皿。更新があるときだけ現れる6つ目。 -->
-              <path d="M10 3.4v8.4" />
-              <path d="M6.6 8.6L10 12l3.4-3.4" />
-              <path d="M4.2 14.2v1.4a1 1 0 0 0 1 1h9.6a1 1 0 0 0 1-1v-1.4" />
+              <path d="M10 4v7.6" />
+              <path d="M6.8 8.6L10 11.8l3.2-3.2" />
+              <path d="M4.6 14v1.2a1 1 0 0 0 1 1h8.8a1 1 0 0 0 1-1V14" />
             </svg>
           </button>
-          <button type="button" data-action="quit" title="おやすみ（終了。次に呼ばれても起きない）" aria-label="おやすみ">
+          <button type="button" data-action="quit" title="終了する（呼ばれても起きない）" aria-label="終了">
             <svg viewBox="0 0 20 20" aria-hidden="true">
-              <path d="M10 3.2v6.4" />
-              <path d="M6.2 5.6a6 6 0 1 0 7.6 0" />
+              <path d="M10 4v6" />
+              <path d="M6.4 6.2a5.6 5.6 0 1 0 7.2 0" />
             </svg>
           </button>
         </div>

package/docs/DEVELOPMENT.md

@@ -75,7 +75,28 @@ README に載せている画像もこれで撮っています。
 
 ---
 
-## `05` 変更が反映されるタイミング
+## `05` 環境変数
+
+すべて省略可能です。設定ファイル（`~/.ui-chan/config.json`）より**環境変数が優先**されます。
+
+| 変数 | 効果 |
+|---|---|
+| `UI_CHAN_TTS_USERNAME` / `UI_CHAN_TTS_PASSWORD` | VoiSona Talk の資格情報。通常は `~/.ui-chan/.env` に置きます |
+| `UI_CHAN_HOME` | ユーザーデータの場所（既定 `~/.ui-chan`） |
+| `UI_CHAN_PORT` | アプリが待ち受ける WebSocket ポート（既定 8123） |
+| `UI_CHAN_AGENT_NAME` | `get_state` に出るエージェント名。既定は MCP クライアントが名乗る名前 |
+| `UI_CHAN_NO_PERSONA_INSTRUCTIONS` | `1` で、MCP ハンドシェイクでの人格注入をやめる |
+| `UI_CHAN_NO_PERSONA_HOOK` | `1` で、SessionStart フックでの人格注入をやめる（アプリ起動はする） |
+| `UI_CHAN_OPENCODE_CONFIG` / `UI_CHAN_HERMES_CONFIG` | それぞれの設定ファイルの場所を上書き |
+| `HERMES_HOME` | Hermes Agent のホーム（既定 `~/.hermes`） |
+| `UI_CHAN_ROOT` | Hermes プラグインが ui-chan の場所を見つけるための上書き |
+
+<sub>以前は `.env.example` を同梱していましたが、`ui-chan` の対話セットアップが
+`~/.ui-chan/.env` を作って中身も書くようになったため、削除しました。</sub>
+
+---
+
+## `06` 変更が反映されるタイミング
 
 | 直したもの | 反映 |
 |---|---|
@@ -88,7 +109,7 @@ README に載せている画像もこれで撮っています。
 
 ---
 
-## `06` アーキテクチャ
+## `07` アーキテクチャ
 
 MCP サーバは薄いブリッジで、**状態はすべて Electron アプリ側に一元化**されています。
 複数のエージェントが同時に繋いでも状態が食い違いません。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-chan-mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "雨衣ちゃんMCP — デスクトップの隅に住む、AI の体になるマスコット（PSD立ち絵＋吹き出し＋音声。MCP で操作）",
   "main": "dist/app/main.js",
   "private": false,
@@ -59,10 +59,10 @@
     ".claude-plugin",
     "ui-chan.config.json",
     "cue.schema.json",
-    ".env.example",
     "docs",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE.md"
   ],
   "repository": {
     "type": "git",

package/plugins/hermes/ui-chan/plugin.yaml

@@ -1,5 +1,5 @@
 name: ui-chan
-version: 0.5.0
+version: 0.5.1
 description: デスクトップマスコット「うい」への自動リアクション（EventCue）。ツール失敗・サブエージェントの往復・セッション終了を、隣にいるういちゃんに伝える。
 provides_hooks:
   - pre_tool_call

package/tools/setup/check-package.mjs

@@ -16,6 +16,9 @@
 // This is now the *only* thing standing between a mistake and the registry:
 // the package is public, so `npm publish` will succeed unless this fails.
 import { execFileSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
 
 const FORBIDDEN = [
   { re: /\.psd$/i, why: '立ち絵PSD（二次配布禁止）' },
@@ -29,8 +32,46 @@ const FORBIDDEN = [
   { re: /voisona/i, why: 'VoiSona Talk 由来のファイル' },
 ];
 
-const out = execFileSync('npm', ['pack', '--dry-run', '--json'], { encoding: 'utf-8' });
-const files = JSON.parse(out)[0].files.map((f) => f.path);
+// **実際に tarball を作って、その中身を見る。**
+//
+// 以前は `npm pack --json` の出力を解釈していたが、環境差で二度こけた：
+// (1) `prepare`（ビルド）の出力が JSON の前後に混ざり、しかも npm の版で
+// stdout か stderr かが変わる。(2) npm 11 は `[{...}]`、npm 12 は
+// `{"名前": {...}}` と形そのものが変わる。どちらも「手元では通って CI で
+// だけ落ちる」壊れ方をした。
+//
+// この検査はライセンス素材の混入を止める最後の砦なので、npm の表示仕様に
+// 依存させない。tar が読める実体だけを見る。
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'ui-chan-pack-'));
+let files;
+try {
+  // --ignore-scripts: ビルドし直す必要はない（見たいのは、いまディスクに
+  // あるもののうち何が詰められるか）。--pack-destination: 作業ツリーを汚さない。
+  const packed = execFileSync('npm', ['pack', '--ignore-scripts', '--pack-destination', tmp], {
+    encoding: 'utf-8',
+    maxBuffer: 32 * 1024 * 1024,
+  });
+  const tgz = fs
+    .readdirSync(tmp)
+    .filter((f) => f.endsWith('.tgz'))
+    .map((f) => path.join(tmp, f))[0];
+  if (!tgz) {
+    console.error(`❌ tarball が作られませんでした:\n${packed}`);
+    process.exit(1);
+  }
+  // tar の一覧は "package/<パス>" 形式。ディレクトリ行（末尾 /）は捨てる。
+  files = execFileSync('tar', ['-tzf', tgz], { encoding: 'utf-8', maxBuffer: 32 * 1024 * 1024 })
+    .split('\n')
+    .filter((l) => l && !l.endsWith('/'))
+    .map((l) => l.replace(/^package\//, ''));
+} finally {
+  fs.rmSync(tmp, { recursive: true, force: true });
+}
+
+if (files.length === 0) {
+  console.error('❌ tarball の中身を読めませんでした。');
+  process.exit(1);
+}
 
 const hits = files.flatMap((path) => {
   const rule = FORBIDDEN.find((r) => r.re.test(path));

package/.env.example

@@ -1,13 +0,0 @@
-# Example environment variables for local development/debugging.
-# Copy this file to `.env` and fill in your VoiSona Talk credentials.
-# `.env` is gitignored so credentials never get committed.
-
-# VoiSona Talk REST API credentials (used by TTS synthesis)
-UI_CHAN_TTS_USERNAME=your_voisona_username
-UI_CHAN_TTS_PASSWORD=your_voisona_api_password
-
-# Optional: override the WebSocket port the display app listens on
-# UI_CHAN_PORT=8123
-
-# Optional: override the agent name reported in get_state
-# UI_CHAN_AGENT_NAME=debug