update: 链式调用

Author: ningmengchongshui

blog/2026/02/26/v2.1.20.md blog/2026/02/26/v2.1.21.mdblog/2026/02/26/v2.1.20.md renamed to blog/2026/02/26/v2.1.21.md

@@ -1,5 +1,5 @@
 ---
-title: V2.1.20
+title: V2.1.21
 description: 写法简化
 # slug: welcome-docusaurus-v2
 authors: ningmengchongshui

docs/alemonjsDocs/basic/data-type.md

@@ -18,206 +18,195 @@ sidebar_position: 5
 ### Text
 
 ```ts title="src/response/**/*/res.ts"
-import { Text, useMessage } from 'alemonjs'
+import { useMessage } from 'alemonjs'
 export default event => {
   // 创建
   const [message] = useMessage(event)
-  message.send(
-    format(Text('这个'), Text('标题', { style: 'bold' }), Text('被加粗了'))
-  )
-  message.send(format(Text('这个'), Text('标题'), Text('没有变化')))
-  message.send(
-    format(
-      Text(`// 我的代码块 \nconst Send = useSend(event)`, {
+
+ // ex 1
+ message.send({
+  format: Format.create().addText('标题', { style: 'bold' }), Text('被加粗了'))
+ })
+
+  // ex 2
+ message.send({
+  format: Format.create().addText('这个').addText('标题').addText('没有变化')
+ })
+
+  // ex 3
+  message.send({
+  format: Format.create().addText(`// 我的代码块 \nconst Send = useSend(event)`, {
         style: 'block'
       })
-    )
-  )
-}
+ })
 ```
 
 ### Image
 
 ```ts title="src/response/**/*/res.ts"
-import { useMessage, Image } from 'alemonjs'
+import { useMessage, Format } from 'alemonjs'
 import jpgURL from '@src/assets/test.jpeg'
 import { readFileSync } from 'node:fs'
+
 export default event => {
   const [message] = useMessage(event)
-  const { url, file } = Image
+
   // file
-  message.send(format(file(jpgURL)))
+  message.send({
+    format: Format.create().addImageFile(jpgURL)
+  })
+
   // url
-  message.send(format(url('https://xxx.com/yyy.png')))
+  message.send({
+    format: Format.create().addImageURL('https://xxx.com/yyy.png')
+  })
+
   // buffer
   const img = readFileSync(jpgURL)
-  message.send(format(Image(img)))
+  message.send({
+    format: Format.create().addImage(img)
+  })
 }
 ```
 
 ### Mention
 
 ```ts title="response/**/*/res.ts"
-import { useMessage, Text, Mention } from 'alemonjs'
+import { useMessage, Text, Mention, Format } from 'alemonjs'
 export default event => {
   const [message] = useMessage(event)
   // 发送多种类型的消息
-  message.send(
-    format(
-      Text('Hello '),
-      Mention(event.UserId),
-      Text(', How are things going?')
-    )
-  )
-  // @ 所有人
-  message.send(format(Mention()))
+
+  message.send({
+    format: Format.create()
+      .addText('hello ')
+      .addMention(event.UserId)
+      .addText(', How are things going?')
+  })
+
+  // @ all
+  message.send({
+    format: Format.create().addMention()
+  })
+
   // @ channel
-  message.send(
-    format(
-      Mention(event.ChannelId, {
-        belong: 'channel'
-      })
-    )
-  )
+  message.send({
+    format: Format.create().addMention(event.ChannelId, {
+      belong: 'channel'
+    })
+  })
 }
 ```
 
 ### Button
 
 ```ts
-import { BT, useMessage } from 'alemonjs'
+import { useMessage, Format } from 'alemonjs'
+
 export default event => {
   const [message] = useMessage(event)
 
-  const { group, row } = BT
-
   // 一行多个
-  message.send(
-    format(group(row(BT('开始', '/开始游戏'), BT('结束', '/结束游戏'))))
-  )
+  message.send({
+    format: Format.create().addButtonGroup(
+      Format.create()
+        .createButtonGroup()
+        .addRow()
+        .addButton('开始', '/开始游戏')
+        .addButton('结束', '/结束游戏')
+    )
+  })
 
   // 多行多个
-  message.send(
-    format(
-      group(
-        row(BT('开始', '/开始游戏'), BT('结束', '/结束游戏')),
-        row(BT('退出', '/退出游戏'), BT('注销', '/注销账户'))
-      )
+  message.send({
+    format: Format.create().addButtonGroup(
+      Format.create()
+        .createButtonGroup()
+        .addRow()
+        .addButton('开始', '/开始游戏')
+        .addButton('结束', '/结束游戏')
+        .addRow()
+        .addButton('退出', '/退出游戏')
+        .addButton('注销', '/注销账户')
     )
-  )
+  })
 
   // 更多类型
-  message.send(
-    format(
-      group(
-        // link
-        row(
-          BT('访问文档', 'https://alemonjs.com/', {
-            type: 'link'
-          })
-        ),
-        row(
-          BT('是否同意', '/同意', {
-            type: 'call'
-          })
-        ),
-        // 自动发送 + 显示字频道list + 禁用提示
-        row(
-          BT('哈哈', '/哈哈', {
-            autoEnter: false,
-            showList: true,
-            toolTip: '不支持'
-          })
-        )
-      )
-    )
+  const format = Format.create()
+  format.addButtonGroup(
+    format
+      .createButtonGroup()
+      // link
+      .addRow()
+      .addButton('访问文档', 'https://alemonjs.com/', { type: 'link' })
+      // call
+      .addRow()
+      .addButton('是否同意', '/同意', { type: 'call' })
+      // 自动发送 + 显示子频道list + 禁用提示
+      .addRow()
+      .addButton('哈哈', '/哈哈', {
+        autoEnter: false,
+        showList: true,
+        toolTip: '不支持'
+      })
   )
-
-  const { template } = BT
-
-  // 使用申请好的模板（特定平台下使用）
-  message.send(format(template('template_id')))
-
-  // 向申请的模板注入参数
-  message.send(format(template('template_id')))
+  message.send({ format })
 }
 ```
 
 ### MarkDown
 
 ```ts
-import { MD, useMessage } from 'alemonjs'
+import { useMessage, Format } from 'alemonjs'
+
 export default event => {
   const [message] = useMessage(event)
 
-  const {
-    text,
-    title,
-    bold,
-    italicStar,
-    strikethrough,
-    link,
-    image,
-    list,
-    listItem,
-    blockquote,
-    divider,
-    newline
-  } = MD
-
-  message.send(
-    format(
-      MD(
-        // 标题
-        title('标题！！'),
-        // 副标题
-        subtitle('子标题'),
-        text('普通文本'),
-        // 加粗
-        bold('加粗'),
-        // 斜体
-        italic('斜体'),
-        // 星号斜体
-        italicStar('星号斜体'),
-        // 删除线
-        strikethrough('删除线'),
-        // 链接
-        link('链接', 'https://www.baidu.com'),
-        // 图片
-        image('https://www.baidu.com/img/bd_logo1.png', {
-          width: 100,
-          height: 100
-        }),
-        // 有序列表
-        list(
-          listItem(1, '有序列表'),
-          listItem(2, '有序列表'),
-          listItem(3, '有序列表'),
-          listItem(4, '有序列表')
-        ),
-        // 无序列表
-        list(
-          listItem('无序列表'),
-          listItem('无序列表'),
-          listItem('无序列表'),
-          listItem('无序列表'),
-          listItem('无序列表')
-        ),
-        // 块引用
-        blockquote('块引用'),
-        // 水平分割线
-        divider(),
-        // 换行
-        newline(),
-        // 换多行
-        newline(true)
-      )
+  const format = Format.create()
+  const md = format.createMarkdown()
+
+  md
+    // 标题
+    .addTitle('标题！！')
+    // 副标题
+    .addSubtitle('子标题')
+    // 普通文本
+    .addText('普通文本')
+    // 加粗
+    .addBold('加粗')
+    // 斜体
+    .addItalic('斜体')
+    // 星号斜体
+    .addItalicStar('星号斜体')
+    // 删除线
+    .addStrikethrough('删除线')
+    // 链接
+    .addLink('链接', 'https://www.baidu.com')
+    // 图片
+    .addImage('https://www.baidu.com/img/bd_logo1.png', {
+      width: 100,
+      height: 100
+    })
+    // 有序列表
+    .addList(
+      { index: 1, text: '有序列表' },
+      { index: 2, text: '有序列表' },
+      { index: 3, text: '有序列表' },
+      { index: 4, text: '有序列表' }
     )
-  )
-
-  const { template } = MD
-
-  // 向申请的模板注入参数
-  message.send(format(template('template_id', { title: '你好' })))
+    // 无序列表
+    .addList('无序列表', '无序列表', '无序列表', '无序列表', '无序列表')
+    // 块引用
+    .addBlockquote('块引用')
+    // 水平分割线
+    .addDivider()
+    // 换行
+    .addNewline()
+    // 换多行
+    .addNewline(true)
+
+  format.addMarkdown(md)
+
+  message.send({ format })
 }
 ```

docs/alemonjsDocs/basic/response.md

@@ -30,6 +30,7 @@ export default (e, next) => {
   })
   // 事件不匹配。或...
   if (!event.selects || !event.regular || !event.prefix || !event.exact) {
+    // 交给下一个进行处理
     next()
     return
   }

docs/alemonjsDocs/basic/route.md

@@ -7,6 +7,11 @@ sidebar_position: 2
 
 ## defineRouter
 
+- 确定优先级
+- 利用中间件，统一处理一类响应
+
+- 更早的确认是否执行，方便懒加载
+
 ```ts title="src/router.ts"
 import { lazy, defineRouter } from 'alemonjs'
 export default defineRouter([

docs/start.mdx

@@ -73,7 +73,7 @@ start({
 ```js title="lib/index.js"
 import {
   defineChildren,
-  defineRoute,
+  defineRouter,
   logger,
   useMessage,
   Format
@@ -89,7 +89,7 @@ const response = e => {
 }
 
 // 设置路由规则
-const responseRoute = defineRoute([
+const responseRouter = defineRouter([
   {
     regular: /^(\/|#)?hello$/,
     handler: () => response
@@ -100,7 +100,7 @@ export default defineChildren({
   // 注册内容
   register() {
     return {
-      responseRoute
+      responseRouter
     }
   },
   // 当注册完成时