From 7e73902325e59426790889e244c212971a636f41 Mon Sep 17 00:00:00 2001
From: augushong <augushong@163.com>
Date: Fri, 14 Aug 2026 22:04:52 +0800
Subject: [PATCH] =?UTF-8?q?feat(admin):=20XHProf=20=E6=80=A7=E8=83=BD?=
 =?UTF-8?q?=E6=97=A5=E5=BF=97=E4=BA=94=E5=BC=A0=E8=A1=A8=20Scheme=20?=
 =?UTF-8?q?=E8=BF=81=E7=A7=BB=E4=B8=8E=E6=A8=A1=E5=9E=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/admin/model/XhprofLogPosition.php         | 27 +++++++++
 app/admin/model/XhprofRun.php                 | 26 +++++++++
 app/admin/model/XhprofRunDetail.php           | 18 ++++++
 app/admin/model/XhprofRunWatch.php            | 23 ++++++++
 app/admin/model/XhprofWatch.php               | 24 ++++++++
 app/admin/scheme/XhprofLogPosition.php        | 56 +++++++++++++++++++
 app/admin/scheme/XhprofRun.php                | 55 ++++++++++++++++++
 app/admin/scheme/XhprofRunDetail.php          | 24 ++++++++
 app/admin/scheme/XhprofRunWatch.php           | 42 ++++++++++++++
 app/admin/scheme/XhprofWatch.php              | 45 +++++++++++++++
 .../migrations/20260814100001_xhprof_run.php  | 31 ++++++++++
 .../20260814100002_xhprof_run_detail.php      | 22 ++++++++
 .../20260814100003_xhprof_watch.php           | 27 +++++++++
 .../20260814100004_xhprof_run_watch.php       | 27 +++++++++
 .../20260814100005_xhprof_log_position.php    | 31 ++++++++++
 15 files changed, 478 insertions(+)
 create mode 100644 app/admin/model/XhprofLogPosition.php
 create mode 100644 app/admin/model/XhprofRun.php
 create mode 100644 app/admin/model/XhprofRunDetail.php
 create mode 100644 app/admin/model/XhprofRunWatch.php
 create mode 100644 app/admin/model/XhprofWatch.php
 create mode 100644 app/admin/scheme/XhprofLogPosition.php
 create mode 100644 app/admin/scheme/XhprofRun.php
 create mode 100644 app/admin/scheme/XhprofRunDetail.php
 create mode 100644 app/admin/scheme/XhprofRunWatch.php
 create mode 100644 app/admin/scheme/XhprofWatch.php
 create mode 100644 database/migrations/20260814100001_xhprof_run.php
 create mode 100644 database/migrations/20260814100002_xhprof_run_detail.php
 create mode 100644 database/migrations/20260814100003_xhprof_watch.php
 create mode 100644 database/migrations/20260814100004_xhprof_run_watch.php
 create mode 100644 database/migrations/20260814100005_xhprof_log_position.php

diff --git a/app/admin/model/XhprofLogPosition.php b/app/admin/model/XhprofLogPosition.php
new file mode 100644
index 0000000..1d0ad7b
--- /dev/null
+++ b/app/admin/model/XhprofLogPosition.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id 主键ID
+ * @property string $node_id 节点ID（区分不同采集节点）
+ * @property string $file_path 日志文件绝对路径
+ * @property int $inode 文件 inode，用于检测日志轮转
+ * @property int $offset 上次读取到的字节偏移
+ * @property int $last_read_time 上次读取时间戳
+ * @property string $last_line_hash 上次最后一行的 md5 哈希（容错校验）
+ * @property int $parse_fail_count 解析失败累计次数
+ * @property string $parse_fail_samples 解析失败样本行（最多保留若干条）
+ * @property int $create_time 创建时间戳
+ * @property int $update_time 更新时间戳
+ */
+class XhprofLogPosition extends TimeModel
+{
+
+    protected $name = "xhprof_log_position";
+
+    protected $deleteTime = false;
+
+}
diff --git a/app/admin/model/XhprofRun.php b/app/admin/model/XhprofRun.php
new file mode 100644
index 0000000..0bcf37f
--- /dev/null
+++ b/app/admin/model/XhprofRun.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id 主键ID
+ * @property string $node_id 节点ID（区分不同采集节点）
+ * @property string $url 请求完整 URL（超长截断）
+ * @property string $simple_url 规范化 URL（去 query、数字段替换，聚合用）
+ * @property string $method HTTP 方法
+ * @property int $wall_time 总耗时（微秒，main() 的 wt）
+ * @property int $cpu_time CPU 耗时（微秒，main() 的 cpu）
+ * @property int $memory_peak 内存峰值（字节，main() 的 pmu）
+ * @property string $request_time 请求开始时间（REQUEST_TIME_FLOAT 浮点秒）
+ * @property int $create_time 入库时间戳
+ */
+class XhprofRun extends TimeModel
+{
+
+    protected $name = "xhprof_run";
+
+    protected $deleteTime = false;
+
+}
diff --git a/app/admin/model/XhprofRunDetail.php b/app/admin/model/XhprofRunDetail.php
new file mode 100644
index 0000000..86f5adf
--- /dev/null
+++ b/app/admin/model/XhprofRunDetail.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id 主键，值=ul_xhprof_run.id（不自增）
+ * @property string $profile_data 原始 profile JSON
+ */
+class XhprofRunDetail extends TimeModel
+{
+
+    protected $name = "xhprof_run_detail";
+
+    protected $deleteTime = false;
+
+}
diff --git a/app/admin/model/XhprofRunWatch.php b/app/admin/model/XhprofRunWatch.php
new file mode 100644
index 0000000..3729b07
--- /dev/null
+++ b/app/admin/model/XhprofRunWatch.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id 主键ID
+ * @property int $run_id 采样记录ID（ul_xhprof_run.id）
+ * @property int $watch_id 监控规则ID（ul_xhprof_watch.id）
+ * @property int $ct 命中边次数和
+ * @property int $wt_sum 命中耗时合计（微秒）
+ * @property int $wt_max 命中单次最大耗时（微秒）
+ * @property int $create_time 入库时间戳
+ */
+class XhprofRunWatch extends TimeModel
+{
+
+    protected $name = "xhprof_run_watch";
+
+    protected $deleteTime = false;
+
+}
diff --git a/app/admin/model/XhprofWatch.php b/app/admin/model/XhprofWatch.php
new file mode 100644
index 0000000..c4507c6
--- /dev/null
+++ b/app/admin/model/XhprofWatch.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id 主键ID
+ * @property string $name 规则名称（人读）
+ * @property string $regex PCRE 正则（对被调用函数名匹配）
+ * @property string $note 备注
+ * @property int $threshold_ms 比对阈值（毫秒），0=不比对
+ * @property int $status 状态:1=启用,0=禁用
+ * @property int $create_time 创建时间戳
+ * @property int $update_time 更新时间戳
+ */
+class XhprofWatch extends TimeModel
+{
+
+    protected $name = "xhprof_watch";
+
+    protected $deleteTime = false;
+
+}
diff --git a/app/admin/scheme/XhprofLogPosition.php b/app/admin/scheme/XhprofLogPosition.php
new file mode 100644
index 0000000..6f181d9
--- /dev/null
+++ b/app/admin/scheme/XhprofLogPosition.php
@@ -0,0 +1,56 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Component;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'ul_xhprof_log_position', comment: 'XHProf 日志文件读取位置（增量读取状态）')]
+#[Index(columns: ['node_id', 'file_path'], name: 'uniq_node_file', type: 'UNIQUE')]
+class XhprofLogPosition extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'varchar', length: 64, nullable: false, default: '', comment: '节点ID（区分不同采集节点）')]
+    public $node_id;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, comment: '日志文件绝对路径')]
+    #[Component(type: 'text', options: [])]
+    public $file_path;
+
+    #[Field(type: 'bigint', default: '0', unsigned: true, comment: '文件 inode，用于检测日志轮转')]
+    #[Component(type: 'text', options: [])]
+    public $inode;
+
+    #[Field(type: 'bigint', default: '0', unsigned: true, comment: '上次读取到的字节偏移')]
+    #[Component(type: 'text', options: [])]
+    public $offset;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '上次读取时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $last_read_time;
+
+    #[Field(type: 'varchar', length: 32, default: '', comment: '上次最后一行的 md5 哈希（容错校验）')]
+    #[Component(type: 'text', options: [])]
+    public $last_line_hash;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '解析失败累计次数')]
+    #[Component(type: 'text', options: [])]
+    public $parse_fail_count;
+
+    #[Field(type: 'text', nullable: true, comment: '解析失败样本行（最多保留若干条）')]
+    #[Component(type: 'textarea', options: [])]
+    public $parse_fail_samples;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '创建时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $create_time;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '更新时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $update_time;
+}
diff --git a/app/admin/scheme/XhprofRun.php b/app/admin/scheme/XhprofRun.php
new file mode 100644
index 0000000..4f5fa23
--- /dev/null
+++ b/app/admin/scheme/XhprofRun.php
@@ -0,0 +1,55 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Component;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'ul_xhprof_run', comment: 'XHProf 性能采样记录（每次请求一条）')]
+#[Index(columns: ['simple_url', 'request_time'], name: 'idx_simple_url_time', type: 'NORMAL')]
+#[Index(columns: ['request_time'], name: 'idx_request_time', type: 'NORMAL')]
+#[Index(columns: ['wall_time'], name: 'idx_wall_time', type: 'NORMAL')]
+class XhprofRun extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'varchar', length: 64, nullable: false, default: 'default', comment: '节点ID（区分不同采集节点）')]
+    #[Component(type: 'text', options: [])]
+    public $node_id;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, comment: '请求完整 URL（超长截断）')]
+    #[Component(type: 'text', options: [])]
+    public $url;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, default: '', comment: '规范化 URL（去 query、数字段替换，聚合用）')]
+    #[Component(type: 'text', options: [])]
+    public $simple_url;
+
+    #[Field(type: 'varchar', length: 10, nullable: false, default: '', comment: 'HTTP 方法')]
+    #[Component(type: 'text', options: [])]
+    public $method;
+
+    #[Field(type: 'bigint', default: '0', comment: '总耗时（微秒，main() 的 wt）')]
+    #[Component(type: 'text', options: [])]
+    public $wall_time;
+
+    #[Field(type: 'bigint', default: '0', comment: 'CPU 耗时（微秒，main() 的 cpu）')]
+    #[Component(type: 'text', options: [])]
+    public $cpu_time;
+
+    #[Field(type: 'bigint', default: '0', comment: '内存峰值（字节，main() 的 pmu）')]
+    #[Component(type: 'text', options: [])]
+    public $memory_peak;
+
+    #[Field(type: 'decimal', precision: 12, scale: 3, default: '0.000', comment: '请求开始时间（REQUEST_TIME_FLOAT 浮点秒）')]
+    #[Component(type: 'text', options: [])]
+    public $request_time;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '入库时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $create_time;
+}
diff --git a/app/admin/scheme/XhprofRunDetail.php b/app/admin/scheme/XhprofRunDetail.php
new file mode 100644
index 0000000..d8ee2b2
--- /dev/null
+++ b/app/admin/scheme/XhprofRunDetail.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+
+/**
+ * XHProf 采样原始 profile 数据表（显式豁免表）
+ *
+ * - 不进后台：无 CURD 页面、无 Component 注解
+ * - 无 create_time/update_time/delete_time 约定字段
+ * - 无额外索引（主键即查询入口，id = ul_xhprof_run.id）
+ */
+#[Table(name: 'ul_xhprof_run_detail', comment: 'XHProf 采样原始 profile 数据（按 run 1:1，不进后台）')]
+class XhprofRunDetail extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: false, primary: true, comment: '主键，值=ul_xhprof_run.id（不自增）')]
+    public $id;
+
+    #[Field(type: 'longtext', nullable: true, comment: '原始 profile JSON')]
+    public $profile_data;
+}
diff --git a/app/admin/scheme/XhprofRunWatch.php b/app/admin/scheme/XhprofRunWatch.php
new file mode 100644
index 0000000..b47f417
--- /dev/null
+++ b/app/admin/scheme/XhprofRunWatch.php
@@ -0,0 +1,42 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Component;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'ul_xhprof_run_watch', comment: 'XHProf 采样与监控规则命中聚合（导入时物化）')]
+#[Index(columns: ['watch_id', 'create_time'], name: 'idx_watch_time', type: 'NORMAL')]
+#[Index(columns: ['run_id'], name: 'idx_run_id', type: 'NORMAL')]
+class XhprofRunWatch extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '采样记录ID（ul_xhprof_run.id）')]
+    #[Component(type: 'text', options: [])]
+    public $run_id;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '监控规则ID（ul_xhprof_watch.id）')]
+    #[Component(type: 'text', options: [])]
+    public $watch_id;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '命中边次数和')]
+    #[Component(type: 'text', options: [])]
+    public $ct;
+
+    #[Field(type: 'bigint', default: '0', comment: '命中耗时合计（微秒）')]
+    #[Component(type: 'text', options: [])]
+    public $wt_sum;
+
+    #[Field(type: 'bigint', default: '0', comment: '命中单次最大耗时（微秒）')]
+    #[Component(type: 'text', options: [])]
+    public $wt_max;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '入库时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $create_time;
+}
diff --git a/app/admin/scheme/XhprofWatch.php b/app/admin/scheme/XhprofWatch.php
new file mode 100644
index 0000000..21c4a6c
--- /dev/null
+++ b/app/admin/scheme/XhprofWatch.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Component;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'ul_xhprof_watch', comment: 'XHProf 函数监控规则')]
+#[Index(columns: ['regex'], name: 'uniq_regex', type: 'UNIQUE')]
+class XhprofWatch extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'varchar', length: 100, nullable: false, comment: '规则名称（人读）')]
+    #[Component(type: 'text', options: [])]
+    public $name;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, comment: 'PCRE 正则（对被调用函数名匹配）')]
+    #[Component(type: 'text', options: [])]
+    public $regex;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, default: '', comment: '备注')]
+    #[Component(type: 'text', options: [])]
+    public $note;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '比对阈值（毫秒），0=不比对')]
+    #[Component(type: 'text', options: [])]
+    public $threshold_ms;
+
+    #[Field(type: 'tinyint', length: 4, default: '1', comment: '状态:1=启用,0=禁用')]
+    #[Component(type: 'switch', options: ['0' => '禁用', '1' => '启用'])]
+    public $status;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '创建时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $create_time;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '更新时间戳')]
+    #[Component(type: 'date', options: [])]
+    public $update_time;
+}
diff --git a/database/migrations/20260814100001_xhprof_run.php b/database/migrations/20260814100001_xhprof_run.php
new file mode 100644
index 0000000..b4db348
--- /dev/null
+++ b/database/migrations/20260814100001_xhprof_run.php
@@ -0,0 +1,31 @@
+<?php
+
+use think\migration\Migrator;
+
+/**
+ * XHProf 性能日志 - 采样记录表
+ *
+ * 每次被采样的请求一条记录。耗时字段库内统一微秒、内存统一字节，展示层换算。
+ */
+class XhprofRun extends Migrator
+{
+    public function change()
+    {
+        $table = $this->table('xhprof_run', ['id' => false, 'primary_key' => ['id']])
+            ->setComment('XHProf 性能采样记录（每次请求一条）')
+            ->addColumn('id', 'integer', ['limit' => 11, 'null' => false, 'signed' => false, 'identity' => true, 'comment' => '主键ID'])
+            ->addColumn('node_id', 'string', ['limit' => 64, 'null' => false, 'default' => 'default', 'comment' => '节点ID（区分不同采集节点）'])
+            ->addColumn('url', 'string', ['limit' => 500, 'null' => false, 'comment' => '请求完整 URL（超长截断）'])
+            ->addColumn('simple_url', 'string', ['limit' => 255, 'null' => false, 'default' => '', 'comment' => '规范化 URL（去 query、数字段替换，聚合用）'])
+            ->addColumn('method', 'string', ['limit' => 10, 'null' => false, 'default' => '', 'comment' => 'HTTP 方法'])
+            ->addColumn('wall_time', 'biginteger', ['default' => 0, 'comment' => '总耗时（微秒，main() 的 wt）'])
+            ->addColumn('cpu_time', 'biginteger', ['default' => 0, 'comment' => 'CPU 耗时（微秒，main() 的 cpu）'])
+            ->addColumn('memory_peak', 'biginteger', ['default' => 0, 'comment' => '内存峰值（字节，main() 的 pmu）'])
+            ->addColumn('request_time', 'decimal', ['precision' => 12, 'scale' => 3, 'default' => 0, 'comment' => '请求开始时间（REQUEST_TIME_FLOAT 浮点秒）'])
+            ->addColumn('create_time', 'integer', ['limit' => 11, 'comment' => '入库时间戳', 'signed' => false])
+            ->addIndex(['simple_url', 'request_time'], ['name' => 'idx_simple_url_time'])
+            ->addIndex(['request_time'], ['name' => 'idx_request_time'])
+            ->addIndex(['wall_time'], ['name' => 'idx_wall_time'])
+            ->create();
+    }
+}
diff --git a/database/migrations/20260814100002_xhprof_run_detail.php b/database/migrations/20260814100002_xhprof_run_detail.php
new file mode 100644
index 0000000..9b36138
--- /dev/null
+++ b/database/migrations/20260814100002_xhprof_run_detail.php
@@ -0,0 +1,22 @@
+<?php
+
+use think\migration\Migrator;
+use Phinx\Db\Adapter\MysqlAdapter;
+
+/**
+ * XHProf 性能日志 - 采样原始 profile 数据表
+ *
+ * 显式豁免表：不进后台（无 CURD 页面）、无 create_time 等约定字段、无额外索引。
+ * id 与 ul_xhprof_run.id 一一对应（非自增），查询入口即主键。
+ */
+class XhprofRunDetail extends Migrator
+{
+    public function change()
+    {
+        $table = $this->table('xhprof_run_detail', ['id' => false, 'primary_key' => ['id']])
+            ->setComment('XHProf 采样原始 profile 数据（按 run 1:1，不进后台）')
+            ->addColumn('id', 'integer', ['limit' => 11, 'null' => false, 'signed' => false, 'comment' => '主键，值=ul_xhprof_run.id（不自增）'])
+            ->addColumn('profile_data', 'text', ['length' => MysqlAdapter::TEXT_LONG, 'null' => true, 'comment' => '原始 profile JSON'])
+            ->create();
+    }
+}
diff --git a/database/migrations/20260814100003_xhprof_watch.php b/database/migrations/20260814100003_xhprof_watch.php
new file mode 100644
index 0000000..8426e86
--- /dev/null
+++ b/database/migrations/20260814100003_xhprof_watch.php
@@ -0,0 +1,27 @@
+<?php
+
+use think\migration\Migrator;
+
+/**
+ * XHProf 性能日志 - 函数监控规则表
+ *
+ * regex 为 PCRE 正则，导入任务按被调用（callee）函数名匹配，命中边聚合到 run_watch 表。
+ */
+class XhprofWatch extends Migrator
+{
+    public function change()
+    {
+        $table = $this->table('xhprof_watch', ['id' => false, 'primary_key' => ['id']])
+            ->setComment('XHProf 函数监控规则')
+            ->addColumn('id', 'integer', ['limit' => 11, 'null' => false, 'signed' => false, 'identity' => true, 'comment' => '主键ID'])
+            ->addColumn('name', 'string', ['limit' => 100, 'null' => false, 'comment' => '规则名称（人读）'])
+            ->addColumn('regex', 'string', ['limit' => 255, 'null' => false, 'comment' => 'PCRE 正则（对被调用函数名匹配）'])
+            ->addColumn('note', 'string', ['limit' => 255, 'null' => false, 'default' => '', 'comment' => '备注'])
+            ->addColumn('threshold_ms', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '比对阈值（毫秒），0=不比对'])
+            ->addColumn('status', 'tinyinteger', ['limit' => 4, 'default' => 1, 'comment' => '状态:1=启用,0=禁用'])
+            ->addColumn('create_time', 'integer', ['limit' => 11, 'comment' => '创建时间戳', 'signed' => false])
+            ->addColumn('update_time', 'integer', ['limit' => 11, 'comment' => '更新时间戳', 'signed' => false])
+            ->addIndex(['regex'], ['unique' => true, 'name' => 'uniq_regex'])
+            ->create();
+    }
+}
diff --git a/database/migrations/20260814100004_xhprof_run_watch.php b/database/migrations/20260814100004_xhprof_run_watch.php
new file mode 100644
index 0000000..1bf32c5
--- /dev/null
+++ b/database/migrations/20260814100004_xhprof_run_watch.php
@@ -0,0 +1,27 @@
+<?php
+
+use think\migration\Migrator;
+
+/**
+ * XHProf 性能日志 - 采样与监控规则命中聚合表
+ *
+ * 导入任务解析 profile 时按启用规则物化（每 run × 每命中规则一条），页面零计算。
+ */
+class XhprofRunWatch extends Migrator
+{
+    public function change()
+    {
+        $table = $this->table('xhprof_run_watch', ['id' => false, 'primary_key' => ['id']])
+            ->setComment('XHProf 采样与监控规则命中聚合（导入时物化）')
+            ->addColumn('id', 'integer', ['limit' => 11, 'null' => false, 'signed' => false, 'identity' => true, 'comment' => '主键ID'])
+            ->addColumn('run_id', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '采样记录ID（ul_xhprof_run.id）', 'signed' => false])
+            ->addColumn('watch_id', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '监控规则ID（ul_xhprof_watch.id）', 'signed' => false])
+            ->addColumn('ct', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '命中边次数和'])
+            ->addColumn('wt_sum', 'biginteger', ['default' => 0, 'comment' => '命中耗时合计（微秒）'])
+            ->addColumn('wt_max', 'biginteger', ['default' => 0, 'comment' => '命中单次最大耗时（微秒）'])
+            ->addColumn('create_time', 'integer', ['limit' => 11, 'comment' => '入库时间戳', 'signed' => false])
+            ->addIndex(['watch_id', 'create_time'], ['name' => 'idx_watch_time'])
+            ->addIndex(['run_id'], ['name' => 'idx_run_id'])
+            ->create();
+    }
+}
diff --git a/database/migrations/20260814100005_xhprof_log_position.php b/database/migrations/20260814100005_xhprof_log_position.php
new file mode 100644
index 0000000..2293887
--- /dev/null
+++ b/database/migrations/20260814100005_xhprof_log_position.php
@@ -0,0 +1,31 @@
+<?php
+
+use think\migration\Migrator;
+
+/**
+ * XHProf 性能日志 - 文件读取位置表
+ *
+ * 记录每个 runs-*.jsonl 文件的 inode/offset/最近读取时间/失败计数等增量读取状态。
+ * 唯一键 uniq_node_file(node_id, file_path)：多节点导各自文件互不覆盖。
+ */
+class XhprofLogPosition extends Migrator
+{
+    public function change()
+    {
+        $table = $this->table('xhprof_log_position', ['id' => false, 'primary_key' => ['id']])
+            ->setComment('XHProf 日志文件读取位置（增量读取状态）')
+            ->addColumn('id', 'integer', ['limit' => 11, 'null' => false, 'signed' => false, 'identity' => true, 'comment' => '主键ID'])
+            ->addColumn('node_id', 'string', ['limit' => 64, 'null' => false, 'default' => '', 'comment' => '节点ID（区分不同采集节点）'])
+            ->addColumn('file_path', 'string', ['limit' => 500, 'null' => false, 'comment' => '日志文件绝对路径'])
+            ->addColumn('inode', 'biginteger', ['default' => 0, 'comment' => '文件 inode，用于检测日志轮转', 'signed' => false])
+            ->addColumn('offset', 'biginteger', ['default' => 0, 'comment' => '上次读取到的字节偏移', 'signed' => false])
+            ->addColumn('last_read_time', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '上次读取时间戳', 'signed' => false])
+            ->addColumn('last_line_hash', 'string', ['limit' => 32, 'default' => '', 'comment' => '上次最后一行的 md5 哈希（容错校验）'])
+            ->addColumn('parse_fail_count', 'integer', ['limit' => 11, 'default' => 0, 'comment' => '解析失败累计次数', 'signed' => false])
+            ->addColumn('parse_fail_samples', 'text', ['null' => true, 'comment' => '解析失败样本行（最多保留若干条）'])
+            ->addColumn('create_time', 'integer', ['limit' => 11, 'comment' => '创建时间戳', 'signed' => false])
+            ->addColumn('update_time', 'integer', ['limit' => 11, 'comment' => '更新时间戳', 'signed' => false])
+            ->addIndex(['node_id', 'file_path'], ['unique' => true, 'name' => 'uniq_node_file'])
+            ->create();
+    }
+}