From 508af00d9fb2eb68c8cfa9d48305d3f7da436e64 Mon Sep 17 00:00:00 2001
From: duorameng <2997944583@qq.com>
Date: Fri, 17 Apr 2026 08:44:44 +0800
Subject: [PATCH] chore: udpate docs

---
 docs/.vitepress/config.mts    |  3 +-
 docs/guide/examples/notify.md | 87 +++++++++++++++++++++++++++++++++++
 2 files changed, 89 insertions(+), 1 deletion(-)
 create mode 100644 docs/guide/examples/notify.md

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index cad1be3..cdde3f3 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -42,7 +42,8 @@ export default defineConfig({
                         text: '脚本示例',
                         link: '/guide/examples/',
                         items: [
-                            { text: '浏览器示例', link: '/guide/examples/browser' }
+                            { text: '浏览器示例', link: '/guide/examples/browser' },
+                            { text: '消息通知示例', link: '/guide/examples/notify' }
                         ]
                     }
                 ]
diff --git a/docs/guide/examples/notify.md b/docs/guide/examples/notify.md
new file mode 100644
index 0000000..bdb0a74
--- /dev/null
+++ b/docs/guide/examples/notify.md
@@ -0,0 +1,87 @@
+# 消息通知示例
+
+白虎面板提供了一个名为 `baihu` 的内建包，让您可以在脚本（Python 或 Node.js）中通过一行代码实现零配置推送。
+
+---
+
+## 准备工作
+
+在运行消息通知脚本之前，请确保已经完成了必要的初始化工作。
+
+### 1. 安装内建包
+在白虎面板的在线终端或通过任务执行以下命令，为您当前的所有语言环境安装 `baihu` 包：
+
+```bash
+baihu builtininstall
+```
+
+### 2. 配置环境变量
+前往 **「定时任务」** -> **「编辑任务」** -> **「环境变量」**，添加以下两个键值对：
+
+- `BHPKG_NOTIFY_TOKEN`: 进入「消息推送」->「脚本调用说明」标签即可找到。
+- `BHPKG_NOTIFY_CHANNEL`: 进入「消息推送」->「渠道列表」标签即可查看对应的 **ID**。
+
+> [!TIP]
+> 如果您更改了容器内部的服务端口（默认 8052），还需要额外添加 `BHPKG_NOTIFY_URL` 变量。详情请参考 [消息中心说明](../notify.md)。
+
+---
+
+## 代码示例
+
+### Python (同步)
+
+```python
+import baihu
+
+# 内建通知测试示例 (Python)
+def main():
+    print("正在尝试发送 Python 内建通知...")
+    try:
+        # 调用内建 notify 函数
+        # 内部会自动使用环境变量进行鉴权和投递
+        response = baihu.notify(
+            title="Python 任务提醒",
+            text="这是一条来自 Python 示例脚本的通知消息。调用非常简单！"
+        )
+        print(f"服务器响应: {response}")
+            
+    except Exception as e:
+        print(f"发送过程发生异常: {e}")
+
+if __name__ == "__main__":
+    main()
+```
+
+### Node.js (异步)
+
+```javascript
+const baihu = require('baihu');
+
+/**
+ * 内建通知测试示例 (Node.js)
+ */
+console.log("正在尝试发送 Node.js 内建通知...");
+
+try {
+    // 简单的一行代码即可完成推送
+    baihu.notify(
+        "Node.js 任务提醒", 
+        "这是一条来自 Node.js 示例脚本的通知消息。无需配置 API 地址或 Token。"
+    );
+    
+    console.log("发送请求已提交。");
+    console.log("提示：内建包采用异步非阻塞发送，不会干扰主逻辑执行。");
+    
+} catch (e) {
+    console.error(`通知失败: ${e.message}`);
+}
+```
+
+---
+
+## 运行与验证
+
+1. **保存脚本**：将上述代码保存为 `.py` 或 `.js` 文件。
+2. **创建任务**：在面板中创建新任务并关联该文件。
+3. **注入配置**：在任务配置中填入 `BHPKG_NOTIFY_TOKEN` 等变量。
+4. **立即运行**：点击「运行」按钮，检查对应的消息渠道是否收到了推送消息。