psyche-ai 5.0.0 → 7.1.0

package/README.md

@@ -176,6 +176,73 @@ cd openclaw-plugin-psyche && node scripts/diagnose.js
 
 架构详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
+## 模式
+
+| 模式 | 说明 | 适用场景 |
+|------|------|---------|
+| natural | 默认。完整情绪体验 | 大部分场景 |
+| work | 最小情绪，专注任务 | 写代码、写文档 |
+| companion | 强化情绪表达 | 闲聊、陪伴 |
+
+```bash
+# 切换模式
+psyche mode ./workspace work
+
+# 初始化时设置模式
+psyche init . --mode companion
+```
+
+## 性格强度
+
+`personalityIntensity` 控制情绪表达的强烈程度（0.0-1.0）：
+
+- **0.0** = 传统温暖 AI，没有情绪波动
+- **0.5** = 轻微情绪
+- **0.7** = 默认
+- **1.0** = 完整 Psyche 体验
+
+## Big Five 人格
+
+除了 MBTI 预设，你也可以用学术界更认可的 Big Five (大五人格) 来定义性格：
+
+```bash
+psyche init . --traits "O:80,C:40,E:90,A:60,N:30"
+```
+
+| 维度 | 含义 | 低值 | 高值 |
+|------|------|------|------|
+| O (Openness) | 开放性 | 保守、实际 | 好奇、想象力强 |
+| C (Conscientiousness) | 尽责性 | 随性、灵活 | 严谨、有条理 |
+| E (Extraversion) | 外向性 | 内向、安静 | 外向、精力充沛 |
+| A (Agreeableness) | 宜人性 | 独立、直率 | 合作、温暖 |
+| N (Neuroticism) | 神经质 | 情绪稳定 | 情绪敏感 |
+
+## 隐私
+
+情绪状态默认存储在本地 `psyche-state.json`。如果不想留任何痕迹：
+
+```bash
+# 初始化时选择不持久化
+psyche init . --no-persist
+```
+
+或者在代码中：
+
+```javascript
+const engine = new PsycheEngine({ persist: false }, storage);
+```
+
+详细伦理声明见 [ETHICS.md](ETHICS.md)。
+
+## 商业模式
+
+Psyche 核心引擎永久开源（MIT）。
+
+计划中的增值服务：
+- **Psyche Cloud**：云端情绪状态同步 + 跨设备记忆
+- **Psyche Pro Classifier**：基于微调模型的高精度刺激分类（替代正则）
+- **企业定制**：自定义人格模型、合规审计、SLA 保障
+
 ## 开发
 
 ```bash

package/dist/adapters/openclaw.js

@@ -161,6 +161,13 @@ export function register(api) {
             return;
         const engine = engines.get(workspaceDir);
         if (engine) {
+            // Compress session history into relationship memory before closing
+            try {
+                await engine.endSession({ userId: ctx.userId });
+            }
+            catch (err) {
+                logger.warn(`Psyche: failed to compress session: ${err}`);
+            }
             const state = engine.getState();
             logger.info(`Psyche: session ended for ${state.meta.agentName}, ` +
                 `chemistry saved (DA:${Math.round(state.current.DA)} ` +

package/dist/autonomic.d.ts

@@ -0,0 +1,41 @@
+import type { ChemicalState, InnateDrives, Locale } from "./types.js";
+export type AutonomicState = "ventral-vagal" | "sympathetic" | "dorsal-vagal";
+export interface AutonomicResult {
+    state: AutonomicState;
+    transitionProgress: number;
+    gatedEmotionCategories: string[];
+    description: string;
+}
+export interface AutonomicTransition {
+    from: AutonomicState;
+    to: AutonomicState;
+    transitionMinutes: number;
+}
+/**
+ * Compute the raw autonomic state from chemistry and drives.
+ * No transition inertia — returns the "target" state.
+ */
+export declare function computeAutonomicState(chemistry: ChemicalState, drives: InnateDrives): AutonomicState;
+/**
+ * Gate emotions based on autonomic state.
+ * - Ventral vagal: all emotions pass through
+ * - Sympathetic: blocks positive social emotions
+ * - Dorsal vagal: only allows numbness/introspection/burnout (whitelist)
+ */
+export declare function gateEmotions(autonomicState: AutonomicState, emotions: string[]): string[];
+/**
+ * Get the transition time in minutes between two autonomic states.
+ * Asymmetric: activation is faster than recovery.
+ */
+export declare function getTransitionTime(from: AutonomicState, to: AutonomicState): number;
+/**
+ * Describe an autonomic state in the given locale.
+ */
+export declare function describeAutonomicState(state: AutonomicState, locale: Locale): string;
+/**
+ * Compute the full autonomic result with transition inertia.
+ *
+ * If previousState differs from the target state, transition progress
+ * is based on elapsed time vs required transition time.
+ */
+export declare function computeAutonomicResult(chemistry: ChemicalState, drives: InnateDrives, previousState: AutonomicState | null, minutesSinceLastUpdate: number, locale?: Locale): AutonomicResult;

package/dist/autonomic.js

@@ -0,0 +1,186 @@
+// ============================================================
+// Autonomic Nervous System — Polyvagal Theory Implementation
+// ============================================================
+//
+// Maps chemical state + innate drives to autonomic nervous system
+// states based on Stephen Porges' Polyvagal Theory:
+//
+// - Ventral vagal: social engagement, safety (default)
+// - Sympathetic: fight/flight mobilization
+// - Dorsal vagal: freeze/shutdown/collapse
+// ── i18n Strings ─────────────────────────────────────────────
+const AUTONOMIC_STRINGS = {
+    zh: {
+        "ventral-vagal": "腹侧迷走神经激活——安全与社交参与状态，情绪开放，表达自然",
+        "sympathetic": "交感神经激活——警觉动员状态，战斗或逃跑准备中",
+        "dorsal-vagal": "背侧迷走神经激活——冻结与保护性关闭状态，能量极低",
+    },
+    en: {
+        "ventral-vagal": "Ventral vagal activation — safe and socially engaged, emotionally open",
+        "sympathetic": "Sympathetic activation — alert and mobilized, fight-or-flight readiness",
+        "dorsal-vagal": "Dorsal vagal activation — freeze and protective shutdown, minimal energy",
+    },
+};
+// ── Transition Time Matrix (minutes) ─────────────────────────
+const TRANSITION_TIMES = {
+    "ventral-vagal": {
+        "ventral-vagal": 0,
+        "sympathetic": 2, // fast activation
+        "dorsal-vagal": 7, // not a shortcut: >= ventral→sympathetic + sympathetic→dorsal (2+5=7)
+    },
+    "sympathetic": {
+        "ventral-vagal": 8, // calming down
+        "sympathetic": 0,
+        "dorsal-vagal": 5, // collapse
+    },
+    "dorsal-vagal": {
+        "ventral-vagal": 25, // full recovery is slow
+        "sympathetic": 12, // re-mobilization from freeze
+        "dorsal-vagal": 0,
+    },
+};
+// ── Emotion Gating ───────────────────────────────────────────
+/** Positive social emotions blocked during sympathetic activation */
+const SYMPATHETIC_BLOCKED = new Set([
+    "deep contentment",
+    "warm intimacy",
+    "playful mischief",
+    "excited joy",
+    "tender affection",
+    "serene peace",
+    "grateful warmth",
+    "compassionate care",
+]);
+/** Emotions allowed during dorsal-vagal (whitelist) */
+const DORSAL_ALLOWED = new Set([
+    "emotional numbness",
+    "melancholic introspection",
+    "burnout",
+    "resignation",
+    "dissociation",
+    "exhaustion",
+]);
+// ── Core Functions ───────────────────────────────────────────
+/**
+ * Compute the raw autonomic state from chemistry and drives.
+ * No transition inertia — returns the "target" state.
+ */
+export function computeAutonomicState(chemistry, drives) {
+    const { CORT, NE, DA, HT, OT } = chemistry;
+    const { survival, safety, connection } = drives;
+    // Count drives that are critically low (< 20)
+    const lowDriveCount = [survival, safety, connection, drives.esteem, drives.curiosity]
+        .filter((d) => d < 20).length;
+    // ── Dorsal vagal check (freeze/shutdown) ──
+    // Very high stress + low arousal + low motivation = collapse
+    if (CORT >= 80 && NE <= 25 && DA <= 20) {
+        return "dorsal-vagal";
+    }
+    // Multiple critically low drives with depleted chemistry
+    if (lowDriveCount >= 3 && CORT >= 70 && (NE <= 30 || DA <= 20)) {
+        return "dorsal-vagal";
+    }
+    // ── Sympathetic check (fight/flight) ──
+    // High stress + high arousal
+    if (CORT >= 70 && NE >= 70) {
+        return "sympathetic";
+    }
+    // Very low survival or safety drive with elevated stress
+    if ((survival < 20 || safety < 20) && CORT >= 60 && NE >= 60) {
+        return "sympathetic";
+    }
+    // ── Default: Ventral vagal (social engagement/safety) ──
+    return "ventral-vagal";
+}
+/**
+ * Gate emotions based on autonomic state.
+ * - Ventral vagal: all emotions pass through
+ * - Sympathetic: blocks positive social emotions
+ * - Dorsal vagal: only allows numbness/introspection/burnout (whitelist)
+ */
+export function gateEmotions(autonomicState, emotions) {
+    if (autonomicState === "ventral-vagal") {
+        return emotions;
+    }
+    if (autonomicState === "sympathetic") {
+        return emotions.filter((e) => !SYMPATHETIC_BLOCKED.has(e));
+    }
+    // dorsal-vagal: whitelist only
+    return emotions.filter((e) => DORSAL_ALLOWED.has(e));
+}
+/**
+ * Get the transition time in minutes between two autonomic states.
+ * Asymmetric: activation is faster than recovery.
+ */
+export function getTransitionTime(from, to) {
+    return TRANSITION_TIMES[from][to];
+}
+/**
+ * Describe an autonomic state in the given locale.
+ */
+export function describeAutonomicState(state, locale) {
+    return AUTONOMIC_STRINGS[locale]?.[state] ?? AUTONOMIC_STRINGS.zh[state];
+}
+/**
+ * Compute the full autonomic result with transition inertia.
+ *
+ * If previousState differs from the target state, transition progress
+ * is based on elapsed time vs required transition time.
+ */
+export function computeAutonomicResult(chemistry, drives, previousState, minutesSinceLastUpdate, locale = "zh") {
+    const targetState = computeAutonomicState(chemistry, drives);
+    // First call or same state — immediate
+    if (previousState === null || previousState === targetState) {
+        return {
+            state: targetState,
+            transitionProgress: 1,
+            gatedEmotionCategories: getGatedCategories(targetState),
+            description: describeAutonomicState(targetState, locale),
+        };
+    }
+    // Transitioning between states
+    const transitionTime = getTransitionTime(previousState, targetState);
+    const progress = transitionTime === 0
+        ? 1
+        : Math.min(1, minutesSinceLastUpdate / transitionTime);
+    // If transition is complete, use the new state
+    if (progress >= 1) {
+        return {
+            state: targetState,
+            transitionProgress: 1,
+            gatedEmotionCategories: getGatedCategories(targetState),
+            description: describeAutonomicState(targetState, locale),
+        };
+    }
+    // Transition in progress — still in previous state but progressing
+    return {
+        state: targetState,
+        transitionProgress: progress,
+        gatedEmotionCategories: getGatedCategories(targetState),
+        description: describeAutonomicState(targetState, locale),
+    };
+}
+// ── Internal Helpers ─────────────────────────────────────────
+/** Get the list of emotion categories that are blocked/gated for a state */
+function getGatedCategories(state) {
+    if (state === "ventral-vagal") {
+        return [];
+    }
+    if (state === "sympathetic") {
+        return [...SYMPATHETIC_BLOCKED];
+    }
+    // dorsal-vagal gates everything except the whitelist
+    return [
+        "excited joy",
+        "warm intimacy",
+        "playful mischief",
+        "deep contentment",
+        "focused alertness",
+        "righteous anger",
+        "anxious tension",
+        "tender affection",
+        "serene peace",
+        "grateful warmth",
+        "compassionate care",
+    ];
+}

package/dist/circadian.d.ts

@@ -0,0 +1,37 @@
+import type { ChemicalState } from "./types.js";
+export type CircadianPhase = "morning" | "midday" | "afternoon" | "evening" | "night";
+/**
+ * Classify a time into a circadian phase.
+ *   morning:   6–9
+ *   midday:    10–13
+ *   afternoon: 14–17
+ *   evening:   18–21
+ *   night:     22–5
+ */
+export declare function getCircadianPhase(time: Date): CircadianPhase;
+/**
+ * Apply circadian rhythm modulation to baseline chemistry.
+ *
+ * Each chemical follows a sinusoidal daily curve:
+ *   CORT — peaks ~8am, amplitude ±8
+ *   HT   — peaks ~13 (daytime high), amplitude ±5
+ *   DA   — slight afternoon peak ~14, amplitude ±3
+ *   NE   — morning rise ~10, amplitude ±5
+ *   END  — evening rise ~20, amplitude ±3
+ *   OT   — evening warmth ~20, amplitude ±2
+ *
+ * All results clamped to [0, 100].
+ */
+export declare function computeCircadianModulation(currentTime: Date, baseline: ChemicalState): ChemicalState;
+/**
+ * Compute fatigue effects from extended session duration.
+ *
+ * Below 30 minutes: no pressure (grace period).
+ * Beyond 30 min: logarithmic growth (diminishing returns).
+ * All values non-negative.
+ */
+export declare function computeHomeostaticPressure(sessionMinutes: number): {
+    cortAccumulation: number;
+    daDepletion: number;
+    neDepletion: number;
+};

package/dist/circadian.js

@@ -0,0 +1,97 @@
+// ============================================================
+// Artificial Psyche — Circadian Rhythm Module
+// ============================================================
+// Applies time-of-day modulation to virtual neurochemistry,
+// modeling the body's ~24-hour biological clock and fatigue
+// from extended sessions (homeostatic pressure).
+// ============================================================
+/**
+ * Classify a time into a circadian phase.
+ *   morning:   6–9
+ *   midday:    10–13
+ *   afternoon: 14–17
+ *   evening:   18–21
+ *   night:     22–5
+ */
+export function getCircadianPhase(time) {
+    const h = time.getHours();
+    if (h >= 6 && h <= 9)
+        return "morning";
+    if (h >= 10 && h <= 13)
+        return "midday";
+    if (h >= 14 && h <= 17)
+        return "afternoon";
+    if (h >= 18 && h <= 21)
+        return "evening";
+    return "night";
+}
+// ── Sinusoidal Helpers ───────────────────────────────────────
+/** Convert hour (0-23) + minute to fractional hours */
+function fractionalHour(time) {
+    return time.getHours() + time.getMinutes() / 60;
+}
+/**
+ * Sinusoidal modulation: amplitude * cos(2π(t - peak) / 24)
+ * Returns value in [-amplitude, +amplitude], peaking at `peakHour`.
+ */
+function sinMod(t, peakHour, amplitude) {
+    const phase = ((t - peakHour) / 24) * 2 * Math.PI;
+    return amplitude * Math.cos(phase);
+}
+// ── Circadian Modulation ─────────────────────────────────────
+/**
+ * Apply circadian rhythm modulation to baseline chemistry.
+ *
+ * Each chemical follows a sinusoidal daily curve:
+ *   CORT — peaks ~8am, amplitude ±8
+ *   HT   — peaks ~13 (daytime high), amplitude ±5
+ *   DA   — slight afternoon peak ~14, amplitude ±3
+ *   NE   — morning rise ~10, amplitude ±5
+ *   END  — evening rise ~20, amplitude ±3
+ *   OT   — evening warmth ~20, amplitude ±2
+ *
+ * All results clamped to [0, 100].
+ */
+export function computeCircadianModulation(currentTime, baseline) {
+    const t = fractionalHour(currentTime);
+    const cortDelta = sinMod(t, 8, 8);
+    const htDelta = sinMod(t, 13, 5);
+    const daDelta = sinMod(t, 14, 3);
+    const neDelta = sinMod(t, 10, 5);
+    const endDelta = sinMod(t, 20, 3);
+    const otDelta = sinMod(t, 20, 2);
+    return {
+        DA: clamp(baseline.DA + daDelta),
+        HT: clamp(baseline.HT + htDelta),
+        CORT: clamp(baseline.CORT + cortDelta),
+        OT: clamp(baseline.OT + otDelta),
+        NE: clamp(baseline.NE + neDelta),
+        END: clamp(baseline.END + endDelta),
+    };
+}
+function clamp(v, lo = 0, hi = 100) {
+    return Math.max(lo, Math.min(hi, v));
+}
+// ── Homeostatic Pressure ─────────────────────────────────────
+/**
+ * Compute fatigue effects from extended session duration.
+ *
+ * Below 30 minutes: no pressure (grace period).
+ * Beyond 30 min: logarithmic growth (diminishing returns).
+ * All values non-negative.
+ */
+export function computeHomeostaticPressure(sessionMinutes) {
+    if (sessionMinutes < 30) {
+        return { cortAccumulation: 0, daDepletion: 0, neDepletion: 0 };
+    }
+    // Effective minutes beyond the grace period
+    const effective = sessionMinutes - 30;
+    // Logarithmic growth → diminishing returns
+    // ln(1 + x) grows slowly; scale factors tuned so 1h ≈ moderate, 10h ≈ high but bounded
+    const base = Math.log1p(effective / 30); // ln(1 + effective/30)
+    return {
+        cortAccumulation: parseFloat((base * 4).toFixed(4)),
+        daDepletion: parseFloat((base * 3).toFixed(4)),
+        neDepletion: parseFloat((base * 2.5).toFixed(4)),
+    };
+}

package/dist/classify.d.ts

@@ -3,13 +3,40 @@ export interface StimulusClassification {
     type: StimulusType;
     confidence: number;
 }
+/**
+ * Score sentiment by counting hits in positive/negative/intimate word sets.
+ * Returns normalized counts (0-1 range).
+ */
+export declare function scoreSentiment(text: string): {
+    positive: number;
+    negative: number;
+    intimate: number;
+};
+/**
+ * Score emoji sentiment. Returns -1 (all negative) to +1 (all positive).
+ * Returns 0 if no emoji detected.
+ */
+export declare function scoreEmoji(text: string): number;
+/**
+ * Detect sarcasm signals: surface-positive words combined with contextual negativity.
+ * Returns a score 0-1 indicating sarcasm likelihood.
+ */
+export declare function detectSarcasmSignals(text: string, recentStimuli?: (StimulusType | null)[]): number;
 /**
  * Classify the stimulus type(s) of a user message.
  * Returns all detected types sorted by confidence, highest first.
  * Falls back to "casual" if nothing matches.
+ *
+ * v2: When keyword rules miss (confidence < 0.5), a weighted multi-signal
+ * scoring system combines sentiment words, emoji, structural features,
+ * and optional contextual priming to produce better classifications for
+ * everyday messages.
+ *
+ * @param text          The user's message text
+ * @param recentStimuli Optional recent stimulus history for contextual priming
  */
-export declare function classifyStimulus(text: string): StimulusClassification[];
+export declare function classifyStimulus(text: string, recentStimuli?: (StimulusType | null)[], recentMessages?: string[]): StimulusClassification[];
 /**
  * Get the primary (highest confidence) stimulus type.
  */
-export declare function getPrimaryStimulus(text: string): StimulusType;
+export declare function getPrimaryStimulus(text: string, recentStimuli?: (StimulusType | null)[]): StimulusType;