沙箱调研过程复盘：遇到的问题与解决方式

针对 sandbox-landscape.md 的深度解读和问题调研工作记录。

一、工具层面的问题

现象：切换到各项目目录执行 gh issue list，Firecracker、Daytona、gVisor、E2B、Kata 全部返回空输出。

原因：本地克隆的仓库没有配置 GitHub remote 的 gh 认证（本地镜像只有代码，没有 gh 的 repo 授权上下文）。CubeSandbox 因为 recently active 且可能有特定的 auth 缓存而可用。

解决方式：

现象：gh issue view 不支持非当前目录的 issue，WebFetch 抓取 GitHub issue 详情页时部分 URL 返回 404。

原因：GitHub 对未认证的 issue 详情页有限流，部分 issue 需要登录才能查看。

解决方式：

用 gh CLI 的 gh issue view <num> 在本地已克隆的项目目录下查看
对上游项目改用 gh search issues 获取列表 + gh issue view <num> --repo <owner>/<repo> 获取详情
WebFetch 主要用于抓取 issue 列表页（不需要认证）

现象：6 个项目的 gh search issues 并行执行时，部分调用返回 “Cancelled: parallel tool call errored”。

原因：系统对并行 Bash 调用有错误传播机制——一个失败会 cancel 同批次的其余调用。

解决方式：改为串行执行，每个调用独立。虽然慢一些，但更稳定。

现象：尝试用 Read 重新读取 sandbox-landscape.md 时，返回 “Wasted call — file unchanged since your last Read”。

原因：Read 工具有缓存机制，同一文件在未修改的情况下不会重复返回内容。

解决方式：用 sed / wc -l 等 Bash 命令处理文件，不依赖 Read 的缓存。

现象：sandbox-landscape.md 列出了 6 个项目，但 projects/ 目录下有 30+ 个项目（包含所有赛道的）。

原因：projects/ 是所有犀牛鸟赛道的汇总目录，sandbox 只是其中之一。

解决方式：通过项目名称精确匹配路径（CubeSandbox / daytona / E2B / firecracker / gvisor / kata-containers），忽略其他赛道的项目。

现象：E2B 的本地仓库只有 README.md / CONTRIBUTING.md / DEV.md 等文档，核心 SDK 和基础设施代码不在本地。

原因：E2B 的核心代码在 e2b-dev/infra（Terraform 部署）和 npm/PyPI 发布的 SDK 中，本地克隆的是 SDK 的说明仓库。

解决方式：在解读中明确标注”本地只有文档，核心代码在外部”，不强行解读不存在的代码结构。

现象：第一轮输出将所有 6 个项目的解读放在一次回复中，内容过长。

解决方式：用户要求”沉淀为文档”后，拆分为 7 个文件（1 个总览 + 6 个单项目），每个文件独立可读。

现象：sandbox-landscape.md 的对比表只覆盖了表面数据（启动时间、内存、语言），不包含设计哲学和竞争分析。

解决方式：

#	问题	状态	解决方向
1	gh CLI 对其他项目不可用	部分解决	需要配置 gh 认证或使用 API token
2	部分 GitHub issue 详情页需登录	未解决	可以用 gh CLI with token 解决
3	E2B 核心代码不在本地	信息缺口	需要单独 clone `e2b-dev/infra`
4	Daytona 的完整架构图没有本地文档	信息缺口	需要读取 `apps/` 子目录的代码
5	各项目的 CLAUDE.md / AGENTS.md 可能包含内部指引	未读取	按需读取