# aozorayui/js-plugin architecture

> Architecture diagram of the GitHub repository aozorayui/js-plugin, 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/aozorayui/js-plugin
- Repository: https://github.com/aozorayui/js-plugin

## Overview

This repository is a set of three Yunzai-Bot message plugins: natural-language alarms, local Louvre-style image rendering, and alias/mention notifications with history. In each workflow, a chat event enters the corresponding plugin; it then parses the request, performs its domain action, and replies or records results. Alarm scheduling and Redis persistence are visible in excerpts, as are the image renderer and alias/mention history features. The alias excerpt does not show all persistence and notification calls, so those documented capabilities are represented at plugin level without speculative internal links.

Main entry points: [`Timed-alarm-clock.js`](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js) (Alarm commands), [`one-last-image.js`](https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js) (Image commands), [`alias&at_notice.js`](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js) (Message and commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_alarms["Alarm plugin"]
  node_alarm_plugin["Alarm commands"]
  node_time_parse["Time parsing"]
  node_alarm_store[("Alarm records")]
  node_scheduler["Job scheduling"]
  node_alarm_notify["Timed reminders"]
  node_alarm_lists["Alarm lists"]
end

subgraph group_art["Image plugin"]
  node_image_plugin["Image commands<br/>[one-last-image.js]"]
  node_image_source["Image sourcing<br/>[one-last-image.js]"]
  node_option_parser["Effect options<br/>[one-last-image.js]"]
  node_image_renderer["Local rendering<br/>[one-last-image.js]"]
end

subgraph group_notices["Notice plugin"]
  node_mention_plugin["Message and commands<br/>[alias&amp;at_notice.js]"]
  node_alias_management["Alias management<br/>[alias&amp;at_notice.js]"]
  node_alias_records[("Alias data<br/>[alias&amp;at_notice.js]")]
  node_mention_tracking["Mention tracking<br/>[alias&amp;at_notice.js]"]
  node_history_queries["History queries<br/>[alias&amp;at_notice.js]"]
  node_history_store[("Mention history<br/>[alias&amp;at_notice.js]")]
  node_private_notify["Private notifications<br/>[alias&amp;at_notice.js]"]
  node_record_images["History images<br/>[alias&amp;at_notice.js]"]
end

node_chat_user(("Chat user"))
node_yunzai["Yunzai Bot"]
node_puppeteer["Puppeteer"]
node_common["Yunzai common"]

node_chat_user -->|"sends message"| node_yunzai
node_yunzai -->|"dispatches command"| node_alarm_plugin
node_alarm_plugin -->|"parses time"| node_time_parse
node_alarm_plugin -->|"writes records"| node_alarm_store
node_alarm_plugin -->|"schedules jobs"| node_scheduler
node_scheduler -.->|"triggers reminder"| node_alarm_notify
node_alarm_plugin -->|"reads records"| node_alarm_store
node_alarm_plugin -->|"lists or cancels"| node_alarm_lists
node_alarm_plugin -->|"builds forwards"| node_common
node_yunzai -->|"dispatches command"| node_image_plugin
node_image_plugin -->|"gets source image"| node_image_source
node_image_plugin -->|"parses options"| node_option_parser
node_image_plugin -->|"renders image"| node_image_renderer
node_image_renderer -->|"renders locally"| node_puppeteer
node_image_plugin -->|"replies with image"| node_chat_user
node_yunzai -->|"dispatches messages"| node_mention_plugin
node_mention_plugin -->|"handles alias commands"| node_alias_management
node_alias_management -->|"reads and writes"| node_alias_records
node_mention_plugin -->|"tracks mentions"| node_mention_tracking
node_mention_tracking -.->|"records events"| node_history_store
node_mention_plugin -->|"handles history queries"| node_history_queries
node_history_queries -.->|"reads records"| node_history_store
node_mention_tracking -->|"notifies targets"| node_private_notify
node_history_queries -->|"renders history"| node_record_images
node_record_images -->|"captures screenshot"| node_puppeteer
node_mention_plugin -->|"builds forwards"| node_common

click node_alarm_plugin "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_time_parse "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_alarm_store "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_scheduler "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_alarm_notify "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_alarm_lists "https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js"
click node_image_plugin "https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js"
click node_image_source "https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js"
click node_option_parser "https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js"
click node_image_renderer "https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js"
click node_mention_plugin "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_alias_management "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_alias_records "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_mention_tracking "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_history_queries "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_history_store "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_private_notify "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js"
click node_record_images "https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.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_alarm_plugin,node_time_parse,node_alarm_store,node_scheduler,node_alarm_notify,node_alarm_lists,node_chat_user toneBlue
class node_image_plugin,node_image_source,node_option_parser,node_image_renderer toneAmber
class node_mention_plugin,node_alias_management,node_alias_records,node_mention_tracking,node_history_queries,node_history_store,node_private_notify,node_record_images toneMint
class node_yunzai,node_puppeteer,node_common toneIndigo
```

## Components

### Alarm plugin

- [Alarm commands](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`
- [Time parsing](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`
- [Alarm records](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`
- [Job scheduling](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`
- [Timed reminders](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`
- [Alarm lists](https://github.com/aozorayui/js-plugin/blob/main/Timed-alarm-clock.js): `Timed-alarm-clock.js`

### Image plugin

- [Image commands](https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js): `one-last-image.js`
- [Image sourcing](https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js): `one-last-image.js`
- [Effect options](https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js): `one-last-image.js`
- [Local rendering](https://github.com/aozorayui/js-plugin/blob/main/one-last-image.js): `one-last-image.js`

### Notice plugin

- [Message and commands](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [Alias management](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [Alias data](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [Mention tracking](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [History queries](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [Mention history](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [Private notifications](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`
- [History images](https://github.com/aozorayui/js-plugin/blob/main/alias%26at_notice.js): `alias&at_notice.js`

### Other components

- **Chat user**
- **Yunzai Bot**
- **Puppeteer**
- **Yunzai common**

## Connections

- Chat user → Yunzai Bot: sends message (evidence: `README.md`)
- Yunzai Bot → Alarm commands: dispatches command (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Time parsing: parses time (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Alarm records: writes records (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Job scheduling: schedules jobs (evidence: `Timed-alarm-clock.js`)
- Job scheduling → Timed reminders: triggers reminder (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Alarm records: reads records (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Alarm lists: lists or cancels (evidence: `Timed-alarm-clock.js`)
- Alarm commands → Yunzai common: builds forwards (evidence: `Timed-alarm-clock.js`)
- Yunzai Bot → Image commands: dispatches command (evidence: `one-last-image.js`)
- Image commands → Image sourcing: gets source image (evidence: `one-last-image.js`)
- Image commands → Effect options: parses options (evidence: `one-last-image.js`)
- Image commands → Local rendering: renders image (evidence: `one-last-image.js`)
- Local rendering → Puppeteer: renders locally (evidence: `one-last-image.js`)
- Image commands → Chat user: replies with image (evidence: `one-last-image.js`)
- Yunzai Bot → Message and commands: dispatches messages (evidence: `alias&at_notice.js`)
- Message and commands → Alias management: handles alias commands (evidence: `alias&at_notice.js`)
- Alias management → Alias data: reads and writes (evidence: `alias&at_notice.js`)
- Message and commands → Mention tracking: tracks mentions (evidence: `alias&at_notice.js`)
- Mention tracking → Mention history: records events (evidence: `alias&at_notice.js`)
- Message and commands → History queries: handles history queries (evidence: `alias&at_notice.js`)
- History queries → Mention history: reads records (evidence: `alias&at_notice.js`)
- Mention tracking → Private notifications: notifies targets (evidence: `alias&at_notice.js`)
- History queries → History images: renders history (evidence: `alias&at_notice.js`)
- History images → Puppeteer: captures screenshot (evidence: `alias&at_notice.js`)
- Message and commands → Yunzai common: builds forwards (evidence: `alias&at_notice.js`)
