myWiki/raw/articles/zleap-workspace-harness-2026.md

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