> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 态势监控 | Situation Monitor

> 面向加密资产投资者的 AI 辅助实时情报系统

# 📌 态势监控系统 | Situation Monitor

**Situation Monitor** 是一个面向加密资产投资者的 AI 辅助实时情报系统，旨在用系统替代用户盯盘和刷信息的行为，只在"值得注意"时打断用户。

<Warning>
  **核心定位**: 我们不是在做自动交易机器人，而是在做提前预警的情报系统。
</Warning>

## 🎯 项目目标 | Project Goals

### 核心目标

<CardGroup cols={2}>
  <Card title="持续监控" icon="eye">
    监控市场行情、链上行为与公开舆情
  </Card>

  <Card title="自动过滤" icon="filter">
    过滤噪音与低质量信息
  </Card>

  <Card title="早期发现" icon="lightbulb">
    发现早期趋势与异常行为
  </Card>

  <Card title="精准推送" icon="bell">
    用简洁、可执行的方式推送关键信号
  </Card>
</CardGroup>

### 解决的核心问题

系统希望解决用户的核心问题：

> **"现在需不需要操作？如果需要，应该关注什么？"**

<Tip>
  这是一个**决策前过滤系统（Decision Pre-filter）**，而不是普通行情或资讯平台。
</Tip>

## 🧠 用户痛点 | User Pain Points

当前用户普遍面临的问题：

<AccordionGroup>
  <Accordion title="FOMO 焦虑" icon="clock">
    离开屏幕就产生 FOMO（怕错过行情），需要持续盯盘
  </Accordion>

  <Accordion title="信息过载" icon="inbox">
    信息源过多（推特、TG、新闻、KOL）难以筛选
  </Accordion>

  <Accordion title="机会识别" icon="magnifying-glass">
    很难识别真正的早期机会
  </Accordion>

  <Accordion title="情绪影响" icon="brain">
    决策容易被情绪和舆论带偏
  </Accordion>
</AccordionGroup>

**Situation Monitor 的定位**：用系统替代用户盯盘和刷信息的行为，只在"值得注意"时打断用户。

## 🧩 系统架构 | System Architecture

系统采用 **流水线 + 模块化服务** 架构。

<Steps>
  <Step title="阶段 A：数据采集层">
    由 APScheduler 定时调度，采集市场行情、链上数据、社交媒体和新闻源
  </Step>

  <Step title="阶段 B：数据清洗与结构化">
    统一字段结构、去重、噪声过滤、特征提取
  </Step>

  <Step title="阶段 C：信号分析引擎">
    跨数据源关联分析、叙事趋势跟踪、异常行为检测、风险分级
  </Step>

  <Step title="阶段 D：通知与用户交互层">
    通过多渠道矩阵（TG/WA/Twitter/Rocket.Chat）推送高优先级信号，配合 Dashboard 实现多维提醒
  </Step>
</Steps>

### 🛰️ 全局数据流架构 | Data Flow Architecture

```mermaid theme={null}
graph TD
    subgraph "数据采集层 (On-chain & Off-chain)"
        A1["市场行情 API"] --> B1["原始信号池"]
        A2["Twitter/X 爬虫"] --> B1
        A3["GMGN 链上扫描"] --> B1
        A4["RSS 宏观新闻"] --> B1
    end

    subgraph "AI 审计与分析引擎 (Brain)"
        B1 --> C1{"逻辑审计"}
        C2["AI 语义评分"] & C3["维度关联"] --> D1["信号评级"]
    end

    subgraph "推送终端 (Delivery)"
        D1 --> E1["Telegram 群组"]
        D1 --> E2["WhatsApp 频道"]
        D1 --> E3["Twitter 矩阵"]
        D1 --> E4["Rocket.Chat (内部)"]
        D1 --> E5["Dashboard"]
    end

    style D1 fill:#f96,stroke:#333,stroke-width:2px
    style B1 fill:#bbf,stroke:#333,stroke-width:1px
```

### 数据采集层（阶段 A）

| 数据源                   | 频率    | 目的            |
| --------------------- | ----- | ------------- |
| 市场行情（Binance / OKX 等） | 5 分钟  | 判断市场是否活跃、有无异动 |
| GMGN 新币数据             | 5 分钟  | 发现新项目与大户行为    |
| Twitter / X           | 10 分钟 | 监测叙事与情绪变化     |
| RSS 新闻源               | 15 分钟 | 宏观与政策事件       |

**输出**: 原始数据 JSON

### 数据清洗层（阶段 B）

**职责**:

* 统一字段结构
* 去重
* 噪声过滤
* 特征提取

**产出标准化数据**:

* `clean_market.json`
* `clean_tokens.json`
* `clean_sentiment.json`

### 信号分析引擎（阶段 C）

这是系统的**核心价值模块**。

**主要能力**:

* 跨数据源关联分析
* 叙事趋势演化跟踪
* 异常行为检测
* 风险分级

**输出**: `signals.json`

**分析方式**:

* **规则系统**: 负责确定性过滤
* **LLM**: 负责模式识别与语义判断

### 通知与用户交互层（阶段 D）

**推送通路**:

* **内部通道**: Rocket.Chat (DevOps & 核心成员)
* **外部矩阵**: Telegram 群组、WhatsApp 频道、Twitter/X 自动发帖
* **可视化**: 网页版交互式 Dashboard

**推送原则**:

* 只推高优先级信号
* 避免信息轰炸
* 市场平稳期采用摘要推送

**目标状态**: 用户无需主动盯盘，系统在多终端必要时提醒。

## 🎖️ 用户分级与权限 | User Tiers & Permissions

系统通过阶梯式的订阅模型，为不同等级的用户提供差异化的情报服务。

### 📊 权益流转架构 | Rights Flow Architecture

```mermaid theme={null}
graph LR
    subgraph "用户等级 | User Tiers"
        U1["🆓 免费用户"]
        U2["📝 注册用户"]
        U3["💰 付费用户"]
        U4["👑 高级付费用户"]
    end

    subgraph "交付前端 | Delivery Frontends"
        F1["📱 Telegram<br/>即时信号"]
        F2["📰 Ghost CMS<br/>深度分析"]
        F3["💬 Rocket.Chat<br/>高端情报"]
    end

    U1 -- "不可见 / 基础看板" --> F1
    U2 -- "实时信号" --> F1
    U3 -- "优先推送" --> F1
    U3 -- "可读文章" --> F2
    U4 -- "提前/全量信号" --> F1
    U4 -- "完整内容/专属分析" --> F2
    U4 -- "准入资格" --> F3

    style U4 fill:#f9f,stroke:#333,stroke-width:2px
    style F3 fill:#dfd,stroke:#333,stroke-width:2px
    style U1 fill:#eee,stroke:#999
```

### 📋 权限明细表 | Permission Matrix

| 交付终端            | 免费用户   | 注册用户   | 付费用户   | 高级付费用户     |
| :-------------- | :----- | :----- | :----- | :--------- |
| **Telegram**    | 仅看板可见  | 实时信号推送 | 极速优先推送 | 提前/全量信号    |
| **Ghost CMS**   | 仅标题/摘要 | 仅标题/摘要 | 深度分析全文 | 专属策略分析     |
| **Rocket.Chat** | 无权限    | 无权限    | 无权限    | **核心情报准入** |

<Tip>
  这种分层设计确保了系统的商业可持续性，同时将最高价值的情报保留在最核心的圈层。
</Tip>

## 👥 团队分工 | Team Structure

按流水线模块拆分：

| 小组      | 负责模块     |
| ------- | -------- |
| **A 组** | 数据采集服务   |
| **B 组** | 清洗与数据管道  |
| **C 组** | 分析引擎与 AI |
| **D 组** | 推送系统与接口  |

各模块以服务方式独立部署，通过数据库或消息队列通信。

## 🧱 基础设施 | Infrastructure

<CardGroup cols={2}>
  <Card title="Kubernetes" icon="server">
    k3s - 服务以 Pod 形式部署
  </Card>

  <Card title="PostgreSQL" icon="database">
    结构化数据存储
  </Card>

  <Card title="Redis" icon="bolt">
    缓存与去重（可选）
  </Card>

  <Card title="对象存储" icon="cloud">
    原始数据归档
  </Card>
</CardGroup>

## 📈 开发路线 | Development Roadmap

<AccordionGroup>
  <Accordion title="Phase 1：验证阶段（MVP）" icon="vial">
    * Rocket.Chat 内部推送集成
    * Telegram/Twitter 外部矩阵原型
    * 简单规则信号
    * 人工评估信号质量

    **目标**: 验证多端覆盖对降低焦虑的有效性。
  </Accordion>

  <Accordion title="Phase 2：智能增强" icon="brain">
    * 引入叙事演化追踪
    * AI 聚类与主题总结

    **目标**: 提高信号准确度与前瞻性。
  </Accordion>

  <Accordion title="Phase 3：产品化" icon="rocket">
    * 用户画像
    * 个性化阈值
    * 订阅计费系统
  </Accordion>
</AccordionGroup>

## 🧭 设计原则 | Design Principles

<CodeGroup>
  ```markdown 信号优先于数据 theme={null}
  系统输出的是可执行的信号，而非原始数据
  ```

  ```markdown 自动化优先于看板 theme={null}
  减少人工干预，系统自动判断和推送
  ```

  ```markdown 可解释优先于黑盒 theme={null}
  每个信号都有明确的触发原因和证据
  ```

  ```markdown 模块化优先于单体系统 theme={null}
  各模块独立部署，便于扩展和维护
  ```
</CodeGroup>

## � 相关协议与规范 | Protocols & Specs

<CardGroup cols={2}>
  <Card title="核心协议 (signals.json)" icon="file-code" href="/guides/project-vision/situation-monitor-signals">
    查看信号定义、优先级判定与生命周期
  </Card>

  <Card title="接口与数据流" icon="plug" href="/guides/project-vision/situation-monitor-interfaces">
    各层级模块间的 API 交互与数据管道规范
  </Card>
</CardGroup>

<Danger>
  **非目标范围**: 系统明确不提供自动下单、盈利保证、明确买卖点位。系统定位是情报与决策辅助，而非交易执行。
</Danger>