EIGHTfs/dsh-test-sync-plugin

README 摘要

🔀 dsh-test-sync 蓝绿部署同步插件：主实例安装插件时自动同步到测试实例并重启 ✨ 为什么需要它？ 在 DSH 双实例蓝绿部署场景下，每次在主实例（3081）安装新插件都需要手动同步到测试实例（3084），流程繁琐且容易遗漏。本插件实现了： 痛点 解决方案 手动同步 patch 文件易漏插件 自动监听主实例 cordis.patch.yml，检测到变更立即同步 测试实例重启需要手动操作 同步完成后自动触发测试实例重启，无需人工介入 多次频繁变更可能冲突 防抖机制（默认 3s），批量变更合并为一次同步 📦 安装方法 第一步：源码放入 node modules local 第二步：添加依赖声明 编辑 /vol1/@appshare/DeepSeekHarness/profiles/web/package.json ，在 dependencies 中添加： 第三步：注册到 cordis.patch.yml 编辑 /vol1/@appshare/DeepSeekHarness/.dsh/profiles/web/cordis.patch.yml ，添加： 第四步：重启主实例 🎛️ 配置说明 配置项 类型 默认值 说明 testHome string .../dsh-test-home 测试实例的 DSH HOME 路径 proxyPort number 3084 测试实例反代端口（健康检查用） enabled boolean true 是否启用自动同步 debounceMs number 3000 同步防抖延迟（毫秒） 🔌 API 说明 所有 API 通过主实例 3081 端口访问。 查询同步状态 手动触发同步 启用同步 禁用同步 🧪 验证方法 验证插件加载成功 预期输出： 验证同步功能 验证健康检查 预期输出： 200 ⚠️ 已知坑 问题 原因 解决方法 测试实例未启动时同步失败 health check 超时 先手动启动测试实例再同步 手动编辑测试实例 patch 后冲突 直接覆盖而非合并 同步前备份，或只通过 GUI 操作主实例 频繁变更导致多次重启 debounceMs 设置过小 增大 debounceMs 到 5000+ 📋 版本记录 版本 日期 说明 1.0.0 2026-01-01 初始版本：监听 patch 变更、自动同步、重启测试实例 工作原理 ：插件通过 chokidar 监听主实例 cordis.patch.yml 文件变更，检测到 bundles 列表变化后，自动计算 hash 对比、提取新增插件名称、写入测试实例 patch 文件，并触发测试实例重启。整个过程无需人工干预，实现蓝绿部署的无缝同步。

分类