# tianyupaipai-cmd/xinchao-dynamic-mind architecture

> Architecture diagram of the GitHub repository tianyupaipai-cmd/xinchao-dynamic-mind, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tianyupaipai-cmd/xinchao-dynamic-mind
- Repository: https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind

## Overview

心潮是可自托管的 AI 动态状态层：终端经 HTTP 或远程 MCP 读取短期上下文、提交有界互动或便签，服务端结算状态并返回结果。独立分支提供 Dashboard、OAuth、用户互动 Bridge，以及可选的模型、长期记忆和通知适配器。状态引擎可离线运行，外部集成并非必需。关系依据 README 与所示源码；Bridge、持久化和部分路由细节未完整展示，相关连线仅按文档描述。

Main entry points: [`src/server.js`](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/server.js) (HTTP 服务), [`src/engine.js`](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/engine.js) (状态结算引擎), [`src/context-envelope.js`](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/context-envelope.js) (Context Envelope), [`src/bridge-queue.js`](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bridge-queue.js) (互动耐久队列)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["服务与协议"]
  node_server["HTTP 服务<br/>[server.js]"]
  node_mcp["MCP 工具协议<br/>[mcp-protocol.js]"]
  node_oauth["OAuth 2.1<br/>[oauth-provider.js]"]
  node_config["运行配置<br/>[config.js]"]
end

subgraph group_mind["动态状态"]
  node_engine["状态结算引擎<br/>[engine.js]"]
  node_dimensions["驱动力维度<br/>[dimensions.js]"]
  node_thoughts["念头池<br/>[thought-pool.js]"]
  node_interactions["互动语义反馈"]
  node_state[("状态存储<br/>[state-store.js]")]
end

subgraph group_continuity["短期连续性"]
  node_context["Context Envelope"]
  node_handoff["交接便签<br/>[handoff-notes.js]"]
  node_heartbeat["心跳记录<br/>[heartbeat-store.js]"]
  node_journal[("转换日志")]
end

subgraph group_dashboard["Dashboard 与 Bridge"]
  node_dashboard_auth["Dashboard 会话<br/>[dashboard-auth.js]"]
  node_projection["状态与时间线投影"]
  node_bridge["互动耐久队列<br/>[bridge-queue.js]"]
  node_wake_protocol["Wake Bridge 信封"]
end

subgraph group_integrations["可选适配器"]
  node_model["模型适配器<br/>[model-client.js]"]
  node_ombre["Ombre 记忆适配器<br/>[ombre-client.js]"]
  node_bark["Bark 通知<br/>[bark-client.js]"]
  node_dedupe["通知去重<br/>[bark-dedupe.js]"]
  node_board["公共留言板客户端<br/>[board-client.js]"]
end

node_client(("终端与 Agent"))
node_model_service(("兼容模型服务"))
node_memory_service(("Ombre 记忆服务"))
node_bark_service(("Bark 推送服务"))
node_board_service(("留言板服务"))

node_client -->|"调用 HTTP API"| node_server
node_client -->|"调用远程 MCP"| node_mcp
node_server -->|"加载配置"| node_config
node_server -->|"读取驱动力"| node_engine
node_server -->|"处理 MCP 请求"| node_mcp
node_server -->|"处理授权端点"| node_oauth
node_server -->|"构建上下文"| node_context
node_server -->|"结算互动"| node_interactions
node_server -->|"记录便签"| node_handoff
node_server -->|"刷新在场时间"| node_heartbeat
node_server -->|"生成状态投影"| node_projection
node_server -->|"处理互动投递"| node_bridge
node_server -->|"读取变化时间线"| node_journal
node_server -->|"生成梦境内容"| node_model
node_server -.->|"请求长期记忆"| node_ombre
node_server -->|"筛选通知内容"| node_dedupe
node_server -.->|"发送推送"| node_bark
node_server -->|"读写留言板"| node_board
node_engine -->|"读取维度规则"| node_dimensions
node_engine -->|"更新念头池"| node_thoughts
node_context -->|"提取动态状态"| node_engine
node_context -->|"渲染近期便签"| node_handoff
node_projection -->|"读取维度定义"| node_dimensions
node_mcp -->|"调用工具回调"| node_server
node_server -.->|"读写运行状态"| node_state
node_bridge -->|"持久化队列"| node_state
node_model -->|"请求生成"| node_model_service
node_ombre -->|"检索记忆"| node_memory_service
node_bark -->|"发送通知"| node_bark_service
node_board -->|"读写留言"| node_board_service
node_bridge -.->|"使用信封协议"| node_wake_protocol

click node_server "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/server.js"
click node_mcp "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/mcp-protocol.js"
click node_oauth "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/oauth-provider.js"
click node_config "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/config.js"
click node_engine "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/engine.js"
click node_dimensions "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dimensions.js"
click node_thoughts "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/thought-pool.js"
click node_interactions "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/interaction-messages.js"
click node_state "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/state-store.js"
click node_context "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/context-envelope.js"
click node_handoff "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/handoff-notes.js"
click node_heartbeat "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/heartbeat-store.js"
click node_journal "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/transition-journal.js"
click node_dashboard_auth "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dashboard-auth.js"
click node_projection "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dashboard-projection.js"
click node_bridge "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bridge-queue.js"
click node_wake_protocol "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/wake-bridge-protocol.js"
click node_model "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/model-client.js"
click node_ombre "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/ombre-client.js"
click node_bark "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bark-client.js"
click node_dedupe "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bark-dedupe.js"
click node_board "https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/board-client.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_mcp,node_oauth,node_config toneBlue
class node_engine,node_dimensions,node_thoughts,node_interactions,node_state toneAmber
class node_context,node_handoff,node_heartbeat,node_journal toneMint
class node_dashboard_auth,node_projection,node_bridge,node_wake_protocol toneRose
class node_model,node_ombre,node_bark,node_dedupe,node_board,node_client,node_model_service,node_memory_service,node_bark_service,node_board_service toneIndigo
```

## Components

### 服务与协议

- [HTTP 服务](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/server.js): `src/server.js`
- [MCP 工具协议](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/mcp-protocol.js): `src/mcp-protocol.js`
- [OAuth 2.1](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/oauth-provider.js): `src/oauth-provider.js`
- [运行配置](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/config.js): `src/config.js`

### 动态状态

- [状态结算引擎](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/engine.js): `src/engine.js`
- [驱动力维度](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dimensions.js): `src/dimensions.js`
- [念头池](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/thought-pool.js): `src/thought-pool.js`
- [互动语义反馈](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/interaction-messages.js): `src/interaction-messages.js`
- [状态存储](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/state-store.js): `src/state-store.js`

### 短期连续性

- [Context Envelope](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/context-envelope.js): `src/context-envelope.js`
- [交接便签](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/handoff-notes.js): `src/handoff-notes.js`
- [心跳记录](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/heartbeat-store.js): `src/heartbeat-store.js`
- [转换日志](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/transition-journal.js): `src/transition-journal.js`

### Dashboard 与 Bridge

- [Dashboard 会话](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dashboard-auth.js): `src/dashboard-auth.js`
- [状态与时间线投影](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/dashboard-projection.js): `src/dashboard-projection.js`
- [互动耐久队列](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bridge-queue.js): `src/bridge-queue.js`
- [Wake Bridge 信封](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/wake-bridge-protocol.js): `src/wake-bridge-protocol.js`

### 可选适配器

- [模型适配器](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/model-client.js): `src/model-client.js`
- [Ombre 记忆适配器](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/ombre-client.js): `src/ombre-client.js`
- [Bark 通知](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bark-client.js): `src/bark-client.js`
- [通知去重](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/bark-dedupe.js): `src/bark-dedupe.js`
- [公共留言板客户端](https://github.com/tianyupaipai-cmd/xinchao-dynamic-mind/blob/main/src/board-client.js): `src/board-client.js`

### Other components

- **终端与 Agent**
- **兼容模型服务**
- **Ombre 记忆服务**
- **Bark 推送服务**
- **留言板服务**

## Connections

- 终端与 Agent → HTTP 服务: 调用 HTTP API (evidence: `README.md`)
- 终端与 Agent → MCP 工具协议: 调用远程 MCP (evidence: `README.md`)
- HTTP 服务 → 运行配置: 加载配置 (evidence: `src/server.js`)
- HTTP 服务 → 状态结算引擎: 读取驱动力 (evidence: `src/server.js`)
- HTTP 服务 → MCP 工具协议: 处理 MCP 请求 (evidence: `src/server.js`)
- HTTP 服务 → OAuth 2.1: 处理授权端点 (evidence: `README.md`)
- HTTP 服务 → Context Envelope: 构建上下文 (evidence: `src/server.js`)
- HTTP 服务 → 互动语义反馈: 结算互动 (evidence: `README.md`)
- HTTP 服务 → 交接便签: 记录便签 (evidence: `README.md`)
- HTTP 服务 → 心跳记录: 刷新在场时间 (evidence: `README.md`)
- HTTP 服务 → 状态与时间线投影: 生成状态投影 (evidence: `src/server.js`)
- HTTP 服务 → 互动耐久队列: 处理互动投递 (evidence: `README.md`)
- HTTP 服务 → 转换日志: 读取变化时间线 (evidence: `src/server.js`)
- HTTP 服务 → 模型适配器: 生成梦境内容 (evidence: `src/server.js`)
- HTTP 服务 → Ombre 记忆适配器: 请求长期记忆 (evidence: `README.md`)
- HTTP 服务 → 通知去重: 筛选通知内容 (evidence: `src/server.js`)
- HTTP 服务 → Bark 通知: 发送推送 (evidence: `README.md`)
- HTTP 服务 → 公共留言板客户端: 读写留言板 (evidence: `src/server.js`)
- 状态结算引擎 → 驱动力维度: 读取维度规则 (evidence: `src/engine.js`)
- 状态结算引擎 → 念头池: 更新念头池 (evidence: `src/engine.js`)
- Context Envelope → 状态结算引擎: 提取动态状态 (evidence: `src/context-envelope.js`)
- Context Envelope → 交接便签: 渲染近期便签 (evidence: `src/context-envelope.js`)
- 状态与时间线投影 → 驱动力维度: 读取维度定义 (evidence: `src/dashboard-projection.js`)
- MCP 工具协议 → HTTP 服务: 调用工具回调 (evidence: `src/server.js`)
- HTTP 服务 → 状态存储: 读写运行状态 (evidence: `README.md`)
- 互动耐久队列 → 状态存储: 持久化队列 (evidence: `src/bridge-queue.js`)
- 模型适配器 → 兼容模型服务: 请求生成 (evidence: `src/model-client.js`)
- Ombre 记忆适配器 → Ombre 记忆服务: 检索记忆 (evidence: `src/ombre-client.js`)
- Bark 通知 → Bark 推送服务: 发送通知 (evidence: `src/bark-client.js`)
- 公共留言板客户端 → 留言板服务: 读写留言 (evidence: `src/board-client.js`)
- 互动耐久队列 → Wake Bridge 信封: 使用信封协议
