Initial commit: TaskPool React panel

- React frontend with route-level code splitting
- Backend rebranded from Baihu to TaskPool
- DB brand migration script and local compatibility

example/builtin/test_env.js

@@ -0,0 +1,58 @@
+const taskpool = require('taskpool');
+
+/**
+ * 内建工具环境变量管理测试示例 (Node.js)
+ * 
+ * 使用说明：
+ * 1. 确保已在该 Node.js 环境下安装过内建包。
+ * 2. 运行时系统需要注入有效的 OpenAPI 凭证 (BHPKG_OPENAPI_TOKEN 或 OPENAPI_TOKEN)。
+ */
+
+async function main() {
+    console.log("====== 开始运行 Node.js 环境变量管理示例 ======");
+
+    try {
+        // 获取全部环境变量
+        const envs = await taskpool.getEnvs();
+        console.log(`当前共有 ${envs.length} 个环境变量`);
+
+        // 新增一个临时环境变量
+        const newEnvName = "BHPKG_TEST_KEY_JS";
+        const newEnvVal = "HelloTaskPoolJS";
+        console.log(`正在创建环境变量: ${newEnvName}...`);
+        const createdEnv = await taskpool.addEnv(
+            newEnvName,
+            newEnvVal,
+            "Node.js SDK 测试自动创建"
+        );
+        console.log(`创建成功: ID=${createdEnv.id}, Name=${createdEnv.name}`);
+
+        // 查询该环境变量
+        const checkedEnv = await taskpool.getEnv(newEnvName);
+        if (checkedEnv) {
+            console.log(`成功查询到变量: ${checkedEnv.name} = ${checkedEnv.value}`);
+
+            // 修改该环境变量的值
+            const updatedVal = "HelloTaskPoolJS_Updated";
+            console.log(`正在修改环境变量的值为: ${updatedVal}...`);
+            const updatedEnv = await taskpool.updateEnv(
+                checkedEnv.id,
+                newEnvName,
+                updatedVal,
+                "Node.js SDK 测试自动更新"
+            );
+            console.log(`更新成功: Value=${updatedEnv.value}`);
+
+            // 删除该临时环境变量
+            console.log(`正在删除临时环境变量: ID=${checkedEnv.id}...`);
+            await taskpool.deleteEnv(checkedEnv.id);
+            console.log("删除成功！");
+        }
+
+    } catch (e) {
+        console.error(`环境变量操作失败: ${e.message}`);
+        console.log("提示: 请确保在面板任务设置中正确注入了 OpenAPI Token。");
+    }
+}
+
+main();

example/builtin/test_env.py

@@ -0,0 +1,55 @@
+import taskpool
+
+# 内建工具环境变量管理测试示例 (Python)
+# 
+# 前提条件：
+# 1. 已经在环境中安装了 taskpool 包（例如通过 `taskpool builtininstall`）
+# 2. 环境中已注入有效环境变量：
+#    - BHPKG_OPENAPI_TOKEN (必填，用于管理接口鉴权)
+
+def main():
+    print("====== 开始运行 Python 环境变量管理示例 ======")
+
+    try:
+        # 获取全部环境变量
+        envs = taskpool.get_envs()
+        print(f"当前共有 {len(envs)} 个环境变量")
+        
+        # 新增一个临时环境变量
+        new_env_name = "BHPKG_TEST_KEY"
+        new_env_val = "HelloTaskPool"
+        print(f"正在创建环境变量: {new_env_name}...")
+        created_env = taskpool.add_env(
+            name=new_env_name,
+            value=new_env_val,
+            remark="Python SDK 测试自动创建"
+        )
+        print(f"创建成功: ID={created_env.get('id')}, Name={created_env.get('name')}")
+
+        # 查询刚才创建的环境变量详情
+        checked_env = taskpool.get_env(new_env_name)
+        if checked_env:
+            print(f"成功查询到变量: {checked_env.get('name')} = {checked_env.get('value')}")
+
+            # 修改该环境变量的值
+            updated_val = "HelloTaskPool_Updated"
+            print(f"正在修改环境变量的值为: {updated_val}...")
+            updated_env = taskpool.update_env(
+                id=checked_env.get("id"),
+                name=new_env_name,
+                value=updated_val,
+                remark="Python SDK 测试自动更新"
+            )
+            print(f"更新成功: Value={updated_env.get('value')}")
+
+            # 删除该临时环境变量
+            print(f"正在删除临时环境变量: ID={checked_env.get('id')}...")
+            taskpool.delete_env(checked_env.get("id"))
+            print("删除成功！")
+            
+    except Exception as e:
+        print(f"环境变量操作失败: {e}")
+        print("提示: 请确保在面板任务设置中正确注入了 OpenAPI Token。")
+
+if __name__ == "__main__":
+    main()

example/builtin/test_notify.js

@@ -0,0 +1,26 @@
+const taskpool = require('taskpool');
+
+/**
+ * 内建通知测试示例 (Node.js)
+ * 
+ * 使用说明：
+ * 1. 确保已在该 Node.js 环境下安装过内建包。
+ * 2. 系统会自动注入 BHPKG_NOTIFY_TOKEN 和 BHPKG_NOTIFY_CHANNEL。
+ */
+
+console.log("正在尝试发送 Node.js 内建通知...");
+
+try {
+    // 简单的一行代码即可完成推送
+    taskpool.notify(
+        "Node.js 任务提醒", 
+        "这是一条来自 Node.js 示例脚本的通知消息。无需配置 API 地址或 Token。"
+    );
+    
+    console.log("发送请求已提交。");
+    console.log("提示：内建包采用异步非阻塞发送，不会干扰主逻辑执行。");
+    
+} catch (e) {
+    console.error(`通知失败: ${e.message}`);
+    console.error("请检查环境变量是否注入，或是否已运行过 'taskpool builtininstall'。");
+}

example/builtin/test_notify.py

@@ -0,0 +1,30 @@
+import taskpool
+
+# 内建通知测试示例 (Python)
+# 
+# 前提条件：
+# 1. 已经在环境中安装了 taskpool 包（例如通过 `taskpool builtininstall`）
+# 2. 环境中已注入有效环境变量：
+#    - BHPKG_NOTIFY_TOKEN
+#    - BHPKG_NOTIFY_CHANNEL
+
+def main():
+    print("正在尝试发送 Python 内建通知...")
+    try:
+        # 调用内建 notify 函数
+        # 内部会自动使用 BHPKG_NOTIFY_TOKEN & BHPKG_NOTIFY_CHANNEL 进行鉴权和投递
+        response = taskpool.notify(
+            title="Python 任务提醒",
+            text="这是一条来自 Python 示例脚本的通知消息。调用非常简单！"
+        )
+        print("发送请求已处理。")
+        if response:
+            print(f"服务器响应: {response}")
+            
+    except ImportError as e:
+        print(f"错误: 库未正确加载。请确保已执行过环境初始化。详情: {e}")
+    except Exception as e:
+        print(f"发送过程发生异常: {e}")
+
+if __name__ == "__main__":
+    main()

example/builtin/test_task.js

@@ -0,0 +1,40 @@
+const taskpool = require('taskpool');
+
+/**
+ * 内建工具任务管理测试示例 (Node.js)
+ * 
+ * 使用说明：
+ * 1. 确保已在该 Node.js 环境下安装过内建包。
+ * 2. 运行时系统需要注入有效的 OpenAPI 凭证 (BHPKG_OPENAPI_TOKEN 或 OPENAPI_TOKEN)。
+ */
+
+async function main() {
+    console.log("====== 开始运行 Node.js 任务管理与执行控制示例 ======");
+
+    try {
+        // 获取所有任务列表
+        const tasks = await taskpool.getTasks();
+        console.log(`成功获取到 ${tasks.length} 个定时任务:`);
+        tasks.slice(0, 5).forEach(task => { // 仅展示前5项
+            console.log(`  - [${task.id}] ${task.name} (表达式: ${task.schedule || ''}, 备注: ${task.remark || ''})`);
+        });
+
+        // 尝试触发第一个任务的运行
+        if (tasks.length > 0) {
+            const targetTask = tasks[0];
+            console.log(`\n尝试手动触发任务运行: [${targetTask.id}] ${targetTask.name}...`);
+            await taskpool.executeTask(targetTask.id);
+            console.log("执行指令发送成功。");
+        }
+
+        // 获取最近的执行结果列表
+        const results = await taskpool.getLastResults();
+        console.log(`\n最近共有 ${results.length} 条任务执行记录。`);
+
+    } catch (e) {
+        console.error(`任务操作失败: ${e.message}`);
+        console.log("提示: 请确保在面板任务设置中正确注入了 OpenAPI Token。");
+    }
+}
+
+main();

example/builtin/test_task.py

@@ -0,0 +1,36 @@
+import taskpool
+
+# 内建工具任务管理与执行控制测试示例 (Python)
+# 
+# 前提条件：
+# 1. 已经在环境中安装了 taskpool 包（例如通过 `taskpool builtininstall`）
+# 2. 环境中已注入有效环境变量：
+#    - BHPKG_OPENAPI_TOKEN (必填，用于管理接口鉴权)
+
+def main():
+    print("====== 开始运行 Python 任务管理与执行控制示例 ======")
+
+    try:
+        # 获取所有任务列表
+        tasks = taskpool.get_tasks()
+        print(f"成功获取到 {len(tasks)} 个定时任务:")
+        for task in tasks[:5]:  # 仅打印前5个
+            print(f"  - [{task.get('id')}] {task.get('name')} (表达式: {task.get('schedule')}, 备注: {task.get('remark')})")
+
+        # 示例：尝试触发第一个任务的运行
+        if tasks:
+            target_task = tasks[0]
+            print(f"\n尝试手动触发任务运行: [{target_task.get('id')}] {target_task.get('name')}...")
+            result = taskpool.execute_task(target_task.get("id"))
+            print("执行指令发送成功。")
+
+        # 获取最近的执行结果列表
+        results = taskpool.get_last_results()
+        print(f"\n最近共有 {len(results)} 条任务执行记录。")
+            
+    except Exception as e:
+        print(f"任务操作失败: {e}")
+        print("提示: 请确保在面板任务设置中正确注入了 OpenAPI Token。")
+
+if __name__ == "__main__":
+    main()