mnemox-ai/tradememory-protocol

TradeMemory 协议 – 面向 AI 交易代理的本地优先记忆与安全层

这是什么 – 一个开源 Python 包，记录 AI 驱动交易者的每一笔交易，分析交易者自身的历史表现，并能在下一笔订单到达经纪商的 MCP（市场连接协议）服务器之前进行干预（拒绝或重新排序）。它支持流行的经纪商 API（Alpaca、Hyperliquid、MT5、Binance），并可作为执行用户定义风险策略的轻量代理运行。

核心概念

• 召回 – recall_memories(order="losses_first") 按结果、相似性、近期性、置信度和“情绪状态”（OWM 五因素模型）加权返回过去的亏损交易。
• 记录 – remember_trade 将交易写入五个记忆层（情景、语义、程序、情感、原始记录）。
• 反思 – 定期统计摘要（中位持仓时间、亏损集中度、R 倍数）帮助代理检测漂移。
• 审计 – 每个决策都经过 SHA-256 哈希、链式连接，并每日生成 Merkle 根，提供可导出的防篡改日志。

如何使用

1. 同步历史 – tradememory sync hyperliquid --address 0x… 或 tradememory sync alpaca --env-file ~/.secrets/alpaca.env 将成交记录拉入本地 SQLite 数据库。
2. 将记忆服务器添加到代理 – 在 Claude Desktop（或任何兼容 MCP 的代理）中配置 tradememory MCP 服务器。
3. 预检 – 在代理提出订单之前，调用 recall_memories 以显示类似的过往亏损；代理可自动拒绝违反限制的订单。
4. 可选制动器 – 安装 proxy 扩展（pip install "tradememory-protocol[proxy]"）以运行本地代理，仅将符合策略的订单转发给经纪商，同时记录每个决策。

主要功能（MCP 工具）

类别	工具	用途
记忆	remember_trade, recall_memories	记录交易，检索加权亏损优先列表
状态	get_agent_state, get_behavioral_analysis	当前置信度、回撤、连胜指标
规划	create_trading_plan, check_active_plans	构建条件交易计划
风险	check_trade_legitimacy	五因素交易前门控（完整 / 减少 / 跳过）
审计	export_audit_trail, verify_audit_hash, verify_audit_chain	防篡改日志，Merkle 根
演进	evolution_* 工具	研究级策略生成与回测

典型用例

• 美股交易者 – 单个零售用户本地运行记忆服务器，在每次 Alpaca 订单前获得“亏损优先”检查清单，并执行每日亏损上限。
• 外汇 EA 系统 – 自动化 MT5 专家顾问同步交易，记忆层自动拒绝重复近期亏损模式的订单。
• 合规审计追踪 – 机构用户导出 SHA-256 链式日志以满足 MiFID II 或未来欧盟 AI 法案要求。

局限性（参见 LIMITATIONS.md）

• OWM 评分为研究级；统计显著性仍在收集中（当前验证运行于 < 20 笔交易）。
• 目前仅拒绝部分订单类型（括号单、止损限价单、追踪单），而非评估。
• 审计记录没有内置数字签名；防篡改依赖于哈希链。
• 演进引擎为实验性，不用于生产部署。

安装与快速开始

pip install tradememory-protocol          # 核心记忆服务器
tradememory sync hyperliquid --address 0xYourAddress
# 可选制动代理（Python 3.12+）
pip install "tradememory-protocol[proxy]"
tradememory proxy init --account-id <id> --symbols AAPL,MSFT

运行 tradememory 作为 MCP 服务器，并将 AI 代理的 MCP 配置指向它。

安全与隐私

• 记忆服务器从不持有经纪商密钥；密钥仅传递给由代理启动的经纪商进程。
• 所有出站调用均为只读（除可选的 MT5 同步 Discord Webhook 外）。
• 审计根默认通过 RFC 3161 时间戳；可通过 TRADEMEMORY_TSA=off 禁用。

研究状态

• OWM 五因素评分已实现并通过 CI 测试。
• 审计追踪完全可用。
• 演进和混合向量召回处于研究模式。
• 正在进行的实证验证（目标 ≥ 100 笔交易以获得统计置信度）。

文档与帮助

• 入门指南、用例、API 参考、OWM 框架、架构以及中文 README 均位于 docs/ 文件夹中。
• 问题：开启 制动集成 问题或预约 30 分钟免费设置通话。

许可证 – 核心包为 MIT；可选的 proxy 扩展引入 mnemox-control（仅限 AGPL-3.0，商业许可证可用）。

非财务建议 – 该工具仅展示历史亏损模式；交易决策仍由用户负责。