@goodandready/dsh-remote-workspace 0.3.0 → 0.3.2

package/README.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -236,3 +246,10 @@ All endpoints are hosted under `/dsh-remote-workspace`:
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### 13. Smart Tarball Sync & Diagnostics (v0.3.1)
+- **`🚀 Fast Tarball Stream`**: High-throughput directory sync via on-the-fly streaming `tar -czf` bypassing per-file roundtrips.
+- **`🩺 Remote Diagnostics (remote_diagnose)`**: Instant one-shot checks for occupied ports (`ports`), OOM killer events (`oom_killer`), disk consumption (`disk`), and service crash-logs (`service_logs`).
+- **`📥 Import from ~/.ssh/config`**: One-click import of hosts, keys, and ProxyJump configurations directly into the encrypted `.env` vault.
+- **`🗃️ Remote Environment Manager (remote_env)`**: Inspect and atomically modify remote `.env` key-values with password masking and structural preservation.
+- **`📡 Background Anomaly Alerts`**: Proactive monitoring of disk (<10% free), memory (<5%), and restarting Docker containers via Cordis event bus (`remote-workspace/alert`).

package/README.ru.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -236,3 +246,10 @@ dsh-remote-workspace:
 ## 📄 Лицензия
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### 13. Пакетная синхронизация и диагностика (v0.3.1)
+- **`🚀 Быстрый Tarball поток`**: Высокоскоростная передача структуры каталогов через потоковый `tar -czf` без задержек пофайлового обхода.
+- **`🩺 Диагностика сервера (remote_diagnose)`**: Мгновенный аудит занятых портов (`ports`), срабатываний OOM Killer (`oom_killer`), дискового пространства (`disk`) и crash-логов служб.
+- **`📥 Импорт из ~/.ssh/config`**: Автоматическое добавление хостов, ключей и bastion-узлов в зашифрованный `.env` vault.
+- **`🗃️ Менеджер переменных окружения (remote_env)`**: Атомарное изменение и безопасный просмотр удалённых `.env` файлов с маскированием паролей.
+- **`📡 Мониторинг аномалий`**: Оповещение о переполнении диска (<10%), дефиците ОЗУ (<5%) и циклических перезапусках контейнеров через шину событий Cordis (`remote-workspace/alert`).

package/README.zh.md

@@ -22,6 +22,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -236,3 +246,10 @@ dsh-remote-workspace:
 ## 📄 开源许可证
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### 13. 归档流同步与综合诊断 (v0.3.1)
+- **`🚀 快速 Tarball 流式同步`**：利用实时 `tar -czf` 数据流传输整个目录，彻底消除小文件频繁往返的延迟。
+- **`🩺 远程系统诊断 (remote_diagnose)`**：一键检测端口占用 (`ports`)、OOM 终止记录 (`oom_killer`)、磁盘分布 (`disk`) 与服务崩溃日志。
+- **`📥 导入 ~/.ssh/config`**：快速解析本机已有主机、私钥及跳板机配置至加密 `.env` 保管库。
+- **`🗃️ 远程环境变量管理 (remote_env)`**：支持远程 `.env` 的安全预览与原子化变量修改，自动遮蔽敏感密码。
+- **`📡 异常告警监控`**：当磁盘低于 10%、内存不足 5% 或容器异常重启时，主动触发 Cordis 事件总线 (`remote-workspace/alert`) 告警。

package/docs/design/DESIGN.md

@@ -7,7 +7,7 @@ emote_fs,
 emote_sync, 
 emote_tunnel).
 - **Аудитория**: Разработчики и инженеры, использующие DSH для работы с проектами на VPS, удаленных серверах, облачных инстансах и MiniPC.
-- **Статус**: В активной доработке (Стабильность, Тесты, Редизайн в стиле dsh-clinebot).
+- **Статус**: Стабильный релиз v0.3.2 (One-Click Updater, Cross-Plugin API, Clean Tokens, Modular Routes).
 
 ## User Surfaces
 - **Web/UI**: Нативная карточка настроек профилей хостов (settings.plugin.item), удаленный SFTP браузер каталогов, чип статуса подключения в шапке сессии (conversation.session.header.utilities).

package/lib/alert-service.js

@@ -0,0 +1,109 @@
+export class AlertService {
+  /**
+   * @param {any} ctx
+   * @param {import('./health-service.js').HealthService} healthService
+   * @param {import('./docker-service.js').DockerService} dockerService
+   */
+  constructor(ctx, healthService, dockerService) {
+    this.ctx = ctx;
+    this.healthService = healthService;
+    this.dockerService = dockerService;
+    /** @type {NodeJS.Timeout|null} */
+    this.timer = null;
+    /** @type {Array<any>} */
+    this.activeAlerts = [];
+    this.checkIntervalMs = 5 * 60 * 1000; // 5 mins
+    this.enabled = false;
+  }
+
+  start(intervalMs = 300000) {
+    this.stop();
+    this.checkIntervalMs = intervalMs;
+    this.enabled = true;
+    this.timer = setInterval(() => this.check(), this.checkIntervalMs);
+  }
+
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.enabled = false;
+  }
+
+  /**
+   * Run single alert check across active profile
+   */
+  async check(profile) {
+    if (!profile) return [];
+
+    const alerts = [];
+    try {
+      // 1. Health check
+      const health = await this.healthService.getHealth(profile, true);
+      if (health.disk && health.disk.percent >= 90) {
+        alerts.push({
+          id: `disk-${Date.now()}`,
+          level: health.disk.percent >= 95 ? 'critical' : 'warning',
+          type: 'disk_full',
+          message: `Disk usage on ${profile.name || profile.host} is ${health.disk.percent}%`,
+          timestamp: Date.now()
+        });
+      }
+
+      if (health.memory && health.memory.percent >= 95) {
+        alerts.push({
+          id: `mem-${Date.now()}`,
+          level: 'warning',
+          type: 'memory_high',
+          message: `Memory usage on ${profile.name || profile.host} is ${health.memory.percent}%`,
+          timestamp: Date.now()
+        });
+      }
+
+      // 2. Docker check
+      if (this.dockerService) {
+        try {
+          const containers = await this.dockerService.listContainers(profile);
+          for (const c of containers) {
+            if (c.State === 'restarting' || (c.Status && c.Status.includes('Restarting'))) {
+              alerts.push({
+                id: `docker-${c.ID || c.Names}`,
+                level: 'warning',
+                type: 'container_restarting',
+                message: `Container ${c.Names || c.ID} is restarting repeatedly`,
+                timestamp: Date.now()
+              });
+            }
+          }
+        } catch {
+          // Docker might not be installed or active, non-blocking
+        }
+      }
+    } catch (err) {
+      // If host unreachable
+      alerts.push({
+        id: `host-unreachable-${Date.now()}`,
+        level: 'critical',
+        type: 'host_unreachable',
+        message: `Host ${profile.name || profile.host} unreachable: ${err.message}`,
+        timestamp: Date.now()
+      });
+    }
+
+    this.activeAlerts = alerts;
+
+    // Emit Cordis event if ctx is present
+    if (this.ctx && typeof this.ctx.emit === 'function' && alerts.length > 0) {
+      for (const alert of alerts) {
+        this.ctx.emit('remote-workspace/alert', alert);
+      }
+    }
+
+    return alerts;
+  }
+
+  getAlerts() {
+    return this.activeAlerts;
+  }
+}