vault backup: 2026-06-09 23:15:17

claude-code-best/docs/features/daemon.md

@@ -1,16 +1,24 @@
+---
+tags: [daemon, supervisor, 后台守护, worker, claude-code]
+create time: 2026-06-09 22:30
+---
+
 # DAEMON — 后台守护进程
 
+## 概述
+
+DAEMON 将 Claude Code 变为后台守护进程。主进程（supervisor）管理多个 worker 子进程的生命周期，通过文件系统状态文件进行通信。适用于持续运行的后台服务场景（如配合 BRIDGE_MODE 提供远程控制服务）。
+
+> [!info]
 > Feature Flag: `FEATURE_DAEMON=1`
 > 实现状态：Supervisor 和 remoteControl Worker 已实现
 > 引用数：3
 
-## 一、功能概述
+## 正文
 
-DAEMON 将 Claude Code 变为后台守护进程。主进程（supervisor）管理多个 worker 子进程的生命周期，通过文件系统状态文件进行通信。适用于持续运行的后台服务场景（如配合 BRIDGE_MODE 提供远程控制服务）。
+### 实现架构
 
-## 二、实现架构
-
-### 2.1 模块状态
+#### 模块状态
 
 | 模块 | 文件 | 状态 |
 |------|------|------|
@@ -20,9 +28,9 @@ DAEMON 将 Claude Code 变为后台守护进程。主进程（supervisor）管
 | CLI 路由 | `src/entrypoints/cli.tsx` | **布线** — `--daemon-worker` 和 `daemon` 子命令 |
 | 命令注册 | `src/commands.ts` | **布线** — DAEMON + BRIDGE_MODE 门控 |
 
-### 2.2 CLI 入口
+#### CLI 入口
 
-```
+```bash
 # 启动守护进程
 claude daemon start
 
@@ -43,30 +51,28 @@ claude daemon logs <session>
 claude daemon kill <session>
 ```
 
-### 2.3 架构
+#### 架构
 
-```
-Supervisor (daemonMain)
-      │
-      ├── Worker: remoteControl
-      │   └── runBridgeHeadless() — 远程控制 headless 模式
-      │       接收远程会话、处理消息、权限审批
-      │
-      ▼
-文件系统状态文件 (daemon-state.json)
-  - PID、CWD、启动时间、Worker 类型
-  - queryDaemonStatus() / stopDaemonByPid()
+```mermaid
+graph TD
+    A["Supervisor daemonMain"] --> B["Worker: remoteControl"]
+    B --> C["runBridgeHeadless 远程控制 headless 模式"]
+    C --> D["接收远程会话、处理消息、权限审批"]
+    A --> E["文件系统状态文件 daemon-state.json"]
+    E --> F["PID、CWD、启动时间、Worker 类型"]
+    E --> G["queryDaemonStatus / stopDaemonByPid"]
 ```
 
-### 2.4 Worker 生命周期管理
+#### Worker 生命周期管理
 
 Supervisor 为每个 worker 实现：
+
 - **指数退避重启**：初始 2s，上限 120s，倍数 ×2
 - **快速失败检测**：10s 内连续崩溃 5 次则 parking（不再重启）
 - **永久错误退出码**：78 (EXIT_CODE_PERMANENT) 导致直接 parking
 - **优雅关闭**：SIGTERM/SIGINT → abort signal → 30s 强制 SIGKILL
 
-### 2.5 与 BRIDGE_MODE 的关系
+#### 与 BRIDGE_MODE 的关系
 
 DAEMON 和 BRIDGE_MODE 常组合使用：
 
@@ -77,9 +83,10 @@ if (feature('DAEMON') && feature('BRIDGE_MODE')) {
 }
 ```
 
-双重门控：两个 feature 都需要开启才能使用远程控制服务器。
+> [!warning]
+> 双重门控：两个 feature 都需要开启才能使用远程控制服务器。
 
-## 三、关键设计决策
+### 关键设计决策
 
 1. **多进程架构**：一个 supervisor + 多个 worker，进程隔离
 2. **文件系统状态通信**：通过 `daemon-state.json` 文件进行状态共享（非 Unix 域套接字）
@@ -87,7 +94,7 @@ if (feature('DAEMON') && feature('BRIDGE_MODE')) {
 4. **CLI 子命令路由**：`daemon` 子命令和 `--daemon-worker` 参数在 `cli.tsx` 中路由
 5. **Worker 环境变量**：supervisor 通过环境变量（`DAEMON_WORKER_*`）向 worker 传递配置
 
-## 四、使用方式
+### 使用方式
 
 ```bash
 # 启用守护进程模式
@@ -106,7 +113,7 @@ claude daemon stop
 claude --daemon-worker=remoteControl
 ```
 
-## 五、文件索引
+### 文件索引
 
 | 文件 | 职责 |
 |------|------|
@@ -115,3 +122,9 @@ claude --daemon-worker=remoteControl
 | `src/daemon/state.ts` | Daemon 状态管理：PID 文件读写、状态查询 |
 | `src/entrypoints/cli.tsx` | CLI 路由 |
 | `src/commands.ts` | 命令注册（双重门控） |
+
+## 关联笔记
+
+- [[bridge-mode]]
+- [[daemon-restructure-design]]
+- [[remote-control-self-hosting]]