mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-17 13:55:50 +00:00
637c9081f6
Squashed merge of: 1. fix/mcp-tsc-errors — 修复上游 MCP 重构后的 tsc 错误和测试失败 2. feat/pipe-mute-disconnect — Pipe IPC 逻辑断开、/lang 命令、mute 状态机 3. feat/stub-recovery-all — 实现全部 stub 恢复 (task 001-012) 4. feat/kairos-activation — KAIROS 激活解除阻塞 + 工具实现 5. codex/openclaw-autonomy-pr — 自治权限系统、运行记录、managed flows Additional: 6. daemon/job 命令层级化重构 (subcommand 架构) 7. 跨平台后台引擎抽象 (detached/tmux engines) 8. 修复 src/ 中 43 个预存在的 TypeScript 类型错误 9. 修复 langfuse isolated test mock 完整性 10. 修复 CodeRabbit 审查的 Critical/Major/Minor 问题 11. remote-control-server logger 抽象 (测试 stderr 静默化) 12. /simplify 审查修复 (代码复用、质量、效率)
78 lines
2.0 KiB
Markdown
78 lines
2.0 KiB
Markdown
# Task 001: daemon status / stop
|
||
|
||
> 来源: [stub-recovery-design-1-4.md](../features/stub-recovery-design-1-4.md) 第 1 项
|
||
> 优先级: P0 (首选实现项)
|
||
> 工作量: 小
|
||
> 状态: DONE
|
||
|
||
## 目标
|
||
|
||
让 `claude daemon status` 和 `claude daemon stop` 在任意 CLI 进程中都能正确工作，不依赖 TUI 内存态。
|
||
|
||
## 背景
|
||
|
||
- `start` 路径已有完整 supervisor + worker 生命周期 (`src/daemon/main.ts`, `src/daemon/workerRegistry.ts`)
|
||
- `status` / `stop` 目前只是占位输出 (`src/daemon/main.ts:49`)
|
||
- `/remote-control-server` 有自己的命令内 UI 状态，但只维护当前进程内的 `daemonProcess`，不适合跨进程管理
|
||
|
||
## 实现方案
|
||
|
||
### 新增文件
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `src/daemon/state.ts` | daemon 状态文件读写模块 |
|
||
|
||
### 修改文件
|
||
|
||
| 文件 | 改动 |
|
||
|------|------|
|
||
| `src/daemon/main.ts` | `start` 写入状态文件；`status`/`stop` 调用 state 模块 |
|
||
| `src/commands/remoteControlServer/remoteControlServer.tsx` | 读取同一份状态文件（轻量改动） |
|
||
|
||
### 状态文件
|
||
|
||
路径: `~/.claude/daemon/remote-control.json`
|
||
|
||
```json
|
||
{
|
||
"pid": 12345,
|
||
"cwd": "/path/to/project",
|
||
"startedAt": "2026-04-12T10:00:00Z",
|
||
"workerKinds": ["bridge", "rcs"],
|
||
"lastStatus": "running"
|
||
}
|
||
```
|
||
|
||
### status 逻辑
|
||
|
||
1. 读取状态文件
|
||
2. 用进程探测验证 pid 是否存活
|
||
3. 输出 `running` / `stopped` / `stale`
|
||
4. stale 时自动清理状态文件
|
||
|
||
### stop 逻辑
|
||
|
||
1. 读取 pid
|
||
2. 发送 `SIGTERM`
|
||
3. 等待退出（超时兜底）
|
||
4. 超时后 `SIGKILL`
|
||
5. 清理状态文件
|
||
|
||
## 验证步骤
|
||
|
||
- [ ] `claude daemon start` 正常启动并写入状态文件
|
||
- [ ] 新开终端执行 `claude daemon status`，显示 `running`
|
||
- [ ] 执行 `claude daemon stop`，daemon 正常退出
|
||
- [ ] 再次执行 `claude daemon status`，返回 `stopped` 或 `stale cleaned`
|
||
- [ ] Windows 下 stop 超时兜底正常工作
|
||
|
||
## 风险
|
||
|
||
- Windows 信号模型和 Unix 不同，`stop` 需要超时兜底
|
||
- 当前设计默认单 supervisor，不处理多实例并发
|
||
|
||
## 依赖
|
||
|
||
无外部依赖，可独立实施。
|