Architecture

# 四层 核心架构

Pneuma 基于四个清晰分离的层级构建，将 AI 执行、视觉渲染和领域特定知识优雅地解耦。

4

### Mode 协议层

ModeManifest

声明式的灵魂。定义了 AI 的能力边界 (Skills)、用户界面的呈现方式 (Viewers)，以及智能体的偏好配置。

3

### 内容视图层

ViewerContract

动态前端。实时渲染工作区内容，提取上下文反馈给 AI，并暴露可供 Agent 调用的前端接口。

2

### 智能体桥接层

AgentBackend

AI 调度核心。全权负责启动、挂起、恢复以及与底层 CLI 智能体 (例如 Claude Code) 进行进程间通信。

1

### 运行时壳层

Bun + Hono + Vite

坚实的基石。掌控文件监听、PTY 伪终端分配、会话状态持久化，并托管极其关键的双向 WebSocket 桥。