# Zleap-Agent: Workspace-first 的 Agent Harness 设计

- **来源**: Datawhale 微信公众号
- **作者**: 陈思州 (Datawhale 成员)
- **日期**: 2026-07
- **URL**: https://mp.weixin.qq.com/s/iiTmgbtrYHMMjQ7dn7CDrg
- **代码仓库**: https://github.com/Zleap-AI/Zleap-Agent

## 摘要

文章从 Agent 圈从 Prompt Engineering → Loop Engineering → Harness Engineering 的演进出发，详细剖析了开源项目 Zleap-Agent 的 Workspace-first 架构设计。核心思想：不让 Agent 每一步加载全部工具、记忆和历史，而是先切工作区、再组装上下文。文章按 Context、Tools、Memory、Runtime、Boundary 五个维度拆解了这套设计。

## 核心概念

- **Workspace-first**: 先选工作区，再组装上下文 — 不同任务应运行在不同工作区中
- **Context = System Prompt + Workspace Prompt + Tools + Memory + History**
- **Context 加载方式**: Prefetch（提前带入）vs Agentic（按需读取）
- **工具-工作区绑定**: 工具不再全局暴露，按工作区可见
- **记忆三分区**: A 线 people notes（人）→ 用户偏好；B 线 core records（事/经验）→ 工作事件+可复用经验
- **Memory Dream**: 离线记忆整理器，后台提取稳定画像和可复用经验
- **快慢召回**: prefetch(fast, 不走 LLM) + 主动 recall(slow, 精排)
- **Runtime Trace**: PostgreSQL 持久化运行轨迹，支持审计和回滚
- **多模型路由**: 不同工作区可绑定不同模型
- **边界设计**: 数据边界、工具边界、模型边界、记忆边界

## 关键摘录

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

## 引用的项目/论文

- Claude Code (Boris Cherny)
- OpenClaw (Peter Steinberger)
- Hermes Agent Channel Fracture 案例
- WildClawBench
- Agentic Harness Engineering 实验
- Terminal-Bench 2
