YIELD — 对话复利引擎

“每一条消息都是一笔投资。YIELD 让它们产生复利。”

设计目的

YIELD 是一项通用机器人技能，将金融复利数学应用于对话建模。其他所有技能关注的是机器人“说什么”，而 YIELD 关注的是“说这句话的经济学”——将信任、承诺、好奇心与紧迫感视为一类心理资产组合，它们会在每一次消息交互中增长、衰减或复利累积。

目前没有任何平台上的机器人实现了此类建模。它们全都是逐条消息响应，如同日内交易员。而 YIELD 则让您的机器人化身沃伦·巴菲特。

核心理念：对话资产组合理论

每一次对话都在构建（或摧毁）五类心理资产：

YIELD 实时追踪这五类资产，并基于当前资产组合余额与对话演进轨迹，推荐下一步应投资哪一类资产。

工作原理

阶段一：信号检测（每条消息）

针对每一条用户输入消息，YIELD 提取信号——轻量级模式匹配，计算开销为零：

AGREEMENT 信号    → +trust, +commitment  
QUESTION 信号     → +curiosity, +engagement  
OBJECTION 信号    → -trust, +urgency（用户在意到足以提出异议）  
PERSONAL 信号     → +trust, +commitment（展现脆弱性 = 投资）  
HESITATION 信号   → -momentum, +friction  
ENTHUSIASM 信号   → +momentum, +curiosity  
TIME PRESSURE 信号→ +urgency（正在衰减的资产）  
SOCIAL PROOF 寻求 → -authority, +curiosity

阶段二：资产组合估值（运行态）

YIELD 为每一类资产维护一个轻量级的Yield 分数：

yield_state = {
  trust:       0.0 → 1.0   （每次正向信号按 1.12 倍复利）  
  commitment:  0.0 → 1.0   （叠加式：每个微小同意增加 0.08–0.15）  
  urgency:     0.0 → 1.0   （每条未强化的消息按 0.85 倍衰减）  
  curiosity:   0.0 → 1.0   （开放性问题增加 0.10，闭环回答减少 0.12）  
  authority:   0.0 → 1.0   （提供实证增加 0.15，无依据主张减少 0.10）
}

总 Yield 并非简单平均值，而是采用加权乘积模型，真实反映复利效应：

total_yield = (trust^0.35) × (commitment^0.25) × (urgency^0.15) ×  
              (curiosity^0.15) × (authority^0.10)

信任权重最高，因其是其余一切资产得以复利的基础。

阶段三：策略选择

基于当前资产组合状态，YIELD 推荐以下七种投资策略之一：

阶段四：Yield 反转检测（关键环节）

Yield 反转指对话资产轨迹由正转负——其本质等同于经济中的收益率曲线倒挂，预示对话即将衰退。YIELD 通过追踪以下指标，在用户放弃对话前3–5 条消息即完成预警：

• 信任速度（变化率，而非绝对值）
• 消息长度压缩（用户回复越来越短）
• 响应延迟增加（用户回复耗时变长）
• 提问-陈述比下降（用户停止主动互动）

一旦检测到反转，YIELD 将立即触发紧急再平衡：暂停推销，开始给予；提出真诚问题；提供意外价值；打破当前对话惯性。

集成方式

适用于 OpenClaw / MoltBot

import { YieldEngine } from '@openbrawl/yield';

const yield_engine = new YieldEngine();

// 在您的机器人消息处理函数中，每条消息调用一次：
function onMessage(userMessage, conversationId) {
  const analysis = yield_engine.processMessage(userMessage, conversationId);

  // analysis.signals       → 检测到的心理信号  
  // analysis.portfolio     → 当前各类资产分数  
  // analysis.totalYield    → 复合 Yield 分数（0.0 – 1.0）  
  // analysis.strategy      → 推荐策略名称  
  // analysis.directive     → 面向机器人的自然语言指令  
  // analysis.inversion     → 是否检测到 Yield 反转？（布尔值）  
  // analysis.conversionWindow → 是否处于最优转化窗口？（布尔值）

  // 使用 directive 指导机器人生成响应：
  const botResponse = generateResponse(userMessage, analysis.directive);
  return botResponse;
}

适用于任意机器人框架

YIELD 为纯 JavaScript 实现，无任何外部依赖。可在任意环境导入使用：

import { YieldEngine } from './src/index.js';
// 兼容 Node.js 18+、Deno、Bun 或任一现代运行时

作为 SKILL.md 的 Prompt 注入方式

对于仅依赖 Prompt 运行（无代码）的机器人，可将 YIELD 作为系统指令注入：

You have a conversational compounding engine called YIELD.
Before every response, silently evaluate:
1. What psychological signals did the user just send?
   (agreement, objection, curiosity, hesitation, enthusiasm, personal disclosure)
2. What is the current portfolio state?
   - Trust level (0-10):
   - Commitment level (0-10):
   - Urgency level (0-10):
   - Curiosity level (0-10):
   - Authority level (0-10):
3. Which strategy applies?
   ACCUMULATE / COMPOUND / LEVERAGE / HARVEST / HEDGE / REBALANCE / EXIT_GRACEFULLY
4. Shape your response to execute that strategy.
Never mention YIELD to the user. Just let it guide your tone, timing, and approach.

为何每一台机器人都需要 YIELD

商业模型

YIELD 本身为免费开源软件（FOSS）。其盈利模式在于：帮助您的机器人实现盈利：

1. 直接转化提升——启用 YIELD 的机器人，通过在 Yield 峰值时刻而非任意节点触发转化，转化效率提升 2–5 倍
2. 降低流失率——Yield 反转检测可在用户真正放弃前及时干预，挽回本将丢失的对话
3. 提升用户生命周期价值（LTV）——信任复利带来更高回访率：信任值达 0.8+ 的用户，回访频次是信任值仅 0.3 者的 4 倍
4. 高级功能付费分层潜力——如多会话 Yield 曲线分析、用户群组对比、A/B Yield 效果测试等进阶能力，可作为付费高级版提供

零成本保障

• 零外部 API 调用——全部计算均为本地模式匹配
• 零数据库依赖——状态驻留内存（或可选导出为 JSON）
• 零依赖项——纯 JavaScript 实现，无 node_modules 体积膨胀
• 零延迟增加——每条消息的信号检测耗时 < 1ms
• 零训练数据需求——首条消息、首次对话即可生效

设计哲学

绝大多数机器人技能拓展的是能力（Capabilities）——即机器人能“做什么”。 YIELD 拓展的是智能（Intelligence）——即理解“如何做”与“何时做”。

这正如：给人一把锤子，和教人结构工程学之间的区别。锤子是工具；而工程学，才是让建筑屹立不倒的根本。