---
title: "Workspace-first 架构"
created: 2026-07-03
updated: 2026-07-03
type: concept
tags: ["agent", "harness", "workspace", "context-management"]
sources: ["https://mp.weixin.qq.com/s/iiTmgbtrYHMMjQ7dn7CDrg"]
---

# Workspace-first 架构

> 先选工作区，再组装上下文——不让 Agent 每一步都加载全部工具、记忆和历史。

## 核心定义

**Workspace-first** 是 [[zleap-workspace-harness-2026|Zleap-Agent]] 提出的 Agent Harness 设计范式。它不先问"Agent 能接多少工具"，而是先问"当前任务应该发生在哪个工作区"。Agent 的运行环境被切分为多个独立工作区，每个工作区有自己的 prompt、tools、memory、history、model 和 permission。

## 与子 Agent 的区别

| 维度 | 子 Agent | Workspace |
|------|---------|-----------|
| 角色 | 临时找另一个人帮忙 | 同一个人切换工作台 |
| 上下文 | 独立角色和上下文 | 人能延续，但工具/资料/权限变了 |
| 结果 | 做完后交回结果 | 持续在当前环境中工作 |

## 工作区类型

- **Main Workspace**: 调度台——理解用户目标、判断任务应进哪个工作区
- **CLI Workspace**: 文件读写、代码编辑、命令执行、测试
- **Web Search Workspace**: 搜索、网页阅读、引用整理
- **业务 Workspace**: 销售、财务、运营、研究等具体场景

## 核心价值

1. **上下文减负**：每轮只加载当前工作区的内容，而非全局加载
2. **工具收敛**：按工作区暴露工具，降低 tool schema 成本和误调用概率
3. **记忆隔离**：不同工作区的记忆分开管理，降低跨任务污染风险
4. **模型路由**：不同工作区可绑定不同模型，兼顾成本/延迟/安全

## 与 Harness Engineering 的关系

[[harness-engineering|Harness Engineering]] 关注为 Agent 构建约束层，而 Workspace-first 是 Harness Engineering 在上下文和工具维度的一种具体落地策略。它和 [[agent-harness-engineering|Agent Harness 七维度框架]] 中的上下文管理和工具接入直接对应。

## 关键洞察

> 模型层做稀疏注意力，是为了让模型不要看所有 token；Harness 层做 Workspace，是为了让 Agent 不要加载所有上下文。

## 与 Agent 工作空间文件系统的关系

[[agent-workspace-filesystem|Agent 工作空间文件系统]] 和 Workspace-first 是互补的设计方向：
- Workspace-first 侧重**工作区隔离**（不同的 prompt/tools/memory/model per workspace）
- Agent 工作空间文件系统侧重**接口形态**（类 POSIX 语义让 Agent 以 ls/grep/read 模式工作）
- 二者共同指向一个趋势：Agent 接口和运行环境的设计不再是事后附加，而是核心的性能杠杆

## 参考

- [[zleap-workspace-harness-2026|Zleap-Agent：Workspace-first 的 Agent Harness 设计]]
- [[agent-workspace-filesystem|Agent 工作空间文件系统]]
- [[agents-want-filesystems-nokv-2026|Agents Want Filesystems (新智元)]]
- [[harness-engineering|Harness Engineering]]
- [[loop-engineering|Loop Engineering]]
- [[context-management|上下文管理]]
