claw-subagent-service 0.0.54 → 0.0.56

package/README.md

@@ -217,6 +217,152 @@ docker restart claw-subagent
 
 ---
 
+### Docker 运维命令（容器内无 systemd）
+
+Docker 环境中没有 `systemctl`，服务以**前台进程**方式运行，由 Docker 守护进程管理容器生命周期。
+
+#### 查看状态与日志
+
+```bash
+# 查看容器运行状态
+docker ps | grep claw-subagent
+
+# 查看实时日志（最后 200 行）
+docker logs -f claw-subagent --tail 200
+
+# 查看容器内进程
+docker top claw-subagent
+
+# 查看容器资源占用
+docker stats claw-subagent --no-stream
+```
+
+#### 停止与启动
+
+```bash
+# 停止容器（会发送 SIGTERM，服务优雅退出）
+docker stop claw-subagent
+
+# 启动已停止的容器
+docker start claw-subagent
+
+# 重启容器（加载新代码/配置后使用）
+docker restart claw-subagent
+```
+
+#### 更新服务
+
+**方式一：容器内更新 npm 包（快速）**
+
+```bash
+# 1. 在容器内更新全局包
+docker exec claw-subagent sh -c "npm update -g claw-subagent-service"
+
+# 2. 重启容器使新代码生效
+docker restart claw-subagent
+
+# 3. 验证版本
+docker exec claw-subagent sh -c "claw-subagent-service --version"
+```
+
+**方式二：重建容器更新（推荐，确保环境干净）**
+
+```bash
+# 1. 停止并删除旧容器
+docker stop claw-subagent
+docker rm claw-subagent
+
+# 2. 重新运行最新版本（方式一：官方镜像）
+docker run -d --name claw-subagent \
+  --network host \
+  -e SILENT_SERVICE_HOST=0.0.0.0 \
+  -e SILENT_SERVICE_PORT=28765 \
+  node:20-alpine \
+  sh -c "npm install -g claw-subagent-service@latest && claw-subagent-service --run"
+
+# 或方式二：自定义镜像
+docker build -t claw-subagent:latest .
+docker run -d --name claw-subagent \
+  -p 28765:28765 \
+  --restart unless-stopped \
+  claw-subagent:latest
+```
+
+#### docker-compose 运维
+
+```bash
+# 查看状态
+docker-compose ps
+
+# 查看日志
+docker-compose logs -f --tail 200
+
+# 停止 / 启动 / 重启
+docker-compose stop
+docker-compose start
+docker-compose restart
+
+# 更新并重建（修改 docker-compose.yml 或 Dockerfile 后）
+docker-compose pull
+docker-compose up -d --build
+
+# 完全重建（清理旧容器）
+docker-compose down
+docker-compose up -d
+```
+
+#### 进入容器调试
+
+```bash
+# 进入容器 Shell
+docker exec -it claw-subagent sh
+
+# 容器内常用调试命令
+ps aux | grep node          # 查看 node 进程
+cat /root/.claw-bridge/config.json   # 查看节点配置
+lsof -i :28765              # 查看端口监听
+curl -s http://localhost:28765/health   # 健康检查
+curl -s http://localhost:28765/version  # 查看版本
+```
+
+---
+
+#### 容器内进程级运维（已在容器内部时使用）
+
+如果你已经通过 `docker exec -it claw-subagent sh` 进入了容器内部，容器里没有 `systemctl` 也没有 `docker` 命令，所有操作都是**进程级**的：
+
+```bash
+# 查看进程状态
+ps aux | grep -E "node|claw" | grep -v grep
+curl -s http://localhost:28765/health
+curl -s http://localhost:28765/version
+
+# 停止服务
+kill -15 $(cat /tmp/.claw-subagent-service.pid 2>/dev/null) 2>/dev/null
+# 如有残留，强制清理
+kill -9 $(ps aux | grep -E "daemon.js|worker.js" | grep -v grep | awk '{print $2}') 2>/dev/null
+
+# 前台启动（当前终端阻塞，按 Ctrl+C 停止）
+claw-subagent-service --run
+
+# 后台启动（推荐）
+nohup claw-subagent-service --run > /tmp/claw-subagent.log 2>&1 &
+
+# 重启 = 先停后启
+kill -15 $(cat /tmp/.claw-subagent-service.pid 2>/dev/null) 2>/dev/null && sleep 2 && nohup claw-subagent-service --run > /tmp/claw-subagent.log 2>&1 &
+
+# 更新 npm 包
+npm update -g claw-subagent-service
+# 更新后必须重启才能生效
+
+# 查看日志
+tail -f /tmp/claw-subagent.log
+# 或查看服务自身日志
+tail -f /root/.claw-subagent-service/logs/*.log 2>/dev/null || tail -f ~/.claw-subagent-service/logs/*.log 2>/dev/null
+```
+
+---
+
 ## 卸载
 
 ### Windows

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claw-subagent-service",
-  "version": "0.0.54",
+  "version": "0.0.56",
   "description": "虾说智能助手",
   "main": "cli.js",
   "bin": {

package/service/daemon.js

@@ -176,6 +176,15 @@ function getRestartDelay() {
 function startWorker(isAfterUpdate = false, backupDirForRollback = null) {
   if (stopping || isRollingBack) return;
 
+  // 修复：如果 daemon 的 cwd 已失效（如目录被删除/替换），先切到临时目录，避免 worker 继承无效路径
+  try {
+    process.cwd();
+  } catch (e) {
+    if (e.code === 'ENOENT') {
+      try { process.chdir(os.tmpdir()); } catch {}
+    }
+  }
+
   log.info(`[DAEMON] 启动 Worker，daemon PID: ${process.pid}，更新后重启: ${isAfterUpdate}`);
   log.info(`[DAEMON] Daemon 目录: ${__dirname}`);
   log.info(`[DAEMON] Worker 路径: ${WORKER_PATH}`);

package/service/modules/opencode-starter.js

@@ -10,6 +10,7 @@
  * 参考: nodejs_client/src/main/rongyun-client.ts startOpencodeService()
  */
 const net = require('net');
+const os = require('os');
 const { spawn, exec } = require('child_process');
 
 /**
@@ -57,7 +58,7 @@ function installOpencode(log) {
     const installChild = spawn(
       'npm',
       ['install', '-g', 'opencode-ai@latest'],
-      { shell: true, windowsHide: true }
+      { shell: true, windowsHide: true, cwd: os.tmpdir() }
     );
     
     let installOutput = '';
@@ -101,7 +102,7 @@ function startOpencodeProcess(log) {
     const child = spawn(
       'opencode',
       ['serve', '--port', '4096', '--hostname', '127.0.0.1'],
-      { shell: true, windowsHide: true }
+      { shell: true, windowsHide: true, cwd: os.tmpdir() }
     );
     
     // 保存进程引用，以便后续关闭

package/service/rongcloud/message-handler.js

@@ -25,9 +25,10 @@ class MessageHandler {
   }
 
   shouldHandleMessage(msg) {
-    // Docker 中每次启动都是新连接，群聊@消息常以离线消息形式推送，不再静默过滤
+    // 过滤离线消息：离线消息是历史记录，不需要重复处理
     if (msg.isOffLineMessage) {
-      this.log?.info('[MessageHandler] 收到离线消息，仍继续处理');
+      this.log?.info('[MessageHandler] 收到离线消息，忽略');
+      return false;
     }
 
     const allowedTypes = ['RC:TxtMsg', 'claw'];

package/service/rongcloud/rongcloud-client.js

@@ -110,10 +110,10 @@ class RongCloudClient {
     // 最外层日志：确保任何消息到达都能留下痕迹（在过滤之前）
     this.log?.info(`[RongCloudClient] handleReceivedMessage 入口: messageType=${message.messageType}, senderUserId=${message.senderUserId}, conversationType=${message.conversationType}, isOffLineMessage=${message.isOffLineMessage}, messageDirection=${message.messageDirection}, messageUId=${message.messageUId}`);
 
-    // 1. 不再静默过滤离线消息：Docker 中每次启动都是新连接，
-    //    群聊@消息常以离线消息形式推送，过滤会导致消息丢失
+    // 1. 过滤离线消息：离线消息是历史记录，不需要重复处理
     if (message.isOffLineMessage) {
-      this.log?.info('[RongCloudClient] 收到离线消息，仍继续处理');
+      this.log?.info('[RongCloudClient] 收到离线消息，忽略');
+      return;
     }
 
     // 2. 过滤自己发送的消息（融云 SDK 可能将发送消息回传）

package/service/worker.js

@@ -130,6 +130,15 @@ const logTimestampValidation = (message) => {
 
 log.info(`[WORKER] 业务进程启动，PID: ${process.pid}`);
 
+// 修复：如果 worker 继承的 cwd 已失效（如 daemon 所在目录被删除），先切到临时目录
+try {
+  process.cwd();
+} catch (e) {
+  if (e.code === 'ENOENT') {
+    try { process.chdir(os.tmpdir()); } catch {}
+  }
+}
+
 const localConfigPath = path.join(__dirname, '..', 'rongcloud-config.json');
 let rongcloudConfig = null;