perk-pushplus-sdk 1.2.2__tar.gz → 1.2.4__tar.gz

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: perk-pushplus-sdk
-Version: 1.2.2
+Version: 1.2.4
 Summary: pushplus(推送加) 官方接口的 Python SDK，覆盖消息发送接口与全部开放接口。
 Author: perk-net
 License: Apache-2.0
@@ -35,7 +35,7 @@ Requires-Dist: responses>=0.23; extra == "dev"
 [pushplus(推送加)](https://www.pushplus.plus) 官方接口的 Python SDK，覆盖 **消息接口** 与 **全部开放接口**。
 
 - **消息接口**（`/send`、`/batchSend`）：单渠道 + 多渠道发送，含 Builder API。
-- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格。
+- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、新消息 ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **回调解析**：`message_complate`、`add_topic_user`、`add_friend` 三类回调统一解析。
@@ -168,6 +168,17 @@ topic_blacklist = client.topic_user.blacklist_list(TopicUserListQuery.of(1, 20,
 # webhook 渠道
 webhooks = client.webhook.list()
 
+# 新消息 ClawBot：绑定 Channel API Key 后，channel 传 cmcc（仅中国移动）
+client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+cmcc_info = client.cmcc.info()  # cmcc_info.bound == 1 表示已绑定
+client.cmcc.send_test()
+client.send(SendRequest(
+    title="服务告警",
+    content="订单服务响应超时",
+    channel=Channel.CMCC,
+    template=Template.TXT,
+))
+
 # QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
 from perk_pushplus import QqBotSaveRequest
 link = client.qq_bot.get_bind_link()   # link.url 生成二维码，或私聊发送 link.bindCode
@@ -188,6 +199,19 @@ client.setting.change_is_send(1)  # 启用发送
 # 预处理（会员）
 client.pre.test(...)
 
+# 消息规则（会员）
+from perk_pushplus import ForwardLogListQuery, ForwardRuleSaveRequest, ForwardVariable
+client.forward_rule.save_setting(1)  # 开启，未命中时仍按默认方式推送
+client.forward_rule.add(ForwardRuleSaveRequest(
+    ruleName="阿里云监控多渠道",
+    tokenId=-1,
+    sourceType=1,
+    titleTemplate="{{alertName}}",
+    variables=[ForwardVariable(varName="alertName", sourceType=3, extractType=1, extractKey="alertName")],
+))
+rules = client.forward_rule.list()
+logs = client.forward_log.list(ForwardLogListQuery.of(1, 20, match_result=1))
+
 # 图片服务（一行上传到 PushPlus 图床）
 r = client.image.upload_file("/tmp/logo.png")
 print(r.url)  # 可访问的图片地址

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/README.md

@@ -3,7 +3,7 @@
 [pushplus(推送加)](https://www.pushplus.plus) 官方接口的 Python SDK，覆盖 **消息接口** 与 **全部开放接口**。
 
 - **消息接口**（`/send`、`/batchSend`）：单渠道 + 多渠道发送，含 Builder API。
-- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格。
+- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、新消息 ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **回调解析**：`message_complate`、`add_topic_user`、`add_friend` 三类回调统一解析。
@@ -136,6 +136,17 @@ topic_blacklist = client.topic_user.blacklist_list(TopicUserListQuery.of(1, 20,
 # webhook 渠道
 webhooks = client.webhook.list()
 
+# 新消息 ClawBot：绑定 Channel API Key 后，channel 传 cmcc（仅中国移动）
+client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+cmcc_info = client.cmcc.info()  # cmcc_info.bound == 1 表示已绑定
+client.cmcc.send_test()
+client.send(SendRequest(
+    title="服务告警",
+    content="订单服务响应超时",
+    channel=Channel.CMCC,
+    template=Template.TXT,
+))
+
 # QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
 from perk_pushplus import QqBotSaveRequest
 link = client.qq_bot.get_bind_link()   # link.url 生成二维码，或私聊发送 link.bindCode
@@ -156,6 +167,19 @@ client.setting.change_is_send(1)  # 启用发送
 # 预处理（会员）
 client.pre.test(...)
 
+# 消息规则（会员）
+from perk_pushplus import ForwardLogListQuery, ForwardRuleSaveRequest, ForwardVariable
+client.forward_rule.save_setting(1)  # 开启，未命中时仍按默认方式推送
+client.forward_rule.add(ForwardRuleSaveRequest(
+    ruleName="阿里云监控多渠道",
+    tokenId=-1,
+    sourceType=1,
+    titleTemplate="{{alertName}}",
+    variables=[ForwardVariable(varName="alertName", sourceType=3, extractType=1, extractKey="alertName")],
+))
+rules = client.forward_rule.list()
+logs = client.forward_log.list(ForwardLogListQuery.of(1, 20, match_result=1))
+
 # 图片服务（一行上传到 PushPlus 图床）
 r = client.image.upload_file("/tmp/logo.png")
 print(r.url)  # 可访问的图片地址

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "perk-pushplus-sdk"
-version = "1.2.2"
+version = "1.2.4"
 description = "pushplus(推送加) 官方接口的 Python SDK，覆盖消息发送接口与全部开放接口。"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.8"

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/__init__.py

@@ -29,6 +29,13 @@ from .enums import (
     Channel,
     ErrorCode,
     FormStatus,
+    ForwardConditionOperator,
+    ForwardExtractType,
+    ForwardMatchResult,
+    ForwardMessageType,
+    ForwardMode,
+    ForwardSourceType,
+    ForwardVarSourceType,
     SendStatus,
     ShareLogin,
     SharePerm,
@@ -47,6 +54,8 @@ from .models import (
     ClawBotInfo,
     ClawBotMessage,
     ClawBotQrCode,
+    CmccBindRequest,
+    CmccInfo,
     CpItem,
     DocContent,
     DocListItem,
@@ -63,6 +72,19 @@ from .models import (
     FormSaveRequest,
     FormSettings,
     FormTheme,
+    ForwardCondition,
+    ForwardConditionItem,
+    ForwardLogDetail,
+    ForwardLogItem,
+    ForwardLogListQuery,
+    ForwardRuleDetail,
+    ForwardRuleItem,
+    ForwardRuleSaveRequest,
+    ForwardRuleSetting,
+    ForwardRuleTestRequest,
+    ForwardRuleTestResult,
+    ForwardTarget,
+    ForwardVariable,
     FriendItem,
     FriendQrCode,
     FriendBlacklistItem,
@@ -114,7 +136,7 @@ from .models import (
 )
 from .rate_limit import RateLimitGuard
 
-__version__ = "1.2.2"
+__version__ = "1.2.4"
 
 __all__ = [
     "__version__",
@@ -139,6 +161,13 @@ __all__ = [
     "FormStatus",
     "SharePerm",
     "ShareLogin",
+    "ForwardMode",
+    "ForwardSourceType",
+    "ForwardVarSourceType",
+    "ForwardExtractType",
+    "ForwardMatchResult",
+    "ForwardConditionOperator",
+    "ForwardMessageType",
     "ApiResponse",
     "PageQuery",
     "PageResult",
@@ -181,6 +210,8 @@ __all__ = [
     "ClawBotQrCode",
     "ClawBotInfo",
     "ClawBotMessage",
+    "CmccBindRequest",
+    "CmccInfo",
     "QqBotBindLink",
     "QqBotInfo",
     "QqBotBindInfo",
@@ -212,4 +243,17 @@ __all__ = [
     "DocContent",
     "ExcelVo",
     "ExcelContent",
+    "ForwardConditionItem",
+    "ForwardCondition",
+    "ForwardVariable",
+    "ForwardTarget",
+    "ForwardRuleItem",
+    "ForwardRuleDetail",
+    "ForwardRuleSaveRequest",
+    "ForwardRuleTestRequest",
+    "ForwardRuleTestResult",
+    "ForwardRuleSetting",
+    "ForwardLogListQuery",
+    "ForwardLogItem",
+    "ForwardLogDetail",
 ]

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/api/__init__.py

@@ -3,11 +3,14 @@ from .access_key import AccessKeyApi
 from .base import AbstractApi, OpenAbstractApi
 from .channel import ChannelApi
 from .clawbot import ClawBotApi
+from .cmcc import CmccApi
 from .friend import FriendApi
 from .image import ImageApi
 from .form import FormApi
 from .doc import DocApi
 from .excel import ExcelApi
+from .forward_log import ForwardLogApi
+from .forward_rule import ForwardRuleApi
 from .message import MessageApi
 from .message_token import MessageTokenApi
 from .open_message import OpenMessageApi
@@ -33,6 +36,7 @@ __all__ = [
     "WebhookApi",
     "ChannelApi",
     "ClawBotApi",
+    "CmccApi",
     "QqBotApi",
     "SettingApi",
     "PreApi",
@@ -40,4 +44,6 @@ __all__ = [
     "FormApi",
     "DocApi",
     "ExcelApi",
+    "ForwardRuleApi",
+    "ForwardLogApi",
 ]

perk_pushplus_sdk-1.2.4/src/perk_pushplus/api/cmcc.py

@@ -0,0 +1,38 @@
+"""开放接口 - 新消息 ClawBot（文档「九. 新消息ClawBot接口」）。
+
+需先在手机 5G 消息的「新消息ClawBot」应用号中获取 Channel API Key，再调用绑定接口。
+发送消息时 channel 传 ``cmcc``。仅支持中国移动用户。
+"""
+from __future__ import annotations
+
+from ..models import CmccBindRequest, CmccInfo
+from .base import OpenAbstractApi
+
+
+class CmccApi(OpenAbstractApi):
+    """新消息 ClawBot 渠道相关接口。"""
+
+    def bind(self, api_key: str) -> None:
+        """绑定新消息 ClawBot。``api_key`` 必须以 ``ak_`` 或 ``app_`` 开头。"""
+
+        self.execute_open(
+            "POST", "/api/open/cmcc/bind", CmccBindRequest(apiKey=api_key), None
+        )
+
+    def info(self) -> CmccInfo:
+        """查询绑定状态。"""
+
+        return self.execute_open("GET", "/api/open/cmcc/info", None, CmccInfo)
+
+    def unbind(self) -> None:
+        """解绑新消息 ClawBot。"""
+
+        self.execute_open("GET", "/api/open/cmcc/unbind", None, None)
+
+    def send_test(self) -> None:
+        """发送测试消息。未绑定会返回「未绑定新消息ClawBot」。"""
+
+        self.execute_open("GET", "/api/open/cmcc/test", None, None)
+
+
+__all__ = ["CmccApi"]

perk_pushplus_sdk-1.2.4/src/perk_pushplus/api/forward_log.py

@@ -0,0 +1,25 @@
+"""开放接口 - 消息规则触发记录（文档「十四. 消息规则接口」第 10、11 节）。"""
+from __future__ import annotations
+
+from typing import Optional
+
+from ..models import ForwardLogDetail, ForwardLogItem, ForwardLogListQuery, PageResult
+from .base import OpenAbstractApi
+
+
+class ForwardLogApi(OpenAbstractApi):
+    """消息规则触发记录。"""
+
+    def list(self, query: Optional[ForwardLogListQuery] = None) -> PageResult[ForwardLogItem]:
+        body = query if query is not None else ForwardLogListQuery()
+        result = self.execute_open(
+            "POST", "/api/open/forwardLog/list", body, PageResult[ForwardLogItem]
+        )
+        return result or PageResult(list=[])
+
+    def detail(self, log_id: int) -> ForwardLogDetail:
+        path = self.append_query("/api/open/forwardLog/detail", {"logId": int(log_id)})
+        return self.execute_open("GET", path, None, ForwardLogDetail)
+
+
+__all__ = ["ForwardLogApi"]

perk_pushplus_sdk-1.2.4/src/perk_pushplus/api/forward_rule.py

@@ -0,0 +1,69 @@
+"""开放接口 - 消息规则（文档「十四. 消息规则接口」）。需开通会员后才能开启。"""
+from __future__ import annotations
+
+from typing import Optional
+
+from ..models import (
+    ForwardRuleDetail,
+    ForwardRuleItem,
+    ForwardRuleSaveRequest,
+    ForwardRuleSetting,
+    ForwardRuleTestRequest,
+    ForwardRuleTestResult,
+    PageQuery,
+    PageResult,
+)
+from .base import OpenAbstractApi
+
+
+class ForwardRuleApi(OpenAbstractApi):
+    """消息规则（仅会员）。"""
+
+    def list(self, query: Optional[PageQuery] = None) -> PageResult[ForwardRuleItem]:
+        body = query if query is not None else PageQuery()
+        result = self.execute_open(
+            "POST", "/api/open/forwardRule/list", body, PageResult[ForwardRuleItem]
+        )
+        return result or PageResult(list=[])
+
+    def detail(self, rule_id: int) -> ForwardRuleDetail:
+        path = self.append_query("/api/open/forwardRule/detail", {"ruleId": int(rule_id)})
+        return self.execute_open("GET", path, None, ForwardRuleDetail)
+
+    def add(self, req: ForwardRuleSaveRequest) -> None:
+        self.execute_open("POST", "/api/open/forwardRule/add", req, None)
+
+    def edit(self, req: ForwardRuleSaveRequest) -> None:
+        """修改消息规则；会整体覆盖模板变量和发送目标。"""
+
+        self.execute_open("POST", "/api/open/forwardRule/edit", req, None)
+
+    def delete(self, rule_id: int) -> None:
+        path = self.append_query("/api/open/forwardRule/delete", {"ruleId": int(rule_id)})
+        self.execute_open("DELETE", path, None, None)
+
+    def change_status(self, rule_id: int, status: int) -> None:
+        """启用 / 停用消息规则：1 启用，0 停用。"""
+
+        path = self.append_query(
+            "/api/open/forwardRule/changeStatus",
+            {"ruleId": int(rule_id), "status": int(status)},
+        )
+        self.execute_open("GET", path, None, None)
+
+    def test(self, req: ForwardRuleTestRequest) -> ForwardRuleTestResult:
+        """用模拟请求测试规则，不会真正发送消息。"""
+
+        return self.execute_open("POST", "/api/open/forwardRule/test", req, ForwardRuleTestResult)
+
+    def get_setting(self) -> ForwardRuleSetting:
+        return self.execute_open("GET", "/api/open/forwardRule/setting", None, ForwardRuleSetting)
+
+    def save_setting(self, mode: int) -> None:
+        """设置总开关：0 关闭，1 开启且未命中仍推送，2 开启且未命中不推送。"""
+
+        path = self.append_query("/api/open/forwardRule/setting", {"mode": int(mode)})
+        self.execute_open("GET", path, None, None)
+
+
+__all__ = ["ForwardRuleApi"]

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/client.py

@@ -9,6 +9,7 @@ from .api import (
     AccessKeyApi,
     ChannelApi,
     ClawBotApi,
+    CmccApi,
     FriendApi,
     ImageApi,
     MessageApi,
@@ -24,6 +25,8 @@ from .api import (
     FormApi,
     DocApi,
     ExcelApi,
+    ForwardLogApi,
+    ForwardRuleApi,
 )
 from .config import PushPlusConfig
 from .exceptions import PushPlusError
@@ -77,6 +80,7 @@ class PushPlusClient:
         self.webhook = WebhookApi(config, self.http_requester, self.access_key_manager)
         self.channel = ChannelApi(config, self.http_requester, self.access_key_manager)
         self.claw_bot = ClawBotApi(config, self.http_requester, self.access_key_manager)
+        self.cmcc = CmccApi(config, self.http_requester, self.access_key_manager)
         self.qq_bot = QqBotApi(config, self.http_requester, self.access_key_manager)
         self.setting = SettingApi(config, self.http_requester, self.access_key_manager)
         self.pre = PreApi(config, self.http_requester, self.access_key_manager)
@@ -84,6 +88,8 @@ class PushPlusClient:
         self.form = FormApi(config, self.http_requester, self.access_key_manager)
         self.doc = DocApi(config, self.http_requester, self.access_key_manager)
         self.excel = ExcelApi(config, self.http_requester, self.access_key_manager)
+        self.forward_rule = ForwardRuleApi(config, self.http_requester, self.access_key_manager)
+        self.forward_log = ForwardLogApi(config, self.http_requester, self.access_key_manager)
 
     @classmethod
     def of(cls, config: PushPlusConfig) -> "PushPlusClient":

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/config.py

@@ -62,7 +62,7 @@ class PushPlusConfig:
     可显式设置 ``2 * 86400`` 等更长值来减少无用试探。
     """
 
-    user_agent: str = "perk-pushplus-python-sdk/1.2.1"
+    user_agent: str = "perk-pushplus-python-sdk/1.2.4"
     """HTTP User-Agent 头。"""
 
     extra_headers: dict = field(default_factory=dict)

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/enums.py

@@ -42,6 +42,8 @@ class Channel(_StrCodeEnum):
     """App 渠道（安卓/鸿蒙/iOS）。"""
     CLAWBOT = "clawbot"
     """微信 ClawBot。"""
+    CMCC = "cmcc"
+    """新消息 ClawBot（中国移动 5G 消息）；仅支持中国移动用户。"""
     QQ = "qq"
     """QQ 机器人；不带 option 发给自己，option 填配置编码则发到对应 QQ 群。"""
 
@@ -257,6 +259,142 @@ class ShareLogin(_IntCodeEnum):
         return self.value
 
 
+class ForwardMode(_IntCodeEnum):
+    """消息规则总开关。0-关闭，1-开启且未命中仍推送，2-开启且未命中不推送。"""
+
+    OFF = 0
+    ON_FALLBACK = 1
+    ON_STRICT = 2
+
+    @property
+    def code(self) -> int:
+        return self.value
+
+    @property
+    def description(self) -> str:
+        return _FORWARD_MODE_DESCRIPTIONS[self]
+
+
+_FORWARD_MODE_DESCRIPTIONS = {
+    ForwardMode.OFF: "关闭（推送与原来一致）",
+    ForwardMode.ON_FALLBACK: "开启，未命中时仍按默认方式推送",
+    ForwardMode.ON_STRICT: "开启，未命中时不推送",
+}
+
+
+class ForwardSourceType(_IntCodeEnum):
+    """消息规则触发来源。0-全部，1-消息接口，2-邮件。"""
+
+    ALL = 0
+    API = 1
+    MAIL = 2
+
+    @property
+    def code(self) -> int:
+        return self.value
+
+    @property
+    def description(self) -> str:
+        return _FORWARD_SOURCE_TYPE_DESCRIPTIONS[self]
+
+
+_FORWARD_SOURCE_TYPE_DESCRIPTIONS = {
+    ForwardSourceType.ALL: "全部",
+    ForwardSourceType.API: "消息接口",
+    ForwardSourceType.MAIL: "邮件",
+}
+
+
+class ForwardVarSourceType(_IntCodeEnum):
+    """模板变量来源。1-请求头，2-Query参数，3-请求体，4-URL路径，5-主题（邮件）。"""
+
+    HEADER = 1
+    QUERY = 2
+    BODY = 3
+    PATH = 4
+    SUBJECT = 5
+
+    @property
+    def code(self) -> int:
+        return self.value
+
+
+class ForwardExtractType(_IntCodeEnum):
+    """模板变量提取方式。1-序列化数据，2-正则表达式，3-JSONPath，4-原始全文。"""
+
+    SERIALIZED = 1
+    REGEX = 2
+    JSON_PATH = 3
+    RAW = 4
+
+    @property
+    def code(self) -> int:
+        return self.value
+
+
+class ForwardMatchResult(_IntCodeEnum):
+    """触发记录匹配结果。0-条件不满足，1-已转发，2-频率限制，3-不在触发时间段，4-执行异常。"""
+
+    NOT_MATCHED = 0
+    FORWARDED = 1
+    RATE_LIMITED = 2
+    OUT_OF_TIME = 3
+    ERROR = 4
+
+    @property
+    def code(self) -> int:
+        return self.value
+
+    @property
+    def description(self) -> str:
+        return _FORWARD_MATCH_RESULT_DESCRIPTIONS[self]
+
+
+_FORWARD_MATCH_RESULT_DESCRIPTIONS = {
+    ForwardMatchResult.NOT_MATCHED: "条件不满足",
+    ForwardMatchResult.FORWARDED: "已转发",
+    ForwardMatchResult.RATE_LIMITED: "频率限制",
+    ForwardMatchResult.OUT_OF_TIME: "不在触发时间段",
+    ForwardMatchResult.ERROR: "执行异常",
+}
+
+
+class ForwardConditionOperator(_StrCodeEnum):
+    """图形化触发条件运算符。"""
+
+    EQ = "eq"
+    NE = "ne"
+    CONTAINS = "contains"
+    NOT_CONTAINS = "notContains"
+    STARTS_WITH = "startsWith"
+    ENDS_WITH = "endsWith"
+    REGEX = "regex"
+    GT = "gt"
+    GTE = "gte"
+    LT = "lt"
+    LTE = "lte"
+    IN = "in"
+    NOT_IN = "notIn"
+    EMPTY = "empty"
+    NOT_EMPTY = "notEmpty"
+
+    @property
+    def code(self) -> str:
+        return self.value
+
+
+class ForwardMessageType(_StrCodeEnum):
+    """消息规则发送目标的消息类型。也支持写成 ``{{变量名}}``。"""
+
+    ONE = "one"
+    TOPIC = "topic"
+    FRIEND = "friend"
+
+    @property
+    def code(self) -> str:
+        return self.value
+
+
 __all__ = [
     "Channel",
     "Template",
@@ -267,4 +405,11 @@ __all__ = [
     "FormStatus",
     "SharePerm",
     "ShareLogin",
+    "ForwardMode",
+    "ForwardSourceType",
+    "ForwardVarSourceType",
+    "ForwardExtractType",
+    "ForwardMatchResult",
+    "ForwardConditionOperator",
+    "ForwardMessageType",
 ]

{perk_pushplus_sdk-1.2.2 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/models/__init__.py

@@ -36,6 +36,7 @@ from .open_friend import FriendBlacklistItem, FriendItem, FriendQrCode
 from .open_webhook import WebhookItem, WebhookSaveRequest
 from .open_channel import CpItem, MailDetail, MailItem, MpItem
 from .open_clawbot import ClawBotInfo, ClawBotMessage, ClawBotQrCode
+from .open_cmcc import CmccBindRequest, CmccInfo
 from .open_qqbot import (
     QqBotBindInfo,
     QqBotBindLink,
@@ -59,6 +60,21 @@ from .open_form import (
     FormTheme,
 )
 from .open_doc import DocContent, DocListItem, DocListQuery, DocVo, ExcelContent, ExcelVo
+from .open_forward import (
+    ForwardCondition,
+    ForwardConditionItem,
+    ForwardLogDetail,
+    ForwardLogItem,
+    ForwardLogListQuery,
+    ForwardRuleDetail,
+    ForwardRuleItem,
+    ForwardRuleSaveRequest,
+    ForwardRuleSetting,
+    ForwardRuleTestRequest,
+    ForwardRuleTestResult,
+    ForwardTarget,
+    ForwardVariable,
+)
 
 __all__ = [
     "ApiResponse",
@@ -105,6 +121,8 @@ __all__ = [
     "ClawBotQrCode",
     "ClawBotInfo",
     "ClawBotMessage",
+    "CmccBindRequest",
+    "CmccInfo",
     "QqBotBindLink",
     "QqBotInfo",
     "QqBotBindInfo",
@@ -136,4 +154,17 @@ __all__ = [
     "DocContent",
     "ExcelVo",
     "ExcelContent",
+    "ForwardConditionItem",
+    "ForwardCondition",
+    "ForwardVariable",
+    "ForwardTarget",
+    "ForwardRuleItem",
+    "ForwardRuleDetail",
+    "ForwardRuleSaveRequest",
+    "ForwardRuleTestRequest",
+    "ForwardRuleTestResult",
+    "ForwardRuleSetting",
+    "ForwardLogListQuery",
+    "ForwardLogItem",
+    "ForwardLogDetail",
 ]

perk_pushplus_sdk-1.2.4/src/perk_pushplus/models/open_cmcc.py

@@ -0,0 +1,28 @@
+"""开放接口 - 新消息 ClawBot 模型。"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class CmccBindRequest:
+    """新消息 ClawBot 绑定请求。"""
+
+    apiKey: str
+    """中国移动新消息 Channel API Key，必须以 ak_ 或 app_ 开头。"""
+
+
+@dataclass
+class CmccInfo:
+    """新消息 ClawBot 绑定状态。"""
+
+    bound: Optional[int] = None
+    """是否已绑定；0-未绑定，1-已绑定。"""
+    apiKeyMasked: Optional[str] = None
+    """脱敏后的 API Key。"""
+    createTime: Optional[str] = None
+    """绑定时间。"""
+
+
+__all__ = ["CmccBindRequest", "CmccInfo"]