feat: initial commit

2026-06-14 14:00:24 +08:00
commit 72d388f642
118 changed files with 39015 additions and 0 deletions
@@ -0,0 +1,70 @@
+<?php
+/**
+ * MySQL 辅助（PHP 8 兼容：禁止向 mysqli 传入 null）
+ */
+
+if (!function_exists('cloak_db_string')) {
+    /**
+     * 将任意值转为可写入 SQL 的字符串（null → 空串）
+     *
+     * @param mixed $value
+     */
+    function cloak_db_string($value): string
+    {
+        if ($value === null) {
+            return '';
+        }
+        return (string) $value;
+    }
+}
+
+if (!function_exists('cloak_db_escape')) {
+    /**
+     * @param mysqli $conn
+     * @param mixed  $value
+     */
+    function cloak_db_escape(mysqli $conn, $value): string
+    {
+        return mysqli_real_escape_string($conn, cloak_db_string($value));
+    }
+}
+
+if (!function_exists('cloak_visitor_log_format_timing')) {
+    /**
+     * @param mixed $raw JSON 或已格式化的摘要
+     */
+    function cloak_visitor_log_format_timing($raw)
+    {
+        $raw = trim((string) $raw);
+        if ($raw === '') {
+            return '';
+        }
+        if (!class_exists('CloakPipelineTimer', false)) {
+            require_once dirname(__DIR__) . '/Cloak/PipelineTimer.php';
+        }
+        $decoded = json_decode($raw, true);
+        if (is_array($decoded)) {
+            return CloakPipelineTimer::formatText($decoded);
+        }
+        return $raw;
+    }
+}
+
+if (!function_exists('cloak_visitor_log_apply_result_filter')) {
+    /**
+     * 日志列表 result 筛选：默认排除 wait(检测中)；显式选 wait/true/false 时精确匹配
+     *
+     * @return string SQL 片段（含前导 AND）
+     */
+    function cloak_visitor_log_apply_result_filter(mysqli $conn, $resultParam): string
+    {
+        $resultParam = trim((string) $resultParam);
+        if ($resultParam === 'wait') {
+            return " AND `result` = 'wait'";
+        }
+        if ($resultParam === 'true' || $resultParam === 'false') {
+            return " AND `result` = '" . cloak_db_escape($conn, $resultParam) . "'";
+        }
+        return " AND (`result` IS NULL OR `result` <> 'wait')";
+    }
+}