情绪弧线导演 · dph-emotion-arc

定位：编剧向的「情绪叙事工具」（合规白名单方向），不是持续情感陪伴。依据调研《情绪交互 Agent 与 DPH 插件可行性调研报告》（2026-10-01）：插件生态中「情绪识别 → 状态 → 策略」闭环、情绪记忆账本、跨版本适配矩阵——三件事均无人做过（7 个占位仓库合计 40★，4 个九天内死亡）。本插件补齐这三件。

一句话

文本情绪识别 → 显式情绪状态文件（emotion-state.json）→ 对话策略映射 + 关系型记忆账本 + 角色卡人格感知。识别双引擎：确定性词典（零成本、可审计、永远兜底）+ LLM 精判（BYOK、按 detectorMode 组合）；状态是跨会话持久化的显式文件（对齐报告第 07 章「离散标签 + 状态文件承载」架构），策略以注入提示形式映射到 Agent 行为。

架构（管线式，非端到端）

用户消息
  │  agent/inbox/claimed（scoped 事件）
  ▼
识别双引擎（detectorMode）
  ├─ llm：LLM 精判（4s 超时防护，温度 0，JSON 容错解析）
  └─ lexicon：词典 + 否定短语 + emoji + 感叹号加权（兜底）
  │  防护① 低置信度 → 回落中性
  ▼
情绪状态机（强度 + 指数衰减半衰期 30min + 换标签迟滞防抖）
  │  防护③ 推断审计日志 audit/<sid>.jsonl（rule: llm/lexicon/lexicon-fallback/manual）
  ▼
  ├─ 显著变化 → agent.inject() 策略提示（共情/倾听/降不确定…；notifyMode 可关）
  ├─ systemPrompt.context() 每步注入当前状态 + 角色卡人格（稳态感知）
  └─ 持久化 state/<sid>.json（跨会话延续）
记忆账本 ledger/<sid>.jsonl ← Agent 工具 emotion_ledger_append（冲突/和解/安抚…）
角色卡 persona/<id>.json ← Agent 工具 emotion_card_import（SillyTavern V2 PNG / V3 JSON）

三个感知错误防护（报告第 07 章）：① 低置信度回落中性；② 标签切换需超过强度迟滞；③ 推断日志供审计。

能力面（三件套）

空位（调研 §06）	本插件实现
情绪识别 → 状态 → 策略闭环	双引擎识别（LLM 精判 + 词典兜底）+ `emotion-state` 状态文件 + 策略映射注入 + system prompt 上下文
情绪记忆账本（关系型记忆）	`ledger/<sid>.jsonl`：conflict / reconciliation / soothe / breakthrough / preference / milestone，跨会话保留，反哺角色弧光
跨版本存活	见下方适配矩阵；所有外部 API 均做防御性读取，宿主 API 缺失时跳过而非崩溃
（V1.1）角色资产接入	SillyTavern V2/V3 角色卡导入 → persona 档案 → 人格感知策略（对齐「一份资产多生态分发」）

工具（Agent 可用）

emotion_state —— 读当前状态（标签/强度/置信/触发语/历史/账本尾/角色卡）
emotion_state_set —— 手动校准（写入审计日志 rule=manual）
emotion_ledger_append —— 追加关系型记忆
emotion_card_import —— 导入 SillyTavern 角色卡（V2 PNG / V3 JSON / V2 JSON）并绑定当前会话

UI

Composer 下方的「情绪弧线」芯片：当前情绪（颜色点 + emoji + 名称 + 强度条 + 相对时间），点击展开状态面板（触发语 / 变化历史 / 账本尾）。数据经只读 HTTP 端点获取，写操作仅经 Agent 工具。

数据文件（可导出、可迁移）

<dataDir>/state/<sessionId>.json   情绪状态（version 字段 + 历史 + persona 绑定）
<dataDir>/ledger/<sessionId>.jsonl 情绪记忆账本
<dataDir>/audit/<sessionId>.jsonl  推断审计日志（可追溯）
<dataDir>/persona/<personaId>.json 角色卡 persona 档案（V1.1）

默认 dataDir = dshHomePath('emotion-arc')，可在 cordis.patch.yml 中覆写。

适配矩阵（Compatibility Matrix）

组件	版本	状态
DeepSeek Harness（dsh）	0.1.7 – 0.2.x（Developer Preview）	✅ 基于 0.2.x API 面编写
依赖的宿主 API	`agent/inbox/claimed` · `agent.inject` · `agent/created`/`agent/disposed`（scoped, global:true）· `systemPrompt.context` · `tools.register` · `webServer.register`	均有 `0.1.7+` 先例；全部防御式调用
客户端 API	`window.__ModuleLoader__` · `ctx.slots.inject/register` · `conversation.composer.dock`（标准 prop `sessionId`）· 主题 token `--dsw-alias-*`	✅
浏览器	现代 Chromium / WebView（fetch + React 18）	✅

维护纪律（对齐调研 §06「8 天 5 个 release」的教训）：

本插件不 import 任何 @deepseek-ai/* 包（bundle 自包含），降低破坏性变更面；
宿主 API 变更时优先「跳过功能」而非抛错——插件卸载/失效绝不影响会话；
每次 dsh 发布后跑一遍 emotion_state 工具 + 芯片刷新冒烟测试，README 同步更新适配矩阵；
数据文件格式带 version 字段，迁移时只加字段不删字段。

开发循环（本机迭代须知）：

Host 侧代码（engine.js）修改后，需重启 Harness 才生效（Node ESM 按 URL 缓存模块，进程内无法热换）；
Client 侧（client.js）修改后刷新页面即可；
禁用/启用插件时请间隔 ≥10 秒（cordis 纤维释放是异步的，快速切换会让路由卡死，届时只能重启恢复）；
单测：node test-emotion.mjs（24 用例：词典 + LLM 解析 + 角色卡解析），node test-fork-repro.mjs（回归用例）。

配置（cordis.patch.yml）

config:
  enabled: true
  dataDir: !!js dshHomePath('emotion-arc')
  decayHalfLifeMs: 1800000   # 情绪半衰期 30min
  neutralFloor: 0.15         # 低于此强度回落中性
  minConfidence: 0.5         # 防护①阈值
  hysteresis: 0.15           # 防护②换标签迟滞
  injectThreshold: 0.25      # 触发策略注入的强度变化阈值
  injectCooldownMs: 5000     # 注入冷却
  notifyOnShift: true        # 情绪显著变化时注入通知
  notifyMode: inject         # inject=注入+上下文；context-only=仅稳态上下文（最安静）
  detectorMode: auto         # lexicon=零成本词典；llm=纯 LLM；auto=LLM 优先+词典兜底
  llmTimeoutMs: 4000         # LLM 精判超时（超时走兜底）
  llmMaxTokens: 120          # 精判输出上限
  # llmProvider / llmModel   # 可选：指定精判模型；缺省用 Harness 默认模型（BYOK）
  historyLimit: 20           # 历史保留条数

Roadmap（对齐调研 MVP-1 双轨）

✅ V1.0 闭环 + 账本 + 适配矩阵（已实机验收）
✅ V1.1 LLM 精判（BYOK）+ SillyTavern V2/V3 角色卡导入 + 注入调优（本轮）
V2 语音情绪识别（emotion2vec+ 本地 SER）+ 情感 TTS（CosyVoice / fish-speech）
插件外收入：语 C 人设包 / 角色卡定制（付费心智已被「语擦师」经济验证）——插件本身免费，是作品集与获客器

合规声明

本插件为情绪叙事工具，不提供拟人化人格的持续情感互动（《人工智能拟人化互动服务管理暂行办法》三要件不触发）：状态文件为显式工程数据，策略映射为写作方法论，不含「虚拟伴侣」功能。仅限研究与创作辅助，不构成任何医疗/心理服务。

情绪弧线导演 · dph-emotion-arc

定位：编剧向的「情绪叙事工具」（合规白名单方向），不是持续情感陪伴。依据调研《情绪交互 Agent 与 DPH 插件可行性调研报告》（2026-10-01）：插件生态中「情绪识别 → 状态 → 策略」闭环、情绪记忆账本、跨版本适配矩阵——三件事均无人做过（7 个占位仓库合计 40★，4 个九天内死亡）。本插件补齐这三件。

一句话

架构（管线式，非端到端）

用户消息
  │  agent/inbox/claimed（scoped 事件）
  ▼
识别双引擎（detectorMode）
  ├─ llm：LLM 精判（4s 超时防护，温度 0，JSON 容错解析）
  └─ lexicon：词典 + 否定短语 + emoji + 感叹号加权（兜底）
  │  防护① 低置信度 → 回落中性
  ▼
情绪状态机（强度 + 指数衰减半衰期 30min + 换标签迟滞防抖）
  │  防护③ 推断审计日志 audit/<sid>.jsonl（rule: llm/lexicon/lexicon-fallback/manual）
  ▼
  ├─ 显著变化 → agent.inject() 策略提示（共情/倾听/降不确定…；notifyMode 可关）
  ├─ systemPrompt.context() 每步注入当前状态 + 角色卡人格（稳态感知）
  └─ 持久化 state/<sid>.json（跨会话延续）
记忆账本 ledger/<sid>.jsonl ← Agent 工具 emotion_ledger_append（冲突/和解/安抚…）
角色卡 persona/<id>.json ← Agent 工具 emotion_card_import（SillyTavern V2 PNG / V3 JSON）

三个感知错误防护（报告第 07 章）：① 低置信度回落中性；② 标签切换需超过强度迟滞；③ 推断日志供审计。

能力面（三件套）

空位（调研 §06）	本插件实现
情绪识别 → 状态 → 策略闭环	双引擎识别（LLM 精判 + 词典兜底）+ `emotion-state` 状态文件 + 策略映射注入 + system prompt 上下文
情绪记忆账本（关系型记忆）	`ledger/<sid>.jsonl`：conflict / reconciliation / soothe / breakthrough / preference / milestone，跨会话保留，反哺角色弧光
跨版本存活	见下方适配矩阵；所有外部 API 均做防御性读取，宿主 API 缺失时跳过而非崩溃
（V1.1）角色资产接入	SillyTavern V2/V3 角色卡导入 → persona 档案 → 人格感知策略（对齐「一份资产多生态分发」）

工具（Agent 可用）

emotion_state —— 读当前状态（标签/强度/置信/触发语/历史/账本尾/角色卡）
emotion_state_set —— 手动校准（写入审计日志 rule=manual）
emotion_ledger_append —— 追加关系型记忆
emotion_card_import —— 导入 SillyTavern 角色卡（V2 PNG / V3 JSON / V2 JSON）并绑定当前会话

UI

数据文件（可导出、可迁移）

<dataDir>/state/<sessionId>.json   情绪状态（version 字段 + 历史 + persona 绑定）
<dataDir>/ledger/<sessionId>.jsonl 情绪记忆账本
<dataDir>/audit/<sessionId>.jsonl  推断审计日志（可追溯）
<dataDir>/persona/<personaId>.json 角色卡 persona 档案（V1.1）

默认 dataDir = dshHomePath('emotion-arc')，可在 cordis.patch.yml 中覆写。

适配矩阵（Compatibility Matrix）

组件	版本	状态
DeepSeek Harness（dsh）	0.1.7 – 0.2.x（Developer Preview）	✅ 基于 0.2.x API 面编写
依赖的宿主 API	`agent/inbox/claimed` · `agent.inject` · `agent/created`/`agent/disposed`（scoped, global:true）· `systemPrompt.context` · `tools.register` · `webServer.register`	均有 `0.1.7+` 先例；全部防御式调用
客户端 API	`window.__ModuleLoader__` · `ctx.slots.inject/register` · `conversation.composer.dock`（标准 prop `sessionId`）· 主题 token `--dsw-alias-*`	✅
浏览器	现代 Chromium / WebView（fetch + React 18）	✅

维护纪律（对齐调研 §06「8 天 5 个 release」的教训）：

本插件不 import 任何 @deepseek-ai/* 包（bundle 自包含），降低破坏性变更面；
宿主 API 变更时优先「跳过功能」而非抛错——插件卸载/失效绝不影响会话；
每次 dsh 发布后跑一遍 emotion_state 工具 + 芯片刷新冒烟测试，README 同步更新适配矩阵；
数据文件格式带 version 字段，迁移时只加字段不删字段。

开发循环（本机迭代须知）：

Host 侧代码（engine.js）修改后，需重启 Harness 才生效（Node ESM 按 URL 缓存模块，进程内无法热换）；
Client 侧（client.js）修改后刷新页面即可；
禁用/启用插件时请间隔 ≥10 秒（cordis 纤维释放是异步的，快速切换会让路由卡死，届时只能重启恢复）；
单测：node test-emotion.mjs（24 用例：词典 + LLM 解析 + 角色卡解析），node test-fork-repro.mjs（回归用例）。

配置（cordis.patch.yml）

config:
  enabled: true
  dataDir: !!js dshHomePath('emotion-arc')
  decayHalfLifeMs: 1800000   # 情绪半衰期 30min
  neutralFloor: 0.15         # 低于此强度回落中性
  minConfidence: 0.5         # 防护①阈值
  hysteresis: 0.15           # 防护②换标签迟滞
  injectThreshold: 0.25      # 触发策略注入的强度变化阈值
  injectCooldownMs: 5000     # 注入冷却
  notifyOnShift: true        # 情绪显著变化时注入通知
  notifyMode: inject         # inject=注入+上下文；context-only=仅稳态上下文（最安静）
  detectorMode: auto         # lexicon=零成本词典；llm=纯 LLM；auto=LLM 优先+词典兜底
  llmTimeoutMs: 4000         # LLM 精判超时（超时走兜底）
  llmMaxTokens: 120          # 精判输出上限
  # llmProvider / llmModel   # 可选：指定精判模型；缺省用 Harness 默认模型（BYOK）
  historyLimit: 20           # 历史保留条数

Roadmap（对齐调研 MVP-1 双轨）

✅ V1.0 闭环 + 账本 + 适配矩阵（已实机验收）
✅ V1.1 LLM 精判（BYOK）+ SillyTavern V2/V3 角色卡导入 + 注入调优（本轮）
V2 语音情绪识别（emotion2vec+ 本地 SER）+ 情感 TTS（CosyVoice / fish-speech）
插件外收入：语 C 人设包 / 角色卡定制（付费心智已被「语擦师」经济验证）——插件本身免费，是作品集与获客器

liuxinxing123/dph-emotion-arc

情绪弧线导演 · dph-emotion-arc

一句话

架构（管线式，非端到端）

能力面（三件套）

工具（Agent 可用）

UI

数据文件（可导出、可迁移）

适配矩阵（Compatibility Matrix）

配置（cordis.patch.yml）

Roadmap（对齐调研 MVP-1 双轨）

合规声明

Community comments

liuxinxing123/dph-emotion-arc

情绪弧线导演 · dph-emotion-arc

一句话

架构（管线式，非端到端）

能力面（三件套）

工具（Agent 可用）

UI

数据文件（可导出、可迁移）

适配矩阵（Compatibility Matrix）

配置（cordis.patch.yml）

Roadmap（对齐调研 MVP-1 双轨）

合规声明

Community comments