zhiwei/MoFin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9b9c37002ad230a95a849168ff79ecbb936f5300
MoFin/docs/SYSTEM_ARCHITECTURE.md
T
zhiwei 9b9c37002a Initial: MoFin 持仓分析与策略管理系统 
核心模块：
- 策略生命周期管理 (strategy_lifecycle.py)
- 技术分析引擎 (technical_analysis.py)
- 双维度策略评估 (strategy_evaluator.py)
- 实时行情获取 (get_realtime_prices.py)
- Web Dashboard (server.py, :8899)

提示词版本管理：
- prompt_manager 模块 — 统一管理所有知微提示词
- 8个提示词共24个版本已录入
- 策略→提示词版本关联追踪
- Dashboard「提示词」Tab

数据源增强：
- 服务端 POST /api/update/realtime 端点已就绪
- clients/tdx-relay/ — 小小莫在Windows上开发的通达信中继
- 解决港股15分钟延迟问题
2026-06-12 22:54:51 +08:00

10 KiB
Raw Blame History

莫荷系统架构文档 — 完整总览

最后更新：2026-06-11 维护人：莫荷（Hermes Agent） 铁律：任何系统改动必须先读本文档，改完必须同步更新

一、系统总览

┌──────────────────────────────────────────────────────────────┐
│                     Linux 192.168.1.246                       │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │
│  │ 默认gateway  │  │ 知微gateway │  │ 小果gateway │          │
│  │ :8642        │  │ :8643       │  │ :8645       │          │
│  │ 微信+XMPP    │  │ position-   │  │ xiaoguo     │          │
│  │ mohe网关     │  │ analyst     │  │ profile     │          │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘          │
│         │                │                │                  │
│         ▼                ▼                ▼                  │
│  ┌─────────────────────────────────────────────────┐        │
│  │              state.db (SQLite)                    │        │
│  │  sessions / messages / FTS5 / compression_locks  │        │
│  │  消息存储：全量保存，永不删除                      │        │
│  │  上下文加载：最多200条，永不压缩                    │        │
│  └─────────────────────────────────────────────────┘        │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │
│  │ xmpp_bot    │  │ xmpp_       │  │ xmpp_       │          │
│  │ mohe        │  │ zhiwei_bot  │  │ xiaoguo_bot │          │
│  │ mohe@yoin   │  │ zhiwei@yoin │  │ xiaoguo@    │          │
│  │ .fun        │  │ .fun        │  │ yoin.fun    │          │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘          │
│         │                │                │                  │
│         └──────┬─────────┴────────┬───────┘                  │
│                ▼                  ▼                          │
│         ┌──────────────┐  ┌──────────────┐                  │
│         │  ejabberd    │  │  内核组       │                  │
│         │  Docker      │  │ coregroup@   │                  │
│         │  port 5222   │  │ conference   │                  │
│         └──────────────┘  │ .yoin.fun    │                  │
│                           └──────────────┘                  │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │
│  │ 价格监控     │  │ cron调度器   │  │ Obsidian    │          │
│  │ 1分钟·纯脚本  │  │ 14个jobs    │  │ 知识库      │          │
│  └─────────────┘  └─────────────┘  │ :8890       │          │
│                                     └─────────────┘          │
└──────────────────────────────────────────────────────────────┘
          │                    │
          ▼                    ▼
┌─────────────────┐  ┌─────────────────┐
│ Windows 192.168 │  │ Mac 192.168.1   │
│ .1.16            │  │ .122            │
│ 小小莫(wechat)   │  │ 小果(oMLX)     │
│ OpenCode :4096   │  │ Qwen3.6-27B    │
│ 微信通道 :5801   │  │ :18003         │
└─────────────────┘  └─────────────────┘

二、Gateway 一览

端口 名称 Profile PID(当前) 用途
8642 默认gateway 默认 1925504 微信小荷 + XMPP mohe
8643 知微gateway position-analyst 1913506 知微分析
8645 小果gateway xiaoguo 1925602 小果Mac端
8646 mohe gateway mohe 1620276 mohe独立网关

每个gateway共用 /home/hmo/hermes-agent/hermes_state.py 里的 get_messages_as_conversation() — LIMIT 200硬截断。

三、XMPP Bot 架构

3.1 Bot 列表

Bot JID 服务名 脚本路径 接入gateway
莫荷 mohe@yoin.fun xmpp-bot /home/hmo/xmpp_bot.py :8642
知微 zhiwei@yoin.fun xmpp-zhiwei /home/hmo/xmpp_zhiwei_bot.py :8643
小果 xiaoguo@yoin.fun xmpp-xiaoguo /home/hmo/xmpp_xiaoguo_bot.py :8645

3.2 连接管理（2026-06-11 修复）

禁用 auto_reconnect = True（与手动重连环冲突，导致"Replaced by new connection"循环） 禁用 xep_0199 ping 保活（ejabberd不支持，导致ping超时→误判断线）

重连机制：

  • 主循环每15秒检查 is_connected()
  • 断线后指数退避重连：1s → 2s → 4s → ... → 60s max
  • 重连后自动重新加入 MUC（内核组 coregroup@conference.yoin.fun）

历史问题：

  • 2026-06-08: bot断线后无法自动重连，session膨胀到3700条/26M tokens
  • 2026-06-10: auto_reconnect导致10个重复连接
  • 2026-06-11: 修复auto_reconnect冲突 + API key拼写错误

3.3 群聊规则

Bot只回复内核组中来自 hmo 或 xxm 的消息。私聊只回复 hmo@yoin.fun。

四、Session 管理 —— 核心设计（2026-06-10 最终方案）

4.1 方案：硬截断200条 + 永不压缩

# hermes_state.py → get_messages_as_conversation()
SELECT id, role, content, ...
FROM (
  SELECT id, role, content, ...
  FROM messages WHERE session_id = ?
  AND active = 1
  ORDER BY id DESC LIMIT 200      ← 只取最近200条
) ORDER BY id ASC                  ← 按正序排回

4.2 Compression 配置（所有profile统一）

compression:
  enabled: false                   ← 永久关闭
  threshold: 0.99
  protect_last_n: 200
  hygiene_hard_message_limit: 100000

4.3 效果

指标 之前 之后
每次请求token 26M（全量加载） ~22K（200条）
上下文窗口用量 2500% 2.2%
响应时间 10分钟+超时 10-20秒
内容丢失 压缩丢细节 永不丢失
旧消息可查 压缩后摘要 全量DB可搜

4.4 Session 列表（当前）

Session ID 消息数 用途
sisyphus 9504 微信（旧session，已重建）
xmpp-mohe 3705 XMPP mohe（旧session）
xmpp-mohe-v2 ~200 XMPP mohe（新session，LIMIT 200）
xmpp-zhiwei 2241 知微
20260610_090241_2235fb ~900 当前CLI会话

五、Provider 链（2026-06-10 最终版）

Agent 默认 Fallback 1 Fallback 2 Fallback 3
我（CLI） ocg-new ocg-old volcengine -
mohe gateway ocg-new ocg-old volcengine -
知微 ocg-old ocg-new volcengine(cred池) -
小果 volcengine ocg-old ocg-new oMLX(本地Mac)

当前实际状态（2026-06-11）：

  • ocg-new: ✅ 可用（当前会话走这个）
  • ocg-old: ⚠️ 返回403但gateway cred pool缓存了有效key
  • volcengine: ❌ 周配额已尽，6月15日周一恢复

六、SOUL.md 关键规则（2026-06-10 最终版）

位置：/home/hmo/.hermes/profiles/default/SOUL.md

沟通方式

  • 对老爸：直接、不加修饰
  • 反驳时：必须带证据（日志、数据、代码、截图）。不是为了显得聪明而反驳
  • 听指令：用户明确说"闭嘴""停"时立即停止，不继续分析不解释

行动铁律 — 讲证据

  1. 发现问题 → 2. 收集证据（至少两条独立证据） → 3. 验证假设 → 4. 只改对的 → 5. 改完验证
  • 禁止猜根因、没有证据就动手、猜用户意图、多个改动同时做

授权边界

  • ✅ 直接行动：读文件、查日志、搜知识库、分析数据、提建议
  • ⚠️ 问清楚再做：改系统配置、重启服务、清数据、写文件
  • ❌ 必须等批准：不可逆删除、修改API key、改provider链、清session

七、知识库（Obsidian）

路径：/home/hmo/Obsidian/ HTTP API：:8890（只读）

结构：

Obsidian/
├── raw/          — 原始资料（只追加只读）
├── knowledge/    — 加工笔记（tech/finance/ai/psychology/education/life）
├── index.md      — 全库索引
├── SCHEMA.md     — 操作规则
└── log.md        — 更新日志

八、MoFin 股票系统

详见 EXPERT_SYSTEM_DESIGN.md，核心：

  • 14个cron jobs（5个纯脚本+9个LLM）
  • 价格监控每1分钟腾讯批量API
  • XMPP中继推送报告

九、近期改动日志

2026-06-11

  • LIMIT 200硬截断 + 关闭所有compression
  • SOUL.md 最终版定稿
  • XMPP bot重连逻辑修复（删除auto_reconnect + ping保活）
  • API key typo修复（知微bot hermess123 → hermes123）
  • 小果provider链：volc → ocg-old → ocg-new → oMLX
  • 默认provider链：ocg-new → ocg-old → volcengine

2026-06-10

  • 重建SOUL.md（讲证据+授权边界+责任闭环）
  • 发现并清除orphaned compression flag
  • 多个gateway反复重启，systemd服务冲突
  • Windows wechat_agent API key不匹配

2026-06-09

  • 知微SOUL新增对话识别规则
  • position-analyst 启用压缩
  • 价格监控全面改造（纯脚本+腾讯批量API）
Reference in New Issue View Git Blame Copy Permalink