diff --git a/plugins/jsc-mod-companion/.claude-plugin/plugin.json b/plugins/jsc-mod-companion/.claude-plugin/plugin.json index d104773..261b6f0 100644 --- a/plugins/jsc-mod-companion/.claude-plugin/plugin.json +++ b/plugins/jsc-mod-companion/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-mod-companion", - "version": "0.0.4", + "version": "0.0.3", "description": "小說角色陪伴：人設注入、語氣、心情與好感、互動記憶、主動關心與待辦，並可用 ingest skill 解析小說建立角色", "license": "MIT", "author": { diff --git a/plugins/jsc-mod-companion/README.md b/plugins/jsc-mod-companion/README.md index f950b50..ed14ae6 100644 --- a/plugins/jsc-mod-companion/README.md +++ b/plugins/jsc-mod-companion/README.md @@ -6,8 +6,11 @@ 查看目前角色、心情、關係階段與四維度（好感、信賴、親密、依賴）與待辦數量。 +查看目前角色、心情、好感與待辦數量。情緒有 8 個維度（心情、精力、害羞、忌妒、想念、心跳、想家、不悅），預設列出前 3 強，`--all` 顯示完整數值（▰▱ 量表依維度上色）；band 上的情緒名稱為目前最強的主情緒。 + ```text /jsc-mod-companion:status +/jsc-mod-companion:status --all ``` ### `/jsc-mod-companion:switch <角色>` @@ -116,3 +119,11 @@ - 正則先判明確的情況（責罵、感謝、完成）。 - 正則沒判出時，採用模型於回覆末尾補的 `<評估:標籤>`；標籤須在 `tags.ts` 的白名單內，缺失或不在白名單就當作沒有標籤。 - 白名單約 20 個，參考 wiki 第 9.4 章；不含戀愛與親密類標籤。 + +## 情緒模型 + +- 8 維度各有基準與半衰期（心情 8h、精力 6h、害羞 2h、忌妒 4h、想念 12h、心跳 1h、想家 24h、不悅 4h，神經質 50 時），數值集中在 `hooks/companion/emotion.ts`。 +- 晝夜節律：精力基準在本地 15 點最高、凌晨 3 點最低（±0.1，依 `tz` 設定）。 +- 事件的情感注入、疲勞易怒（精力低於 0.3 時負面變化 ×1.5）、正向習慣化（重複 ×0.7ⁿ）、負向敏感化（重複最多 ×2），計次以 6 小時半衰期遺忘。 +- 舊的 PAD 存檔讀檔時自動映射（p→心情、a→精力、d→害羞）並升級，不需重建。 +- 與第 9 章的差異：晝夜節律振幅、習慣化係數等數值為本實作自訂，尚未逐項對照第 9 章。 diff --git a/plugins/jsc-mod-companion/hooks/companion/core.ts b/plugins/jsc-mod-companion/hooks/companion/core.ts index c73b1b1..fad8f77 100644 --- a/plugins/jsc-mod-companion/hooks/companion/core.ts +++ b/plugins/jsc-mod-companion/hooks/companion/core.ts @@ -3,7 +3,9 @@ import type { LegacyAffinity } from './relation' import { FUBUKI } from './defaults' import { readJson, writeJson } from './fs' import type { Clock, Fs } from './fs' -import { applyDelta, decay, keywordEvent, MOOD_EVENTS, moodLabel } from './mood' +import { applyEvent, baselineOf, decayEmotions, dominant, fromPad, gauge, ranked, toPad } from './emotion' +import type { Emotions } from './emotion' +import { keywordEvent, MOOD_EVENTS, moodLabel } from './mood' import type { MoodEvent } from './mood' import { extraversionOf, neuroticismOf } from './core/params' import { extractTag } from './tags' @@ -29,6 +31,7 @@ export const DEFAULT_USER: UserSettings = { export type View = { core: CompanionCore mood: Pad + emotions: Emotions label: string kaomoji: string relation: Dims @@ -52,15 +55,21 @@ export function createCompanion({ fs, clock, root, builtins = [FUBUKI] }: Compan if (!core || !b) return core return { ...core, persona: core.persona ?? b.persona, attribute: core.attribute ?? b.attribute, extraversion: core.extraversion ?? b.extraversion, freq: core.freq ?? b.freq } } - // 舊存檔只有單一 affinity：讀檔時升級成四維度並寫回 - const getState = async (id: string): Promise => { - const st = await readJson & { relation?: CompanionState['relation']; affinity?: LegacyAffinity }>(fs, `${dir(id)}/state.json`) - if (!st) return null - if (st.relation) return st as CompanionState - const { affinity, ...rest } = st - const up: CompanionState = { ...rest, relation: affinity ? migrateAffinity(affinity) : initialRelation(clock.now()) } - await writeJson(fs, `${dir(id)}/state.json`, up) - return up + const baseOf = (core: CompanionCore) => baselineOf(core.baseline, core.emotionBaseline) + // 讀檔時把舊存檔升級並寫回，不要求重建：PAD（mood）映射到八維度；單一好感（affinity）升成關係四維度 + const getState = async (id: string, core: CompanionCore): Promise => { + const raw = await readJson & { emotion?: CompanionState['emotion']; relation?: CompanionState['relation']; mood?: Pad & { at: number }; affinity?: LegacyAffinity }>(fs, `${dir(id)}/state.json`) + if (!raw) return null + if (raw.emotion && raw.relation) return { ...raw, habit: raw.habit ?? {} } as CompanionState + const { mood, affinity, ...rest } = raw + const st = { + ...rest, + emotion: raw.emotion ?? fromPad(mood ?? { ...core.baseline, at: clock.now() }, baseOf(core), core.baseline), + habit: raw.habit ?? {}, + relation: raw.relation ?? (affinity ? migrateAffinity(affinity) : initialRelation(clock.now())), + } as CompanionState + await putState(id, st) + return st } const putState = (id: string, s: CompanionState) => writeJson(fs, `${dir(id)}/state.json`, s) @@ -68,7 +77,7 @@ export function createCompanion({ fs, clock, root, builtins = [FUBUKI] }: Compan if (await getCore(core.id)) return const now = clock.now() await writeJson(fs, `${dir(core.id)}/core.json`, core) - await putState(core.id, { mood: { ...core.baseline, at: now }, relation: initialRelation(now), todos: 0 }) + await putState(core.id, { emotion: { ...baselineOf(core.baseline, core.emotionBaseline), at: now }, habit: {}, relation: initialRelation(now), todos: 0 }) } // 第一次啟用自動啟用預設角色；之後即使關閉也不會再自動啟用 @@ -87,28 +96,33 @@ export function createCompanion({ fs, clock, root, builtins = [FUBUKI] }: Compan const { active } = await getGlobal() if (!active) return null const core = await getCore(active) - const st = await getState(active) + const st = core && (await getState(active, core)) if (!core || !st) return null const now = clock.now() - const mood = decay(st.mood, core.baseline, now - st.mood.at, neuroticismOf(core, st)) + const base = baseOf(core) + const emotions = decayEmotions(st.emotion, base, now, neuroticismOf(core, st), tzMinutes((await getUser()).tz)) + const mood = toPad(emotions, base, core.baseline) + const main = dominant(emotions) const rel = idleDecay(st.relation, now) const todos = (await readJson<{ done: boolean }[]>(fs, `${dir(active)}/todos.json`))?.filter(t => !t.done).length ?? 0 - return { core, mood, ...moodLabel(mood), relation: effective(rel), stage: STAGES[rel.stage]!, todos } + return { core, mood, emotions, ...(main ?? moodLabel(mood)), relation: effective(rel), stage: STAGES[rel.stage]!, todos } } async function mutate(fn: (core: CompanionCore, st: CompanionState, now: number) => CompanionState) { const { active } = await getGlobal() if (!active) return const core = await getCore(active) - const st = await getState(active) + const st = core && (await getState(active, core)) if (!core || !st) return await putState(active, fn(core, st, clock.now())) } async function moodEvent(ev: MoodEvent) { + const tz = (await getUser()).tz await mutate((core, st, now) => { - const cur = decay(st.mood, core.baseline, now - st.mood.at, neuroticismOf(core, st)) - return { ...st, mood: { ...applyDelta(cur, MOOD_EVENTS[ev]), at: now } } + const cur = decayEmotions(st.emotion, baseOf(core), now, neuroticismOf(core, st), tzMinutes(tz)) + const next = applyEvent(cur, st.habit, ev, now) + return { ...st, emotion: { ...next.emotions, at: now }, habit: next.habit } }) } @@ -118,11 +132,14 @@ export function createCompanion({ fs, clock, root, builtins = [FUBUKI] }: Compan const bar = (v: number) => (v >= 0 ? '+' : '') + v.toFixed(2) - async function status(): Promise { + async function status(all = false): Promise { const v = await view() if (!v) return '目前沒有啟用角色。' const lines = [`${v.kaomoji} ${v.core.name}｜${v.label}`] lines.push(`心情 PAD：P ${bar(v.mood.p)} A ${bar(v.mood.a)} D ${bar(v.mood.d)}`) + const dims = ranked(v.emotions) + lines.push(all ? '情緒（完整）：' : '情緒（前 3 強，/status --all 看完整）：') + for (const d of all ? dims : dims.slice(0, 3)) lines.push(` ${gauge(d, v.emotions)}`) lines.push(`好感：${v.stage}（${v.relation.affection.toFixed(1)}）`) lines.push(`關係：好感 ${v.relation.affection.toFixed(1)} 信賴 ${v.relation.trust.toFixed(1)} 親密 ${v.relation.intimacy.toFixed(1)} 依賴 ${v.relation.dependence.toFixed(1)}`) lines.push(`待辦：${v.todos}`) @@ -177,7 +194,7 @@ export function createCompanion({ fs, clock, root, builtins = [FUBUKI] }: Compan async function command(raw: string): Promise { const [sub = '', ...rest] = raw.trim().split(/\s+/).filter(Boolean) - if (sub === 'status') return status() + if (sub === 'status') return status(rest.includes('--all')) if (sub === 'switch') return rest[0] ? switchTo(rest[0]) : `用法：/jsc-mod-companion:switch <角色>。可用：${(await available()).join('、')}` if (sub === 'off') { const g = await getGlobal() diff --git a/plugins/jsc-mod-companion/hooks/companion/emotion.test.ts b/plugins/jsc-mod-companion/hooks/companion/emotion.test.ts new file mode 100644 index 0000000..fb1c54b --- /dev/null +++ b/plugins/jsc-mod-companion/hooks/companion/emotion.test.ts @@ -0,0 +1,150 @@ +import { describe, expect, test } from 'claude-code/testing' + +import { createCompanion } from './core' +import { applyEvent, baselineOf, circadian, decayEmotions, dominant, fromPad, halfLifeMs, toPad } from './emotion' +import type { Emotions } from './emotion' +import { fakeClock, memoryFs } from './fs' +import type { CompanionCore } from './types' + +const H = 3_600_000 +const near = (a: number, b: number) => expect(Math.abs(a - b)).toBeLessThan(1e-9) +const ZERO = baselineOf({ p: 0, a: 0, d: 0 }) +// 本地正午 12:00（tz +0000），晝夜節律不為 0 但不影響其他維度 +const NOON = Date.UTC(2026, 9, 14, 12) + +const MIKO: CompanionCore = { + id: 'miko', + name: '月見ミコ', + facts: { birthday: 'unknown', zodiac: 'unknown', bloodType: 'unknown', hair: 'unknown', face: 'unknown', height: 'unknown', weight: 'unknown', measurements: 'unknown' }, + neuroticism: 50, + baseline: { p: 0, a: 0, d: 0 }, +} + +describe('衰減', () => { + test('各維度依自己的半衰期回到基線', () => { + const s = { ...ZERO, shy: 1, homesick: 1, mood: 1, at: NOON } + const e = decayEmotions(s, ZERO, NOON + 2 * H, 50, 0) + near(e.shy, 0.5) // 害羞半衰期 2 小時 + near(e.homesick, Math.pow(0.5, 2 / 24)) // 想家半衰期 24 小時 + near(e.mood, 0.5 + 0.5 * Math.pow(0.5, 2 / 8)) + }) + + test('神經質影響半衰期，且久放會回到基線', () => { + expect(halfLifeMs('mood', 100)).toBeGreaterThan(halfLifeMs('mood', 0)) + const e = decayEmotions({ ...ZERO, upset: 1, at: NOON }, ZERO, NOON + 30 * 24 * H, 50, 0) + expect(e.upset).toBeLessThan(0.001) + }) + + test('精力基線隨晝夜節律：下午高、凌晨低', () => { + const at = (h: number) => decayEmotions({ ...ZERO, at: 0 }, ZERO, Date.UTC(2026, 9, 14, h) + 365 * 24 * H, 50, 0).energy + expect(at(15)).toBeGreaterThan(at(3)) + near(circadian(Date.UTC(2026, 9, 14, 15), 0), 0.1) + near(circadian(Date.UTC(2026, 9, 14, 7), 480), 0.1) // 時區換算：UTC 07 = 本地 15 + }) +}) + +describe('習慣化與敏感化', () => { + test('正向事件重複發生，效果遞減', () => { + let e: Emotions = ZERO + let habit = {} + const gains: number[] = [] + for (let i = 0; i < 3; i++) { + const r = applyEvent(e, habit, 'thanks', NOON) + gains.push(r.emotions.mood - e.mood) + ;({ emotions: e, habit } = r) + } + near(gains[0]!, 0.075) + near(gains[1]!, 0.075 * 0.7) + near(gains[2]!, 0.075 * 0.49) + }) + + test('習慣化隨時間遺忘：隔 6 小時後計次減半', () => { + const r1 = applyEvent(ZERO, {}, 'thanks', NOON) + const r2 = applyEvent(ZERO, r1.habit, 'thanks', NOON + 6 * H) + near(r2.emotions.mood - ZERO.mood, 0.075 * Math.pow(0.7, 0.5)) + }) + + test('負向事件重複發生，傷害放大且上限 2 倍', () => { + let e: Emotions = { ...ZERO, mood: 1, energy: 0.6 } + let habit = {} + const drops: number[] = [] + for (let i = 0; i < 6; i++) { + const r = applyEvent(e, habit, 'scold', NOON) + drops.push(e.mood - r.emotions.mood) + ;({ emotions: e, habit } = r) + } + near(drops[0]!, 0.06) + near(drops[1]!, 0.06 * 1.25) + near(drops[5]!, 0.06 * 2) + }) + + test('疲勞易怒：精力低時負面變化放大 1.5 倍', () => { + const fresh = applyEvent({ ...ZERO, energy: 0.6 }, {}, 'toolFail', NOON).emotions + const tired = applyEvent({ ...ZERO, energy: 0.1 }, {}, 'toolFail', NOON).emotions + near(tired.upset - ZERO.upset, (fresh.upset - ZERO.upset) * 1.5) + }) + + test('情感注入：感謝帶動心跳，想念會在回來時消解', () => { + expect(applyEvent(ZERO, {}, 'thanks', NOON).emotions.heartbeat).toBeGreaterThan(0) + const missing = applyEvent(ZERO, {}, 'ignored', NOON).emotions + expect(applyEvent(missing, {}, 'return', NOON).emotions.missing).toBeLessThan(missing.missing) + }) + + test('每維度單回合變化不超過 0.3，值域 0~1', () => { + const r = applyEvent({ ...ZERO, mood: 0.05 }, { scold: { n: 50, at: NOON } }, 'scold', NOON).emotions + expect(r.mood).toBeGreaterThanOrEqual(0) + expect(r.upset).toBeLessThanOrEqual(0.3) + }) +}) + +describe('主情緒', () => { + test('強度達門檻才採用，否則回到 PAD 八分區標籤', () => { + expect(dominant(ZERO)).toBe(null) + expect(dominant({ ...ZERO, shy: 0.8 })?.label).toBe('害羞') + expect(dominant({ ...ZERO, mood: 0.1 })?.label).toBe('低落') + }) +}) + +describe('舊 PAD 存檔升級', () => { + test('PAD 映射到八維度並可還原', () => { + const base = baselineOf({ p: 0.2, a: 0.1, d: 0.1 }) + const e = fromPad({ p: -0.5, a: 0.4, d: -0.3, at: 7 }, base, { p: 0.2, a: 0.1, d: 0.1 }) + expect(e.at).toBe(7) + const pad = toPad(e, base, { p: 0.2, a: 0.1, d: 0.1 }) + near(pad.p, -0.5) + near(pad.a, 0.4) + near(pad.d, -0.3) + }) + + test('讀檔時自動升級並寫回，狀態不變', async () => { + const fs = memoryFs() + const clock = fakeClock() + const root = '/h/.companion' + const now = clock.now() + const old = { mood: { p: 0.3, a: 0, d: 0, at: now }, affinity: { value: 0.1, stage: 0, dayKey: '', dayGain: 0, lastSeen: now }, todos: 0 } + fs.files.set(`${root}/global.json`, JSON.stringify({ active: 'miko', activatedOnce: true })) + fs.files.set(`${root}/companions/miko/core.json`, JSON.stringify(MIKO)) + fs.files.set(`${root}/companions/miko/state.json`, JSON.stringify(old)) + const c = createCompanion({ fs, clock, root, builtins: [MIKO] }) + const v = (await c.view())! + near(v.mood.p, 0.3) + near(v.emotions.mood, 0.65) + await c.moodEvent('thanks') + const saved = JSON.parse(fs.files.get(`${root}/companions/miko/state.json`)!) + expect(saved.mood).toBeUndefined() + expect(saved.emotion.mood).toBeGreaterThan(0.65) + }) +}) + +describe('/status', () => { + test('預設顯示前 3 強情緒，--all 顯示 8 維度', async () => { + const fs = memoryFs() + const c = createCompanion({ fs, clock: fakeClock(), root: '/h/.companion', builtins: [MIKO] }) + await c.ensureActivated() + await c.moodEvent('scold') + const brief = (await c.command('status')).split('\n').filter(l => l.startsWith(' ') && l.includes('\x1b[')) + expect(brief).toHaveLength(3) + const all = (await c.command('status --all')).split('\n').filter(l => l.startsWith(' ') && l.includes('\x1b[')) + expect(all).toHaveLength(8) + }) +}) diff --git a/plugins/jsc-mod-companion/hooks/companion/emotion.ts b/plugins/jsc-mod-companion/hooks/companion/emotion.ts new file mode 100644 index 0000000..c3a700f --- /dev/null +++ b/plugins/jsc-mod-companion/hooks/companion/emotion.ts @@ -0,0 +1,180 @@ +import { clamp, MOOD_EVENTS } from './mood' +import type { MoodEvent } from './mood' +import { bar } from './seg' +import type { Pad } from './types' + +const HOUR = 3_600_000 + +// 八個情緒維度，值域皆為 0~1（心情、精力以 0.5 為中性） +export const DIMS = ['mood', 'energy', 'shy', 'jealous', 'missing', 'heartbeat', 'homesick', 'upset'] as const +export type Dim = (typeof DIMS)[number] +export type Emotions = Record +export type EmotionState = Emotions & { at: number } + +// 各維度半衰期（小時，神經質 50 時的值） +export const HALF_LIFE_H: Record = { + mood: 8, + energy: 6, + shy: 2, + jealous: 4, + missing: 12, + heartbeat: 1, + homesick: 24, + upset: 4, +} + +export const DIM_INFO: Record = { + mood: { name: '心情', kaomoji: '(´ᴗ`)', ansi: '32' }, + energy: { name: '精力', kaomoji: '(≧▽≦)', ansi: '33' }, + shy: { name: '害羞', kaomoji: '(๑>◡<๑)', ansi: '36' }, + jealous: { name: '忌妒', kaomoji: '(￣^￣)', ansi: '35' }, + missing: { name: '想念', kaomoji: '(´;ω;`)', ansi: '34' }, + heartbeat: { name: '心跳', kaomoji: '(*´∀`*)', ansi: '91' }, + homesick: { name: '想家', kaomoji: '(´･_･`)', ansi: '90' }, + upset: { name: '不悅', kaomoji: '(╬`益´)', ansi: '31' }, +} + +// 心情、精力是雙向維度，主情緒標籤依高低而定 +const POLES: Partial> = { mood: ['低落', '開心'], energy: ['疲倦', '有精神'] } + +// 高神經質的角色情緒消退較慢：50 為基準，0→0.5 倍，100→1.5 倍 +export const halfLifeMs = (dim: Dim, neuroticism: number) => HALF_LIFE_H[dim] * HOUR * (0.5 + neuroticism / 100) + +export const clampDim = (x: number) => clamp(x, 0, 1) + +/** 由 PAD 基線推得各維度基線；其餘維度基線為 0 */ +export function baselineOf(pad: Pad, override: Partial = {}): Emotions { + return { + mood: clampDim((pad.p + 1) / 2), + energy: clampDim((pad.a + 1) / 2), + shy: clampDim(-pad.d), + jealous: 0, + missing: 0, + heartbeat: 0, + homesick: 0, + upset: 0, + ...override, + } +} + +/** 晝夜節律：精力基線在本地 15 點最高、凌晨 3 點最低，振幅 ±0.1 */ +export function circadian(nowMs: number, tzOffsetMin: number): number { + const hour = (((nowMs / HOUR + tzOffsetMin / 60) % 24) + 24) % 24 + return 0.1 * Math.cos(((hour - 15) / 24) * 2 * Math.PI) +} + +// 讀檔時才計算：x = B + (x − B)·0.5^(Δ/τ)，精力的 B 疊加晝夜節律 +export function decayEmotions(s: EmotionState, baseline: Emotions, now: number, neuroticism: number, tzOffsetMin: number): Emotions { + const dt = Math.max(0, now - s.at) + const out = {} as Emotions + for (const d of DIMS) { + const b = d === 'energy' ? clampDim(baseline.energy + circadian(now, tzOffsetMin)) : baseline[d] + out[d] = clampDim(b + (s[d] - b) * Math.pow(0.5, dt / halfLifeMs(d, neuroticism))) + } + return out +} + +/** 由八維度推回 PAD，供記憶檢索與相容介面使用 */ +export function toPad(e: Emotions, baseline: Emotions, basePad: Pad): Pad { + return { + p: clamp((e.mood - 0.5) * 2 - e.upset), + a: clamp((e.energy - 0.5) * 2), + d: clamp(basePad.d + baseline.shy - e.shy), + } +} + +/** 舊 PAD 存檔 → 八維度（p→心情、a→精力、d→害羞，其餘維度取基線） */ +export function fromPad(mood: Pad & { at: number }, baseline: Emotions, basePad: Pad): EmotionState { + return { + ...baseline, + mood: clampDim((mood.p + 1) / 2), + energy: clampDim((mood.a + 1) / 2), + shy: clampDim(baseline.shy + basePad.d - mood.d), + at: mood.at, + } +} + +// 情感注入：事件（評估標籤）對各維度的增減。mood／upset／energy／shy 由 rules.ts 的 PAD 增減換算 +// （p>0 → 心情 p/2；p<0 → 心情 0.3p、不悅 −0.4p；a/2 → 精力；−d → 害羞），合成後與 PAD 增減一致； +// 心跳、想念、想家等新維度的額外效果寫在 EXTRA +const EXTRA: Partial>> = { + thanks: { heartbeat: 0.05 }, + return: { missing: -0.3, heartbeat: 0.1 }, + lateNight: { homesick: 0.05 }, + favorite: { heartbeat: 0.08 }, + ignored: { missing: 0.1 }, + cared: { heartbeat: 0.05, missing: -0.1 }, + remembered: { heartbeat: 0.05 }, +} + +export function emotionEffect(ev: MoodEvent): Partial { + const { p, a, d } = MOOD_EVENTS[ev] + return { + mood: p > 0 ? p / 2 : p * 0.3, + upset: p < 0 ? -p * 0.4 : 0, + energy: a / 2, + shy: -d, + ...EXTRA[ev], + } +} + +// 「壞」方向：心情下降，或不悅、忌妒上升 +const isBad = (d: Dim, x: number) => (d === 'mood' ? x < 0 : (d === 'upset' || d === 'jealous') && x > 0) + +export const TURN_CAP = 0.3 +export const TIRED = 0.3 +export const IRRITABLE = 1.5 +export const HABITUATION = 0.7 +export const SENSITIZATION = 0.25 +export const SENSITIZATION_MAX = 2 +export const HABIT_HALF_LIFE_H = 6 + +export type Habit = Partial> + +const habitCount = (h: Habit, ev: MoodEvent, now: number) => { + const r = h[ev] + return r ? r.n * Math.pow(0.5, Math.max(0, now - r.at) / (HABIT_HALF_LIFE_H * HOUR)) : 0 +} + +/** + * 套用事件：正向事件習慣化（重複受益遞減，0.7^n）、負向事件敏感化（重複受創放大，上限 2 倍）、 + * 精力低於 0.3 時負面變化放大 1.5 倍（疲勞易怒）；每個維度單回合變化上限 ±0.3。 + * 計次隨時間以 6 小時半衰期遺忘。 + */ +export function applyEvent(cur: Emotions, habit: Habit, ev: MoodEvent, now: number): { emotions: Emotions; habit: Habit } { + const n = habitCount(habit, ev, now) + const p = MOOD_EVENTS[ev].p + const gain = p > 0 ? Math.pow(HABITUATION, n) : 1 + const harm = p < 0 ? Math.min(SENSITIZATION_MAX, 1 + SENSITIZATION * n) : 1 + const irritable = cur.energy < TIRED ? IRRITABLE : 1 + const out = { ...cur } + for (const [d, raw] of Object.entries(emotionEffect(ev)) as [Dim, number][]) { + const dx = raw * (isBad(d, raw) ? harm * irritable : gain) + out[d] = clampDim(out[d] + clamp(dx, -TURN_CAP, TURN_CAP)) + } + return { emotions: out, habit: { ...habit, [ev]: { n: n + 1, at: now } } } +} + +/** 強度：雙向維度為偏離中性的程度，其餘維度即其值 */ +export const salience = (d: Dim, v: number) => (POLES[d] ? Math.abs(v - 0.5) * 2 : v) + +export function ranked(e: Emotions): Dim[] { + return [...DIMS].sort((a, b) => salience(b, e[b]) - salience(a, e[a])) +} + +export const DOMINANT_MIN = 0.25 + +/** 主情緒：強度達門檻的最強維度；否則 null，由 PAD 八分區標籤補位 */ +export function dominant(e: Emotions): { dim: Dim; label: string; kaomoji: string } | null { + const dim = ranked(e)[0]! + if (salience(dim, e[dim]) < DOMINANT_MIN) return null + const poles = POLES[dim] + return { dim, label: poles ? poles[e[dim] >= 0.5 ? 1 : 0] : DIM_INFO[dim].name, kaomoji: DIM_INFO[dim].kaomoji } +} + +/** /status 的情緒量表：▰▱ 依維度上色 */ +export function gauge(d: Dim, e: Emotions): string { + const poles = POLES[d] + const name = poles ? `${DIM_INFO[d].name}（${poles[e[d] >= 0.5 ? 1 : 0]}）` : DIM_INFO[d].name + return `${name} \x1b[${DIM_INFO[d].ansi}m${bar(e[d] * 100)}\x1b[0m ${Math.round(e[d] * 100)}` +} diff --git a/plugins/jsc-mod-companion/hooks/companion/mood.ts b/plugins/jsc-mod-companion/hooks/companion/mood.ts index 2b060c7..1aefa28 100644 --- a/plugins/jsc-mod-companion/hooks/companion/mood.ts +++ b/plugins/jsc-mod-companion/hooks/companion/mood.ts @@ -4,31 +4,6 @@ import type { Pad } from './types' export const clamp = (x: number, lo = -1, hi = 1) => Math.max(lo, Math.min(hi, x)) -const HOUR = 3_600_000 -const MOOD_HALF_LIFE_H = 8 - -// 高神經質的角色情緒消退較慢：50 為基準，0→0.5 倍，100→1.5 倍 -export const halfLife = (neuroticism: number) => MOOD_HALF_LIFE_H * HOUR * (0.5 + neuroticism / 100) - -// 讀檔時才計算：x = B + (x − B)·0.5^(Δ/τ) -export function decay(mood: Pad, baseline: Pad, elapsedMs: number, neuroticism: number): Pad { - if (elapsedMs <= 0) return { p: mood.p, a: mood.a, d: mood.d } - const k = Math.pow(0.5, elapsedMs / halfLife(neuroticism)) - return { - p: baseline.p + (mood.p - baseline.p) * k, - a: baseline.a + (mood.a - baseline.a) * k, - d: baseline.d + (mood.d - baseline.d) * k, - } -} - -// 單軸每回合變化上限 ±0.3 -export const TURN_CAP = 0.3 - -export function applyDelta(mood: Pad, delta: Pad): Pad { - const step = (x: number, dx: number) => clamp(x + clamp(dx, -TURN_CAP, TURN_CAP)) - return { p: step(mood.p, delta.p), a: step(mood.a, delta.a), d: step(mood.d, delta.d) } -} - // 心情事件即評估標籤，增減量由 rules.ts 的規則表決定 export const MOOD_EVENTS = RULES export type MoodEvent = Tag diff --git a/plugins/jsc-mod-companion/hooks/companion/rules.test.ts b/plugins/jsc-mod-companion/hooks/companion/rules.test.ts index 4e661a4..953da37 100644 --- a/plugins/jsc-mod-companion/hooks/companion/rules.test.ts +++ b/plugins/jsc-mod-companion/hooks/companion/rules.test.ts @@ -75,13 +75,13 @@ describe('缺失退回', () => { await a.ensureActivated() await a.onPrompt('今天好累') await a.onTurnComplete(false, '辛苦了\n<評估:soothe>') - expect((await a.view())!.mood.p).toBeCloseTo(RULES.soothe.p, 5) + expect(Math.abs((await a.view())!.mood.p - RULES.soothe.p)).toBeLessThan(1e-5) const b = mk() await b.ensureActivated() await b.onPrompt('謝謝你') await b.onTurnComplete(false, '不客氣\n<評估:scold>') - expect((await b.view())!.mood.p).toBeCloseTo(RULES.thanks.p, 5) + expect(Math.abs((await b.view())!.mood.p - RULES.thanks.p)).toBeLessThan(1e-5) const c = mk() await c.ensureActivated() diff --git a/plugins/jsc-mod-companion/hooks/companion/types.ts b/plugins/jsc-mod-companion/hooks/companion/types.ts index ad34a70..cb5f00e 100644 --- a/plugins/jsc-mod-companion/hooks/companion/types.ts +++ b/plugins/jsc-mod-companion/hooks/companion/types.ts @@ -1,4 +1,5 @@ import type { Attribute, Trigger } from './care' +import type { EmotionState, Emotions, Habit } from './emotion' import type { ParamVec } from './core/params' export type Pad = { p: number; a: number; d: number } @@ -28,6 +29,8 @@ export type CompanionCore = { params?: ParamVec baseline: Pad relationTraits?: RelationTraits + // 八維度個別基線（覆寫由 baseline 推得的值），角色專屬值放本機 core.json + emotionBaseline?: Partial } export const STAGES = ['陌生', '熟人', '朋友', '好友'] as const @@ -49,7 +52,8 @@ export type Relation = { export type RelationTraits = { guard?: number; shy?: number; coy?: number; clingy?: number } export type CompanionState = { - mood: Pad & { at: number } + emotion: EmotionState + habit: Habit relation: Relation todos: number // 人格 18 參數的存檔偏移與今日偏移（今日偏移於 dayKey 當天有效）