📝 update doc

2025-07-27 16:21:28 +00:00 · 2020-12-31 17:58:09 +08:00
parent 938b5bf275
commit 49201f5346
28 changed files with 552 additions and 1116 deletions
--- a/docs/api/adapters/ding.md
+++ b/docs/api/adapters/ding.md
@ -5,6 +5,12 @@ sidebarDepth: 0

 # NoneBot.adapters.ding 模块

+## 钉钉群机器人 协议适配
+
+协议详情请看: [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
+
+# NoneBot.adapters.ding.exception 模块
+

 ## _exception_ `DingAdapterException`

@ -38,11 +44,6 @@ sidebarDepth: 0



-## _exception_ `ApiNotAvailable`
-
-基类：[`nonebot.exception.ApiNotAvailable`](../exception.md#nonebot.exception.ApiNotAvailable), `nonebot.adapters.ding.exception.DingAdapterException`
-
-
 ## _exception_ `NetworkError`

 基类：[`nonebot.exception.NetworkError`](../exception.md#nonebot.exception.NetworkError), `nonebot.adapters.ding.exception.DingAdapterException`
@ -71,6 +72,8 @@ sidebarDepth: 0
    发消息的 session 已经过期。


+# NoneBot.adapters.ding.bot 模块
+

 ## _class_ `Bot`

@ -94,22 +97,6 @@ sidebarDepth: 0



-### _async_ `handle_message(message)`
-
-
-* **说明**
-
-    处理上报消息的函数，转换为 `Event` 事件后调用 `nonebot.message.handle_event` 进一步处理事件。
-
-
-
-* **参数**
-
-    
-    * `message: dict`: 收到的上报消息
-
-
-
 ### _async_ `call_api(api, event=None, **data)`


@ -190,295 +177,7 @@ sidebarDepth: 0
    * `ActionFailed`: API 调用失败


-
-## _class_ `Event`
-
-基类：[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
-
-钉钉 协议 Event 适配。各事件字段参考 [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
-
-
-### `get_type()`
-
-
-* **说明**
-
-    获取事件类型的方法，类型通常为 NoneBot 内置的四种类型。
-
-
-
-* **返回**
-
-    
-    * `Literal["message", "notice", "request", "meta_event"]`
-
-
-
-### `get_event_name()`
-
-
-* **说明**
-
-    获取事件名称的方法。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_event_description()`
-
-
-* **说明**
-
-    获取事件描述的方法，通常为事件具体内容。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_message()`
-
-
-* **说明**
-
-    获取事件消息内容的方法。
-
-
-
-* **返回**
-
-    
-    * `Message`
-
-
-
-### `get_plaintext()`
-
-
-* **说明**
-
-    获取消息纯文本的方法，通常不需要修改，默认通过 `get_message().extract_plain_text` 获取。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_user_id()`
-
-
-* **说明**
-
-    获取事件主体 id 的方法，通常是用户 id 。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_session_id()`
-
-
-* **说明**
-
-    获取会话 id 的方法，用于判断当前事件属于哪一个会话，通常是用户 id、群组 id 组合。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `is_tome()`
-
-
-* **说明**
-
-    获取事件是否与机器人有关的方法。
-
-
-
-* **返回**
-
-    
-    * `bool`
-
-
-
-## _class_ `ConversationType`
-
-基类：`str`, `enum.Enum`
-
-An enumeration.
-
-
-### `_member_type_`
-
-`builtins.str` 的别名
-
-
-## _class_ `MessageEvent`
-
-基类：`nonebot.adapters.ding.event.Event`
-
-
-### `get_type()`
-
-
-* **说明**
-
-    获取事件类型的方法，类型通常为 NoneBot 内置的四种类型。
-
-
-
-* **返回**
-
-    
-    * `Literal["message", "notice", "request", "meta_event"]`
-
-
-
-### `get_event_name()`
-
-
-* **说明**
-
-    获取事件名称的方法。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_event_description()`
-
-
-* **说明**
-
-    获取事件描述的方法，通常为事件具体内容。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_message()`
-
-
-* **说明**
-
-    获取事件消息内容的方法。
-
-
-
-* **返回**
-
-    
-    * `Message`
-
-
-
-### `get_plaintext()`
-
-
-* **说明**
-
-    获取消息纯文本的方法，通常不需要修改，默认通过 `get_message().extract_plain_text` 获取。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_user_id()`
-
-
-* **说明**
-
-    获取事件主体 id 的方法，通常是用户 id 。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-### `get_session_id()`
-
-
-* **说明**
-
-    获取会话 id 的方法，用于判断当前事件属于哪一个会话，通常是用户 id、群组 id 组合。
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-## _class_ `PrivateMessageEvent`
-
-基类：`nonebot.adapters.ding.event.MessageEvent`
-
-
-## _class_ `GroupMessageEvent`
-
-基类：`nonebot.adapters.ding.event.MessageEvent`
-
-
-### `is_tome()`
-
-
-* **说明**
-
-    获取事件是否与机器人有关的方法。
-
-
-
-* **返回**
-
-    
-    * `bool`
-
+# NoneBot.adapters.ding.message 模块


 ## _class_ `MessageSegment`
@ -488,13 +187,45 @@ An enumeration.
 钉钉 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。


+### _static_ `atAll()`
+
+@全体
+
+
+### _static_ `atMobiles(*mobileNumber)`
+
+@指定手机号人员
+
+
+### _static_ `text(text)`
+
+发送 `text` 类型消息
+
+
+### _static_ `image(picURL)`
+
+发送 `image` 类型消息
+
+
 ### _static_ `extension(dict_)`

 "标记 text 文本的 extension 属性，需要与 text 消息段相加。


+### _static_ `markdown(title, text)`
+
+发送 `markdown` 类型消息
+
+
+### _static_ `actionCardSingleBtn(title, text, singleTitle, singleURL)`
+
+发送 `actionCardSingleBtn` 类型消息
+
+
 ### _static_ `actionCardMultiBtns(title, text, btns, hideAvatar=False, btnOrientation='1')`

+发送 `actionCardMultiBtn` 类型消息
+

 * **参数**

@ -508,6 +239,8 @@ An enumeration.

 ### _static_ `feedCard(links)`

+发送 `feedCard` 类型消息
+

 * **参数**

@ -521,3 +254,40 @@ An enumeration.
 基类：[`nonebot.adapters.Message`](README.md#nonebot.adapters.Message)

 钉钉 协议 Message 适配。
+
+# NoneBot.adapters.ding.event 模块
+
+
+## _class_ `Event`
+
+基类：[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
+
+钉钉协议事件。各事件字段参考 [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
+
+
+## _class_ `ConversationType`
+
+基类：`str`, `enum.Enum`
+
+An enumeration.
+
+
+## _class_ `MessageEvent`
+
+基类：`nonebot.adapters.ding.event.Event`
+
+消息事件
+
+
+## _class_ `PrivateMessageEvent`
+
+基类：`nonebot.adapters.ding.event.MessageEvent`
+
+私聊消息事件
+
+
+## _class_ `GroupMessageEvent`
+
+基类：`nonebot.adapters.ding.event.MessageEvent`
+
+群消息事件