本技能用于火山引擎 TLS 的 LogCollector 日志采集任务，包括设计、校验、部署、变更与故障排查。适用环境为 Linux 主机与 Kubernetes（DaemonSet 或 Controller/CRD 方式）。
用途与范围
- 处理 TLS 资源与采集规则配置。
- Linux 主机上的安装与生命周期管理。
- Kubernetes DaemonSet 安装，以及 Controller/CRD 安装与规则管理。
- 针对心跳、绑定、解析或写入链路的排查。 通用 CLI 操作模型由 volcengine-tls 提供，本技能聚焦 LogCollector 专属工作流。仅需方案或命令时不应改动远端资源；需要执行时应先展示解析后的目标与计划写入，校验后再做获授权的变更。
使用方式（契约优先）
- 运行 volclog --profile <profile> doctor，需要实时连通性检查时加 --online。
- 用 volclog tool list <group> 发现具体动作。
- 用 volclog tool describe <group.action> --view full 阅读所选契约；动作 ID、字段与枚举值以当前 describe 输出为准。
- 在持久化复杂解析、路径提取、时间戳、索引分隔符或处理器配置前，按 references/config-validation.md 做样本验证。
- 涉及 Project、Topic、主机组、采集规则、索引或绑定时参考 references/tls-resources.md。
- 写操作先加 --dry-run；dry-run 只校验本地请求形态，不证明服务会接受或解析语义正确。随后执行一次授权写入；结果不明确时用读动作核对，而非盲目重试。
- 安装场景遵循对应参考：references/linux-host.md、references/kubernetes-daemonset.md、references/kubernetes-controller.md。
- 按 references/verification.md 验证进程或工作负载健康、机器心跳、规则绑定与 Topic 写入。
采集设计要点
- 主机文件输入只用于主机路径，容器 stdout 输入只用于 stdout/stderr，容器文件输入只用于容器内文件，不要混用 Paths 与 ContainerRule 形态。
- 选择尽量窄且稳定的路径与 Kubernetes 过滤条件，禁止创建可能误采整个集群的空容器过滤。
- 默认使用 Label 主机组；安装的标签须与主机组 HostIdentifier 一致，同一 agent 不可同时配置标签与 IP 身份。
- 复用资源前按精确名称或 ID 核对，多候选时停止并请用户选择。
- 不编造分片数、保留期、索引设置、资源名、路径、正则、时区或解析键等生产值。
- 默认不采集 LogCollector 自身日志；仅在用户明确要求临时端到端测试并接受回环风险时允许自日志 POC，并定义清理步骤。
- 安装成功不等于采集成功；进程健康、心跳、绑定与 Topic 写入需分别验收。
必需输入 按所选路径解析所需项：运行时选择器（显式 --profile、--secrets-file 或有意选择的环境凭据）、区域与 TLS 端点（不得互相推导）、公网或私网路径、目标 Project/Topic/主机组/采集规则的 ID 或精确名称、输入源、Kubernetes 上下文与命名空间等。不要在对话中回显凭据，不将 AK/SK 写入技能文件、仓库、清单或 shell 历史。
停止条件 运行时选择器、区域、端点、目标账号、集群或资源身份不明确；写入结果不确定且读写核对失败；解析配置未通过样本验证；安装会覆盖确认目标之外的服务、DaemonSet、CRD、绑定或采集规则；POC 自日志规则出现写入或资源加速增长时，应停止并报告具体阶段。
输出约定 报告所选运行时、目标环境与资源 ID 或精确名称、采集源与解析策略、已运行的校验及结果、计划与完成的写入（区分 dry-run 与实跑）、部署命令及执行位置、进程/Pod、心跳、绑定与 Topic 写入的验证证据，以及临时 POC 资源的清理步骤。