furniture-3d-system-Wu/furniture-3d-system/agents/script-monitor/README.md

供应链脚本监控 Agent

每台运行脚本的机器部署一份 Agent。Agent 只主动向产品平台发起 HTTP 请求，不需要为被监控机器开放入站端口。

需要交给安装同事逐台执行时，请使用完整的 《脚本监控 Agent 逐台接入操作手册》。

接入

1. 在供应链中心的“脚本监控”页面点击“接入机器”，生成独立的 agentId 和 agentToken。
2. 复制本目录到目标机器，把 config.example.json 复制为 config.json，填入凭据、内外网地址和脚本任务说明。
3. 先运行 node agent.mjs 确认上报，再使用 pm2 start ecosystem.config.cjs 常驻。

需要在平台点击“立即运行”的脚本，必须在 config.json 对应任务中显式配置 "allowManualRun": true。平台只会下发脚本 key，Agent 始终执行本机配置里预存的 command，不会接收平台传来的任意命令。Agent 默认每 5 秒主动领取一次执行请求， 因此内网机器不需要开放入站端口。

connectionMode 支持：

• intranet：只走内网地址。
• internet：只走公网地址，生产必须使用 HTTPS。
• auto：优先内网，失败后自动尝试公网。

记录真实运行结果

对于需要记录开始时间、耗时、退出码和输出的任务，用包装器代替原命令：

node /opt/furniture-script-monitor/run-script.mjs supply-chain-archive-sync

包装器执行 config.json 中同一 key 的 command，并在开始与结束时上报。Agent Token 只保存在目标机器的 config.json，该文件已被仓库忽略。