如何通过CLI控制运行中的Python后台目录监控程序

你不需要拆分出完全独立的两套程序，最优做法是单程序支持后台服务和CLI客户端两种运行模式，代码复用率高，维护成本低。如果后续两个模块的迭代节奏、权限要求差异很大，再考虑拆分为两个独立程序，核心的进程通信逻辑是通用的。

可选的进程通信方案 #

根据你的命令复杂度选合适的方案即可：

• 简单无参数命令场景：直接用系统信号实现，开发成本最低
  比如用SIGHUP触发配置重载、SIGUSR1触发暂停监控、SIGTERM触发安全退出，无需额外开发通信逻辑，用户直接用kill -信号 <进程PID>即可操作，或者你在CLI里封装调用逻辑。缺点是不能传递自定义参数，无法实现「修改监控路径」「调整推送阈值」这类带参数的操作。
  示例代码：

  import signal
  # 全局配置变量
  MONITOR_CONFIG = {}
  
  def reload_config(signum, frame):
      global MONITOR_CONFIG
      MONITOR_CONFIG = load_config_from_file()
      print("配置已重载")
  
  # 注册信号处理函数
  signal.signal(signal.SIGHUP, reload_config)
  

• 带参数的复杂命令场景：用本地IPC通信实现，推荐两个选型：
  1. 本地环回TCP接口：跨平台兼容性最好，Windows、Linux、macOS都能用，后台启动一个轻量的TCP服务监听127.0.0.1的指定端口，CLI作为客户端发命令即可。
  2. Unix域套接字（UDS）：Linux/macOS下首选，比TCP性能更高，不占用系统端口，用本地文件作为通信入口，Windows下可以用命名管道做兼容。
     后台服务侧示例（TCP版本）：

  import socket
  import threading
  # 全局配置变量
  MONITOR_PATH = "/default/path"
  
  def command_listener():
      s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
      s.bind(("127.0.0.1", 19999)) # 选一个未被占用的本地端口
      s.listen(1)
      while True:
          conn, _ = s.accept()
          cmd = conn.recv(1024).decode().strip()
          if cmd.startswith("set_monitor_path"):
              _, new_path = cmd.split(maxsplit=1)
              global MONITOR_PATH
              MONITOR_PATH = new_path
              # 可选：持久化到配置文件
              save_config_to_file()
              conn.send(b"success: monitor path updated")
          elif cmd == "get_status":
              conn.send(f"running, monitor path: {MONITOR_PATH}".encode())
          else:
              conn.send(b"error: unknown command")
          conn.close()
  
  # 后台服务启动时，单独开一个线程跑命令监听逻辑，不阻塞主监控流程
  threading.Thread(target=command_listener, daemon=True).start()
  

  CLI客户端侧示例：

  import socket
  import sys
  
  def send_command(cmd):
      s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
      try:
          s.connect(("127.0.0.1", 19999))
          s.send(cmd.encode())
          print(s.recv(1024).decode())
      except ConnectionRefusedError:
          print("error: background service is not running")
  
  if __name__ == "__main__":
      # 用argparse/click解析CLI参数，拼接为命令字符串
      cmd = " ".join(sys.argv[1:])
      send_command(cmd)
  

• 快速开发复杂命令场景：可以用HTTP接口替代原生TCP通信，后台跑一个轻量的FastAPI/Flask服务，CLI用requests发请求，参数序列化、错误处理、权限校验都可以用成熟的Web框架实现，开发效率更高，适合有大量复杂命令的场景。

实现步骤 #

1. 用argparse或者click库做命令行参数解析，判断运行模式：
   • 输入your-monitor start --config xxx时，进入后台服务模式，启动监控逻辑 + 命令监听逻辑
   • 输入your-monitor set-path /new/path、your-monitor status等命令时，进入CLI客户端模式，发送命令到后台服务并输出响应
2. 后台的命令监听逻辑用独立线程/协程运行，不要阻塞主监控的目录扫描逻辑
3. 可选加入PID文件管理：后台启动时把进程PID写入/tmp/your-monitor.pid，CLI操作前先校验PID是否存在、进程是否存活，避免无效请求。

内容的提问来源于stack exchange，提问作者sev