# zju-real/easel architecture

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

- Interactive diagram: https://gitdiagram.com/zju-real/easel
- Repository: https://github.com/zju-real/easel

## Overview

Easel is a creator-focused social-media content workbench: its recommended Web interface connects a persistent account profile and OpenClaw agent to discovery, planning, production, publishing, and performance review. The UI sends chat and management requests through a shared API to the Python backend; the backend coordinates gateway access and account/workspace services, while runnable skills provide domain capabilities. README documents the full five-stage workflow and seven-platform publishing, but many individual skill implementations and backend routes were not sampled, so those branches are represented at directory level and their links rely on README evidence.

Main entry points: [`web/app.py`](https://github.com/zju-real/easel/blob/main/web/app.py) (Web Backend), [`skills/openclaw`](https://github.com/zju-real/easel/tree/main/skills/openclaw) (Runnable Skills), [`web/frontend/src/App.tsx`](https://github.com/zju-real/easel/blob/main/web/frontend/src/App.tsx) (Web Workbench), [`easel/gateway_endpoint.py`](https://github.com/zju-real/easel/blob/main/easel/gateway_endpoint.py) (Gateway Endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Creator Workbench"]
  node_webui["Web Workbench<br/>[App.tsx]"]
  node_api["Frontend API<br/>[api.ts]"]
  node_backend["Web Backend<br/>[app.py]"]
  node_persona["Account Persona<br/>[persona.py]"]
end

subgraph group_runtime["Agent Runtime"]
  node_agent{{"OpenClaw Agent"}}
  node_gateway["Gateway Endpoint"]
  node_questions["Question Bridge"]
  node_workspace["Agent Workspace"]
  node_localagents["Local Agent Discovery<br/>[local_agents.py]"]
  node_skills["Runnable Skills"]
end

subgraph group_content["Content Workflow"]
  node_discovery["Trend Discovery"]
  node_planning["Content Planning"]
  node_creation["Media Creation"]
  node_archive["Project Outputs<br/>[output_paths.py]"]
end

subgraph group_insight["Publishing And Insight"]
  node_publish["Platform Publishing"]
  node_platforms{{"Social Platforms"}}
  node_attribution["Performance Review<br/>[review.py]"]
  node_xhscli["XHS Analyzer CLI<br/>[cli.ts]"]
  node_xhsclient["XHS API Client<br/>[client.ts]"]
  node_xhsanalysis["Note Analysis<br/>[analyze.ts]"]
end

node_creator(("Creator"))

node_creator -->|"uses"| node_webui
node_webui -->|"requests"| node_api
node_api -->|"calls API"| node_backend
node_backend -->|"manages profiles"| node_persona
node_backend -->|"resolves gateway"| node_gateway
node_backend -->|"bridges questions"| node_questions
node_backend -->|"uses workspace"| node_workspace
node_backend -->|"detects agents"| node_localagents
node_gateway -->|"reads state"| node_workspace
node_questions -->|"RPC calls"| node_gateway
node_webui -->|"converses with"| node_agent
node_agent -->|"executes skills"| node_skills
node_agent -->|"uses account context"| node_persona
node_skills -->|"supports"| node_discovery
node_skills -->|"supports"| node_planning
node_skills -->|"produces media"| node_creation
node_creation -->|"archives outputs"| node_archive
node_skills -->|"supports publishing"| node_publish
node_publish -->|"publishes to"| node_platforms
node_platforms -->|"returns performance"| node_attribution
node_attribution -->|"informs profile"| node_persona
node_xhscli -->|"uses client"| node_xhsclient
node_xhsclient -->|"requests XHS"| node_platforms
node_xhscli -->|"analyzes notes"| node_xhsanalysis

click node_webui "https://github.com/zju-real/easel/blob/main/web/frontend/src/App.tsx"
click node_api "https://github.com/zju-real/easel/blob/main/web/frontend/src/lib/api.ts"
click node_backend "https://github.com/zju-real/easel/blob/main/web/app.py"
click node_persona "https://github.com/zju-real/easel/blob/main/easel/persona.py"
click node_gateway "https://github.com/zju-real/easel/blob/main/easel/gateway_endpoint.py"
click node_questions "https://github.com/zju-real/easel/blob/main/easel/gateway_questions.py"
click node_workspace "https://github.com/zju-real/easel/blob/main/easel/openclaw_workspace.py"
click node_localagents "https://github.com/zju-real/easel/blob/main/easel/local_agents.py"
click node_skills "https://github.com/zju-real/easel/tree/main/skills/openclaw"
click node_discovery "https://github.com/zju-real/easel/tree/main/skills/openclaw"
click node_planning "https://github.com/zju-real/easel/tree/main/skills/openclaw"
click node_creation "https://github.com/zju-real/easel/tree/main/skills/shared/scripts"
click node_archive "https://github.com/zju-real/easel/blob/main/skills/shared/scripts/output_paths.py"
click node_publish "https://github.com/zju-real/easel/tree/main/skills/openclaw/skill-wechat-publisher/scripts"
click node_attribution "https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-social-performance-review/scripts/review.py"
click node_xhscli "https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/cli.ts"
click node_xhsclient "https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/lib/client.ts"
click node_xhsanalysis "https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/lib/analyze.ts"

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_webui,node_api,node_backend,node_persona toneBlue
class node_agent,node_gateway,node_questions,node_workspace,node_localagents,node_skills toneAmber
class node_discovery,node_planning,node_creation,node_archive toneMint
class node_publish,node_platforms,node_attribution,node_xhscli,node_xhsclient,node_xhsanalysis toneRose
class node_creator toneIndigo
```

## Components

### Creator Workbench

- [Web Workbench](https://github.com/zju-real/easel/blob/main/web/frontend/src/App.tsx): `web/frontend/src/App.tsx`
- [Frontend API](https://github.com/zju-real/easel/blob/main/web/frontend/src/lib/api.ts): `web/frontend/src/lib/api.ts`
- [Web Backend](https://github.com/zju-real/easel/blob/main/web/app.py): `web/app.py`
- [Account Persona](https://github.com/zju-real/easel/blob/main/easel/persona.py): `easel/persona.py`

### Agent Runtime

- **OpenClaw Agent**
- [Gateway Endpoint](https://github.com/zju-real/easel/blob/main/easel/gateway_endpoint.py): `easel/gateway_endpoint.py`
- [Question Bridge](https://github.com/zju-real/easel/blob/main/easel/gateway_questions.py): `easel/gateway_questions.py`
- [Agent Workspace](https://github.com/zju-real/easel/blob/main/easel/openclaw_workspace.py): `easel/openclaw_workspace.py`
- [Local Agent Discovery](https://github.com/zju-real/easel/blob/main/easel/local_agents.py): `easel/local_agents.py`
- [Runnable Skills](https://github.com/zju-real/easel/tree/main/skills/openclaw): `skills/openclaw`

### Content Workflow

- [Trend Discovery](https://github.com/zju-real/easel/tree/main/skills/openclaw): `skills/openclaw`
- [Content Planning](https://github.com/zju-real/easel/tree/main/skills/openclaw): `skills/openclaw`
- [Media Creation](https://github.com/zju-real/easel/tree/main/skills/shared/scripts): `skills/shared/scripts`
- [Project Outputs](https://github.com/zju-real/easel/blob/main/skills/shared/scripts/output_paths.py): `skills/shared/scripts/output_paths.py`

### Publishing And Insight

- [Platform Publishing](https://github.com/zju-real/easel/tree/main/skills/openclaw/skill-wechat-publisher/scripts): `skills/openclaw/skill-wechat-publisher/scripts`
- **Social Platforms**
- [Performance Review](https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-social-performance-review/scripts/review.py): `skills/openclaw/skill-social-performance-review/scripts/review.py`
- [XHS Analyzer CLI](https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/cli.ts): `skills/openclaw/skill-xhs-analyzer/src/cli.ts`
- [XHS API Client](https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/lib/client.ts): `skills/openclaw/skill-xhs-analyzer/src/lib/client.ts`
- [Note Analysis](https://github.com/zju-real/easel/blob/main/skills/openclaw/skill-xhs-analyzer/src/lib/analyze.ts): `skills/openclaw/skill-xhs-analyzer/src/lib/analyze.ts`

### Other components

- **Creator**

## Connections

- Creator → Web Workbench: uses
- Web Workbench → Frontend API: requests (evidence: `web/frontend/src/App.tsx`)
- Frontend API → Web Backend: calls API (evidence: `web/frontend/src/lib/api.ts`)
- Web Backend → Account Persona: manages profiles (evidence: `web/app.py`)
- Web Backend → Gateway Endpoint: resolves gateway (evidence: `web/app.py`)
- Web Backend → Question Bridge: bridges questions (evidence: `web/app.py`)
- Web Backend → Agent Workspace: uses workspace (evidence: `web/app.py`)
- Web Backend → Local Agent Discovery: detects agents (evidence: `web/app.py`)
- Gateway Endpoint → Agent Workspace: reads state (evidence: `easel/gateway_endpoint.py`)
- Question Bridge → Gateway Endpoint: RPC calls (evidence: `easel/gateway_questions.py`)
- Web Workbench → OpenClaw Agent: converses with
- OpenClaw Agent → Runnable Skills: executes skills
- OpenClaw Agent → Account Persona: uses account context
- Runnable Skills → Trend Discovery: supports
- Runnable Skills → Content Planning: supports
- Runnable Skills → Media Creation: produces media
- Media Creation → Project Outputs: archives outputs
- Runnable Skills → Platform Publishing: supports publishing
- Platform Publishing → Social Platforms: publishes to
- Social Platforms → Performance Review: returns performance
- Performance Review → Account Persona: informs profile
- XHS Analyzer CLI → XHS API Client: uses client (evidence: `skills/openclaw/skill-xhs-analyzer/src/cli.ts`)
- XHS API Client → Social Platforms: requests XHS (evidence: `skills/openclaw/skill-xhs-analyzer/src/lib/client.ts`)
- XHS Analyzer CLI → Note Analysis: analyzes notes (evidence: `skills/openclaw/skill-xhs-analyzer/src/cli.ts`)
