feat(collectors): 可编辑采集配置（B 档结构化编辑器）+ 修 host 标签 / syslog 时间戳

=== 一、两个线上 bug（172.19.16.8 真机取证）===

1) host 标签是字面量 ${HOSTNAME}
   Promtail 不做环境变量展开（除非 -config.expand-env + systemd Environment），
   实测 21,825 条日志的 host 全是 "${HOSTNAME}"，无法按主机过滤。
   → 安装时 `hostname -s` 探测真实主机名并渲染进配置，结果存 Collector.ResolvedHostname，
     让「预览配置」与线上一致。

2) 系统日志时间戳解析失效
   TencentOS 4 的 /var/log/messages 是 ISO8601（2026-07-17T15:38:24.923784+08:00），
   旧正则按传统 syslog（Oct 28 18:11:06）写死 → timestamp 阶段匹配不上，用的是采集时间，
   回填历史日志时间全错。
   → 安装时探测目标机格式：iso8601 → RFC3339Nano；rfc3164 → Jan _2 15:04:05 + Local；
     系统日志路径同时探测（Ubuntu 没有 messages，写死会一条都采不到）。

   实测：写一条 10 分钟前的 ISO8601 探针行，Loki 里 loki_ts 与该行自身时间偏差 **0 秒**；
   另写一条 2 小时前的被 Loki 以 entry too far behind 拒绝 —— 恰好反证时间戳是按事件时间
   解析后推送的（旧实现会用采集时间，反而被接收）。

=== 二、B 档：结构化多 Job 编辑器 ===

后端
- models/scrape_job.go：ScrapeJob + ValidateScrapeJobs
  校验 job 名格式、绝对路径、**敏感路径拦截**（/etc/shadow、/etc/sudoers、/root/.ssh、
  id_rsa、*.pem…）、正则可编译、job/host/__path__ 保留标签名、数量上限。
- services/promtail_host_config.go：多 job 渲染；多路径展开成多个 static_configs；
  pipeline 顺序硬约束 cri → multiline → json → timestamp → drop → limit；
  encoding 写在 scrape_config 级（放进 static_configs 里 promtail 直接起不来）。
- services/host_profile.go：探测 distro / init / hostname / 时区 / 架构 / journald
  与真实存在的系统日志路径。
- CollectorService：renderConfig 实时渲染、PreviewConfig（只渲染不落库）、
  Update 支持 scrapeJobs 并校验、安装结果（hostname/syslog 格式/配置快照）落库。
- 新增 POST /api/v1/collectors/:id/preview → {config, warnings, hostname, syslogFormat}。
- installHost：配置先写 .new + `promtail -check-syntax` 通过才替换，重启后轮询
  systemctl is-active，失败把 journalctl 尾部带回前端。

前端
- 采集项结构化编辑器：名称/路径/标签常驻，多行合并 / JSON / 自定义时间戳 / 命中丢弃 /
  限流折叠在「高级」里；「预览 YAML」弹窗在保存前看到将要下发的配置。
- 本地即时校验 + 旧数据（只有 logPath）自动迁移成 app + system 两个采集项。

=== 三、验证（host-verify-promtail @172.19.16.8）===
- 预览：host=pre-cex-ops-jenkins（无 ${HOSTNAME}），2 job / 3 条系统日志路径 /
  ISO8601 正则 / 多行 + drop + 限流 全部按填写渲染。
- 部署：promtail active、NRestarts=0、-check-syntax 通过，主机侧配置与预览逐行一致。
- Loki：新数据 host 全为 pre-cex-ops-jenkins；job=system 415 条/5min、job=app 40 条/5min。
- 负向 7/7 返回指名到字段的 400：/etc/shadow、/root/.ssh/id_rsa、相对路径、坏正则、
  job 名带空格、保留标签名、空路径。

镜像：lghost/lokistack:latest + v0.1 = sha256:26172f51187d

backend/services/collector.go

@@ -2,6 +2,7 @@ package services
 
 import (
 	"context"
+	"encoding/json"
 	"fmt"
 	"strings"
 	"time"
@@ -27,6 +28,7 @@ type CreateCollectorRequest struct {
 	Namespace        string
 	LogPath          string
 	Labels           string
+	ScrapeJobs       []models.ScrapeJob
 }
 
 // fillAssociations 填充关联的 Loki / Host / Cluster（用于配置生成与展示）
@@ -59,10 +61,33 @@ func (s *CollectorService) fillAssociations(c *models.Collector) {
 			}
 		}
 	}
+	// 配置快照按当前字段实时渲染：DB 里存的 Config 只是上次安装时的副本，
+	// 用户改完采集项还没点「部署」时，看配置应该看到「将要生效的 YAML」。
+	// renderConfig 只读 c 的字段、不取锁，所以在 RLock 内调用是安全的。
+	if cfg, err := s.renderConfig(c); err == nil {
+		c.Config = cfg
+	}
 }
 
-// generateConfigSnapshot 按类型生成配置快照
-func (s *CollectorService) generateConfigSnapshot(c *models.Collector) string {
+// parseScrapeJobs 把接口层传来的 scrapeJobs（[]interface{} / JSON 字符串）解析成模型。
+// gin 的 map 绑定拿不到强类型，统一过一遍 JSON 转换，避免手写一堆类型断言。
+func parseScrapeJobs(v interface{}) ([]models.ScrapeJob, error) {
+	if v == nil {
+		return nil, nil
+	}
+	raw, err := json.Marshal(v)
+	if err != nil {
+		return nil, fmt.Errorf("采集项格式不合法：%w", err)
+	}
+	var jobs []models.ScrapeJob
+	if err := json.Unmarshal(raw, &jobs); err != nil {
+		return nil, fmt.Errorf("采集项格式不合法：%w", err)
+	}
+	return jobs, nil
+}
+
+// renderConfig 按类型渲染当前配置（不落库）。
+func (s *CollectorService) renderConfig(c *models.Collector) (string, error) {
 	endpoint := ""
 	if c.LokiDeployment != nil {
 		endpoint = c.LokiDeployment.Endpoint
@@ -73,7 +98,25 @@ func (s *CollectorService) generateConfigSnapshot(c *models.Collector) string {
 	}
 	switch c.Type {
 	case "host-promtail":
-		return PromtailConfig(endpoint, c.LogPath, "host", c.Labels)
+		// 主机名与 syslog 格式：优先用上次安装时探测到的真实值，
+		// 从未安装过时退回平台登记的主机名/IP（预览会提示这一点）。
+		hostname := c.ResolvedHostname
+		if hostname == "" && c.Host != nil {
+			hostname = c.Host.Name
+		}
+		if hostname == "" && c.Host != nil {
+			hostname = c.Host.HostIP
+		}
+		return PromtailConfigForHost(HostPromtailOptions{
+			Endpoint:       endpoint,
+			Cluster:        "host",
+			LabelsJSON:     c.Labels,
+			Hostname:       hostname,
+			SyslogFormat:   c.SyslogFormat,
+			SystemLogPaths: c.SystemLogPaths,
+			LogPath:        c.LogPath,
+			Jobs:           c.ScrapeJobs,
+		})
 	case "k8s-daemonset":
 		ns := c.Namespace
 		if ns == "" && c.LokiDeployment != nil {
@@ -82,7 +125,7 @@ func (s *CollectorService) generateConfigSnapshot(c *models.Collector) string {
 		if ns == "" {
 			ns = "log"
 		}
-		return PromtailDaemonsetYAML(ns, endpoint, clusterName, c.Labels, c.TargetNamespaces, c.AppLabelSource, c.AppInclude)
+		return PromtailDaemonsetYAML(ns, endpoint, clusterName, c.Labels, c.TargetNamespaces, c.AppLabelSource, c.AppInclude), nil
 	case "k8s-fluentbit-sidecar":
 		host, port := parseLokiURL(endpoint)
 		app := c.TargetDeployment
@@ -90,9 +133,59 @@ func (s *CollectorService) generateConfigSnapshot(c *models.Collector) string {
 		if ns == "" {
 			ns = "default"
 		}
-		return FluentbitConfig(host, port, c.LogPath, app, ns)
+		return FluentbitConfig(host, port, c.LogPath, app, ns), nil
 	}
-	return ""
+	return "", nil
+}
+
+// generateConfigSnapshot 按类型生成配置快照（渲染失败返回空串，不阻断保存）
+func (s *CollectorService) generateConfigSnapshot(c *models.Collector) string {
+	cfg, err := s.renderConfig(c)
+	if err != nil {
+		return ""
+	}
+	return cfg
+}
+
+// PreviewConfig 按「当前已保存配置 + 本次提交的改动」渲染 YAML 预览。
+// 只渲染不落库：用户在编辑器里点「预览」时用，避免为了看一眼 YAML 就改线上采集。
+func (s *CollectorService) PreviewConfig(id uint, updates map[string]interface{}) (map[string]interface{}, error) {
+	c, err := s.Get(id)
+	if err != nil {
+		return nil, err
+	}
+	if v, ok := updates["logPath"].(string); ok {
+		c.LogPath = v
+	}
+	if v, ok := updates["labels"].(string); ok {
+		c.Labels = v
+	}
+	if v, ok := updates["scrapeJobs"]; ok {
+		jobs, perr := parseScrapeJobs(v)
+		if perr != nil {
+			return nil, perr
+		}
+		c.ScrapeJobs = jobs
+	}
+	if c.Type == "host-promtail" {
+		if err := models.ValidateScrapeJobs(c.ScrapeJobs); err != nil {
+			return nil, err
+		}
+	}
+	cfg, err := s.renderConfig(c)
+	if err != nil {
+		return nil, err
+	}
+	warnings := make([]string, 0, 2)
+	if c.Type == "host-promtail" {
+		if c.SyslogFormat == "" {
+			warnings = append(warnings, "尚未成功安装过：系统日志时间戳格式会在安装时按目标机实际格式探测（ISO8601 / 传统 syslog）")
+		}
+		if c.ResolvedHostname == "" {
+			warnings = append(warnings, "尚未成功安装过：host 标签将使用平台登记的主机名，实际安装时会替换为目标机真实 hostname")
+		}
+	}
+	return map[string]interface{}{"config": cfg, "warnings": warnings, "hostname": c.ResolvedHostname, "syslogFormat": c.SyslogFormat}, nil
 }
 
 func (s *CollectorService) Create(req *CreateCollectorRequest) (*models.Collector, error) {
@@ -131,6 +224,7 @@ func (s *CollectorService) Create(req *CreateCollectorRequest) (*models.Collecto
 		Namespace:        req.Namespace,
 		LogPath:          req.LogPath,
 		Labels:           req.Labels,
+		ScrapeJobs:       req.ScrapeJobs,
 		Status:           "pending",
 		CreatedAt:        time.Now(),
 		UpdatedAt:        time.Now(),
@@ -292,6 +386,35 @@ func (s *CollectorService) Update(id uint, updates map[string]interface{}) error
 				}
 				db.Collectors[i].AppInclude = apps
 			}
+			// scrapeJobs：主机模式的结构化采集项（B 档）
+			if v, ok := updates["scrapeJobs"]; ok {
+				jobs, jerr := parseScrapeJobs(v)
+				if jerr != nil {
+					return jerr
+				}
+				if verr := models.ValidateScrapeJobs(jobs); verr != nil {
+					return verr
+				}
+				if len(jobs) != len(db.Collectors[i].ScrapeJobs) {
+					db.Collectors[i].StatusMessage = "采集项已保存，点击部署以应用新配置"
+				}
+				db.Collectors[i].ScrapeJobs = jobs
+			}
+			// 以下三个字段由安装流程写回（探测结果 / 渲染快照），不在前端表单里
+			if v, ok := updates["resolvedHostname"].(string); ok && v != "" {
+				db.Collectors[i].ResolvedHostname = v
+			}
+			if v, ok := updates["syslogFormat"].(string); ok && v != "" {
+				db.Collectors[i].SyslogFormat = v
+			}
+			// 系统日志路径也是探测结果（Ubuntu 与 RHEL 系不同），
+			// 不落库的话「配置预览」会和线上实际采集路径不一致。
+			if v, ok := updates["systemLogPaths"].([]string); ok && len(v) > 0 {
+				db.Collectors[i].SystemLogPaths = v
+			}
+			if v, ok := updates["config"].(string); ok && v != "" {
+				db.Collectors[i].Config = v
+			}
 			db.Collectors[i].UpdatedAt = time.Now()
 			db.RequestSave()
 			return nil
@@ -340,7 +463,22 @@ func (s *CollectorService) Install(id uint) {
 		s.Update(id, map[string]interface{}{"status": "error", "statusMessage": err.Error()})
 		return
 	}
-	s.Update(id, map[string]interface{}{"status": "active", "statusMessage": "采集器已部署"})
+	// 安装时探测到的真实 hostname / syslog 格式 + 实际生效的配置都要落库，
+	// 否则「配置预览」与线上真实配置不一致（用户没法核对）。
+	updates := map[string]interface{}{"status": "active", "statusMessage": "采集器已部署"}
+	if collector.Config != "" {
+		updates["config"] = collector.Config
+	}
+	if collector.ResolvedHostname != "" {
+		updates["resolvedHostname"] = collector.ResolvedHostname
+	}
+	if collector.SyslogFormat != "" {
+		updates["syslogFormat"] = collector.SyslogFormat
+	}
+	if len(collector.SystemLogPaths) > 0 {
+		updates["systemLogPaths"] = collector.SystemLogPaths
+	}
+	s.Update(id, updates)
 }
 
 // Uninstall 异步卸载采集器