WorkBuddy部署需确保系统时间偏差≤±5秒且时区正确：一、Linux用timedatectl set-timezone Asia/Shanghai，Windows手动设为UTC+08:00；二、启用NTP同步并验证synchronized为yes；三、集群主控节点部署chrony并配置阿里云NTP源；四、校准硬件时钟（hwclock --systohc）；五、虚拟机中禁用宿主机时间同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在部署WorkBuddy时遇到安装中断、集群组件注册失败或任务调度时间错乱等问题，很可能是系统时间未与标准时间源对齐所致。WorkBuddy对时间一致性极为敏感，要求所有节点的本地时间偏差严格控制在±5秒以内，且时区必须明确标识。以下是满足该要求的具体配置步骤：
一、确认操作系统时区已正确设定
WorkBuddy依赖系统时区元数据识别地理上下文，若时区未显式设置（如显示为Etc/UTC或空值），将拒绝初始化核心服务。必须为每个部署节点指定与物理位置匹配的IANA时区标识符。
1、Linux节点执行命令检查当前时区设置：timedatectl status | grep "Time zone"。
2、若输出中时区非预期值（例如显示为Etc/UTC而非Asia/Shanghai），则需强制重设：sudo timedatectl set-timezone Asia/Shanghai。
3、Windows节点右键任务栏时间 → “调整日期/时间” → 关闭“自动设置时区” → 手动选择“(UTC+08:00) 北京,重庆,香港特别行政区,乌鲁木齐”。
二、启用并验证NTP客户端同步
NTP客户端负责持续校准系统时钟，防止因硬件时钟漂移导致累积误差。WorkBuddy集群要求所有节点必须运行活跃的NTP客户端，并能稳定连接至少一个可用时间源。
1、Linux节点启用systemd-timesyncd服务：sudo timedatectl set-ntp true。
2、重启时间同步守护进程：sudo systemctl restart systemd-timesyncd。
3、等待10秒后验证同步状态：timedatectl status | grep "System clock synchronized"，确认输出为yes。
4、Windows节点打开“设置”→“时间和语言”→“日期和时间”，确保“自动设置时间”开启，并点击“立即同步”，观察状态变为上次同步:几秒前。
三、配置高精度NTP服务器（适用于集群主控节点）
当WorkBuddy以集群模式部署时，主控节点需作为内部时间权威源，为Worker节点提供低延迟、高可信度的时间服务。此时必须部署专用NTP服务端，并禁用默认客户端冲突行为。
1、在主控节点安装chrony（CentOS 8.2+/Rocky Linux 8.6+）或ntp（其他发行版）：sudo yum install chrony -y。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、备份原始配置：sudo cp /etc/chrony.conf{,_bak}。
3、编辑/etc/chrony.conf，注释默认pool行，添加阿里云公共NTP源：server time1.aliyun.com iburst。
4、取消注释并修改allow指令，允许Worker节点网段访问：allow 192.168.10.0/24（按实际子网调整）。
5、重启服务并检查监听状态：sudo systemctl restart chronyd && sudo ss -tuln | grep :123，确认UDP 123端口处于LISTEN状态。
四、校准硬件时钟防止重启失步
系统重启后时间回退表明主板CMOS电池供电的RTC（实时时钟）存在显著偏差，这将直接破坏WorkBuddy的启动时序校验。必须将校准后的时间持久化写入硬件时钟。
1、Linux节点比对系统时间与硬件时钟：sudo hwclock --show，记录差值。
2、若偏差超过30秒，执行写入操作：sudo hwclock --systohc。
3、Windows节点重启进入UEFI/BIOS界面（开机按Del/F2），定位“Date/Time”选项，手动修正日期与时间至网络当前时间，保存退出。
五、禁用虚拟化环境时间覆盖机制
若WorkBuddy部署于VMware或VirtualBox虚拟机中，宿主机可能通过VMware Tools或Guest Additions强制同步客户机时间，导致时区与NTP状态被反复覆盖，引发Claw调度器拒绝注册。
1、VMware Workstation用户：右键虚拟机 → “设置” → “选项” → “VMware Tools” → 取消勾选同步客户机时间与主机。
2、VirtualBox用户：关闭虚拟机 → “设置” → “系统” → “主板” → 取消勾选启用硬件时钟绝对时间。
3、KVM/QEMU用户：编辑虚拟机XML配置，删除或注释掉
