⚠️ SUPERSEDED / 历史快照（HISTORICAL SNAPSHOT） — 标注追加于 2026-09-24（任务 #122，承接 #109 审计；正文未改写）

本报告是 2026-09-04 当时状态 的只读快照。其中出现的下列称谓/结论可能已过时，请勿据此判断当前实现： - 旧品牌 serverless-sandbox / 旧 CLI sbox → 现为 agent-sandbox / abx，见 ADR 2026-09-09-brand-rename-sbox-to-abx.md。 - 自此已删除的 CLI 命令组（auth/session/secret/skill），见 ADR 2026-09-23-cli-command-reduction.md。 - 自此已移除的旧架构（integrations 集成层 / 能力门控 / 序列化 / keychain），见 ADR 2026-09-23-overdesign-cleanup.md。

当前权威说明以 AGENTS.md 与 docs/ 为准。

qwencli 融入状态 + .agents/design 文档沉淀审计

日期: 2026-09-04 | 任务: #104 | 性质: 只读审计，未修改任何产品代码

Q2: qwencli 是否已融入本项目？

2.1 全局搜索 "qwen" 命中盘点

2.2 会话转录搜索

$ rg -i "qwen" <agent-cache>/projects/<project>/conversation-history/628457aa/628457aa.jsonl
(零命中)

$ rg -i "qwen" .../6e51593d/6e51593d.jsonl
(零命中)

$ rg -i "qwen" .../9620c890/9620c890.jsonl
(零命中)

结论：三个会话转录中 "qwen" 零命中。"融入 qwencli" 从未在可追溯的会话中被用户明确提出或决策。

2.3 设计文档 vs 实际代码的断层

docs/design/built-in-agents.md:212-229 描述了一个 _build_command 方法：

def _build_command(self, action, task, context=None):
    template = self._sandbox._template_name
    if template.startswith("codex"):
        return f"codex {safe_task}"
    elif template.startswith("qwen-"):
        return f"qwen-cli {action} {safe_task}"   # ← 设计愿景

但 src/serverless_sandbox/agent/builtin.py 的实际代码（131 行全文）： - 没有 _build_command 方法 - 没有 _template_name 属性引用 - 没有 任何 qwen-cli 字符串 - browse() 实现为 commands.run(f"curl -sL {url}")（:74） - analyze() 实现为 commands.run("python -m py_compile ...")（:91） - shell() 实现为直接 commands.run(command)（:62）

同时，examples/templates/qwen-code/Dockerfile（52 行全文）： - 安装的是 dashscope、openai、httpx、rich（Python 包） - 没有 npm install -g qwen-cli 或任何 qwen-cli 二进制安装 - 模板的 custom_commands 只有 run: cmd: "python3 {script}"（通用 Python 执行器）

2.4 诚实结论

2.5 最小融入路径（若决定做）

前置阻塞：步骤 1 是硬阻塞 —— 项目中从未定义 "qwen-cli" 是什么工具、从哪安装、其命令接口是什么。设计文档只写了 qwen-cli browse / qwen-cli analyze 但没有给出工具来源。

Q3: 近期设计决策是否都沉淀进 .agents / design 文档？

3.0 .agents/notes/ 目录结构盘点

.agents/notes/
├── implemented/
│   ├── architecture/ (11 files)
│   │   ├── 2026-09-02-agent-as-cli-wrapper.md
│   │   ├── 2026-09-02-dual-auth-mode.md
│   │   ├── 2026-09-02-sbox-cli-naming.md
│   │   ├── 2026-09-02-self-implement-e2b-protocol.md
│   │   ├── 2026-09-02-session-pluggable-storage.md
│   │   ├── 2026-09-02-snapshot-hibernate-deferred.md
│   │   ├── 2026-09-03-capability-model.md
│   │   ├── 2026-09-03-cli-run-vs-exec.md
│   │   ├── 2026-09-03-command-source-resolution.md
│   │   ├── 2026-09-03-no-backward-compat-capability.md
│   │   └── 2026-09-03-sdk-capability-surface.md
│   ├── feature/ (2 files + .gitkeep)
│   │   ├── 2026-09-03-custom-commands-schema.md
│   │   └── 2026-09-03-minimal-template-repo.md
│   └── process/ (.gitkeep only)
├── proposed/
│   ├── architecture/ (.gitkeep only — 空)
│   ├── feature/ (15 files — 模块级实现提案)
│   └── process/ (1 file)
│       └── 2026-09-03-release-publish-flow.md
└── rejected/ (1 file + .gitkeep)
    └── 2026-09-03-capability-model-alternatives.md

3.1 逐项核对

决策 1: envd 两层容器服务模型

内容：平台注入 envd + 用户 server 基于 envd 而非替代；SDK 不 ship 兜底 in-container agent

决策 2: @sandbox.register 源码投递执行 + 函数名→命令名 + 参数类型限 str/int/float/bool

决策 3: Discovery API 设计

内容：Sandbox.list_commands 现状、Layer1 本地静态发现 vs Layer2 server 远程发现、鉴权应复用 AuthProvider.get_headers/EnvdTokenManager.get_headers 而非 api/network.py 的 get_access_headers

决策 4: 单仓库单发行 + [cli] extra 决策

内容：不拆两个库、暂不做二进制

决策 5: template 命令批评（list/delete/cache 假设了不存在的中央 registry）

决策 6: PyPI 打包决策

内容：发行名 serverless-sandbox、缺 py.typed、缺 CI workflow、[project.urls] 占位符

决策 7: O5/O7 开放决策

O5：平台 TemplateInfo 是否承载 custom_commands O7：@sandbox.register 命名冲突

3.2 ADR/issue 编号在 .agents/notes/** front-matter 的命中情况

$ rg -i "#\d+|issue.*\d+|Issue:" .agents/notes/
(零命中)

确认：.agents/notes/ 的所有 ADR 文件中，没有任何 issue 编号（#76/#83/#85/#87/#94 等）。** ADR front-matter 只有 Status: implemented/proposed/rejected，没有 Issue: #NN 字段。 issue ↔ ADR 的映射只存在于 git log / 工单系统，不在 ADR 文件内。

这与 container-serve-boundary.md §8 D8 的发现一致。

3.3 汇总表

附录：证据索引

报告结束。全文为只读审计产物，未修改任何产品代码或现有文档。