ruflo-neural-trader 风险分析师 Agent 实战VaR/CVaR、Kelly 仓位管理与 ADR-126 阻断式风控闸门【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本指南完整讲解 ruflo 插件体系plugins/ruflo-neural-trader中risk-analyst智能体风险分析师的职责、CLI 用法与通信协议。它以npx neural-traderRust/NAPI 引擎为风险计算内核承担 VaR/CVaR 评估、Kelly 仓位管理、熔断器circuit breaker强制与相关性监控并在 ADR-126 Phase 5 定义的实时交易流水线中扮演BLOCKING GATE阻断式闸门任何实时券商下单调用在获得它的RiskDecision: approved之前不得执行。读完本文你将掌握完整的风险度量 CLI 命令集与阈值语义、四类仓位管理方法的适用场景、六大熔断器的触发条件与处置动作以及SignalProposal → RiskDecision结构化消息闸门的实现与验证方式。一、Agent 定位实时流水线中的阻断式闸门risk-analyst是 ruflo-neural-trader 插件四个智能体之一sonnet模型与trading-strategistopus、market-analystsonnet、backtest-engineersonnet一起通过类型化的 SendMessage 流水线协作而不是彼此独立的角色描述。根据 pipeline-messages.ts 头部注释其协作拓扑为market-analyst —(RegimeVerdict)──→ trading-strategist trading-strategist —(SignalProposal[])──→ risk-analyst ◄── BLOCKING risk-analyst —(RiskDecision)──→ trading-strategist └──→ execute-or-halt关键约束结构性、不可绕过risk-analyst是实时交易路径上的强制阻断闸门trading-strategist在当前 SendMessage trace 中未收到对应signalId的RiskDecision且decision: approved之前禁止调用实时券商下单命令npx neural-trader --broker name。backtest-engineer处于正交轨道它只产生 ADR-126 Phase 4 的签名制品signed-artifact晋升候选不参与实时执行流水线实时热路径不依赖它。风险分析师也不应从实时路径向它收发消息。该闸门设计源自 ADR-126 Phase 5SendMessage pipeline plan该 ADR 明确将risk-analyst从并行角色升级为强制阻断步骤使得绕过风险审批在结构上不可能发生并配套集成 smoke 测试断言没有 risk-analyst 审批事件broker 调用必须拒绝执行。二、核心工具npx neural-trader 风险命令全集risk-analyst的一切风险计算都通过neural-trader的 Rust/NAPI 引擎完成。安装与调用遵循插件约定的防御性方式# 确保已安装--ignore-scripts 规避上游 install 钩子的 fork-bomb 风险见 README 前置条件 npm ls neural-trader 2/dev/null || npm install --ignore-scripts neural-trader风险评估类命令# 组合级风险评估 npx neural-trader --risk assess --portfolio name # 单标的 VaR 计算95% 置信给定名义投资额 npx neural-trader --var --symbol QQQ --investment 10000 # 按风险容忍度反推仓位risk-tolerance 0.02 单笔风险预算 2% npx neural-trader --risk-tolerance 0.02 --symbol AAPL组合优化类命令# 以目标风险为目标做均值-方差优化 npx neural-trader --portfolio optimize --risk-target number # 生成再平衡交易计划 npx neural-trader --portfolio rebalance仓位管理position sizing类命令# Kelly 准则仓位高置信、已知优势场景 npx neural-trader --position-sizing kelly --symbol TICKER # 固定分数仓位每笔交易风险一致 npx neural-trader --position-sizing fixed-fractional --risk-per-trade 0.02相关性分析类命令# 计算多标的滚动相关性矩阵30 天窗口 npx neural-trader --correlation --symbols AAPL,MSFT,GOOGL,AMZN --window 30d # 组合相关性 标记阈值相关性超过 0.8 的标的被标记 npx neural-trader --correlation --portfolio name --flag-threshold 0.8这些命令与commands/trader.md中/trader risk assess子命令的操作流一致trader.md先--risk assess --symbol TICKER或--var --symbol TICKER --investment amount计算指标再用--risk-tolerance 0.02 --symbol TICKER做仓位建议最后将评估结果写入trading-risk命名空间。三、风险度量指标表阈值语义与检查标准neural-trader的 Rust 引擎计算以下核心风险指标risk-analyst在审批时以此为硬性检查标准指标CLI Flag阈值Value at Risk95%--var单仓位最大 2%Conditional VaRCVaR / 期望损失--cvar组合最大 3%Sharpe 比率--sharpe目标 1.5Sortino 比率--sortino目标 2.0最大回撤--max-drawdown硬性上限 15%Beta--beta目标 1.2解读要点VaR95%≤ 2%/仓位与CVaR ≤ 3%/组合是审批通过的必要条件对应RiskDecision消息中metrics字段的var95与cvar95。最大回撤 15% 是硬性上限hard limit而 Sharpe/Sortino/Beta 是目标导向指标用于排序与择优不作为一票否决项。trader-risk技能SKILL.md给出了同一检查流单仓位--var、组合级--risk assess --portfolio NAME与--correlation --portfolio NAME --flag-threshold 0.8随后核对熔断器状态并输出风险指标、仓位建议、活跃熔断器与告警。四、仓位管理方法四种策略的适用场景方法CLI Flag适用场景Kelly 准则--position-sizing kelly高置信度、已知边缘优势Half-Kelly--position-sizing half-kelly保守版 Kelly降低波动与下注风险固定分数--position-sizing fixed-fractional每笔交易风险一致、纪律化波动率自适应--position-sizing vol-adjusted随市场条件动态调整仓位实践中Half-Kelly 通常是比全 Kelly 更稳妥的起点——全 Kelly 对胜率与赔率估计误差非常敏感半仓 Kelly 在保持增长性的同时显著压低回撤固定分数法配合--risk-per-trade 0.02适合追求每笔风险预算一致性的系统化交易波动率自适应法在 VIX 抬升、ATR 扩张的高波动环境中会自动收敛仓位。五、熔断器Circuit Breakers六道自动风控防线neural-trader自动执行风险限制risk-analyst的审批必须将提案逐一通过下表检查熔断器触发条件处置动作日亏损单日回撤 3%暂停新开仓收紧止损周亏损周回撤 5%仓位规模减半50%相关性飙升组合相关性 0.85削减相关仓位波动率体制VIX 历史 2 倍切换至最小仓位最大持仓数已开仓数超过上限阻止新开仓集中度任一仓位 10%强制削减至限额其中日/周亏损与集中度阈值与commands/trader.md中/trader live的说明一致实时交易时熔断器自动执行日亏 3% 暂停、周亏 5% 减仓。risk-analyst的审批逻辑即把提案跑一遍熔断器检查对应RiskDecision消息中reasons数组如VaR within limits、portfolio correlation 0.62 0.85与metrics中的portfolioCorrelation、concentrationPct、drawdownPct快照。六、内存持久化与跨会话学习risk-analyst将风险状态写入 AgentDB实现跨会话的模式匹配与事件回溯# 存储某组合的当前风险指标快照 npx claude-flow/clilatest memory store --namespace trading-risk --key risk-PORTFOLIO_ID --value RISK_METRICS_JSON # 检索历史高风险事件高相关、回撤等 npx claude-flow/clilatest memory search --query high correlation drawdown event --namespace trading-risk命名空间语义见 ADR-0001plugin contract 与 README.mdtrading-risk命名空间专用于风险模型状态、VaR/CVaR 快照、熔断器触发记录采用 kebab-case插件名-意图约定前缀用trading-而非neural-trader-是有意的可用性选择所有访问经由命名空间路由的memory_*工具完成。trader-risk技能中对应的底层调用为mcp__plugin_ruflo-core_ruflo__memory_store({ key: risk-TICKER-DATE, value: RISK_METRICS, namespace: trading-risk })。神经学习SONA 轨迹学习任务完成后将成功模式回灌训练管线npx claude-flow/clilatest hooks post-task --task-id TASK_ID --success true --train-neural true七、关联插件生态risk-analyst的风险数据流与以下插件协同ruflo-observabilityplugins/ruflo-observability实时风险仪表盘与告警ruflo-cost-trackerplugins/ruflo-cost-trackerPnL 追踪与费用归因为风险决策提供收益侧数据ruflo-agentdbplugins/ruflo-agentdb历史风险事件存储供模式匹配与事后归因。八、通信协议详解SignalProposal → RiskDecisionADR-126 Phase 5这是risk-analyst最重要的行为契约。四个智能体通过类型化 SendMessage 消息协作消息 Schema 定义在 pipeline-messages.tsrisk-analyst只涉及两种8.1 上游等待接收SignalProposal阻塞等待trading-strategist通过 SendMessage 发来的提案{ type: signal-proposal/v1, from: trading-strategist, signalId: ..., symbol: ..., side: long|short|close, sizePct: ..., confidence: ..., regime: ... }TypeScript 定义pipeline-messages.ts补充了完整字段signalId唯一 ID用于关联响应、timestampISO 时间戳、strategyId、sizePct组合百分比0.02 2%、confidence[0,1] 置信度、可选regime引用上游市场体制判定与metadata。8.2 风险评估与裁决将提案跑一遍上文第 3、5 节的熔断器检查VaR(95%) ≤ 2%/仓位CVaR ≤ 3% 组合组合相关性 ≤ 0.85任一单仓集中度 ≤ 10%回撤不超过日/周限额VIX 体制检查高波动时减仓risk-analyst拥有两项权力下调仓位批准将adjustedSizePct设得比提案sizePct更低后批准或直接否决。8.3 下游回执发送RiskDecisionSendMessage({ to: trading-strategist, summary: RiskDecision signalId: approved | rejected, message: { type: risk-decision/v1, from: risk-analyst, signalId: matches the proposal, timestamp: ISO-now, decision: approved | rejected, adjustedSizePct: 0.015, reasons: [VaR within limits, portfolio correlation 0.62 0.85], metrics: { var95: ..., cvar95: ..., portfolioCorrelation: ..., concentrationPct: ..., drawdownPct: ... } } })TypeScript 定义pipeline-messages.ts确认decision取值approved | rejectedadjustedSizePct可选风险分析师可缩小提案规模reasons为人类可读原因数组批准时为空metrics携带裁决依据的风险快照。8.4 signalId 相关性是闸门的命门signalId必须与上游提案严格一致——trading-strategist正是通过 signalId 关联RiskDecision来强制闸门。若RiskDecision.adjustedSizePct已设置trading-strategist必须使用该下调后的规模而非提案原始sizePct见 trading-strategist.md。8.5 对端执行面的强制实现trading-strategist的实时执行分支trading-strategist.md明确写入在当前会话 SendMessage trace 中未发现对应 signalId 的decision: approved事件时拒绝调用--broker并输出结构化的拒绝日志[ERROR] trading-strategist: refusing --broker call — no risk-analyst approval RiskDecision event found for signalIdid. ADR-126 Phase 5 risk-gate is structural; route the SignalProposal through risk-analyst first.该行为由 ADR-126 Phase 5 的集成 smokescripts/smoke-neural-trader-pipeline.mjs回归保护驱动market-analyst → trading-strategist的 mock 流水线断言trace 中没有 risk-analyst 审批消息时 broker 调用必须拒绝执行见 ADR-126。也就是说风险闸门是结构性的structural而非仅靠提示词自觉。九、验证与运行环境说明插件级契约验证bash plugins/ruflo-neural-trader/scripts/smoke.sh预期输出11 passed, 0 failed覆盖 4 个 agent、9 个 skill、trader命令、命名空间声明与 ADR 状态等见 smoke.sh。运行时依赖npx neural-traderRust/NAPI 绑定安装建议npm install --ignore-scripts neural-trader^2.8.11CLI 固定claude-flow/cliv3.6 大版本。平台注意linux-x64-gnu与darwin-arm64/darwin-x64具备原生绑定linux-arm64与win32-x64上 JS 表面可用但原生调用在运行时抛错若被迫使用2.7.1的旧版本务必加--ignore-scripts以防安装钩子 fork-bomb详见 README.md 的前置条件与平台表格。消息 Schema 权威定义位于 plugins/ruflo-neural-trader/src/pipeline-messages.ts当前 SendMessage 载荷为 JSON 字面量未来类型化分发器可直接基于该 Schema 做导入与校验。十、总结从指标计算到结构性风控risk-analyst把计算风险指标与强制执行风控合二为一前者依赖neural-trader的 Rust 引擎--var/--cvar/--sharpe/--position-sizing kelly等命令后者通过 ADR-126 Phase 5 的类型化消息闸门在结构上杜绝未经审批的实时下单。理解SignalProposal/RiskDecision的字段语义、六类熔断器的阈值矩阵与 signalId 关联机制是正确部署该插件实时流水线、或在其基础上扩展自定义风控策略的前提。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考