Skip to content

docs(task): 添加 Phase 5/6/7 多实例沙箱管理任务规划#3

Merged
Shadow-Azure merged 1 commit into
mainfrom
docs/multi-instance-plan
May 17, 2026
Merged

docs(task): 添加 Phase 5/6/7 多实例沙箱管理任务规划#3
Shadow-Azure merged 1 commit into
mainfrom
docs/multi-instance-plan

Conversation

@Shadow-Azure

Copy link
Copy Markdown
Owner

变更说明

基于用户诉求(通过 CLI 启动沙箱并在其中运行 Claude Code / cc-switch 等应用),重新设计了项目架构为多实例沙箱管理系统,并规划了后续三个 Phase 的实现任务。

核心改造方向

每个沙箱 = 独立 Tauri 窗口进程 + 内嵌 HTTP API(随机端口),通过文件系统注册中心 ~/.sandbox/instances/ 发现和管理。

目标工作流

sandbox-cli start --cli "claude"    → 打开沙箱窗口,运行 Claude Code,返回 ID
sandbox-cli list                     → 列出所有活跃沙箱
sandbox-cli screenshot <id>          → 截取沙箱截图
sandbox-cli click <id> 100 200       → 模拟点击
sandbox-cli close <id>               → 关闭沙箱

变更文件

文件 变更
CLAUDE.md 架构图 → 多实例,新增 CLI 命令/注册中心/多实例工作流
README.md 重写为 start/list/close 工作流
docs/task/README.md Phase 索引增加 Phase 5/6/7
docs/task/task_records.json 新增 21 个任务 (P5-01P5-08, P6-01P6-06, P7-01~P7-05)
docs/task/phase-5-multi-instance.md 新建:沙箱多实例管理核心改造
docs/task/phase-6-gui-support.md 新建:GUI 应用支持 + 前端集成
docs/task/phase-7-integration.md 新建:集成测试与发布

Phase 规划概要

  • Phase 5 (8 tasks): 实例注册中心、HTTP 服务器迁移到 sandbox-core、start/list/close 命令、Tauri 多实例支持
  • Phase 6 (6 tasks): PTY 终端流、macOS 应用启动关联、前端 API 集成
  • Phase 7 (5 tasks): 单元/集成测试、MCP 更新、端到端验证

关联

  • 基于 main 分支当前代码分析(Phase 0-4 已完成,底层自动化引擎全部就绪)
  • 下一步:基于此规划创建 feat/5-multi-instance 分支开始实现

- 更新 CLAUDE.md 架构图和核心接口为多实例架构
- 重写 README.md 展示 start/list/close 工作流
- 新增 phase-5-multi-instance.md: 沙箱多实例管理核心改造
- 新增 phase-6-gui-support.md: GUI 应用支持与前端集成
- 新增 phase-7-integration.md: 集成测试与发布
- 更新 task_records.json 添加 21 个新任务 (P5-01~P7-05)
- 更新 docs/task/README.md Phase 索引
@github-actions

Copy link
Copy Markdown

🔒 门禁检查结果

检查项 状态
Rust 格式化 ✅ success
Rust Clippy ✅ success
Rust 测试 ✅ success
前端构建 ✅ success
前端 Lint ✅ success
前端类型检查 ✅ success
前端测试 ✅ success
安全检查 ✅ success

Rust 测试覆盖率

⚠️ 未生成覆盖率报告

✅ 所有检查通过,可以合入

点击 Squash and merge 合并此PR

@Shadow-Azure
Shadow-Azure merged commit 92ce9d0 into main May 17, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant