@rain13sad/dsh-mnemo-affect 0.0.0-stage → 0.2.0

package/lib/types/index.d.ts

@@ -0,0 +1,216 @@
+/**
+ * @rain13sad/dsh-mnemo-affect —— 情感内核（§11 / §14.2 / §15）
+ *
+ * 四段管线：interocept → core affect → appraisal×context → label（仅渲染时）
+ * 对应 Barrett 四步：身体变化 → 感知 → 结合经验解释 → 情绪出现。
+ *
+ * 边界（代码注释与对外表述都要守住）：
+ *   · 这满足"有需要维持的内部状态"，**不满足**"有主观体验"
+ *   · `report()` 返回数值，不返回感受
+ *   · 任何"我感到…"的措辞都不在此产生
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { Appraisal, Intero, Pad, RelationalSnapshot } from '@rain13sad/dsh-mnemo-core';
+import { type AffectCoefficients } from './appraisal.js';
+import { derivePolicy, type InteroSignals } from './policy.js';
+import { type PersonaState, type SchemaPattern } from './persist.js';
+export declare const name = "mnemo-affect";
+export declare const inject: string[];
+export interface Config {
+    moodTau: number;
+    personaDriftEpsilon: number;
+    negativeWeight: number;
+    enabled: boolean;
+    coeff: AffectCoefficients;
+}
+export declare const Config: z<Config>;
+export interface TurnInput {
+    text: string;
+    turn: number;
+    topic?: string;
+    goalEntities?: string[];
+    seenTopics?: Set<string>;
+    lastAssistantRejected?: boolean;
+    repeated?: boolean;
+    promise?: 'kept' | 'broken';
+    signals?: InteroSignals;
+}
+export interface TurnOutput {
+    appraisal: Appraisal;
+    pad: Pad;
+    mood: Pad;
+    relational: RelationalSnapshot;
+    policy: ReturnType<typeof derivePolicy>;
+    intero: Intero;
+    label: string;
+}
+export declare class AffectService extends Service {
+    config: Config;
+    private intero;
+    private pad;
+    private mood;
+    private relational;
+    private persona;
+    private persona0;
+    private lastTurn;
+    /** 人格版本链（§11.8 可回滚） */
+    private personaRev;
+    private personaHistory;
+    /** 离线环的原始样本：每轮的 PAD / 张力 / 是否被纠正 */
+    private history;
+    private lastPersistTurn;
+    private lastSchemaTurn;
+    private lastSchema;
+    private seenTopics;
+    /** 情绪事件（一次显著的起伏），带衰减；供面板画轨迹、供主动聊天挑话题 */
+    private episodes;
+    /** PAD 轨迹（每轮一个点，上限 240，够画 40 分钟的连续情绪） */
+    private trajectory;
+    /** 有情绪波动的轮数，用于依恋度 */
+    private emotionalTurns;
+    private negativeAccum;
+    private repeats;
+    constructor(ctx: Context, config: Config);
+    /** 当前情绪（本轮），供 recall 做门控与打分。 */
+    current(): Pad;
+    currentMood(): Pad;
+    currentIntero(): Intero;
+    relationalSnapshot(): RelationalSnapshot;
+    /** 六变量可手动注入（调试用，`/mnemo affect set`）。 */
+    setIntero(patch: Partial<Intero>): Intero;
+    /** 一轮的完整评价（快环）。 */
+    observe(input: TurnInput): TurnOutput;
+    /** 人格快照（面板与命令用）。 */
+    personaState(): PersonaState & {
+        baseline: number[];
+        history: Array<{
+            rev: number;
+            vector: number[];
+        }>;
+    };
+    /** 人格回滚（§11.8）：回滚也算一次新版本，不做原地改写。 */
+    rollbackPersona(rev: number): {
+        ok: boolean;
+        message: string;
+    };
+    /**
+     * 依恋度（0..1）：熟悉度 40% + 信任 30% + 共同情绪事件 30%。
+     * 刻意不包含"轮数"——刷轮数涨上来的不是依恋，是时长。
+     */
+    attachment(): number;
+    /** 关系阶段：陌生 → 熟悉 → 亲密 → 依赖（阈值与面板文案绑定，改要一起改） */
+    stage(): {
+        key: 'stranger' | 'familiar' | 'close' | 'attached';
+        label: string;
+        progress: number;
+    };
+    /** 情绪轨迹（面板画折线用） */
+    trajectorySeries(): Array<{
+        turn: number;
+        v: number;
+        a: number;
+        d: number;
+    }>;
+    /** 未平复的情绪事件（峰值 × 半衰），供主动聊天判断"他还在气头上吗" */
+    activeEpisodes(now?: number): Array<{
+        turn: number;
+        v: number;
+        a: number;
+        strength: number;
+        trigger: string;
+    }>;
+    /**
+     * 情感再评估（reappraisal）：用**当前心境**重估一条记忆的效价。
+     * 记忆是建构性的——同一件事，心情好的时候想起来没那么糟。
+     * 只调 valence（情感维度），不动内容、不动 support（证据数不是情绪）。
+     */
+    reappraise(cellId: string): {
+        ok: boolean;
+        before: number;
+        after: number;
+        message: string;
+    };
+    /** 当前用户图式（离线环产物）。 */
+    schema(): SchemaPattern[];
+    /** 慢环落盘：关系模型 + 人格锚。失败不影响情感计算。 */
+    persist(): void;
+    /** 离线环：抽图式并写 kind=3 cell。 */
+    refreshSchema(): SchemaPattern[];
+    /** 热重载 / 重启后从库恢复（§14.7 可重建内存缓存）。 */
+    restoreFromMemory(): boolean;
+    policy(): TurnOutput['policy'];
+    /** affect_report 的数据源：**只有数值**，没有感受。 */
+    report(): Record<string, number | string>;
+    /** 面板需要、但不属于"本轮评价结果"的部分。 */
+    snapshotExtras(): {
+        persona: {
+            rev: number;
+            vector: number[];
+            baseline: number[];
+        };
+        schema: SchemaPattern[];
+        attachment: number;
+        stage: {
+            key: string;
+            label: string;
+            progress: number;
+        };
+        trajectory: Array<{
+            turn: number;
+            v: number;
+            a: number;
+            d: number;
+        }>;
+        episodes: Array<{
+            turn: number;
+            v: number;
+            a: number;
+            strength: number;
+            trigger: string;
+        }>;
+    };
+    /** 供面板消费的快照。 */
+    snapshot(): {
+        persona: {
+            rev: number;
+            vector: number[];
+            baseline: number[];
+        };
+        schema: SchemaPattern[];
+        attachment: number;
+        stage: {
+            key: string;
+            label: string;
+            progress: number;
+        };
+        trajectory: Array<{
+            turn: number;
+            v: number;
+            a: number;
+            d: number;
+        }>;
+        episodes: Array<{
+            turn: number;
+            v: number;
+            a: number;
+            strength: number;
+            trigger: string;
+        }>;
+        enabled: boolean;
+        intero: Intero;
+        pad: Pad;
+        mood: Pad;
+        relational: RelationalSnapshot;
+        policy: import("@rain13sad/dsh-mnemo-core").AffectPolicy;
+    };
+    last(): TurnOutput | null;
+    /** 恢复（热重载后从 kind=5 / kind=4 cell 重建，§14.7 可重建内存缓存）。 */
+    restore(rel: Partial<RelationalSnapshot>, mood?: Pad): void;
+}
+export declare function apply(ctx: Context, config: Config): AffectService;
+export { appraise, coreAffect, integrateMood, label, clampPersona } from './appraisal.js';
+export { deriveUserSchema, readPersisted, relationalCell, personaCell, schemaCell } from './persist.js';
+export type { PersonaState, SchemaPattern } from './persist.js';
+export { derivePolicy, interocept } from './policy.js';
+export { updateRelational, personaFromAttunement, initialRelational } from './relational.js';

package/lib/types/persist.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 情感状态的持久化与离线抽象（对应 §11.5 / §11.7 / §11.8）
+ *
+ * 三个环路里，只有"快环"是纯内存的：
+ *   快环（每轮）  → 本轮 PAD 与策略，写 affect/appraisal 事件
+ *   慢环（每会话）→ mood / 关系模型 / persona，**必须落盘**，否则重启就忘
+ *   离线环（每 N 轮）→ 用户 schema（kind=3），"这个人是什么样"
+ *
+ * 落盘方式是"用记忆库自己的格式"而不是另建一张表：
+ *   kind=5 关系模型 → 一条 cell（flags.bit1 不衰减）
+ *   kind=4 人格锚   → 一条 cell（不可合并、不可衰减）
+ *   kind=3 用户图式 → 由离线环产出，可被后续 pass 继续合并
+ *
+ * 这样做的好处是"热重载可重建"（§14.7）：情感服务挂了重启，从这三类 cell 读回来即可，
+ * 不需要额外的状态存储，也不需要和主库做一致性维护。
+ */
+import { type MemCell, type MemoryService, type Pad, type RelationalSnapshot } from '@rain13sad/dsh-mnemo-core';
+export interface PersonaState {
+    vector: number[];
+    rev: number;
+}
+/** 关系模型 → 一条 kind=5 cell。槽位承载数值，digest 只写摘要（不进 MRS 正文）。 */
+export declare function relationalCell(memory: MemoryService, rel: RelationalSnapshot, persona: PersonaState, now: number): MemCell;
+/** 人格锚 → kind=4 cell，flags.bit1（不可衰减），不参与合并。 */
+export declare function personaCell(memory: MemoryService, persona: PersonaState, now: number): MemCell;
+export interface SchemaPattern {
+    topic: string;
+    pattern: string;
+    confidence: number;
+    support: number;
+}
+/**
+ * 离线环：把散落在几十轮里的情感反应，抽象成一条关于"这个人"的图式。
+ * 这是整套系统里唯一真正的"学习"——它反过来成为下次评价的先验。
+ *
+ * 判据刻意保守：样本 < 3 不产结论，置信度按样本量折算。
+ * 宁可第一次猜不准，也不要拿一条 3 个样本的"规律"去改变行为。
+ */
+export declare function deriveUserSchema(history: Array<{
+    turn: number;
+    topic: string;
+    pad: Pad;
+    strain: number;
+    corrected: boolean;
+}>, minSamples?: number): SchemaPattern[];
+/** 图式 → kind=3 cell（可被后续 NREM pass 继续合并）。 */
+export declare function schemaCell(memory: MemoryService, p: SchemaPattern, now: number): MemCell;
+/** 从库里读回最近一条关系模型 / 人格锚（热重载与重启后的恢复路径）。 */
+export declare function readPersisted(memory: MemoryService): {
+    relational?: RelationalSnapshot;
+    persona?: PersonaState;
+};

package/lib/types/policy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 情感 → 行为：策略表（对应 §11.6，硬约束）
+ *
+ * 情感若不影响行为，就只是装饰。以下映射**强制**，且可回归测试（test/policy.test.mjs）。
+ * 每一条都返回 `reasons`，让"为什么这轮更谨慎"变成可指认的事实，而不是玄学。
+ *
+ * 谄媚的三道刹车（§19.4）在这里落地：
+ *   · warmth 只作用于 verbosity/hedging，不作用于 content
+ *   · trust 高不降低异议意愿，只降低确认频次
+ *   · strain 只由"重复追问/明确不满"驱动，不由"用户不同意"驱动
+ */
+import type { AffectPolicy, Intero, Pad, RelationalSnapshot } from '@rain13sad/dsh-mnemo-core';
+export interface PolicyInput {
+    pad: Pad;
+    mood: Pad;
+    intero: Intero;
+    relational: RelationalSnapshot;
+    /** 当前会话轮次，用于 progress 相关规则 */
+    turns: number;
+    /** 本会话是否已有 goal；无 goal 时 progress 规则不适用 */
+    hasGoal?: boolean;
+}
+export declare function derivePolicy(input: PolicyInput): AffectPolicy;
+/** 从运行时信号推导 6 个内感受变量（§11.1）。全部是真实可测量，不是修辞。 */
+export interface InteroSignals {
+    /** 活跃 job 数 */
+    activeJobs?: number;
+    /** 上下文 token 占比 [0,1] */
+    contextRatio?: number;
+    /** 近 N 轮召回平均分 [0,1] */
+    recallMean?: number;
+    /** 工具错误率 [0,1] */
+    toolErrorRate?: number;
+    /** CONTRADICTS 边密度 [0,1] */
+    conflictDensity?: number;
+    /** 负向评价累积 [0,1] */
+    negativeAccum?: number;
+    /** 重复提问率 [0,1] */
+    repeatRate?: number;
+    /** goal 进度 [0,1]（无 goal 时 undefined） */
+    progress?: number;
+    /** 预算余量 [0,1] */
+    budget?: number;
+    /** 距离上次进度更新的轮数 */
+    roundsSinceProgress?: number;
+}
+export declare function interocept(s: InteroSignals, prev?: Intero): Intero;

package/lib/types/relational.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 关系模型（对应 §11.5，修 D-12）
+ *
+ * 三条关键设计，缺一条就会退化成"越聊越谄媚"：
+ *   1. 不对称更新：负面权重是正面的 3 倍（信任建立慢、崩塌快）
+ *   2. boundaries 只增不减：用户划的边界不能被"后来聊得好"自动撤销
+ *   3. attunement 驱动 persona 微调：高 → 更简洁；低 → 更多澄清
+ *
+ * attunement 的事件来源必须是**可检测的**。v0.1 假设存在 affirmed/corrected 事件
+ * 却没定义谁产生——这里用三条启发式，各自带置信度，低置信不更新。
+ */
+import type { RelationalSnapshot } from '@rain13sad/dsh-mnemo-core';
+export interface RelationalModel extends RelationalSnapshot {
+    /** 内部：上次 attunement 更新的轮次，避免同一轮重复计分 */
+    lastAttuneTurn: number;
+}
+export declare function initialRelational(): RelationalModel;
+export interface RelationalUpdate {
+    model: RelationalModel;
+    delta: {
+        trust: number;
+        attunement: number;
+        repairDebt: number;
+    };
+    reason: string[];
+}
+export interface UpdateOptions {
+    text: string;
+    turn: number;
+    /** 用户是否重复了同一请求（明确纠正的强信号） */
+    repeated?: boolean;
+    /** 承诺兑现（kept）或违背（broken），来自工具执行结果 */
+    promise?: 'kept' | 'broken';
+    /** 负面权重（默认 3，§11.5） */
+    negativeWeight?: number;
+    /** trust 学习率 η */
+    eta?: number;
+}
+export declare function updateRelational(model: RelationalModel, opts: UpdateOptions): RelationalUpdate;
+/**
+ * attunement → persona 微调（§11.5 第 3 条）。
+ * 高 → 更简洁少解释；低 → 更多澄清与铺垫。返回的是**策略参数**，不是人设文案。
+ */
+export declare function personaFromAttunement(attunement: number): {
+    verbosity: -1 | 0 | 1;
+    clarification: number;
+    hedging: number;
+};

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@rain13sad/dsh-mnemo-affect",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "情感内核：内感受 / 评价 / PAD / 心境 / 关系模型（ctx.affect）",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "agent-memory",
+    "typescript",
+    "affect",
+    "emotion",
+    "appraisal",
+    "pad-model"
+  ],
+  "homepage": "https://github.com/Rain13Sad/bcf-mnemovault#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rain13Sad/bcf-mnemovault.git",
+    "directory": "packages/affect"
+  },
+  "bugs": {
+    "url": "https://github.com/Rain13Sad/bcf-mnemovault/issues"
+  },
+  "author": "Rain13Sad",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "engines": {
+    "dsh": ">=0.2.1-rc.3 <0.3.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-session": "*"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@rain13sad/dsh-mnemo-core": "^0.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}