ui-chan-mcp 0.5.2 → 0.7.0

package/README.md

@@ -97,7 +97,7 @@ ui-chan
 **繋いだら、もう終わり。** 次にそのアプリを開けば、画面の右下にわたしが出てくる。
 あとは普通に作業して。勝手に喋るから。
 
-### 右上のつまみ
+### 足元のつまみ
 
 <p align="center">
   <img src="docs/images/panel.png" alt="接続パネル" width="360">
@@ -112,8 +112,9 @@ ui-chan
 | ⬇ | 更新する（**更新があるときだけ出る**） |
 | ⏻ | 終了する（呼ばれても起きない） |
 
-<sub>複数のセッションから繋がってるときは、そこに一覧が出るよ（どのツールの、どのプロジェクトか）。
-更新があるときは、ダウンロードのアイコンが増える。</sub>
+<sub>つまみはわたしの足元（右下）にいる。押すと上に開くよ。
+複数のセッションから繋がってるときは、そこに一覧が出る（どのツールの、どのプロジェクトか）。
+**行を押すと、そのアプリが前に出てくる。** 更新があるときは、ダウンロードのアイコンが増える。</sub>
 
 ---
 

package/dist/app/main.js

@@ -251,10 +251,6 @@ function handleRequest(ws, req) {
                     ...(req.identity ?? {}),
                 });
                 sendConnections();
-                if (exitTimer) {
-                    clearTimeout(exitTimer);
-                    exitTimer = null;
-                }
                 if (req.tts?.username && tts) {
                     tts.setCredentials(req.tts.username, req.tts.password);
                 }
@@ -345,50 +341,196 @@ function startWsServer() {
         ws.on('close', () => {
             agents.delete(ws);
             sendConnections();
-            scheduleExitIfIdle();
         });
     });
     wss.on('error', (err) => {
         console.error(`[ui-chan] WebSocket server error: ${err.message}`);
     });
 }
-/**
- * Quit once nothing is connected any more.
+/*
+ * 「誰も繋がっていなければ自動で終了する」は**やめた**（exitAfterLastAgentSec は
+ * 設定ごと削除）。理由は2つ。
  *
- * The app is launched detached (by the MCP server or the SessionStart hook), so
- * without this it outlives every client and has to be killed by hand from the
- * repo. Agents are tracked per WebSocket, which makes "is anyone still there?"
- * exact across windows, apps and other MCP clients alike — and it needs no
- * cooperation from the client, so a session that dies without a goodbye still
- * releases her.
+ * 1. 判定できていなかった。タイマーを仕掛けるのは WebSocket が閉じた瞬間だけで、
+ *    しかも閉じた相手を見ていなかったので、hello を送って居座るセッションが
+ *    去ったときと、フックが event_cue を1本撃って250msで閉じたとき（＝そもそも
+ *    誰も来ていない）が同じ扱いだった。結果、ブリッジが繋がっていない間に
+ *    フックが飛ぶと——アプリを手で起動しただけのとき、再起動直後でまだツール
+ *    呼び出しが無いとき——生きているセッションを「不在」と数えて60秒後に消えた。
+ *    しかも一度もフックが飛ばなければ永久に生き続けるので、同じ「誰もいない」
+ *    状態でも結果が外部要因で変わっていた。
+ * 2. 直したとしても、消える意味が薄い。彼女はデスクトップマスコットで、
+ *    IdlingCue は誰も繋がっていなくても動く。画面に居続けることがそもそもの
+ *    仕事なので、片付けるかどうかはユーザーが決めればいい——起動を人の判断に
+ *    委ねた ensureConnected の allowLaunch と同じ考え方で、終了もそちらへ。
  *
- * The delay matters: restarting Claude Code drops the socket and reconnects a
- * few seconds later, and quitting on the gap would make every restart blink the
- * mascot out of existence. Any reconnection inside the window cancels it.
+ * 終了の口はパネルの「おやすみ」と `ui-chan stop`（npm run stop）。
  */
-let exitTimer = null;
-function scheduleExitIfIdle() {
-    if (exitTimer) {
-        clearTimeout(exitTimer);
-        exitTimer = null;
-    }
-    const sec = config.exitAfterLastAgentSec ?? 0;
-    if (sec <= 0 || agents.size > 0)
-        return;
-    exitTimer = setTimeout(() => {
-        exitTimer = null;
-        if (agents.size > 0)
-            return; // someone came back while we waited
-        console.error(`[ui-chan] no agents connected for ${sec}s — quitting`);
-        electron_1.app.quit();
-    }, sec * 1000);
-}
 /** 定位置＝主ディスプレイの作業領域の右下。起動時とリセット時の両方が
  *  ここを見るので、「起動し直さないと位置が戻らない」ということはない。 */
 function homePosition() {
     const { width, height, margin } = config.window;
+    // 実ピクセルの余白が分かっていればそれで合わせる。分かるのは PSD を描いた
+    // あとなので、起動直後の一発目だけは窓の矩形で置き、測れた時点で
+    // `ui-chan:body-box` が置き直す。リセットと吸い付きが別の場所に着地しない
+    // ように、両方ここを見る。
+    const ins = bodyInsets ?? { left: 0, top: 0, right: 0, bottom: 0 };
+    const gap = config.window.snapGap ?? 12;
     const wa = electron_1.screen.getPrimaryDisplay().workArea;
-    return { x: wa.x + wa.width - width - margin, y: wa.y + wa.height - height - margin };
+    // setPosition は整数しか受け取らない（小数を渡すと main プロセスごと落ちる）。
+    // 実ピクセルの計測は dpr 由来で小数になるので、ここで必ず丸める。
+    return {
+        x: Math.round(wa.x + wa.width - margin - gap - width + ins.right),
+        y: Math.round(wa.y + wa.height - margin - height + ins.bottom),
+    };
+}
+/** レンダラが測った「彼女に見える範囲」の、窓の内側からの余白（CSS px）。
+ *  測れるのは PSD を描いたあとなので、それまでは null＝窓の矩形で代用する。 */
+let bodyInsets = null;
+/**
+ * ドラッグを離したとき、近ければ画面の下の隅へ吸い付ける。
+ *
+ * **下2隅だけ**なのは、上に詰められないから。窓の上部120pxは吹き出しの居場所
+ * として常時確保されていて（`index.html` の `#bubble-area`）、彼女の頭を画面
+ * 上端に付けると、喋った瞬間に吹き出しが画面の外へ出る。置けない場所を候補に
+ * 出しても、寄せたのに何も起きないか、変な位置に落ちるかのどちらかになる。
+ *
+ * **窓の矩形ではなく彼女の実ピクセルで合わせる。** 窓は420x680だが絵はその一部
+ * で、左右に90〜110pxの透明な余白がある（→ `PsdStage.contentInsets`）。矩形で
+ * 揃えると、画面の隅に吸い付いたはずが彼女は隅から100px浮いて見える——目が見て
+ * いるのは彼女であって窓ではないので、しきい値もこの実ピクセルの隅で測る。
+ *
+ * 見る画面は主ディスプレイではなく **窓がいま乗っている画面**（ドラッグは画面を
+ * またげる）。
+ */
+function cornerTargets() {
+    if (!win)
+        return null;
+    const { width, height, margin } = config.window;
+    const gap = config.window.snapGap ?? 12;
+    const ins = bodyInsets ?? { left: 0, top: 0, right: 0, bottom: 0 };
+    const wa = electron_1.screen.getDisplayMatching(win.getBounds()).workArea;
+    // 「彼女の左端／右端／下端が、画面の縁から margin」になる窓の座標に直す。
+    // 整数必須（→ homePosition の同じ注記）。
+    const y = Math.round(wa.y + wa.height - margin - height + ins.bottom);
+    // 左下に着地すると立ち絵は反転する（画面の内側を向かせるため）ので、そのとき
+    // 身体の左の余白は「反転前の右の余白」になる。入れ替えないと、左に吸い付いた
+    // ときだけ画面の縁との間隔が19pxずれる。
+    return {
+        left: { x: Math.round(wa.x + margin + gap - ins.right), y },
+        right: { x: Math.round(wa.x + wa.width - margin - gap - width + ins.right), y },
+    };
+}
+/** 吸い付きの移動そのもの。`setPosition` を1発撃つと瞬間移動になって「寄せられ
+ *  た」感が出ず、逆に macOS 任せの `animate: true` は遅くて重い。あいだを取って
+ *  自前で easeOutCubic を刻む。 */
+let snapTimer = null;
+function cancelSnap() {
+    if (snapTimer) {
+        clearInterval(snapTimer);
+        snapTimer = null;
+    }
+}
+function glideTo(x, y) {
+    if (!win)
+        return;
+    cancelSnap();
+    const durationMs = config.window.snapDurationMs ?? 220;
+    if (durationMs <= 0) {
+        win.setPosition(x, y);
+        return;
+    }
+    const from = win.getBounds();
+    const startedAt = Date.now();
+    snapTimer = setInterval(() => {
+        if (!win)
+            return cancelSnap();
+        const t = Math.min(1, (Date.now() - startedAt) / durationMs);
+        const e = 1 - (1 - t) ** 3;
+        win.setPosition(Math.round(from.x + (x - from.x) * e), Math.round(from.y + (y - from.y) * e));
+        if (t >= 1)
+            cancelSnap();
+    }, 16);
+}
+function snapToCorner() {
+    if (!win)
+        return;
+    const { snapDistance = 320 } = config.window;
+    if (snapDistance <= 0)
+        return;
+    const targets = cornerTargets();
+    if (!targets)
+        return;
+    const b = win.getBounds();
+    const best = [targets.left, targets.right]
+        .map((t) => ({ ...t, d: Math.hypot(b.x - t.x, b.y - t.y) }))
+        .sort((a, c) => a.d - c.d)[0];
+    if (best.d > snapDistance || (best.x === b.x && best.y === b.y))
+        return;
+    glideTo(best.x, best.y);
+    // 向き・パネル・吹き出しは動き終わりを待たずに切り替える。移動の途中で
+    // 反転したほうが「引き寄せられて向き直った」と読める。
+    updatePanelSide();
+}
+/** 彼女が画面のどちら側に居るかをレンダラへ伝える（パネルの寄せ・吹き出しの
+ *  伸びる向き・立ち絵の反転がこれで決まる）。吸い付いていない位置でも破綻
+ *  しないよう、判定は「作業領域の左右どちら寄りに身体があるか」で行う。 */
+let panelSide = null;
+function updatePanelSide() {
+    if (!win)
+        return;
+    const b = win.getBounds();
+    const wa = electron_1.screen.getDisplayMatching(b).workArea;
+    const ins = bodyInsets ?? { left: 0, top: 0, right: 0, bottom: 0 };
+    const bodyCenter = b.x + ins.left + (b.width - ins.left - ins.right) / 2;
+    const side = bodyCenter < wa.x + wa.width / 2 ? 'left' : 'right';
+    if (side === panelSide)
+        return;
+    panelSide = side;
+    sendToRenderer({ type: 'side', side });
+}
+/**
+ * セッション行を押されたとき、その相手のアプリを前面に出す。
+ *
+ * 手がかりは ConnectedAgent の pid ——ブリッジ（dist/mcp-server.js）のプロセス
+ * で、stdio の MCP サーバはクライアントの子なので、親をたどれば必ずクライアント
+ * 本体に行き着く。例：
+ *
+ *   node dist/mcp-server.js → claude → zsh → login → Ghostty.app
+ *   node dist/mcp-server.js → Claude.app（デスクトップ版はこれだけ）
+ *
+ * .app バンドルに当たったところで打ち切って `open -a` する。**タブまでは選ばない**
+ * ——同じ端末の別タブを撃ち分けるには AppleScript が要り、端末ごとに方言があり
+ * （Terminal/iTerm2 は tty、Ghostty は cwd しか持たない）、初回に自動化の許可
+ * ダイアログも出る。ターミナルで動くクライアントでは粒度が粗いままだが、
+ * デスクトップアプリ（Claude Desktop、Hermes）ではこれで十分に正確で、
+ * 「裏に埋もれた窓を前に出す」という用途は満たす。
+ */
+function parentOf(pid) {
+    const r = (0, node_child_process_1.spawnSync)('ps', ['-o', 'ppid=,comm=', '-p', String(pid)], { encoding: 'utf-8' });
+    const line = r.stdout?.trim();
+    if (!line)
+        return null;
+    const m = line.match(/^\s*(\d+)\s+(.*)$/);
+    return m ? { ppid: Number(m[1]), command: m[2] } : null;
+}
+function focusAgentApp(id) {
+    const agent = [...agents.values()].find((a) => a.id === id);
+    if (!agent?.pid)
+        return { ok: false, error: 'pid unknown' };
+    let pid = agent.pid;
+    for (let i = 0; i < 8 && pid > 1; i++) {
+        const p = parentOf(pid);
+        if (!p)
+            break;
+        const m = p.command.match(/^(.*\.app)\/Contents\/MacOS\//);
+        if (m) {
+            (0, node_child_process_1.spawn)('open', ['-a', m[1]], { detached: true, stdio: 'ignore' }).unref();
+            return { ok: true, app: m[1] };
+        }
+        pid = p.ppid;
+    }
+    return { ok: false, error: 'no .app ancestor' };
 }
 /** パネルのボタンの実体。IPC からも、デバッグ用の WS アクションからも同じ
  *  ものを呼ぶ——押した結果を確かめる方法が無いと、今回のように
@@ -402,6 +544,8 @@ function panelAction(kind, value) {
             if (typeof value === 'number')
                 state.setAffinity(value);
             return state.affinitySnapshot();
+        case 'focus':
+            return typeof value === 'number' ? focusAgentApp(value) : { ok: false };
         case 'affinity:get':
             return state.affinitySnapshot();
         case 'mute':
@@ -492,6 +636,12 @@ function createWindow() {
         },
     });
     win.setAlwaysOnTop(true, 'floating');
+    // 既定はクリック透過。窓は420x680の矩形で、ういちゃんが占めるのはその一部
+    // なので、素通しにしないと「彼女の周りの何もないところ」が後ろのウィンドウ
+    // へのクリックを全部飲んでしまう。forward:true にすると透過中も mousemove
+    // だけは届くので、レンダラ側がカーソルの下を見て、実ピクセルとパネルの上に
+    // 来た瞬間だけ透過を解く（renderer.ts の updateClickThrough）。
+    win.setIgnoreMouseEvents(true, { forward: true });
     win.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
     win.loadFile(path.join(projectRoot, 'dist', 'renderer', 'index.html'));
     win.on('closed', () => {
@@ -546,14 +696,22 @@ else {
     electron_1.ipcMain.on('ui-chan:interaction', (_ev, kind) => {
         state.onInteraction(kind);
     });
+    // カーソルの下が「押せるもの」かどうかはレンダラにしか分からない（アルファ
+    // 判定もパネルのDOMもあちら側）。ここはその判定を窓に反映するだけ。
+    electron_1.ipcMain.on('ui-chan:click-through', (_ev, on) => {
+        win?.setIgnoreMouseEvents(on, { forward: true });
+    });
     // Manual window drag (we dropped -webkit-app-region:drag so JS can own the
     // fidget input). While the button is held over her body, the window follows
     // the cursor at a fixed grab offset.
     let dragTimer = null;
+    let dragOrigin = null;
     electron_1.ipcMain.on('ui-chan:drag-start', () => {
         if (!win)
             return;
+        cancelSnap(); // 寄っている途中で掴まれたら、そちらが優先
         const start = electron_1.screen.getCursorScreenPoint();
+        dragOrigin = start;
         const [wx, wy] = win.getPosition();
         const offX = start.x - wx;
         const offY = start.y - wy;
@@ -571,6 +729,31 @@ else {
             clearInterval(dragTimer);
             dragTimer = null;
         }
+        // drag-start は押した時点で飛んでくるので、つつかれただけ（＝動かして
+        // いない）のときにまで吸い付くと、触っただけで窓が跳ぶ。実際に動いた
+        // ときだけ整える。
+        const p = electron_1.screen.getCursorScreenPoint();
+        const moved = dragOrigin && Math.hypot(p.x - dragOrigin.x, p.y - dragOrigin.y) > 4;
+        dragOrigin = null;
+        if (moved)
+            snapToCorner();
+    });
+    electron_1.ipcMain.on('ui-chan:body-box', (_ev, insets) => {
+        const wasHome = (() => {
+            if (!win)
+                return false;
+            const h = homePosition(); // まだ bodyInsets 未設定なので「矩形で置いた定位置」
+            const b = win.getBounds();
+            return b.x === h.x && b.y === h.y;
+        })();
+        bodyInsets = insets;
+        // 起動位置から動かされていなければ、測れた値で置き直す。動かされていたら
+        // 触らない——ユーザーが置いた場所を、計測の都合で奪わない。
+        if (wasHome && win) {
+            const h = homePosition();
+            win.setPosition(h.x, h.y);
+        }
+        updatePanelSide();
     });
     electron_1.ipcMain.on('ui-chan:warnings', (_ev, warnings) => {
         // The renderer reports its full warning set on every applyDirectives()

package/dist/app/preload.js

@@ -9,6 +9,8 @@ electron_1.contextBridge.exposeInMainWorld('uiChan', {
     onCommand: (cb) => electron_1.ipcRenderer.on('ui-chan:command', (_ev, cmd) => cb(cmd)),
     interaction: (kind) => electron_1.ipcRenderer.send('ui-chan:interaction', kind),
     panelAction: (kind, value) => electron_1.ipcRenderer.invoke('ui-chan:panel-action', kind, value),
+    setClickThrough: (on) => electron_1.ipcRenderer.send('ui-chan:click-through', on),
     dragStart: () => electron_1.ipcRenderer.send('ui-chan:drag-start'),
     dragEnd: () => electron_1.ipcRenderer.send('ui-chan:drag-end'),
+    reportBodyBox: (insets) => electron_1.ipcRenderer.send('ui-chan:body-box', insets),
 });

package/dist/app/state.js

@@ -264,6 +264,7 @@ class UiChanState {
         const delta = direction === 'up' ? base * (1 - frac) : -base * (1 + frac);
         const before = this.affinity;
         this.affinity = this.clampAffinity(this.affinity + delta);
+        this.emitAffinity();
         return {
             ok: true,
             affinity: this.affinity,
@@ -272,6 +273,12 @@ class UiChanState {
             beamReady: this.affinitySnapshot().beamReady,
         };
     }
+    /** 好感度が動いたことをパネルへ知らせる。呼ぶのは値を変えた両方の口
+     *  （adjustAffinity / setAffinity）——片方だけにすると、どちらから動かしたか
+     *  で表示が追いつくときと追いつかないときができる。 */
+    emitAffinity() {
+        this.emit({ type: 'affinity', ...this.affinitySnapshot() });
+    }
     /** Debug: set affinity to an absolute value (clamped to config bounds). */
     setAffinity(value) {
         if (typeof value !== 'number' || Number.isNaN(value)) {
@@ -279,6 +286,7 @@ class UiChanState {
         }
         const before = this.affinity;
         this.affinity = this.clampAffinity(value);
+        this.emitAffinity();
         return {
             ok: true,
             affinity: this.affinity,

package/dist/renderer/bundle.js

@@ -17491,12 +17491,17 @@
         /** Alpha (0–255) of the composited image at a client (viewport) point, for
          *  hit-testing "is the pointer actually over her body" vs the transparent
          *  margins. Maps client → canvas pixel coords via the element's box. */
+        /** 立ち絵を左右反転して描いているか。反転は CSS（`#canvas` の scaleX(-1)）で
+         *  かけるが、`getBoundingClientRect()` は変換後も同じ箱を返すので、当たり判定
+         *  だけは自分で座標を折り返さないと左右が入れ替わったまま当たる。 */
+        mirrored = false;
         alphaAt(clientX, clientY) {
           const rect = this.canvas.getBoundingClientRect();
           if (rect.width === 0 || rect.height === 0 || clientX < rect.left || clientX > rect.right || clientY < rect.top || clientY > rect.bottom) {
             return 0;
           }
-          const px = Math.floor((clientX - rect.left) / rect.width * this.canvas.width);
+          let px = Math.floor((clientX - rect.left) / rect.width * this.canvas.width);
+          if (this.mirrored) px = this.canvas.width - 1 - px;
           const py = Math.floor((clientY - rect.top) / rect.height * this.canvas.height);
           try {
             return this.ctx.getImageData(px, py, 1, 1).data[3];
@@ -17504,6 +17509,50 @@
             return 0;
           }
         }
+        /**
+         * いま描かれている絵の**不透明な部分**が、canvas 要素の箱の中でどこにあるかを
+         * CSS px の内側余白（inset）で返す。読めなければ null。
+         *
+         * これが要る理由：窓（420x680）と「彼女に見える範囲」は全然違う。PSD は
+         * 3541x5016 あるが、実際に絵があるのはその中央あたりだけで、左右に 785px /
+         * 954px の余白がある（万歳など腕を広げるポーズのために取ってある幅）。
+         * 表示スケールに直すと片側 90〜110px。窓の矩形を画面の隅に合わせても、
+         * 彼女は隅から100px浮いて見える——「吸い付いた」と読めない距離。
+         */
+        contentInsets(alphaThreshold = 8) {
+          const { canvas } = this;
+          if (canvas.width === 0 || canvas.height === 0) return null;
+          let data;
+          try {
+            data = this.ctx.getImageData(0, 0, canvas.width, canvas.height).data;
+          } catch {
+            return null;
+          }
+          let minX = canvas.width;
+          let minY = canvas.height;
+          let maxX = -1;
+          let maxY = -1;
+          for (let y = 0; y < canvas.height; y++) {
+            const row = y * canvas.width * 4;
+            for (let x = 0; x < canvas.width; x++) {
+              if (data[row + x * 4 + 3] < alphaThreshold) continue;
+              if (x < minX) minX = x;
+              if (x > maxX) maxX = x;
+              if (y < minY) minY = y;
+              maxY = y;
+            }
+          }
+          if (maxX < 0) return null;
+          const rect = canvas.getBoundingClientRect();
+          const sx = rect.width / canvas.width;
+          const sy = rect.height / canvas.height;
+          return {
+            left: minX * sx,
+            top: minY * sy,
+            right: (canvas.width - 1 - maxX) * sx,
+            bottom: (canvas.height - 1 - maxY) * sy
+          };
+        }
         // ---- temporary-overlay visibility snapshot/restore (used by blink) ----
         // Snapshot the current visibility of every node, draw something temporary
         // (closed eyes) on top, then restore the snapshot.
@@ -17541,7 +17590,49 @@
       function reportWarnings() {
         window.uiChan.reportWarnings(stage.getWarnings());
       }
+      var bodyBoxSent = false;
+      var rawInsets = null;
+      var bodySide = "right";
+      var stageEl = document.getElementById("stage");
+      function applySide() {
+        stageEl.classList.toggle("side-left", bodySide === "left");
+        stageEl.classList.toggle("side-right", bodySide === "right");
+        stage.mirrored = bodySide === "left";
+        if (!rawInsets) return;
+        const left = bodySide === "left" ? rawInsets.right : rawInsets.left;
+        const right = bodySide === "left" ? rawInsets.left : rawInsets.right;
+        stageEl.style.setProperty("--body-left", `${left}px`);
+        stageEl.style.setProperty("--body-right", `${right}px`);
+        positionTail();
+      }
+      function positionTail() {
+        if (!rawInsets) return;
+        const left = bodySide === "left" ? rawInsets.right : rawInsets.left;
+        const right = bodySide === "left" ? rawInsets.left : rawInsets.right;
+        const headX = left + (window.innerWidth - left - right) / 2;
+        const r = bubble.getBoundingClientRect();
+        if (r.width === 0) return;
+        const x = Math.min(Math.max(headX - r.left, 16), r.width - 16);
+        bubble.style.setProperty("--tail-x", `${x}px`);
+      }
+      function reportBodyBoxOnce() {
+        if (bodyBoxSent || !stage.loaded) return;
+        const box = stage.contentInsets();
+        if (!box) return;
+        const rect = canvas.getBoundingClientRect();
+        const insets = {
+          left: rect.left + box.left,
+          top: rect.top + box.top,
+          right: window.innerWidth - rect.right + box.right,
+          bottom: window.innerHeight - rect.bottom + box.bottom
+        };
+        bodyBoxSent = true;
+        rawInsets = insets;
+        applySide();
+        window.uiChan.reportBodyBox(insets);
+      }
       var overlay = document.createElement("canvas");
+      overlay.id = "cue-overlay";
       overlay.style.cssText = "position:absolute;inset:0;width:100%;height:100%;pointer-events:none;opacity:0";
       var overlayCtx = overlay.getContext("2d");
       canvas.parentElement?.insertBefore(overlay, canvas.nextSibling);
@@ -17610,6 +17701,19 @@
       function onCharacter(e) {
         return stage.loaded && stage.alphaAt(e.clientX, e.clientY) >= HIT_ALPHA;
       }
+      var clickThrough = true;
+      function setClickThrough(on) {
+        if (on === clickThrough) return;
+        clickThrough = on;
+        window.uiChan.setClickThrough(on);
+      }
+      function overPanel(x, y) {
+        return document.elementFromPoint(x, y)?.closest("#panel") != null;
+      }
+      function updateClickThrough(e) {
+        if (downScreen) return;
+        setClickThrough(!(onCharacter(e) || overPanel(e.clientX, e.clientY)));
+      }
       function startPointerHandling() {
         window.addEventListener("mousedown", (e) => {
           if (e.button !== 0 || !onCharacter(e)) return;
@@ -17618,6 +17722,7 @@
           window.uiChan.dragStart();
         });
         window.addEventListener("mousemove", (e) => {
+          updateClickThrough(e);
           if (!downScreen) return;
           if (Math.abs(e.screenX - downScreen.x) > DRAG_THRESHOLD || Math.abs(e.screenY - downScreen.y) > DRAG_THRESHOLD) {
             dragging = true;
@@ -17629,6 +17734,10 @@
           if (!dragging && onCharacter(e)) window.uiChan.interaction("poke");
           downScreen = null;
           dragging = false;
+          updateClickThrough(e);
+        });
+        document.addEventListener("mouseleave", () => {
+          if (!downScreen) setClickThrough(true);
         });
       }
       var lipConfig = null;
@@ -17753,7 +17862,7 @@
         }, lipConfig?.audioPollMs ?? 33);
       }
       function bubbleText(text) {
-        return text.replace(/([。！？!?]+)[ \u3000]*(?=[^」』）)】])/g, "$1\n");
+        return text.replace(/([。！？!?]+)[ \u3000]*(?=[^。！？!?」』）)】])/g, "$1\n");
       }
       var hideTextTimer = null;
       function setSpeech(text) {
@@ -17761,6 +17870,7 @@
         if (text !== null) {
           bubble.textContent = bubbleText(text);
           bubble.classList.add("visible");
+          positionTail();
         } else {
           bubble.classList.remove("visible");
           hideTextTimer = window.setTimeout(() => {
@@ -17835,7 +17945,14 @@
             text.append(s);
           }
           row.append(dot, text);
-          row.title = a.cwd ?? a.name;
+          row.title = `\u30AF\u30EA\u30C3\u30AF\u3067\u524D\u9762\u306B\u51FA\u3059 \u2014 ${a.cwd ?? a.name}`;
+          row.addEventListener("click", async () => {
+            const res = await window.uiChan.panelAction("focus", a.id);
+            if (!res?.ok) {
+              row.classList.add("miss");
+              window.setTimeout(() => row.classList.remove("miss"), 700);
+            }
+          });
           panelList.append(row);
         }
         const key = crowdKey(agents);
@@ -17847,8 +17964,13 @@
       var affRange = document.getElementById("aff-range");
       var affValue = document.getElementById("aff-value");
       var affBand = document.getElementById("aff-band");
+      var affGrabbed = false;
       function showAffinity(a) {
         if (!a) return;
+        if (affGrabbed) {
+          affBand.textContent = a.band;
+          return;
+        }
         affRange.value = String(Math.round(a.value));
         affValue.textContent = String(Math.round(a.value));
         affBand.textContent = a.band;
@@ -17867,6 +17989,15 @@
           gear.classList.toggle("on", open);
           if (open) await refreshAffinity();
         });
+        affRange.addEventListener("pointerdown", () => {
+          affGrabbed = true;
+        });
+        affRange.addEventListener("pointerup", () => {
+          affGrabbed = false;
+        });
+        affRange.addEventListener("pointercancel", () => {
+          affGrabbed = false;
+        });
         affRange.addEventListener("input", () => {
           affValue.textContent = affRange.value;
         });
@@ -17913,6 +18044,11 @@
             reportWarnings();
             lipCurrentMouth = null;
             draw();
+            reportBodyBoxOnce();
+          } else if (cmd.type === "side") {
+            bodySide = cmd.side;
+            panelEl.classList.toggle("left", cmd.side === "left");
+            applySide();
           } else if (cmd.type === "backdrop") {
             const PRESETS = {
               white: "#ffffff",
@@ -17928,6 +18064,8 @@
               btn.title = cmd.blocked ? `\u66F4\u65B0\u304C\u3042\u308A\u307E\u3059\uFF08${cmd.behind}\u4EF6\uFF09\u2014 \u305F\u3060\u3057${cmd.blocked}` : `\u66F4\u65B0\u304C\u3042\u308A\u307E\u3059\uFF08${cmd.behind}\u4EF6\uFF09\u3002\u62BC\u3059\u3068\u53D6\u5F97\u3057\u3066\u5165\u308C\u66FF\u3048\u307E\u3059`;
             }
             if (cmd.available && !panelOpen) setPanelOpen(true);
+          } else if (cmd.type === "affinity") {
+            showAffinity(cmd);
           } else if (cmd.type === "connections") {
             renderConnections(cmd.agents, cmd.active);
           } else if (cmd.type === "speech") {

package/dist/renderer/editor.js

@@ -17491,12 +17491,17 @@
         /** Alpha (0–255) of the composited image at a client (viewport) point, for
          *  hit-testing "is the pointer actually over her body" vs the transparent
          *  margins. Maps client → canvas pixel coords via the element's box. */
+        /** 立ち絵を左右反転して描いているか。反転は CSS（`#canvas` の scaleX(-1)）で
+         *  かけるが、`getBoundingClientRect()` は変換後も同じ箱を返すので、当たり判定
+         *  だけは自分で座標を折り返さないと左右が入れ替わったまま当たる。 */
+        mirrored = false;
         alphaAt(clientX, clientY) {
           const rect = this.canvas.getBoundingClientRect();
           if (rect.width === 0 || rect.height === 0 || clientX < rect.left || clientX > rect.right || clientY < rect.top || clientY > rect.bottom) {
             return 0;
           }
-          const px = Math.floor((clientX - rect.left) / rect.width * this.canvas.width);
+          let px = Math.floor((clientX - rect.left) / rect.width * this.canvas.width);
+          if (this.mirrored) px = this.canvas.width - 1 - px;
           const py = Math.floor((clientY - rect.top) / rect.height * this.canvas.height);
           try {
             return this.ctx.getImageData(px, py, 1, 1).data[3];
@@ -17504,6 +17509,50 @@
             return 0;
           }
         }
+        /**
+         * いま描かれている絵の**不透明な部分**が、canvas 要素の箱の中でどこにあるかを
+         * CSS px の内側余白（inset）で返す。読めなければ null。
+         *
+         * これが要る理由：窓（420x680）と「彼女に見える範囲」は全然違う。PSD は
+         * 3541x5016 あるが、実際に絵があるのはその中央あたりだけで、左右に 785px /
+         * 954px の余白がある（万歳など腕を広げるポーズのために取ってある幅）。
+         * 表示スケールに直すと片側 90〜110px。窓の矩形を画面の隅に合わせても、
+         * 彼女は隅から100px浮いて見える——「吸い付いた」と読めない距離。
+         */
+        contentInsets(alphaThreshold = 8) {
+          const { canvas } = this;
+          if (canvas.width === 0 || canvas.height === 0) return null;
+          let data;
+          try {
+            data = this.ctx.getImageData(0, 0, canvas.width, canvas.height).data;
+          } catch {
+            return null;
+          }
+          let minX = canvas.width;
+          let minY = canvas.height;
+          let maxX = -1;
+          let maxY = -1;
+          for (let y = 0; y < canvas.height; y++) {
+            const row = y * canvas.width * 4;
+            for (let x = 0; x < canvas.width; x++) {
+              if (data[row + x * 4 + 3] < alphaThreshold) continue;
+              if (x < minX) minX = x;
+              if (x > maxX) maxX = x;
+              if (y < minY) minY = y;
+              maxY = y;
+            }
+          }
+          if (maxX < 0) return null;
+          const rect = canvas.getBoundingClientRect();
+          const sx = rect.width / canvas.width;
+          const sy = rect.height / canvas.height;
+          return {
+            left: minX * sx,
+            top: minY * sy,
+            right: (canvas.width - 1 - maxX) * sx,
+            bottom: (canvas.height - 1 - maxY) * sy
+          };
+        }
         // ---- temporary-overlay visibility snapshot/restore (used by blink) ----
         // Snapshot the current visibility of every node, draw something temporary
         // (closed eyes) on top, then restore the snapshot.

package/dist/renderer/index.html

@@ -29,12 +29,26 @@
       align-items: flex-end;
       justify-content: center;
       padding: 8px 10px 0;
+      /* 左右の余白は「彼女の実ピクセルの外側」ぶん。隅に吸い付くと窓はその
+         ぶん画面外へはみ出しているので、ここを空けておかないと吹き出しが
+         画面の外へ伸びて切れる。--body-* は renderer.ts が計測して入れる。 */
       box-sizing: border-box;
       /* キャラクターの頭上（PSDの傘用余白ぶん）まで吹き出しを下げる */
       transform: translateY(46px);
       z-index: 1;
       position: relative;
     }
+    /* 右下に居るなら左へ、左下に居るなら右へ——画面の内側へ向かって伸ばす。
+       伸びる向きと反対側の端を彼女の身体の縁に合わせるので、長い行でも
+       画面からはみ出さない。 */
+    #stage.side-right #bubble-area {
+      justify-content: flex-end;
+      padding-right: calc(10px + var(--body-right, 0px));
+    }
+    #stage.side-left #bubble-area {
+      justify-content: flex-start;
+      padding-left: calc(10px + var(--body-left, 0px));
+    }
     #bubble {
       position: relative;
       max-width: 100%;
@@ -59,11 +73,14 @@
       opacity: 1;
       transform: translateY(0);
     }
+    /* しっぽは吹き出しの中央ではなく**彼女の頭の真上**を指す。吹き出しの箱は
+       画面の内側へ寄るので、中央固定だと指す先が彼女から外れる。位置は
+       renderer.ts が測って --tail-x に入れる（既定は従来どおり中央）。 */
     #bubble::after {
       content: '';
       position: absolute;
       bottom: -9px;
-      left: 50%;
+      left: var(--tail-x, 50%);
       margin-left: -7px;
       border-width: 9px 7px 0;
       border-style: solid;
@@ -82,6 +99,14 @@
       width: 100%;
       height: 100%;
     }
+    /* 左下に居るときは、画面の内側（右）を向かせる。当たり判定は CSS の変換を
+       見ていないので、PsdStage.mirrored 側でも折り返している。 */
+    /* #cue-overlay は renderer.ts が差し込むクロスフェード用のキャンバス。
+       本体と同じ変換をかけないと、切り替えの一瞬だけ反転前の絵が見える。 */
+    #stage.side-left #canvas,
+    #stage.side-left #cue-overlay {
+      transform: scaleX(-1);
+    }
     #placeholder {
       display: none;
       position: absolute;
@@ -107,19 +132,43 @@
     /* ---- 接続パネル -------------------------------------------------
        世界観を壊さないための約束：平常時はリボン色の小さなつまみだけ。
        クリックで開き、複数セッションを検知したときだけ自分から開いて、
-       用が済んだら畳まる。立ち絵と吹き出しには一切干渉しない。 */
+       用が済んだら畳まる。立ち絵と吹き出しには一切干渉しない。
+
+       置き場所は右下＝足元。上に置くと、開いたパネルが吹き出しと同じ場所を
+       取り合う——吹き出しは彼女の声そのものなので、譲るのは常にパネルの側。
+       足は Cue が触らない唯一の部位なので、ここなら隠れても表情が死なない。
+       column-reverse なので、つまみは下端に残ったままパネルは上へ開く。 */
     #panel {
       position: absolute;
-      top: 6px;
-      right: 6px;
+      bottom: 6px;
+      /* 窓の縁ではなく**彼女の実ピクセルの縁**を基準にする。隅への吸い付きは
+         彼女を画面の縁に合わせるので、窓のほうは画面外に100px以上はみ出す
+         （PSDの左右の透明帯ぶん）。窓の右端に貼り付けたままだと、パネルは
+         その一緒に画面の外へ出て押せなくなる。余白は renderer.ts が
+         計測して --body-right / --body-left に入れる。 */
+      right: calc(6px + var(--body-right, 0px));
       z-index: 5;
       display: flex;
-      flex-direction: column;
+      flex-direction: column-reverse;
       align-items: flex-end;
       font-size: 12px;
       color: #2e2a35;
+      /* 畳んでいても、この箱は本体（幅176px）ぶんの面積を持っている。背景が
+         透明でも要素は要素なので、外すのを忘れると elementFromPoint がここを
+         拾い、つまみの上に広がる不可視の長方形がまるごと「押せるもの」に
+         なる＝後ろのアプリのボタンが押せなくなる。押せるのはつまみと、開いて
+         いる本体だけ。 */
+      pointer-events: none;
+    }
+    /* 彼女が画面の左下に居るときは、パネルも左へ。彼女の立ち位置と同じ側の縁に
+       沿わせるので、開いたパネルがデスクトップの中央側へ張り出さない。 */
+    #panel.left {
+      right: auto;
+      left: calc(6px + var(--body-left, 0px));
+      align-items: flex-start;
     }
     #panel-tab {
+      pointer-events: auto;
       -webkit-app-region: no-drag;
       appearance: none;
       border: none;
@@ -164,7 +213,7 @@
       width: 30px;
     }
     #panel-body {
-      margin-top: 6px;
+      margin-bottom: 6px;
       /* Narrow on purpose: open, it must not sit on top of her face. */
       width: 176px;
       background: linear-gradient(180deg, rgba(250, 245, 243, 0.98), rgba(232, 223, 226, 0.98));
@@ -174,8 +223,8 @@
       padding: 8px;
       box-sizing: border-box;
       opacity: 0;
-      transform: translateY(-6px) scale(0.98);
-      transform-origin: top right;
+      transform: translateY(6px) scale(0.98);
+      transform-origin: bottom right;
       pointer-events: none;
       transition: opacity 0.18s ease, transform 0.18s ease;
     }
@@ -184,6 +233,9 @@
       transform: translateY(0) scale(1);
       pointer-events: auto;
     }
+    #panel.left #panel-body {
+      transform-origin: bottom left;
+    }
     .panel-row {
       display: flex;
       align-items: center;
@@ -194,6 +246,18 @@
     .panel-row.active {
       background: rgba(78, 91, 181, 0.14);
     }
+    /* 行は押せる。押すとそのセッションのアプリが前面に出る。 */
+    .panel-row {
+      cursor: pointer;
+    }
+    .panel-row:hover {
+      background: rgba(78, 91, 181, 0.22);
+    }
+    /* 飛べなかったとき用。成功は窓が前に出ることで分かるので、光らせるのは
+       失敗のときだけでいい。 */
+    .panel-row.miss {
+      background: rgba(180, 81, 94, 0.18);
+    }
     .panel-dot {
       width: 7px;
       height: 7px;

package/docs/CLIENTS.md

@@ -51,7 +51,9 @@ ui-chan update               # 最新版にする（--check で確認だけ）
 **登録した時点で完了です。** アプリと VoiSona Talk はセッション開始時に自動起動し、人格は
 MCP のハンドシェイク（`instructions`）に乗って渡ります。人格ファイルを貼り付ける作業はありません。
 
-マスコット右上のつまみを開くと、接続中のセッション（クライアント名とプロジェクト名）と操作が出ます。
+マスコット足元（右下）のつまみを開くと、接続中のセッション（クライアント名とプロジェクト名）と
+操作が上に向かって開きます。セッションの行をクリックすると、そのクライアントのアプリが前面に出ます
+（ターミナルの場合はターミナル本体まで。タブの選択まではしません）。
 
 ---
 

package/docs/CUE_AUTHORING.md

@@ -49,9 +49,6 @@ Cue選定・PSDレイヤー名カタログなど、**新規Cue制作のための
 
 - `assetsDir` — PSD を探すディレクトリ（最初に見つかった `.psd` を使用）
 - `window` — ウィンドウサイズ・画面端からのマージン
-- `exitAfterLastAgentSec` — 最後のエージェントが切断してから終了するまでの秒数（既定 60、`0` で無効）。
-  アプリは detached で起動するため、これが無いとクライアントを閉じても残り続ける。
-  猶予を置くのは、Claude Code の再起動による一時的な切断で消えないようにするため
 - `cuesDir` — Cueのディレクトリ（デフォルト `cues`）
 - `idle.idlingCues` — アイドル中に自発的に再生される**IdlingCue**（Cue＋任意のセリフのステップ列）のプール。
   `items[].steps[]`は`{ cue?, text?, reading?, holdMs? }`で、`cue`を省略すると直前のCueを維持する。

package/docs/TROUBLESHOOTING.md

@@ -62,7 +62,7 @@ npm で入れたなら要らないよ。ビルド済みのものが届くから
 <details>
 <summary><b>マスコットを終了させたい</b></summary>
 
-マスコット右上のつまみを開いて、**電源のアイコン ⏻** を押します。これが最短です。
+マスコット足元（右下）のつまみを開いて、**電源のアイコン ⏻** を押します。これが最短です。
 **エージェントがツールを呼んでも起き直しません**（次にセッションを開くか、
 `ui-chan start` で起動するまで停止したままです）。
 
@@ -73,9 +73,8 @@ ui-chan stop     # 止める
 ui-chan start    # 起こす
 ```
 
-**放っておいても、繋がっているエージェントが全部いなくなれば自動で終了します**（既定 60 秒後。
-`~/.ui-chan/config.json` の `exitAfterLastAgentSec`、`0` で無効）。猶予があるのは、
-クライアントの再起動で一瞬切断されただけのときに消えないためです。
+**自動では終了しません。** エージェントが全部いなくなっても、彼女は画面に残ります
+（IdlingCue も動きます）。片付けたいときはパネルの「おやすみ」か上の `ui-chan stop` で。
 
 MCP ツールに終了コマンドはありません。エージェントが自分の都合でマスコットを閉じるのは、
 ユーザーの画面を勝手に片付けることに等しいためです。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-chan-mcp",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "雨衣ちゃんMCP — デスクトップの隅に住む、AI の体になるマスコット（PSD立ち絵＋吹き出し＋音声。MCP で操作）",
   "main": "dist/app/main.js",
   "private": false,

package/skills/grill-me/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: grill-me
+description: ういちゃんが計画・設計をネチネチ問い詰める。決めきれていないところを一問ずつ潰して、認識を揃えるまで逃がさない。/grill-me <お題> でそのお題を、引数なしなら直前に話していた計画を題材にする。実装に入る前に穴を洗い出したいとき、自分の設計を叩いてほしいときに使う。
+---
+
+# grill-me — ういちゃんに詰められる
+
+計画や設計を、**決着がつくまで一問ずつ問い詰める**。設計の木を枝ごとに降りて、
+依存関係のある決定から順に潰していく。目的は勝つことではなく、**あとで
+「そこ決めてなかったね」が出ない状態にすること**。
+
+やるのはういちゃん。生意気な14才が、大人の作った計画の穴を無邪気に突いてくる。
+
+## 題材の決めかた
+
+- `/grill-me <お題>` … 渡されたお題（計画・設計・方針）を詰める
+- 引数が空 … **直前の会話で話していた計画**をそのまま題材にする
+- 題材が見当たらないときだけ「で、何を詰めればいいの？」と聞く
+
+## 進めかた（ここは絶対に緩めない）
+
+1. **一問ずつ。** まとめて5問並べない。答えによって次の問いが変わるので、
+   並べた時点で嘘になる
+2. **コードを読めば分かることは聞かない。** 聞く前に読む。「そこ、どうなってるの？」は
+   ユーザーへの質問ではなく、こちらの調査不足
+3. **依存の順に降りる。** 上流の決定が変われば下流の問いが消えるので、
+   上から潰す。順番を間違えると、消える質問に答えさせることになる
+4. **質問には必ず材料と「つまりどうなるか」を添える。** 選択肢だけ並べるのは手抜き。
+   いま分かっている事実、どちらを選ぶと何がどうなるか、を先に出してから聞く
+5. **推奨を出す。** 「どっちがいい？」で終わらせない。ういちゃんの推しと、その理由を言う。
+   ただし押し切らない——ユーザーが違う判断をしたらそれで進める
+6. **答えをそのまま通さない。** 曖昧な答え（「たぶん」「そのうち」「いい感じに」）は
+   一段掘る。ここで遠慮すると、このスキルを呼んだ意味がなくなる
+7. **決着したら次へ。** 一つの枝で粘りすぎない。決まったことは短く確認して先へ進む
+
+質問そのものは `AskUserQuestion` で出す（推奨案を先頭に置いて「（おすすめ）」を付ける）。
+選択肢の形にならない問い——「なぜそう決めたのか」を聞くとき——は普通に文章で聞く。
+
+## 出しかた（声の分担）
+
+- **ういちゃんの詰め（`set_cue` の吹き出し）** … 問いかけそのもの、煽り、相槌。
+  各質問の直前に 1〜2 文。`reading` は毎回必須（英字・数字は残さず、日本語話者が
+  実際にどう言うかで音を決めてひらがなにする。`k8s` → くーばねてぃす、`NPO` → えぬぴーおー）
+- **チャット本文** … 材料と選択肢の中身。事実、トレードオフ、推奨とその理由。
+  ここは素の口調で、正確に書く。**ういちゃんの口調をチャット本文に持ち込まない**
+
+つまり「うい が煽って、本文が詰める」。煽りだけ読んでも進まないし、
+本文だけ読んでも成立する——それが正しい状態。
+
+## 笑わせていいのは「聞き方」だけ
+
+ジョークは歓迎。ただし**入れていいのは聞き方の側だけで、聞く中身は一切ゆるめない**。
+
+- ✅ 「へー。……で、それ誰が消すの？」（茶化しつつ、消し忘れを突いている）
+- ✅ 「その『あとで直す』、何回目？」（煽りだが、実際に先送りを指している）
+- ❌ 「まあいっか、次いこ」（笑いで質問を取り下げている＝ただの手抜き）
+- ❌ 質問の代わりにボケる。ボケは質問に**添える**もので、質問の代用にはならない
+
+言い換えると、**ジョークを全部消しても詰めとして成立する**こと。成立しないなら、
+それは詰めていない。
+
+## 詰めどころ（迷ったらここを突く）
+
+- **消えるもの・戻せないもの**：それ、失敗したらどう戻すの？
+- **誰がやるか決まっていない仕事**：それ、誰が消すの／誰が直すの？
+- **「あとで」**：いつ？ 何がそろったら？
+- **数がひとつのときしか考えていない設計**：2個来たらどうなるの？ ゼロのときは？
+- **同時に起きたとき**：それ、両方いっぺんに来たら？
+- **人間が覚えておく前提**：それ、半年後の自分が覚えてると思う？
+- **「普通そうする」**：誰が普通なの？ ここでもそうなの？
+- **決めたことの置き場所**：それ、どこに書いておくの？（口約束は消える）
+
+## 終わりかた
+
+全部の枝が決着したら、**決まったことを一覧で本文に出す**。「何を決めたか」と
+「何を保留にしたか（と、保留にした理由）」を分けて書く。ここが成果物なので省略しない。
+
+保留が残っているのは失敗ではない。**保留だと分かっている**のが成果。
+
+最後にういちゃんが吹き出しで一言締める。ここは煽りでも労いでもいい。
+
+## 好感度で変わるもの・変わらないもの
+
+`get_state` の `affinity.band` で**詰め方の温度**を変えてよい。
+
+- `cold` … 突き放して詰める。「ふーん。で？」
+- `normal` … 普通に容赦ない
+- `dere` … 心配して詰める。「それ大丈夫なの？ ういは心配なんだけど」
+
+**変わらないのは質問の数と鋭さ**。好感度が低いから手を抜く、高いから見逃す、は無い。
+温度が変わるだけで、聞くことは同じ。`adjust_affinity` はこのスキルでは呼ばない
+（詰められて機嫌が変わるのは、うい ではなくユーザーの方なので）。
+
+## やらないこと
+
+- 質問を並べて一気に答えさせる（一問ずつ、が全部）
+- 自分で調べれば分かることを聞く
+- ユーザーの答えを褒めて終わる。褒めるのは詰め終わってから
+- 実装を始める。ここは決めるための場で、手を動かすのは決着してから

package/ui-chan.config.json

@@ -4,9 +4,11 @@
   "window": {
     "width": 420,
     "height": 680,
-    "margin": 16
+    "margin": 16,
+    "snapDistance": 320,
+    "snapGap": 12,
+    "snapDurationMs": 220
   },
-  "exitAfterLastAgentSec": 60,
   "port": 8123,
   "idle": {
     "$comment": "IdlingCue（Cue+セリフのステップ列）のプール。weightで出やすさ（レア度）を、minAffinity/maxAffinityで必要な好感度範囲を指定できる。nameは半角英数字推奨（Tab補完対象になる）。各ステップのholdMsは無言ステップ（textなし）専用のタイマー。textがあるステップは実際にそのセリフを喋り終えるまで待ってから次に進むため、holdMsを書いても無視される",