type ConversationCommandQueueItem = {
  id: string; // UUID
  input: string; // 命令文本
  files: string[]; // 附件路径
  createdAt: number; // 时间戳
};

type ConversationCommandQueueState = {
  items: ConversationCommandQueueItem[];
  isPaused: boolean; // 用户可暂停自动执行
};

shouldEnqueueConversationCommand({ enabled, isBusy, hasPendingCommands }) = enabled && (isBusy || hasPendingCommands);

flowchart TD
    A[用户输入] --> B{shouldEnqueue?}
    B -->|NO| C[executeCommand 立即执行]
    B -->|YES| D[enqueue 入队]
    D --> E[存入 sessionStorage]
    E --> F[CommandQueuePanel 渲染]
    C --> G[ipcBridge.conversation.sendMessage]
    G --> H[Backend 处理]
    H --> I[Response Stream]
    I --> J[isBusy = false]
    J --> K{队列非空 且 未暂停?}
    K -->|YES| L[dequeue 取出队首]
    L --> C
    K -->|NO| M[等待]

sequenceDiagram
    participant Q as Queue
    participant E as ExecuteCommand
    participant B as Backend

    Q->>E: dequeue → onExecute(item)
    Note over Q: waitingForTurnStart = true
    E->>B: ipcBridge.sendMessage
    Note over B: isBusy = true
    Note over Q: waitingForTurnStart = false
waitingForTurnCompletion = true
    B-->>E: response stream finish
    Note over B: isBusy = false
    Note over Q: waitingForTurnCompletion = false
    Q->>Q: 检查是否有下一条

get isConnected(): boolean {
  return this.child !== null && !this.child.killed;
}
get hasActiveSession(): boolean {
  return this.sessionId !== null;
}

stateDiagram-v2
    [*] --> DISCONNECTED

    DISCONNECTED --> CONNECTING: connect()
    CONNECTING --> INITIALIZING: spawn 成功
    INITIALIZING --> CONNECTED: initialize 响应收到
isInitialized=true
    INITIALIZING --> ERROR_STARTUP: 超时(60s) / 进程崩溃

    CONNECTED --> HAS_SESSION: newSession() / loadSession()
    HAS_SESSION --> STREAMING: sendPrompt()
    STREAMING --> HAS_SESSION: response 完成 / cancelPrompt()

    HAS_SESSION --> DISCONNECTED: disconnect() / 进程崩溃
    STREAMING --> DISCONNECTED: 进程崩溃
    CONNECTED --> DISCONNECTED: disconnect() / 进程崩溃
    ERROR_STARTUP --> DISCONNECTED: 清理完成

    DISCONNECTED --> HAS_SESSION: sendMessage() 自动重连
(connect → init → session)

    note right of STREAMING
        keepalive 间隔检查
        prompt 超时: 5 min
        permission 期间暂停超时
    end note

private isChildAlive(): boolean {
  return this.child !== null && !this.child.killed &&
         this.child.exitCode === null && this.child.signalCode === null;
}

this.sessionId = response.sessionId || sessionId;

flowchart TD
    A[sendMessage 调用] --> B{isConnected && hasActiveSession?}
    B -->|YES| C[直接发送 prompt]
    B -->|NO| D[start: connect → init → session]
    D --> E{成功?}
    E -->|YES| C
    E -->|NO| F[等待 300ms 重试一次]
    F --> G{成功?}
    G -->|YES| C
    G -->|NO| H[抛出错误]

flowchart TD
    subgraph Renderer["Renderer 进程"]
        U[用户输入] --> SB[SendBox]
        SB --> QD{Queue enabled
& busy?}
        QD -->|YES| Q[Command Queue
sessionStorage]
        QD -->|NO| EC[executeCommand]
        Q -->|auto dequeue
当 AI 空闲| EC
        EC --> IPC[ipcBridge.conversation.sendMessage]
    end

    subgraph Main["Main 进程"]
        IPC --> AG[AcpAgent.sendMessage]
        AG --> RC{isConnected?}
        RC -->|NO| ST[start: 自动重连]
        ST --> AC
        RC -->|YES| AC[AcpConnection.sendPrompt]
        AC --> CP[子进程 stdin]
        CP --> BE[Backend CLI
claude/qwen/codex...]
        BE --> RES[response stream]
        RES --> AC
        AC --> AG
        AG --> IPC2[IPC 响应]
    end

    IPC2 --> |isBusy=false| SB

    style Q fill:#ffd,stroke:#aa0
    style AC fill:#ddf,stroke:#00a