From 58594198dac03094832c935509097b5e240ea17c Mon Sep 17 00:00:00 2001
From: RF-Tar-Railt <3165388245@qq.com>
Date: Fri, 20 Oct 2023 15:35:57 +0800
Subject: [PATCH] release 0.0.19

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 387d7c8..7898cff 100644
--- a/README.md
+++ b/README.md
@@ -215,6 +215,34 @@ modules.module_as_dir::模块加载成功!!!
 modules.module_as_dir::模块加载成功!!!
 ```
 
+## Factory
+
+`saya.factory` 提供了 `factory` 与 `buffer_modifier` 两个装饰器, 用于进一步构建自定义的装饰器来构造用于 `Channel.use` 的 `Schema` .
+
+以 `ListenerSchema` 为例：
+
+```python
+from graia.saya.factory import factory
+
+@factory
+def listen(*event) -> SchemaWrapper:
+    def wrapper(func: Callable, buffer: Dict[str, Any]) -> ListenerSchema:
+        buffer["inline_dispatchers"] = buffer.pop("dispatchers", [])
+        return ListenerSchema(listening_events=list(event), **buffer)
+
+    return wrapper
+```
+
+再将其装饰在响应的函数上：
+
+```python
+from graia.saya.builtins.broadcast.shortcut import listen
+
+@listen(...)  # 填入你需要监听的事件
+async def module_listener():
+    print("事件被触发!!!!")
+```
+
 ## 协议
 
 本项目使用 MIT 作为开源协议.