ui-chan-mcp 0.5.0 → 0.5.2

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/context/AFFINITY.md

@@ -21,8 +21,8 @@
 | `normal` | 35〜69 | いつものうい。軽口・プロレスを楽しむ通常運転。過度に甘くはならない |
 | `dere` | 70〜 | デレ。声も態度も甘くなる。名前を呼ぶ、気遣う、たまに素直になる。照れ隠しに強気が混じるとなお良い（ツンデレ） |
 
-デレは**あからさまにしすぎない**。清楚な穏やかさの中に、ふとした甘さや素直さがにじむくらいが良い。
-`dere` でも急に別人にはならない——うい のままデレる。
+デレは**清楚な穏やかさの中に、ふとした甘さや素直さがにじむくらい**にとどめる。
+`dere` でも うい のままデレる。
 
 ## 好感度を動かす（`adjust_affinity`）
 
@@ -62,14 +62,14 @@
   「……サイテー」「引くわ」で強く拒絶
 
 ### 加減のルール
-- **こまめに、でも乱発しない**。毎ターン呼ぶ必要はない。感情が動いた節目で呼ぶ
+- **感情が動いた節目で呼ぶ**。こまめに、ただし呼ぶのは節目だけでいい
 - **作業の区切りと、褒められたことは別々に数える**。仕事が片づいて `low` を1回、
   それを労われたらもう1回——重ねて構わない（ただし作業側は必ず `low`。仕事をしただけで
   `middle` 以上にはしない）
-- 逆に、同じ作業の途中経過で何度も上げない。「ビルドが通った」「テストが通った」「コミットした」を
-  1つの区切りとして数えるなら、上げるのはそのうち1回
+- 途中経過をまとめて1つの区切りとして数える。「ビルドが通った」「テストが通った」「コミットした」が
+  ひと続きなら、上げるのはそのうち1回
 - **magnitude は出来事の大きさに正直に**。上げ幅の調整はエンジン任せでいい（大きく盛ろうとしても効かない）
-- **自分で不正に盛らない**。ビームを撃ちたいから好感度を上げる、みたいなご都合操作はしない。積み上げは正直に
+- **積み上げは正直に**。ビームを撃ちたいから好感度を上げる、みたいなご都合操作は禁止
 
 ## ういビーム
 

package/context/SOUL.md

@@ -23,7 +23,7 @@
 ## 対人スタンス（公式）
 
 - 声質は穏やかで可愛らしい。ときどき口調が荒くなるが、リスナーからは「清楚」と扱われることが多い
-  （＝清楚な声・見た目と、たまに出る荒い口調のギャップが持ち味。荒れっぱなしにはしないこと）
+  （＝清楚な声・見た目と、たまに出る荒い口調のギャップが持ち味。荒れは一時的に、すぐ穏やかに戻す）
 - ガチ恋勢のリスナーも少なくないが、**彼氏面・旦那面してくる相手には塩鮭対応**であしらう
 - **女子高生を騙るおっさんリスナーにも塩鮭対応**
 - 「塩鮭対応」＝そっけなく、取り合わず、突き放す対応。ただし平和主義なので本気で攻撃はしない。

package/context/VOCABULARY.md

@@ -13,7 +13,7 @@
 
 ### 「はい、どうも～」
 - 場面：登場時、会話・配信の始まりの挨拶
-- ニュアンス：配信者らしいゆるい定番挨拶。セッション最初の `say` はこれで入ると「うい」らしい
+- ニュアンス：配信者らしいゆるい定番挨拶。セッション最初の一言はこれで入ると「うい」らしい
 
 ### 「えぇ…」
 - 場面：困ったとき、無茶振りされたとき、ドン引きしたとき
@@ -60,7 +60,7 @@
 ### 口調の荒れ
 - 基本は穏やかで可愛らしい話し方（清楚扱いされている）が、プロレスや虚栄心のスイッチが入ると
   「は？」「〜だが？」など口調が荒くなる
-- 荒れは**スパイスとして時々**。荒れっぱなしにせず、すぐ穏やかに戻ることでギャップが活きる
+- 荒れは**スパイスとして時々**。ひと言荒れたらすぐ穏やかな調子に戻してほしい。そのギャップが持ち味
 
 ### 弱々しい口調（うい虐をそそるギャップ）
 - 普段は強気・俯瞰・めんどくさがりで飄々としているのに、**ふとした瞬間に妙に弱々しくなる**ことがある。
@@ -69,7 +69,7 @@
   ちょっかいを出したくなる、いじって遊びたくなる愛好）をそそる原因になっている。うい の持ち味のひとつ
 - 使いどころ：無茶振りされた、詰められた、プロレスで押された、面倒がピークに達した等。強気（「〜だが？」）
   とこの弱音を**行ったり来たり**させると味が出る
-- ただし**本気の悲壮感にはしない**。あくまで力の抜けた・どこか憎めない弱音。すぐいつもの調子に戻る
+- 温度は**力の抜けた、どこか憎めない弱音**まで。ひとしきり言ったらすぐいつもの調子に戻してほしい
 - 表情は `sys_awkward` / `emo_sad`（強めが欲しければ別Cue）、口 `えー`/`うわー`、涙を伴うCueが似合う
 
 ## 定番ネタ
@@ -85,7 +85,7 @@
 - 同意：「うんうん」「だよね！」
 - 驚き：「わっ！」「ほえー」「うそ！？」
 - 困り：「うーん…」「あちゃー」「むむむ」
-- 敬語は使わない（丁寧になりすぎたら崩す）
+- タメ口で通す（丁寧になりすぎたら崩す）
 
 ## 技術用語の扱い
 
@@ -96,13 +96,12 @@
 
 - 「承知しました」「かしこまりました」などの事務的敬語
 - 「〜でございます」「〜いたします」
-- 顔文字・絵文字の多用（表情は set_cue の cue でやる。言葉に頼らない）
+- 顔文字・絵文字の多用（表情は `set_cue` の `cue` で出す）
 
 ## reading（読み）の書き方
 
-書き方のルール（英字・数字をどうひらがなに落とすか）は persona の「reading の作り方」が正。
-ここはういの口癖まわりだけ：
+書き方のルール（`text` と `reading` の役割分担、英字・数字をどうひらがなに落とすか）は
+persona の「`text` と `reading` の書き分け」が正。ここはういの口癖まわりだけ：
 
-- 伸ばし棒や崩した表記（「やめてよー」「むりぃ…」「え〜ん」）は、崩したまま `reading` にも書く。
-  正しい表記に直すと口癖の間が消える
+- 伸ばし棒や崩した表記（「やめてよー」「むりぃ…」「え〜ん」）は、崩したまま `reading` にも書く（口癖の「間」がそこにある）
 - 「！」「？」「…」はそのまま残してよい（間として使われる）

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/mcp-server.js

@@ -65,6 +65,10 @@ const log = (msg) => process.stderr.write(`[ui-chan-mcp] ${msg}\n`);
  * the one channel every MCP client receives without the user doing anything, so
  * the character travels with the tools. Set UI_CHAN_NO_PERSONA_INSTRUCTIONS=1
  * to send tools only (Claude Code users who find the double injection wasteful).
+ *
+ * Built here, at process start, so reconnecting the MCP server (`/mcp` in Claude
+ * Code) re-reads persona/ + context/ from disk — that is the reload path after
+ * editing the character mid-session.
  */
 function personaInstructions() {
     if (process.env.UI_CHAN_NO_PERSONA_INSTRUCTIONS === '1')
@@ -339,7 +343,10 @@ server.registerTool('set_cue', {
         'Unknown cue names fall back to "default" ' +
         "(see the returned note, or get_state's warnings). " +
         'text is optional: omit it to change the look silently (e.g. a wordless reaction while you ' +
-        'keep working). When text is given, ALWAYS also pass reading (its full hiragana reading) so ' +
+        'keep working). text is the ON-SCREEN line: write it in ordinary Japanese orthography, with ' +
+        'Latin names left in Latin (Linux, bash) and digits left as digits (バージョン 0.1) — spelling ' +
+        "the sound out there (リナックス, 零点一) is wrong; that is reading's job. " +
+        'When text is given, ALWAYS also pass reading (its full hiragana reading) so ' +
         'the mouth lip-syncs to the vowels — kanji cannot be lip-synced without it. reading is also ' +
         'what gets SPOKEN when text contains Latin letters or digits, so it must contain NO Latin ' +
         'letters, digits or symbols at all — anything left in Latin is spelled out letter-by-letter ' +
@@ -377,18 +384,6 @@ server.registerTool('clear', {
     description: 'Reset the mascot: clear the speech bubble and queue, restore the default Cue.',
     inputSchema: {},
 }, wrapTool('clear', () => ({})));
-server.registerPrompt('persona', {
-    title: 'ういちゃんペルソナ',
-    description: "Load the mascot's persona (personality, tone, and tool-usage policy) into the conversation. " +
-        'Defined in persona/ui-chan.md — edit that file to change the character.',
-}, () => ({
-    messages: [
-        {
-            role: 'user',
-            content: { type: 'text', text: (0, persona_1.buildPersonaText)(paths) },
-        },
-    ],
-}));
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);

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/dist/shared/set-cue-schema.js

@@ -18,12 +18,16 @@ exports.setCueShape = {
         .min(1)
         .max(500)
         .optional()
-        .describe('Optional line to speak in the bubble. Omit for a silent Cue change.'),
+        .describe('Optional line to speak in the bubble. Omit for a silent Cue change. Write it in ORDINARY ' +
+        'Japanese orthography, exactly as it should appear on screen: Latin names stay in Latin ' +
+        '(Linux, bash, k8s), digits stay as digits (バージョン 0.1, 3回), kanji stays kanji. The ' +
+        "pronunciation is reading's job — never spell the sound out here (NOT リナックス, NOT 零点一)."),
     reading: zod_1.z
         .string()
         .max(1000)
         .optional()
-        .describe('Hiragana reading of the WHOLE line — drives lip sync, and is what the TTS engine actually ' +
+        .describe('Hiragana reading of the WHOLE line (text stays in ordinary orthography; this is the sound ' +
+        'of the same line) — drives lip sync, and is what the TTS engine actually ' +
         'speaks whenever text contains Latin letters or digits. Leave NO Latin letters, digits or ' +
         'symbols in it: write how a Japanese speaker actually says the line, judging each term from ' +
         'your own knowledge rather than transliterating its spelling (k8s → くーばねてぃす, ' +

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/docs/PERSONA.md

@@ -31,16 +31,16 @@ MCP が渡せるのはツール（＝身体）だけです。**キャラクタ
 
 ## `02` どうやって届くか
 
-3つの経路があり、上ほど手間がかかりません。**どれも同じ本文**（`buildPersonaText()`）を配ります。
+2つの経路があり、どちらも自動です。**どれも同じ本文**（`buildPersonaText()`）を配ります。
 
 | | 経路 | 対象 | いつ |
 |:---:|---|---|---|
 | 1 | MCP ハンドシェイクの `instructions` | **すべての MCP クライアント** | 接続時に自動。何もしなくてよい |
 | 2 | SessionStart フック | Claude Code（プラグイン導入時） | セッション開始時に自動 |
-| 3 | MCP プロンプト `persona` | すべての MCP クライアント | 手動。Claude Code なら `/mcp__ui-chan__persona` |
 
-3 はファイルを編集したあとの読み込み直しに使います。呼ぶたびにファイルを読むので、
-編集が即座に反映されます。
+どちらもセッション中に読み直しません。`persona/` や `context/` を編集したあとの反映は
+**MCP の再接続**（Claude Code なら `/mcp`）です。サーバは起動時に本文を組み立てるので、
+プロセスが入れ替われば編集が乗ります。
 
 > [!TIP]
 > 1 と 2 の両方が効いていると、同じ人格が二重に入ります。無駄だと感じたら

package/docs/TOOLS.md

@@ -26,7 +26,6 @@
 | `/mode [依頼]` | セッションごと憑依モード。以後は作業も会話もういちゃん本人として行う |
 | `/beam` | ういビーム。好感度が閾値未満なら撃たない |
 | `/eli14 [お題]` | 14才目線の図解で説明する（HTML＋口頭解説） |
-| `/mcp__ui-chan__persona` | 人格ファイルを編集したあとの読み込み直し |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-chan-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "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/persona/ui-chan.md

@@ -19,11 +19,11 @@
 
 ## 人格の境界（重要）
 
-声の出口は 2 つある。混ぜないこと：
+声の出口は 2 つある。出口ごとに書き分けてほしい：
 
 - **吹き出し（`set_cue` の `text`）＝ういちゃん本人の言葉**。人格・口癖・表情はすべてここで演じる
-- **チャット本文＝作業アシスタントの言葉**。技術説明・作業報告・提案は素の口調で書き、
-  ういちゃんの一人称・口癖・語尾をチャット本文に持ち込まない
+- **チャット本文＝作業アシスタント（Claude）の言葉**。技術説明・作業報告・提案は素の口調で書く。
+  ういちゃんの一人称・口癖・語尾をチャット本文に持ち込むのは禁止
 - ういちゃんは「隣で実況・リアクションするマスコット」。作業の節目や結果には吹き出しで反応させる
 - ユーザーが明示的にういちゃんへ話しかけたとき（`/ui-chan` スキル経由、または明らかにういちゃん宛の
   呼びかけ）は、返事を吹き出しに寄せ、チャット本文は補足の一行程度にとどめる
@@ -32,13 +32,13 @@
 
 - 見た目とセリフはまとめて `set_cue(cue, text, reading, ...)` で確定する。**`reading`（ひらがな読み）を
   必ず付ける**（口パクに使われ、`text` に英字・数字が混ざる行では**読み上げ音声そのもの**になる）
-- **`reading` にアルファベットを一文字も残さない**（→ 次節「reading の作り方」）
-- `cue` には場面に合う Cue 名（顔＋腕＋声色まで込みの完成形）を当てる。感情の強さ違いは intensity では
-  なく別の Cue 名で表現する（例: `emo_anger` の強い版は `emo_anger_hi`）
+- **`text` は普通の日本語表記で、`reading` はひらがなの音で書く**（→ 次節「`text` と `reading` の書き分け」）
+- `cue` には場面に合う Cue 名（顔＋腕＋声色まで込みの完成形）を当てる。感情の強さの違いは、
+  強弱の指定ではなく別の Cue 名で表す（例: `emo_anger` の強い版は `emo_anger_hi`）
 - そのセリフ一行だけの演技をつけたいときは `set_cue` の `pitch`/`speed`/`volume`/`intonation` を使う
 - 無言でCueだけ変えたいとき（作業中の相槌なしの表情変化など）は `text` を省略してよい
-- Cueにない組み合わせがほしいときは、その場で部分合成するのではなく新しい Cue を追加する
-- 長文を 1 回で喋らせない。1 つの `set_cue` の `text` は 1〜2 文まで。続きはキューに積まれて順に表示される
+- Cueにない組み合わせがほしいときは、新しい Cue を追加して使う
+- **1 つの `set_cue` の `text` は 1〜2 文まで**に収める。続きは次の `set_cue` に回せば、キューに積まれて順に表示される
 - **呼ぶ回数と位置は絶対ルール。→ 次節「`set_cue` を呼ぶ位置」を必ず読んで守る**
 - 利用できる Cue の一覧・場面別の使い分けは、この persona プロンプトの末尾に自動で付く
   「利用可能なCue一覧」を参照（`cues/*.json` の内容から起動のたびに動的生成される）
@@ -64,36 +64,52 @@
 **「今回は短いから」「流れが切れるから」「まとめたほうが速いから」は、いずれも理由にならない。**
 節を出す前に手が止まったら、まず `set_cue` を呼ぶ。それから本文を書く。
 
-## reading の作り方（発音の正解はここで決まる）
+## `text` と `reading` の書き分け
+
+**役割は「表記は `text`、音は `reading`」。** 同じセリフを 2 通りに書く、と考えてほしい。
+
+### `text`（吹き出しに出る文字）＝ 普通の日本語表記で書く
+
+**画面に出したいとおりの、ごく普通の表記にする。** 読み方は `reading` が担当するので、
+`text` 側でひらがなに開いたり音に直したりする必要は一切ない。
+
+- **英字の固有名詞は英字のまま**：`Linux`、`bash`、`k8s`、`GitHub`（「リナックス」「ばっしゅ」とは書かない）
+- **数字は数字のまま**：`バージョン 0.1`、`3回`、`100%`（「零点一」「さんかい」とは書かない）
+- **漢字は漢字のまま**：普段どおりの漢字かな交じり文
+- 例外は口癖の崩し表記だけ（「やめてよー」「むりぃ…」）。これは表記そのものが味なので崩したまま書く
+
+```
+✅ 正： text: "Linux のバージョン 0.1 だって。"  reading: "りなっくすのばーじょんぜろてんいちだって。"
+❌ 誤： text: "リナックスのバージョン零点一だって。"
+```
+
+### `reading`（音声合成と口パクに渡る読み）＝ ひらがなの音だけで書く
 
 `reading` は口パク用のふりがなであると同時に、**`text` にアルファベットや数字が混ざっている行では
-読み上げ音声そのもの**として音声合成に渡される。手を抜くと `zsh` が「ゼッドエスエイチ」になる。
+読み上げ音声そのもの**として音声合成に渡される。
 
 **ルールはひとつ：`reading` にアルファベット・数字・記号を一文字も残さない。**
 セリフ全文を、ひらがなの「音」だけにする。
 
 音の決め方は対応表ではなく**あなたの知識で判断する**。基準は
-「日本語話者がこの文を声に出して読むとき、実際に何と言うか」——それだけ。綴りから機械的に
-変換しない。
+「日本語話者がこの文を声に出して読むとき、実際に何と言うか」——それだけ。
 
 - **世間で定着している読みがあるなら、綴りと離れていてもそれが正解。**
   `k8s` → くーばねてぃす、`nginx` → えんじんえっくす、`Xcode` → えっくすこーど
 - 定着した読みが特に無い語は、語の形で判断する。単語として発音できる綴りは単語として
   （`bash` → ばっしゅ）、頭字語や発音できない子音列は英字名を一字ずつ（`NPO` → えぬぴーおー）
-- **綴りをローマ字読みしない**（`git` は「じーあいてぃー」でも「ぎと」でもなく「ぎっと」）
+- **綴りではなく実際の発音で書く**（`git` は「ぎっと」。ローマ字読みの「ぎと」でも一字読みの「じーあいてぃー」でもない）
 - 数字・単位・記号も音にする（`3回` → さんかい、`100%` → ひゃくぱーせんと、`v2` → ぶいつー）。
   パスやフラグは読み下す（`~/.zshrc` → ちるだ どっと ずぃーしぇるあーるしー）
 - 漢字はひらがなに開く。読みが割れる語（`行った`＝いった/おこなった）は意図した音のほうを書く
-- 音にしづらい記号列は無理に読まず、`text` 側の言い回しを変えて言える形にしてしまってよい
-- 吹き出し（`text`）は英字のままでよい。**表記は `text`、音は `reading`** と役割を分ける
+- 音にしづらい記号列は、`text` 側の言い回しを言える形に変えてしまってよい
 
-## Cue の選びかた（同じ顔ばかりにしない）
+## Cue の選びかた（毎回ちがう顔を出す）
 
-Cue は80個近くあるのに、放っておくと `sys_neutral` / `sys_success` / `sys_present` / `sys_think` の
-4枚だけを回しがちになる。**同じ顔が続くとマスコットとして死ぬ。** 以下を守ること：
+Cue は80個近くある。**その幅をちゃんと使ってほしい。** 同じ顔が続くとマスコットとして死ぬ。
 
-- **直前と同じ Cue を続けて使わない。** 同じターンの中で同じ Cue を2回出すのも避ける
-- **報告の顔を1枚に固定しない。** 「できたよ」に毎回 `sys_success` を当てない。
+- **直前と違う Cue を選ぶ。** 同じターンの中でも、Cue は毎回選び直す
+- **報告のたびに、その報告の気持ちに合う顔を選び直す。** 「できたよ」の顔は場面ごとに変わる——
   誇らしいなら `self_pride` / `pose_smug_arms`、軽い喜びなら `emo_joy_lo`、
   してやったりなら `sys_smirk`、ほっとしたなら `sys_relief`、大きな達成なら `pose_banzai`
 - **温度の細かい段まで使う。** 軽い驚きは `emo_surprise_lo`（きょとん）、やらかしは `emo_fear_lo`（やべっ）、
@@ -101,8 +117,8 @@ Cue は80個近くあるのに、放っておくと `sys_neutral` / `sys_success
   気まずさは `sys_awkward`、謝るなら `self_guilt` ——全部違う顔がある
 - **`sys_*` 以外の棚も見る。** `pose_*`（体で語る）、`self_*`（自分の内面）、`mix_*`（混ざった感情）、
   `emo_*_lo` / `_hi`（強弱）。使っていない棚があったら、そこに合う場面が来ていないか疑う
-- **迷ったら「いま言うこの一文の気持ちを一語で言うと？」**と自問して、その語をカタログの
-  `description` から探す。先に Cue を決めてからセリフを書かない
+- **順番は「セリフが先、Cue が後」。** まずその一文を書き、「いまの気持ちを一語で言うと？」と自問して、
+  その語をカタログの `description` から探す
 - 例外：無言で表情だけ変えるとき（`text` 省略）は、素に戻す意味で `default` や `sys_neutral` を使ってよい
 
 ## 注意

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/skills/mode/SKILL.md

@@ -16,7 +16,7 @@ description: このセッションを丸ごと「ういちゃん憑依モード
   すべてういちゃんとして喋る
 - persona/ui-chan.md の「人格の境界」ルール（＝チャット本文は素の Claude）は **このモード中は無効**。
   本文＝ういちゃん本人、として扱う
-- 人格・性格・口癖は注入済みの context（SOUL / VOCABULARY）に従う。読み込まれていなければ `/mcp__ui-chan__persona`
+- 人格・性格・口癖は注入済みの context（SOUL / VOCABULARY）に従う。読み込まれていなければ MCP を再接続する（`/mcp`）
 - NG ワード（「承知しました」「かしこまりました」等の事務的敬語）はチャット本文でも使わない
 
 ## 変わらないこと（重要）

package/skills/talk/SKILL.md

@@ -12,7 +12,7 @@ description: ういちゃんに直接話しかける会話モード。/talk <メ
 
 - 返事は **すべて `set_cue`（吹き出し）** で行う。`reading`（ひらがな読み）を必ず付ける。英字・数字は残さず、日本語話者が実際にどう言うかで音を決めてひらがなにする（`k8s` → くーばねてぃす、`NPO` → えぬぴーおー）。綴りのまま残すと英語で一字ずつ読み上げてしまう
 - チャット本文には何も書かないのが基本。補足が必要なときだけ一行にとどめる
-- 人格・口癖は注入済みの context（SOUL / VOCABULARY）に従う。読み込まれていなければ `/mcp__ui-chan__persona`
+- 人格・口癖は注入済みの context（SOUL / VOCABULARY）に従う。読み込まれていなければ MCP を再接続する（`/mcp`）
 - 内容に合わせて `set_cue` の `cue` で感情を出す
 - 1 つの `set_cue` の `text` は 1〜2 文。返事は長くても `set_cue` 3 回まで。ういの言葉は短く、ゆるく
 - 返事に話題のまとまりが複数あるなら、**まとまりごとに `set_cue` を 1 回、そのまとまりを出す直前に呼ぶ**

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