交易团队工作流

这五个角色可以用 Charles、Joe、Chris、Human 和 Eason 来表示：

• Charles 研究公开信息，输出投资观点、催化剂、风险和来源；
• Joe 把观点与量化信号合成订单意图；
• Chris 调用确定性的风控引擎；
• Human 审阅并授权；
• Eason 执行获批订单，并记录回报。

顺序不是装饰。研究适合使用智能体、技能和检索；信号可以运行普通脚本；风控应调用确定性规则；执行则调用交易适配器。外层工作流把这些不同工具固定在同一条路径上。

State（状态）就是贯穿流程、记录输入和中间结果的结构化对象。它至少应包含证券、运行日期、初始资金、用户问题、是否自动审批、节点产出、消息和重试次数。以约 100 万元资金研究贵州茅台为例，金额、持仓和数据截止时间都要进入状态，不能只放在聊天上下文里。

节点应返回自己的局部更新，让图管理器合并；不要让多个节点随意修改同一个共享字典。每次任务使用独立的 thread_id（会话标识），避免不同任务的上下文串台。

不要把所有研究能力都塞进节点文件。可以加载已有的研究模块，创建智能体，通过 invoke 传入用户问题和会话配置。模块化的好处是研究能力能复用，节点只负责编排和接收结果。

一次研究完成后，同时保存结构化观点和原始文本，生成 Markdown 与 HTML 报告。报告至少写明：

• 使用了哪些来源；
• 数据截至哪一天；
• 哪些字段缺失或尚未核实；
• 观点、催化剂和风险分别是什么。

报告好看不代表数据正确。若某个数据源的字段、权限或失败行为没有核对，就把缺口写出来，不要把模型生成的结论当成已经验证的事实。已有模块包含多个技能时，也要逐项核对来源、参数、返回结构和错误处理，而不能只凭“有七个技能”推断能力。

Joe 不应该直接把“看多”改写成买入，而要把它和明确的量化规则合并。示例可以复用 MACD、双均线或 Backtrader 回测脚本。脚本由独立进程运行时，节点必须检查退出码、错误输出和结果文件，不能只看“文件存在”。

信号输出至少包含：方向、参考价格、拟议数量、信号时间、策略版本和依据。假设研究观点的模型分值是 0.82，信号仍然较弱，系统可以给出小仓试单的意图；但 0.82 不是 82% 的盈利概率，除非另有校准和验证。

数量还要先过交易单位约束。若风险预算只允许不足一手，不能默认向上凑到 100 股。正确选择是返回“不交易”，或进入一条已经定义好的人工处理规则，再重新进行风控。胜率约 33% 也不能单独评价趋势策略，还要看平均盈利、平均亏损、成本和回撤。

Chris 从 State 读取订单、账户快照和市场快照，调用统一的 RiskManager。统一调用的意思是：规则只维护一份，工作流不在各个节点里复制关键词、金额、价格、ATR 和宏观检查。

风控结果要写回状态，并保存每条规则的结果和最终优先级：

• 通过不等于没有风险，只表示当前规则允许继续；
• warning 可以给出警告或允许上限；
• halt 表示暂停，不应被研究观点覆盖；
• 不可修复的拒绝应终止流程。

任何订单修改都要重新风控。比如原来批准 100 股，后续节点改成更多数量，不能沿用旧的批准结果。账户和持仓必须来自带时间的可信快照，不能让模型凭空把已有仓位当成零。

审批界面或命令行应同时展示研究摘要、信号、风控理由、证券、方向、数量和价格条件。Human 选择拒绝时走 END；只有同意才进入交易节点。

dry-run（演练模式）表示流程可以运行，但适配器禁止发送真实订单。不能只在页面写一句“模拟”，而要在适配器层阻断真实发送。以贵州茅台为例，100 股可能对应十多万元，因此“只买一手”也不等于小额测试。

自动审批参数只能用于边界明确的演示或已经授权的流程。真实系统还要处理委托受理、部分成交、拒单、撤单、超时和账户对账。收到委托编号不等于已经成交；模拟回报也不能证明真实接口可用。

可以把 Charles→Joe→Chris、风控分支、重试节点、Human 的 yes/no 分支和 Trader→END 导出为 Mermaid 文本，再交给支持 Mermaid 的工具查看。

静态图回答“可能有哪些路径”；运行日志回答“这一次实际走了哪条”。两者都要保存。一次演示约三分钟，其中研究节点约两分半，这只是特定环境的观察，不是性能承诺。优化时可以缩小股票范围、缓存已验证数据、减少重复搜索和只传递必要字段，不能靠删除风控或审批来提速。

工程问题往往不是“代码没启动”，而是信息在节点之间悄悄丢了。至少建立四项检查：

1. 账户与持仓来自带时间的可信快照；
2. 聊天建议和已保存计划分开显示，写入后回读确认；
3. 计划变更展示新旧差异，保留版本，审批绑定具体版本；
4. 中断恢复和外部副作用分开，避免恢复时重复下单。

例如把止盈条件改成 MA20×0.95，必须先说明这是价格阈值还是另一种条件，再核实数据库里真的写入了新规则。模型说“已修改”不等于修改成功。

测试顺序也要分层：先检查行情，再检查指标和回测；然后检查风控，最后接模拟交易。数据错、信号错、数量错、规则错和发送错应能分别定位。前端和后端框架的名称不会自动让策略有效。