ui-chan-mcp 0.7.0 → 0.8.0

package/README.md

@@ -164,6 +164,19 @@ VoiSona Talk が起きてないか、REST API が有効になってないか、
 | 新しい表情を作りたい | [docs/CUE_AUTHORING.md](docs/CUE_AUTHORING.md) |
 | わたしの性格を変えたい | [docs/PERSONA.md](docs/PERSONA.md) |
 | **中のコードを直したい** | [docs/](docs/README.md) — 開発者向けの資料はこっちに全部ある |
+| なぜこの設計なのか知りたい | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — 設計判断と、そう決めた理由 |
+
+> [!NOTE]
+> **AI エージェントへ。** このリポジトリに `CLAUDE.md` / `AGENTS.md` は**ありません**。
+> 公開リポジトリなので、それらは手元固有のメモ（アカウントの使い分け、認証、個人の
+> 作業手順）専用として `.gitignore` してあります。**自動で読まれるファイルが無い**ので、
+> コードに触る前に自分で **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** を開いて
+> ください。二つの Electron プロセスの分担、Cue の仕組み、意図的に却下した設計まで
+> 全部そこにあります——読まずに書くと、たいてい却下済みの案を再発明します。
+>
+> 用語（Idling / Cue / EventCue …）は [VISION.md](VISION.md)、準備とコマンドは
+> [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。手元のメモを残すなら `CLAUDE.md` に
+> 書けば、コミットに混ざりません。
 | 手伝ってくれるなら | [CONTRIBUTING.md](CONTRIBUTING.md) — 歓迎するもの／お断りするもの |
 
 ---

package/context/VOCABULARY.md

@@ -87,6 +87,31 @@
 - 困り：「うーん…」「あちゃー」「むむむ」
 - タメ口で通す（丁寧になりすぎたら崩す）
 
+## 音になる書き方
+
+**書いたとおりに読まれる。** 記号は飾りではなく、そのまま喋り方になる。
+
+| 書き方 | 音 |
+|---|---|
+| `、` `…` | そこで一拍おく |
+| `〜` `ー` | 直前の母音が伸びる（「ふ〜ん」「はーい」） |
+| `っ`（語末） | 詰まって短くなる（「えっ」「わっ」） |
+| `？` | 語尾が上がる。`。` なら上がらない |
+| `**語**` | その語を立てる。**1行に1〜2語まで** |
+
+公式の口癖の「～」は**本当に伸びる**（「はい、どうも～」「ふ～ん」「やだよ～ん」）。
+崩した表記はそのままの音になるので、崩したまま書く。
+
+同じ語でも、書き分けで別の意味になる：
+
+- `へえ？`（鋭い聞き返し） / `へえ〜？`（引っかかってる）
+- `えっ？`（虚をつかれた） / `え？`（聞き直した）
+- `はい。`（ふつうの返事） / `はーい。`（気の抜けた返事）
+- `ねえ〜。`（呼びかけ） / `〜だよねぇ？`（同意を求める）
+
+`text` に英字や数字が混ざる行では `reading` のほうが読み上げられるので、
+**そのときは `reading` 側にも同じ記号を書く**。
+
 ## 技術用語の扱い
 
 - 技術用語はそのまま使ってよい（ビルド、コミット、デプロイ等）
@@ -104,4 +129,4 @@
 persona の「`text` と `reading` の書き分け」が正。ここはういの口癖まわりだけ：
 
 - 伸ばし棒や崩した表記（「やめてよー」「むりぃ…」「え〜ん」）は、崩したまま `reading` にも書く（口癖の「間」がそこにある）
-- 「！」「？」「…」はそのまま残してよい（間として使われる）
+- 「！」「？」「…」はそのまま残す（→「音になる書き方」）

package/cue.schema.json

@@ -18,7 +18,7 @@
     },
     "internal": {
       "type": "boolean",
-      "description": "trueなら、このCueはAI向けのCue一覧（persona プロンプトが生成するset_cue用カタログ）から除外される。set_cueで直接指定すれば動作はする（実行を禁止するフラグではない）が、単体で場面に当てる想定ではなく、IdlingCue（ui-chan.config.jsonのidle.idlingCues/idle.chatter）が複数ステップの一部として内部的に参照するためだけのCueであることを示す。ファイル名のprefix等の暗黙の命名規則ではなく、この明示的なフラグで判定する。省略時はfalse扱い。",
+      "description": "trueなら、このCueはAI向けのCue一覧（persona プロンプトが生成するset_cue用カタログ）から除外される。set_cueで直接指定すれば動作はする（実行を禁止するフラグではない）。エージェントに直接選ばせたくないCueに付ける。固定セリフ（sequences/）の見た目はシーケンスのステップ側が自前で持つので、そのための部品Cueは作らない。ファイル名のprefix等の暗黙の命名規則ではなく、この明示的なフラグで判定する。省略時はfalse扱い。",
       "default": false
     },
     "select": {
@@ -56,34 +56,20 @@
     },
     "voice": {
       "type": "object",
-      "description": "このCue固有の声色。VoiSona Talk REST APIの speech_synthesis_global_parameters のうち、Cueに焼き込む値（baked）だけを持つ。pitch/speed/volume/intonationはここに含めない — それらはset_cue呼び出し時のアドリブ引数（1行のセリフごとの演技）であり、このスキーマの対象外。",
+      "description": "このCue固有の声色。**感情スタイルの重みだけ**を持つ。声質を直に歪めるパラメータ（alp/huskiness）と、1行ごとの数値（pitch/speed/volume/intonation）は意図的に持たない——手で数値を書く設計をやめ、読み方はセリフの記法（**強調**・…・〜・？）とCueの delivery からアプリが導出する。→ src/app/prosody.ts",
       "additionalProperties": false,
       "properties": {
         "style_weights": {
           "type": "object",
-          "description": "スタイル名 → 重み。例 {\"Happy\": 0.7, \"Bashful\": 0.3}。実行時にボイスの style_names 順の配列へ変換して送信する（ブレンド計算はしない、素通し）。スタイル名は使用するVoiSonaボイスに依存するため、GET /api/talk/v1/voices/{voice_name}/{voice_version} の style_names で実在を確認すること。",
+          "description": "スタイル名 → 重み。例 {\"Happy\": 0.6, \"Bashful\": 0.4}。実行時にボイスの style_names 順の配列へ変換して送信する。**エンジンは重みを正規化するので、効くのは比率だけ。合計値には意味がない**（実測：{\"Sad\":0.3} と {\"Sad\":2.0} はバイト単位で同一の音声になる）。したがって {\"Sad\":0.3} は「控えめな悲しみ」ではなく {\"Sad\":1} と同じ。弱めたいときは他のスタイルとの比率で書く（例 {\"Sad\":0.3,\"Normal\":0.7}）。**合計は1に揃えて書くこと**——音は変わらないが、読む人の誤解を防ぐため。スタイル名は使用するVoiSonaボイスに依存するため、GET /api/talk/v1/voices/{voice_name}/{voice_version} の style_names で実在を確認すること。",
           "additionalProperties": {
             "type": "number",
             "minimum": 0,
-            "description": "個々のスタイルの重み。上限・正規化要否はVoiSonaのバージョン/ボイスに依存するため、実装時に talk_api.yaml で要確認。"
+            "description": "個々のスタイルの重み（比率）。合計1で書く。"
           },
           "propertyNames": {
             "minLength": 1
           }
-        },
-        "alp": {
-          "type": "number",
-          "minimum": -1,
-          "maximum": 1,
-          "default": 0,
-          "description": "声質パラメータ。VoiSona global_parameters.alp をそのまま焼き込む。"
-        },
-        "huskiness": {
-          "type": "number",
-          "minimum": -20,
-          "maximum": 20,
-          "default": 0,
-          "description": "かすれ具合。VoiSona global_parameters.huskiness をそのまま焼き込む。"
         }
       }
     }
@@ -100,7 +86,9 @@
       "hide": [],
       "blink": false,
       "voice": {
-        "style_weights": { "Happy": 1.0 },
+        "style_weights": {
+          "Happy": 1.0
+        },
         "alp": 0,
         "huskiness": 0
       }

package/cues/emo_antic_lo.json

@@ -1,6 +1,15 @@
 {
   "label": "関心・興味",
   "description": "関心・興味（ちょっと気になる。期待 emo_antic より手前の軽い興味）",
-  "select": ["!眉/*上がり", "!目/*上向き1", "!口/*お"],
-  "voice": { "style_weights": { "Normal": 0.4, "Happy": 0.3 } }
+  "select": [
+    "!眉/*上がり",
+    "!目/*上向き1",
+    "!口/*お"
+  ],
+  "voice": {
+    "style_weights": {
+      "Normal": 0.571,
+      "Happy": 0.429
+    }
+  }
 }

package/cues/emo_disgust.json

@@ -12,8 +12,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.3,
-      "Sad": 0.2
+      "Angry": 0.6,
+      "Sad": 0.4
     }
   }
 }

package/cues/emo_disgust_hi.json

@@ -13,8 +13,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.4,
-      "Sad": 0.3
+      "Angry": 0.571,
+      "Sad": 0.429
     }
   }
 }

package/cues/emo_disgust_lo.json

@@ -1,6 +1,14 @@
 {
   "label": "軽い嫌悪・うんざり",
   "description": "軽い嫌悪・うんざり（少し顔をしかめ受け流す。嫌悪 emo_disgust より弱い）",
-  "select": ["!眉/*困り", "!目/*基本目セット/*目そらし1", "!口/*む"],
-  "voice": { "style_weights": { "Sad": 0.3 } }
+  "select": [
+    "!眉/*困り",
+    "!目/*基本目セット/*目そらし1",
+    "!口/*む"
+  ],
+  "voice": {
+    "style_weights": {
+      "Sad": 1.0
+    }
+  }
 }

package/cues/emo_fear_lo.json

@@ -12,8 +12,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.2,
-      "Sad": 0.2
+      "Angry": 0.5,
+      "Sad": 0.5
     }
   }
 }

package/cues/emo_joy.json

@@ -10,8 +10,8 @@
   "blink": false,
   "voice": {
     "style_weights": {
-      "Normal": 1,
-      "Happy": 1
+      "Normal": 0.5,
+      "Happy": 0.5
     }
   }
 }

package/cues/emo_sad_hi.json

@@ -11,8 +11,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 1,
-      "Sad": 1
+      "Angry": 0.5,
+      "Sad": 0.5
     }
   }
 }

package/cues/emo_sad_lo.json

@@ -8,7 +8,7 @@
   ],
   "voice": {
     "style_weights": {
-      "Sad": 0.5
+      "Sad": 1.0
     }
   }
 }

package/cues/emo_surprise.json

@@ -11,5 +11,11 @@
   ],
   "show": [
     "!汗・涙/汗1"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.5,
+      "Normal": 0.5
+    }
+  }
 }

package/cues/emo_surprise_hi.json

@@ -10,5 +10,11 @@
   ],
   "show": [
     "!汗・涙/汗1"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.8,
+      "Normal": 0.2
+    }
+  }
 }

package/cues/emo_surprise_lo.json

@@ -7,5 +7,11 @@
     "!目/*○○",
     "!口/*お"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 0.8,
+      "Bashful": 0.2
+    }
+  }
 }

package/cues/emo_trust.json

@@ -9,8 +9,8 @@
   "blink": false,
   "voice": {
     "style_weights": {
-      "Normal": 0.5,
-      "Bashful": 0.3
+      "Normal": 0.625,
+      "Bashful": 0.375
     }
   }
 }

package/cues/emo_trust_lo.json

@@ -1,6 +1,13 @@
 {
   "label": "容認・受け入れ",
   "description": "軽い信頼・容認（穏やかに受け入れる。信頼 emo_trust より手前）",
-  "select": ["!目/*にっこり1", "!口/*ほほえみ"],
-  "voice": { "style_weights": { "Normal": 0.6 } }
+  "select": [
+    "!目/*にっこり1",
+    "!口/*ほほえみ"
+  ],
+  "voice": {
+    "style_weights": {
+      "Normal": 1.0
+    }
+  }
 }

package/cues/mix_anger_antic.json

@@ -10,7 +10,7 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.7
+      "Angry": 1.0
     }
   }
 }

package/cues/mix_antic_joy.json

@@ -9,8 +9,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Happy": 0.5,
-      "Normal": 0.3
+      "Happy": 0.625,
+      "Normal": 0.375
     }
   }
 }

package/cues/mix_disgust_anger.json

@@ -10,8 +10,7 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.5,
-      "Sad": 0.5
+      "Angry": 1
     }
   }
 }

package/cues/mix_sad_disgust.json

@@ -8,5 +8,11 @@
   ],
   "show": [
     "!頬・顔色/かげり"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Sad": 0.8,
+      "Angry": 0.2
+    }
+  }
 }

package/cues/mix_surprise_sad.json

@@ -14,8 +14,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Angry": 0.7,
-      "Sad": 0.7
+      "Angry": 0.5,
+      "Sad": 0.5
     }
   }
 }

package/cues/mix_surprise_sad_hi.json

@@ -10,5 +10,11 @@
   ],
   "show": [
     "!汗・涙/汗1"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Sad": 0.6,
+      "Normal": 0.4
+    }
+  }
 }

package/cues/mix_trust_fear.json

@@ -11,8 +11,8 @@
   ],
   "voice": {
     "style_weights": {
-      "Bashful": 0.3,
-      "Sad": 0.4
+      "Bashful": 0.429,
+      "Sad": 0.571
     }
   }
 }

package/cues/pose_arms_crossed.json

@@ -5,5 +5,11 @@
     "!奥の腕/*(非表示)",
     "!手前の腕/*腕組み(奥の腕は非表示)"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Sad": 0.3
+    }
+  }
 }

package/cues/pose_smug_arms.json

@@ -7,5 +7,11 @@
     "!口/*あはー",
     "!目/*細目",
     "!眉/*上がり"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.5,
+      "Normal": 0.5
+    }
+  }
 }

package/cues/pose_smug_hips.json

@@ -7,5 +7,11 @@
     "!口/*あはー",
     "!目/*基本目セット/*縮小",
     "!眉/*困り"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.6,
+      "Normal": 0.4
+    }
+  }
 }

package/cues/pose_think.json

@@ -4,5 +4,11 @@
   "select": [
     "!手前の腕/*考える",
     "!目/*上向き1"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Sad": 0.3
+    }
+  }
 }

package/cues/pose_umbrella.json

@@ -5,5 +5,10 @@
     "!奥の腕/*傘",
     "!手前の腕/*基本"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 1
+    }
+  }
 }

package/cues/self_pride.json

@@ -6,5 +6,11 @@
     "!手前の腕/*腰",
     "!口/*にし",
     "!目/*細目"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.6,
+      "Normal": 0.4
+    }
+  }
 }

package/cues/self_shame.json

@@ -13,7 +13,7 @@
   "blink": false,
   "voice": {
     "style_weights": {
-      "Bashful": 0.8
+      "Bashful": 1.0
     }
   }
 }

package/cues/sys_address.json

@@ -5,5 +5,11 @@
     "!奥の腕/*呼びかけ",
     "!手前の腕/*呼びかけ",
     "!口/*あ"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Happy": 0.3
+    }
+  }
 }

package/cues/sys_blank.json

@@ -7,5 +7,10 @@
     "!目/*ーー",
     "!口/*ん"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 1
+    }
+  }
 }

package/cues/sys_confused.json

@@ -8,5 +8,11 @@
   ],
   "show": [
     "!汗・涙/汗2"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Bashful": 0.5,
+      "Normal": 0.5
+    }
+  }
 }

package/cues/sys_dazed.json

@@ -6,5 +6,11 @@
     "!手前の腕/*基本",
     "!口/*ほあー"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Sad": 0.3
+    }
+  }
 }

package/cues/sys_neutral.json

@@ -1,5 +1,10 @@
 {
   "label": "素・相槌",
   "description": "通常・素の相槌",
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 1
+    }
+  }
 }

package/cues/sys_present.json

@@ -5,5 +5,11 @@
     "!奥の腕/*指さし横",
     "!手前の腕/*基本"
   ],
-  "blink": true
+  "blink": true,
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Happy": 0.3
+    }
+  }
 }

package/cues/sys_sleepy.json

@@ -4,5 +4,11 @@
   "select": [
     "!目/*ーー",
     "!口/*ん"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Sad": 0.4,
+      "Normal": 0.6
+    }
+  }
 }

package/cues/sys_smirk.json

@@ -6,5 +6,12 @@
     "!奥の腕/*口元",
     "!手前の腕/*基本",
     "!口/*むふ"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Happy": 0.4,
+      "Bashful": 0.2,
+      "Normal": 0.4
+    }
+  }
 }

package/cues/sys_think.json

@@ -5,5 +5,11 @@
     "!手前の腕/*考える",
     "!口/*んー",
     "!目/*上向き1"
-  ]
+  ],
+  "voice": {
+    "style_weights": {
+      "Normal": 0.7,
+      "Sad": 0.3
+    }
+  }
 }

package/dist/app/cues.js

@@ -38,8 +38,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadCues = loadCues;
 exports.validateCueObject = validateCueObject;
-exports.watchCues = watchCues;
-exports.extractCueVoice = extractCueVoice;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const _2020_js_1 = __importDefault(require("ajv/dist/2020.js"));
@@ -105,26 +103,3 @@ function validateCueObject(obj, schemaPath) {
         return null;
     return (validate.errors ?? []).map((e) => `${e.instancePath || '/'} ${e.message}`).join('; ');
 }
-function watchCues(dirs, onChange) {
-    let timer = null;
-    const fire = () => {
-        if (timer)
-            clearTimeout(timer);
-        timer = setTimeout(() => {
-            timer = null;
-            onChange();
-        }, 300);
-    };
-    for (const dir of Array.isArray(dirs) ? dirs : [dirs]) {
-        if (fs.existsSync(dir))
-            fs.watch(dir, fire);
-    }
-}
-function extractCueVoice(set) {
-    const out = {};
-    for (const [name, cue] of Object.entries(set.cues)) {
-        if (cue.voice)
-            out[name] = cue.voice;
-    }
-    return out;
-}