dsh-agentic-pet 0.3.2 → 0.4.1

package/client/pet-settings.js

@@ -12,6 +12,7 @@ window.__ModuleLoader__.load({
     var useState = React.useState
     var useEffect = React.useEffect
     var useCallback = React.useCallback
+    var useRef = React.useRef
 
     var READ = '/api/pet-settings/read'
     var UPDATE = '/api/pet-settings/update'
@@ -60,6 +61,12 @@ window.__ModuleLoader__.load({
       var busyState = useState(false)
       var busy = busyState[0]
       var setBusy = busyState[1]
+      // 语音朗读的声音选择器：null = 收起；展开后 {loading, error, items, search}。
+      var voiceState = useState(null)
+      var voice = voiceState[0]
+      var setVoice = voiceState[1]
+      var previewAudioRef = useRef(null)
+      var keyInputRef = useRef(null)
 
       var refresh = useCallback(function () {
         fetch(READ, { credentials: 'same-origin' })
@@ -91,14 +98,81 @@ window.__ModuleLoader__.load({
       var settings = (data && data.settings) || {}
       var pro = settings.proactivity || {}
       var iv = settings.innerVoice || {}
+      var tts = settings.tts || {}
       var debug = settings.debug || {}
       var affection = (data && data.affection) || {}
       var pets = (data && data.pets) || []
       if (!(pets && pets.length) && data && data.pet) pets = [Object.assign({ id: 'electron' }, data.pet)]
       var moodOf = function (a) { return a >= 80 ? '开心' : a >= 40 ? '满足' : '平静' }
+      // 显示名：用户自定义（settings.names）优先，缺省回落内置名；
+      // 宠物区改名后好感度区自动跟随（同一状态、同一渲染趟）。
+      var defaultName = function (id) { return id === 'electron' ? '鲸鱼娘' : id === 'pure' ? 'Pure 宠物' : id }
+      var BOND_TIERS = [[0, "陌生"], [5, "认识"], [15, "熟了"], [40, "亲近"], [90, "离不开"], [180, "只有你"]]
+      var bondTier = function (days) {
+        var name = "陌生"
+        BOND_TIERS.forEach(function (t) { if (days >= t[0]) name = t[1] })
+        return name
+      }
+      var petName = function (id) {
+        var custom = settings.names && settings.names[id]
+        return custom ? String(custom) : defaultName(id)
+      }
+      // 提交一次改名（失焦/回车调用）：与当前值比较，无变化零开销；
+      // 空值删键（回落默认）。一次编辑 = 至多一次 update = 至多一条 [改名]。
+      var commitName = function (id, raw) {
+        var v = (raw || '').trim()
+        var next = Object.assign({}, (settings.names || {}))
+        var current = next[id]
+        if (v !== '' && v !== defaultName(id)) {
+          if (current === v) return
+          next[id] = v
+        } else {
+          if (current === undefined) return
+          delete next[id]
+        }
+        update({ names: next })
+      }
 
       function update(patch, doneMessage) { act(UPDATE, { patch: patch }, doneMessage) }
 
+      // ── 语音朗读（BreezeBlue TTS）的取声/试听 ──
+      // 列表走宿主代理路由（浏览器直连 api.breeze.blue 会被 CORS 拦下，
+      // key 也不该进页面日志）；试听直接播 preview_url，不经过本插件。
+      var loadVoices = function (search) {
+        setVoice({ loading: true, error: '', items: (voice && voice.items) || [], search: search || '' })
+        fetch('/api/pet-settings/tts/voices?search=' + encodeURIComponent(search || ''), { credentials: 'same-origin' })
+          .then(function (r) { return r.json() })
+          .then(function (d) {
+            if (d && d.error) setVoice({ loading: false, error: d.error, items: [], search: search || '' })
+            else setVoice({ loading: false, error: '', items: (d && d.voices) || [], search: search || '' })
+          })
+          .catch(function (e) {
+            setVoice({ loading: false, error: '请求失败: ' + ((e && e.message) || e), items: [], search: search || '' })
+          })
+      }
+      var playPreview = function (url) {
+        if (!url) return
+        try {
+          if (previewAudioRef.current) previewAudioRef.current.pause()
+          var audio = new Audio(url)
+          previewAudioRef.current = audio
+          audio.play().catch(function () { /* 试听失败不打断配置 */ })
+        } catch (e) { /* ignore */ }
+      }
+      // 取声音列表前先把 key 输入框里未提交的值落盘（输入框是失焦提交，
+      // “输完 key 立刻点选择声音”时 blur 的 POST 会和列表 GET 赛跑——
+      // 代理读到旧文件，401。这里等提交完成再查。）
+      var flushKeyThen = function (done) {
+        var el = keyInputRef.current
+        var current = el ? String(el.value || '').trim() : ''
+        if (current === '' || current === (tts.apiKey || '')) { done(); return }
+        fetch(UPDATE, {
+          method: 'POST', credentials: 'same-origin',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ patch: { tts: { apiKey: current } } }),
+        }).then(function () { done() }, function () { done() })
+      }
+
       return h('div', { style: { width: '100%', maxWidth: 720 } },
         h('div', { style: { display: 'flex', alignItems: 'center', gap: 10, margin: '2px 0 10px' } },
           h('span', { style: { fontWeight: 700, fontSize: 15 } }, '桌宠'),
@@ -111,9 +185,13 @@ window.__ModuleLoader__.load({
         h(Section, { title: '宠物' },
           pets.length
             ? pets.map(function (p) {
-              var name = p.id === 'electron' ? 'TS 宠物' : p.id === 'pure' ? 'Pure 宠物' : String(p.id)
               return h('div', { key: p.id, style: row },
-                h('span', { style: { fontWeight: 700 } }, name),
+                // Uncontrolled + commit-on-blur/Enter: typing is LOCAL until the
+                // edit completes — a per-keystroke update would fire a [改名]
+                // turn per character.清空 + 失焦 = 恢复默认名。
+                h('input', { style: Object.assign({}, inputStyle, { width: 120, fontWeight: 700 }), defaultValue: petName(p.id), title: '改名后点击空白处或回车生效；清空恢复默认',
+                  onBlur: function (e) { commitName(p.id, e.target.value) },
+                  onKeyDown: function (e) { if (e.key === 'Enter') { commitName(p.id, e.target.value); e.target.blur() } } }),
                 p.online
                   ? h('span', null, '在线',
                     h('span', { style: muted }, 'pid ' + String(p.pid ?? '?')),
@@ -121,7 +199,7 @@ window.__ModuleLoader__.load({
                     p.animation ? h('span', { style: muted }, String(p.animation)) : null)
                   : h('span', { style: muted }, '离线'))
             })
-            : h('div', null, '没有在线的宠物', h(Hint, null, '启动 DeepSeek Harness 后 TS 宠物会自动上桌；Pure 宠物需自行启动。'))),
+            : h('div', null, '没有在线的宠物', h(Hint, null, '启动 DeepSeek Harness 后鲸鱼娘会自动上桌；Pure 宠物需自行启动。'))),
 
         // ── 好感度（每宠独立账本） ──
         h(Section, { title: '好感度' },
@@ -133,18 +211,20 @@ window.__ModuleLoader__.load({
             if (!ids.length) return h('div', { style: muted }, '还没有互动记录')
             return ids.map(function (id) {
               var book = (affection && affection[id]) || { affection: 0, total: 0 }
-              var name = id === 'electron' ? 'TS 宠物' : id === 'pure' ? 'Pure 宠物' : id
+              var name = petName(id)
               return h('div', { key: id, style: row },
                 h('span', { style: { fontWeight: 700 } }, name),
                 h('span', { style: { fontSize: 18, fontWeight: 700 } }, String(book.affection ?? 0)),
-                h('span', { style: muted }, '/ 100 · ' + moodOf(book.affection ?? 0)),
+                h('span', { style: muted }, '/ 100 · ' + moodOf(book.affection ?? 0) + ' · 羁绊：' + bondTier(book.bond ? (book.bond.value ?? book.bond.days ?? 0) : 0) + '（' + String(book.bond ? (book.bond.value ?? book.bond.days ?? 0) : 0) + ' 天）'),
                 h('span', { style: muted }, '累计 ' + String(book.total ?? 0) + ' 次'))
             })
           })(),
           h('div', { style: row }, h(SButton, { variant: 'danger', disabled: busy, onClick: function () {
             if (window.confirm('清空所有好感度账本？此操作不可撤销。')) act('/api/pet-settings/reset-affection', {}, '账本已清空')
           } }, '重置账本'),
-          h('span', { style: muted }, '每跨 10 点该宠物会自主庆祝一次'))),
+          h('span', { style: muted }, '每 10 次触摸该宠物会自主庆祝一次'))),
+
+
 
         // ── 内心戏（宠物自主说话）──
         h(Section, { title: h('span', null, '自主表达 ', h('span', { style: { fontSize: 11, fontWeight: 400, color: 'rgba(127,127,127,.9)' } }, '模型驱动')) },
@@ -190,11 +270,11 @@ window.__ModuleLoader__.load({
                   marginLeft: side === 'right' ? -1 : 0 }
               }
               return h('div', { style: { display: 'inline-flex' } },
-                h('button', { style: seg(iv.preset !== 'pet', 'left'), onClick: function () {
-                  if (iv.preset !== 'pet-inner-voice') update({ innerVoice: { preset: 'pet-inner-voice' } })
+                h('button', { style: seg(iv.preset === 'whale598', 'left'), onClick: function () {
+                  if (iv.preset !== 'whale598') update({ innerVoice: { preset: 'whale598' } })
                 } }, '精简（仅表达）'),
-                h('button', { style: seg(iv.preset === 'pet', 'right'), onClick: function () {
-                  if (iv.preset !== 'pet') update({ innerVoice: { preset: 'pet' } })
+                h('button', { style: seg(iv.preset === 'whale598-standard', 'right'), onClick: function () {
+                  if (iv.preset !== 'whale598-standard') update({ innerVoice: { preset: 'whale598-standard' } })
                 } }, '普通（含工作工具）'))
             })()),
           h('div', { style: row }, '指定会话（高级）',
@@ -220,6 +300,61 @@ window.__ModuleLoader__.load({
             '分钟'),
           h(Hint, null, '自由活动：宠物空闲时随机播放一段小动画（纯动画，无模型参与），改动即时推送。')),
 
+        // ── 语音朗读（BreezeBlue TTS）──
+        h(Section, { title: h('span', null, '语音朗读 ', h('span', { style: { fontSize: 11, fontWeight: 400, color: 'rgba(127,127,127,.9)' } }, 'BreezeBlue TTS')) },
+          h('div', { style: row }, '朗读开关', h(Toggle, { value: tts.enabled === true, onChange: function () {
+            update({ tts: { enabled: !(tts.enabled === true) } })
+          } }),
+          h('span', { style: muted }, '宠物展示说话气泡的同时读出来（语音就绪立即一起显示；最多等 5 秒，超时只展示气泡）')),
+          // key / 声音 / 语速音量均为 commit-on-blur：输入期间不落盘，
+          // 清空 = 删除配置（宠物回落为不朗读）。
+          h('div', { style: row },
+            'API Key',
+            h('input', { key: 'tts-key-' + String(tts.apiKey || ''), ref: function (el) { keyInputRef.current = el }, style: Object.assign({}, inputStyle, { width: 260 }), type: 'password', defaultValue: tts.apiKey || '', placeholder: 'brz_...（breezeblue.ai 申请）',
+              onBlur: function (e) { var v = e.target.value.trim(); if (v !== (tts.apiKey || '')) update({ tts: { apiKey: v } }) },
+              onKeyDown: function (e) { if (e.key === 'Enter') e.target.blur() } }),
+            h('a', { href: 'https://breezeblue.ai/app/developer/api-keys', target: '_blank', rel: 'noopener noreferrer',
+              style: Object.assign(btnStyle('primary'), { display: 'inline-block', textDecoration: 'none' }), title: '打开 BreezeBlue 开发者控制台的 API Keys 页面' }, '获取 Key')),
+          h('div', { style: row },
+            '声音',
+            h('input', { key: 'tts-voice-' + String(tts.voiceId || ''), style: Object.assign({}, inputStyle, { width: 210, fontFamily: 'monospace' }), defaultValue: tts.voiceId || '', placeholder: 'voice_id，点右侧选择',
+              onBlur: function (e) { var v = e.target.value.trim(); if (v !== (tts.voiceId || '')) update({ tts: { voiceId: v } }) },
+              onKeyDown: function (e) { if (e.key === 'Enter') e.target.blur() } }),
+            h(SButton, { disabled: busy, onClick: function () {
+              if (voice) { setVoice(null); return }
+              flushKeyThen(function () { loadVoices('') })
+            } }, voice ? '收起' : '选择声音')),
+          voice
+            ? h('div', { style: { border: '1px solid rgba(127,127,127,.3)', borderRadius: 8, padding: '8px 10px', margin: '4px 0 6px' } },
+                h('div', { style: row },
+                  h('input', { style: Object.assign({}, inputStyle, { width: 190 }), value: voice.search || '', placeholder: '搜索声音（名称/风格）',
+                    onChange: function (e) { setVoice(Object.assign({}, voice, { search: e.target.value })) },
+                    onKeyDown: function (e) { if (e.key === 'Enter') loadVoices(voice.search) } }),
+                  h(SButton, { disabled: voice.loading, onClick: function () { flushKeyThen(function () { loadVoices(voice.search) }) } }, '搜索')),
+                voice.error ? h('div', { style: { color: '#ff7369', fontSize: 12, margin: '2px 0' } }, voice.error) : null,
+                h('div', { style: { maxHeight: 220, overflowY: 'auto' } },
+                  (voice.items || []).map(function (v) {
+                    return h('div', { key: v.voice_id, style: Object.assign({}, row, { borderBottom: '1px solid rgba(127,127,127,.15)' }) },
+                      h('span', { style: { fontWeight: 600 } }, v.name || v.voice_id),
+                      h('span', { style: muted }, [v.language_code, v.gender, (v.tone || []).join('/')].filter(Boolean).join(' · ')),
+                      v.voice_id === tts.voiceId ? h('span', { style: { color: '#3ddc84', fontSize: 12, fontWeight: 700 } }, '当前') : null,
+                      h('span', { style: { flex: 1 } }),
+                      v.preview_url ? h(SButton, { onClick: function () { playPreview(v.preview_url) } }, '试听') : null,
+                      h(SButton, { variant: 'primary', onClick: function () { update({ tts: { voiceId: v.voice_id } }, '已选用 ' + (v.name || v.voice_id)) } }, '选用'))
+                  }),
+                  (!voice.loading && !voice.error && (voice.items || []).length === 0) ? h('div', { style: muted }, '没有匹配的声音') : null))
+            : null,
+          h('div', { style: row },
+            '语速',
+            h('input', { key: 'tts-speed-' + String(tts.speed ?? 1), style: inputStyle, defaultValue: String(tts.speed ?? 1), title: '0.5 – 2.0，1 = 正常',
+              onBlur: function (e) { var v = parseFloat(e.target.value); if (Number.isFinite(v) && v !== (tts.speed ?? 1)) update({ tts: { speed: Math.min(2, Math.max(0.5, v)) } }) },
+              onKeyDown: function (e) { if (e.key === 'Enter') e.target.blur() } }),
+            '音量',
+            h('input', { key: 'tts-volume-' + String(tts.volume ?? 1), style: inputStyle, defaultValue: String(tts.volume ?? 1), title: '0.01 – 2.0，1 = 默认',
+              onBlur: function (e) { var v = parseFloat(e.target.value); if (Number.isFinite(v) && v !== (tts.volume ?? 1)) update({ tts: { volume: Math.min(2, Math.max(0.01, v)) } }) },
+              onKeyDown: function (e) { if (e.key === 'Enter') e.target.blur() } })),
+          h(Hint, null, '接入 BreezeBlue（breezeblue.ai）文字转语音：说话气泡显示时用所选声音朗读。key 只保存在本机 pet-settings.json；改动即时生效，无需重启宠物。气泡等语音的超时上限可在 pet-settings.json 的 tts.holdMs 调整（0–8000 毫秒，默认 5000；语音先就绪就立刻展示，超时则只展示气泡）。')),
+
         // ── 调试 ──
         h(Section, { title: '调试' },
           h('div', { style: row }, 'CDP 调试端口 (9222)', h(Toggle, { value: debug.cdp === true, onChange: function () {

package/lib/index.js

@@ -1,9 +1,9 @@
-import { i as installPetDriver, n as installPetService } from "./service-Vj-lLpIv.js";
+import { c as globalFilePath, d as readJsonl, f as readPetName, h as writePetName, i as installPetDriver, l as readAffectionRaw, m as writeGlobalJson, n as installPetService, p as writeAffectionRaw, r as petHome, s as eventsFile, u as readGlobalJson } from "./service-BjTawwUn.js";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
-import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { mkdir, readFile, rm, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, extname, join, normalize, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -20,6 +20,7 @@ import { fileURLToPath } from "node:url";
 * dispatch — the webserver throws on duplicate path registration.
 * @module dsh-agentic-pet/settings-page
 */
+/** The touch ledger the driver owns; reset writes the driver's empty shape. */
 const DEFAULT_SETTINGS = {
 	proactivity: {
 		enabled: false,
@@ -30,16 +31,16 @@ const DEFAULT_SETTINGS = {
 	},
 	innerVoice: {
 		enabled: true,
-		preset: "pet-inner-voice",
+		preset: "whale598",
 		wakeIntervalMinutes: 2,
 		speakProbability: .5,
 		touchReplyProbability: .3,
 		touchReplyCooldownSeconds: 30,
 		boundSessions: {}
 	},
+	tts: { enabled: false },
 	debug: { cdp: false }
 };
-/** The touch ledger the driver owns; reset writes the driver's empty shape. */
 const EMPTY_LEDGER = {
 	affection: 0,
 	total: 0,
@@ -141,10 +142,30 @@ function mergeSettings(current, patch) {
 		const d = patchDebug;
 		if (typeof d.cdp === "boolean") debug.cdp = d.cdp;
 	}
+	const tts = { ...current.tts };
+	const patchTts = patch.tts;
+	if (typeof patchTts === "object" && patchTts !== null) {
+		const t = patchTts;
+		if (typeof t.enabled === "boolean") tts.enabled = t.enabled;
+		const setText = (key) => {
+			const value = t[key];
+			if (typeof value !== "string") return;
+			const trimmed = value.trim();
+			if (trimmed === "") Reflect.deleteProperty(tts, key);
+			else tts[key] = trimmed;
+		};
+		setText("apiKey");
+		setText("voiceId");
+		setText("modelId");
+		setText("languageCode");
+		if (typeof t.speed === "number" && Number.isFinite(t.speed)) tts.speed = Math.min(2, Math.max(.5, t.speed));
+		if (typeof t.volume === "number" && Number.isFinite(t.volume)) tts.volume = Math.min(2, Math.max(.01, t.volume));
+	}
 	return {
 		...current,
 		proactivity,
 		innerVoice,
+		tts,
 		debug
 	};
 }
@@ -168,9 +189,7 @@ function openPathInFileManager(path) {
 * @param home - the dsh home holding the settings/ledger/manifest files.
 */
 function installSettingsPage(ctx, home, pet) {
-	const settingsPath = join(home, "pet-settings.json");
-	const ledgerPath = join(home, "pet-affection.json");
-	const windowPath = join(home, "pet-window.json");
+	const windowPath = globalFilePath(home, "pet-window.json");
 	/** Summarize EVERY live pet (id, online flag, normalized /status). */
 	const petStatus = async () => {
 		return { pets: (await Promise.all((await pet.list()).map((entry) => pet.snapshot(entry)))).map(({ id, online, ...rest }) => ({
@@ -180,11 +199,7 @@ function installSettingsPage(ctx, home, pet) {
 		})) };
 	};
 	const readSettings = async () => {
-		try {
-			return mergeSettings(JSON.parse(await readFile(settingsPath, "utf8")), {});
-		} catch {
-			return mergeSettings({}, {});
-		}
+		return mergeSettings(await readGlobalJson(home, "pet-settings.json"), {});
 	};
 	const routeByPath = /* @__PURE__ */ new Map();
 	const route = (method, path, handler) => {
@@ -220,22 +235,46 @@ function installSettingsPage(ctx, home, pet) {
 	route("GET", "/api/pet-settings/read", async (_req, res) => {
 		const [settings, windowPosition, status] = await Promise.all([
 			readSettings(),
-			readFile(windowPath, "utf8").then((raw) => JSON.parse(raw), () => null),
+			readGlobalJson(home, "pet-window.json").then((raw) => Object.keys(raw).length > 0 ? raw : null),
 			petStatus()
 		]);
 		const affection = {};
-		const legacyBook = await readFile(ledgerPath, "utf8").then((raw) => JSON.parse(raw), () => null);
 		const bookIds = new Set(status.pets.map((pet) => String(pet.id)));
 		bookIds.add("electron");
 		for (const id of bookIds) {
-			const book = await readFile(id === "electron" && legacyBook !== null ? ledgerPath : join(home, "pet-affection.d", `${id}.json`), "utf8").then((raw) => JSON.parse(raw), () => null);
+			const book = await readAffectionRaw(home, id);
 			if (book !== null) affection[id] = book;
 		}
+		const names = {};
+		for (const id of bookIds) {
+			const label = await readPetName(home, id);
+			if (label !== void 0) names[id] = label;
+		}
+		const composed = {
+			...settings,
+			names
+		};
+		const touchTotals = {};
+		for (const id of bookIds) {
+			const events = await readJsonl(eventsFile(home, id), 600);
+			const totals = {
+				total: 0,
+				byPart: {}
+			};
+			for (const event of events) {
+				if (event.type !== "touch") continue;
+				const part = typeof event.part === "string" ? event.part : "miss";
+				totals.total += 1;
+				totals.byPart[part] = (totals.byPart[part] ?? 0) + 1;
+			}
+			if (totals.total > 0) touchTotals[id] = totals;
+		}
 		writeJson(res, 200, {
-			settings,
+			settings: composed,
 			affection,
 			windowPosition,
-			pets: status.pets
+			pets: status.pets,
+			touchTotals
 		});
 	});
 	route("POST", "/api/pet-settings/update", async (req, res) => {
@@ -245,8 +284,13 @@ function installSettingsPage(ctx, home, pet) {
 			writeJson(res, 400, { error: "body must be {patch:{...}}" });
 			return;
 		}
+		const patchNames = patch.names;
+		if (typeof patchNames === "object" && patchNames !== null) {
+			for (const [petId, label] of Object.entries(patchNames)) await writePetName(home, petId, typeof label === "string" && label.trim() !== "" ? label : null);
+			delete patch.names;
+		}
 		const next = mergeSettings(await readSettings(), patch);
-		await writeFile(settingsPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+		await writeGlobalJson(home, "pet-settings.json", next);
 		ctx.emit("pet-settings/changed");
 		writeJson(res, 200, {
 			ok: true,
@@ -254,14 +298,14 @@ function installSettingsPage(ctx, home, pet) {
 		});
 	});
 	route("POST", "/api/pet-settings/reset-affection", async (_req, res) => {
-		await writeFile(ledgerPath, `${JSON.stringify(EMPTY_LEDGER)}\n`, "utf8");
+		await writeAffectionRaw(home, "electron", EMPTY_LEDGER);
 		writeJson(res, 200, {
 			ok: true,
 			affection: EMPTY_LEDGER
 		});
 	});
 	route("POST", "/api/pet-settings/reset-position", async (_req, res) => {
-		if (existsSync(windowPath)) await unlink(windowPath);
+		for (const p of [windowPath, join(home, "pet-window.json")]) await rm(p, { force: true });
 		writeJson(res, 200, { ok: true });
 	});
 	route("POST", "/api/pet-settings/open-logs", async (_req, res) => {
@@ -273,6 +317,59 @@ function installSettingsPage(ctx, home, pet) {
 			opened: target
 		});
 	});
+	route("GET", "/api/pet-settings/tts/voices", async (req, res) => {
+		const settings = await readSettings();
+		const apiKey = typeof settings.tts?.apiKey === "string" ? settings.tts.apiKey : "";
+		if (apiKey === "") {
+			writeJson(res, 400, { error: "尚未配置 BreezeBlue API key" });
+			return;
+		}
+		const url = new URL(req.url ?? "/", "http://127.0.0.1");
+		const params = new URLSearchParams();
+		for (const key of [
+			"search",
+			"language_code",
+			"gender",
+			"accent"
+		]) {
+			const value = url.searchParams.get(key);
+			if (value !== null && value !== "") params.set(key, value);
+		}
+		const rawPageSize = url.searchParams.get("page_size");
+		const pageSize = rawPageSize !== null ? clampNumber(Number(rawPageSize), 1, 100) : void 0;
+		params.set("page_size", String(pageSize ?? 30));
+		try {
+			const response = await fetch(`https://api.breeze.blue/v1/voices?${params.toString()}`, {
+				headers: { "xi-api-key": apiKey },
+				signal: AbortSignal.timeout(1e4)
+			});
+			if (!response.ok) {
+				const detail = await response.text().catch(() => "");
+				writeJson(res, 502, { error: response.status === 401 ? "BreezeBlue 拒绝了这个 key（401）：请到 breezeblue.ai 的 Developer Console 复制 brz_ 开头的 API key" : `BreezeBlue HTTP ${String(response.status)}${detail ? `: ${detail.slice(0, 200)}` : ""}` });
+				return;
+			}
+			const raw = await response.json();
+			const voices = (Array.isArray(raw.voices) ? raw.voices : []).map((entry) => {
+				const voice = entry;
+				const str = (key) => typeof voice[key] === "string" ? voice[key] : null;
+				return {
+					voice_id: str("voice_id") ?? "",
+					name: str("name") ?? "",
+					language_code: str("language_code"),
+					gender: str("gender"),
+					tone: Array.isArray(voice.tone) ? voice.tone.filter((item) => typeof item === "string").slice(0, 3) : [],
+					accent: str("accent"),
+					preview_url: str("preview_url")
+				};
+			}).filter((voice) => voice.voice_id !== "");
+			writeJson(res, 200, {
+				voices,
+				total: typeof raw.total === "number" ? raw.total : voices.length
+			});
+		} catch (error) {
+			writeJson(res, 502, { error: `声音列表请求失败: ${error instanceof Error ? error.message : String(error)}` });
+		}
+	});
 }
 //#endregion
 //#region lib/types/index.js
@@ -311,7 +408,7 @@ const inject = [
 	"workspaceController"
 ];
 /** The URL path prefix the pet renderer is served under. No trailing slash. */
-const PET_PATH_PREFIX = "/pet";
+const PET_PATH_PREFIX = "/whale598";
 /**
 * Locator file naming this runtime's authenticated root for the pet carrier.
 * The desktop shell keeps its authenticated URL in process memory only, so a
@@ -320,7 +417,7 @@ const PET_PATH_PREFIX = "/pet";
 * publisher, then falls back to spawning its own profile.
 */
 function petLocatorPath() {
-	return join(process.env.DSH_HOME ?? join(homedir(), ".dsh"), "pet-surface-url.json");
+	return join(process.env.DSH_HOME ?? join(homedir(), ".dsh"), "whale598", "pet-surface-url.json");
 }
 const HTML_MIME = "text/html; charset=utf-8";
 const MIME = {
@@ -367,7 +464,7 @@ function bytesBody(bytes) {
 /**
 * Answer one GET or HEAD `/pet` request. The URL path is the full server
 * pathname (`/pet` prefix included); it must be exactly the prefix or stay
-* under it. The index entry (`/pet`, `/pet/`, `/pet/index.html`) passes
+* under it. The index entry (`/whale598`, `/whale598/`, `/whale598/index.html`) passes
 * Connection's browser authentication; every other file is public with a weak
 * ETag and `cache-control: no-cache`, answering a matching `If-None-Match`
 * with 304. Traversal outside the dist root is 403, missing paths are 404, a
@@ -379,7 +476,8 @@ function bytesBody(bytes) {
 */
 async function servePetStatic(request, distRoot, distIndex, authorizeIndex) {
 	const pathname = decodeURIComponent(new URL(request.url).pathname);
-	const target = resolve(normalize(join(distRoot, pathname === "/pet" || pathname === `/pet/` ? "/" : pathname.slice(4))));
+	if (!(pathname === "/whale598" || pathname.startsWith(`/whale598/`))) return new Response(null, { status: 404 });
+	const target = resolve(normalize(join(distRoot, pathname === "/whale598" || pathname === `/whale598/` ? "/" : pathname.slice(9))));
 	if (target !== distRoot && !target.startsWith(distRoot + sep)) return new Response(null, { status: 403 });
 	let body;
 	let headers;
@@ -587,9 +685,10 @@ function apply(ctx) {
 	const settled = ctx.get("loader")?.await();
 	if (settled === void 0) settledReady();
 	else settled.then(settledReady).catch(() => {});
-	const pet = installPetService(ctx, dirname(petLocatorPath()));
-	installPetDriver(ctx, dirname(petLocatorPath()), pet);
-	installSettingsPage(ctx, dirname(petLocatorPath()), pet);
+	const home = petHome();
+	const pet = installPetService(ctx, home);
+	installPetDriver(ctx, home, pet);
+	installSettingsPage(ctx, home, pet);
 	ctx.effect(() => () => {
 		readFile(petLocatorPath(), "utf8").then((raw) => {
 			if (JSON.parse(raw).pid === process.pid) return unlink(petLocatorPath());