Agent 时代最应该学的就是状态机和二维矩阵表

用户输入 -> 调 LLM -> LLM 要不要用工具？ -> 执行工具 -> 把工具结果给 LLM -> 再判断 -> 结束

if (order.is_paid && !order.is_shipped && !order.is_refunded) { ... }

class ApprovalService {
    // 审批通过操作
    approve(ticket) {
        // 1. 痛苦的防御性校验
        if (ticket.status !== 'Pending') {
            throw new Error("只有待审批的单子才能审批！");
        }
        
        // 2. 状态变更
        ticket.status = 'Approved';
        
        // 3. 业务副作用
        sendNotification(ticket.owner);
    }
    
    cancel(ticket) {
        // 如果状态是 Draft 或者 Pending 都能取消... 
        // 随着业务发展，这里的 if 会越来越长
        if (ticket.status === 'Draft' || ticket.status === 'Pending') {
            ticket.status = 'Canceled';
        } else {
            throw new Error("当前状态不能取消");
        }
    }
}

// 1. 定义状态机配置（把那张表搬进代码）
const FSM_CONFIG = {
    'Draft': {
        'SUBMIT': { nextState: 'Pending', action: () => console.log('记录提交日志') }
    },
    'Pending': {
        'APPROVE': { nextState: 'Approved', action: () => sendEmail('通过') },
        'REJECT': { nextState: 'Draft', action: () => sendEmail('驳回') }
    },
    'Approved': {} // 终态，不接受任何事件
};

// 2. 状态机引擎（通用、不带业务逻辑）
class StateMachine {
    constructor(entity, config) {
        this.entity = entity; // 你的业务对象，比如 ticket
        this.config = config;
    }

    // 核心：处理事件的方法
    handleEvent(event) {
        const currentState = this.entity.status;
        const transition = this.config[currentState]?.[event];

        // 统一的防御性校验！再也不用在各个方法里写 if 了
        if (!transition) {
            throw new Error(`无法从状态 [${currentState}] 执行事件 [${event}]`);
        }

        // 状态流转
        this.entity.status = transition.nextState;

        // 执行副作用
        if (transition.action) {
            transition.action(this.entity);
        }
    }
}

// 3. 实际业务调用
const ticket = { id: 1, status: 'Draft' };
const fsm = new StateMachine(ticket, FSM_CONFIG);

// 正常流转
fsm.handleEvent('SUBMIT');  // ticket.status 变成 'Pending'
fsm.handleEvent('APPROVE'); // ticket.status 变成 'Approved'

// 异常测试：如果已经 Approved 了，有人恶意调 SUBMIT
fsm.handleEvent('SUBMIT');  // 直接抛错: 无法从状态 [Approved] 执行事件 [SUBMIT]

const LEAD_FSM_CONFIG = {
    'New': {
        'FOLLOW': { nextState: 'In_Progress' },
        // A -> C：新线索直接战败，不需要经过跟进中
        'FAIL': { nextState: 'Lost', action: () => console.log('记录坏账/无效线索原因') }
    },
    'In_Progress': {
        'SIGN': { nextState: 'Won', action: () => console.log('触发财务开票、开通权限') },
        'FAIL': { nextState: 'Lost' }
    },
    'Won': {
        // 终态
    },
    'Lost': {
        // 逆向流转：战败线索被激活
        'REACTIVATE': { nextState: 'In_Progress', action: () => console.log('重新分配给销售') }
    }
};

function markAsLost(lead, reason) {
    // 销售点“战败”时，系统要拼命检查当前到底在哪一步，能不能战败
    if (lead.status !== 'New' && lead.status !== 'In_Progress') {
        throw new Error("已经签约的单子不能战败！");
    }
    
    lead.status = 'Lost';
    lead.failReason = reason;
    // 后续业务...
}

'New': {
    'FAIL_BY_ADMIN': { nextState: 'Lost' } // 明确定义只有主管事件能触发
},
'In_Progress': {
    'FAIL': { nextState: 'Lost' }
}