HarnessAgent 学习指南
面向初级程序员的 AgentScope HarnessAgent 文档详解
HarnessAgent 是什么？
一句话：HarnessAgent 是一个让 AI Agent 能够"长期稳定运行"的工程框架。
想象你有一个 AI 助手。普通的 AI 助手就像"金鱼记忆"------关掉对话就忘了一切。
HarnessAgent 给这个助手装上了"笔记本"（记忆系统）、"身份证"（会话管理）、"工具箱"（工具系统），
让它能像真正的员工一样：记住你是谁、记得之前做了什么、知道怎么用各种工具完成任务。
核心设计思想
HarnessAgent 的设计围绕"身份持续、上下文可控、状态可恢复"三根支柱展开------详见 01-overview.md。
概念依赖关系
总览(01) → 架构(02) → 基础子系统（工作区/会话/记忆 03-05）
→ 进阶模块（文件系统/工具/技能/子代理/流式 06-10）
→ 沙箱(11) → 总结(12)推荐阅读顺序
| 顺序 | 文档 | 一句话导读 | 预计用时 |
|---|---|---|---|
| 1 | 01-overview.md | 总览全局：HarnessAgent 解决什么问题、核心能力有哪些 | 15 min |
| 2 | 02-architecture.md | 架构深潜：为什么是"薄封装"、Hook 怎么驱动一切 | 25 min |
| 3 | 03-workspace.md | 工作空间：Agent 的"办公桌"，目录结构长什么样 | 15 min |
| 4 | 04-session.md | 会话管理：怎么让 Agent 记住"上次聊到哪了" | 15 min |
| 5 | 05-memory.md | 双层记忆：日记本 + 整理笔记，让 Agent 越来越聪明 | 20 min |
| 6 | 06-filesystem.md | 文件系统：Agent 的文件存在哪------本地、远端还是沙箱 | 20 min |
| 7 | 07-tool.md | 内置工具：Agent 自带哪些"工具"可以直接用 | 10 min |
| 8 | 08-skill.md | 技能系统：给 Agent 装"插件"，从市场或工作区加载 | 15 min |
| 9 | 09-subagent.md | 子代理：让 Agent 把任务分给"下属"去做 | 25 min |
| 10 | 10-streaming.md | 流式处理：实时看到 Agent 和子代理的"思考过程" | 15 min |
| 11 | 11-sandbox.md | 沙箱：把 Agent 关在"安全笼子"里执行，隔离风险 | 30 min |
| 12 | 12-summary.md | 总结回顾：串联所有概念，形成完整知识体系 | 10 min |
总计约 3.5 小时，建议分 2-3 次完成。
关键术语速查
| 术语 | 类比 | 简要说明 |
|---|---|---|
HarnessAgent |
装了装备的 AI 员工 | 基于 ReActAgent 的工程化封装 |
ReActAgent |
裸的 AI 助手 | 只有"推理-行动"循环的基础 Agent |
Hook |
中间件/插件 | 在推理循环的关键时机插入的能力 |
RuntimeContext |
当次调用的身份证 | 包含 sessionId 和 userId |
Workspace |
办公桌 | Agent 的专属工作目录和文件 |
Memory |
日记本+笔记 | 双层记忆系统（短期+长期） |
Sandbox |
安全笼子 | 隔离的执行环境 |
📖 完整术语目录 ：GLOSSARY.md --- 收录 64 个 AI/框架术语，每个链接到首次完整解释的位置
前置知识
阅读本系列文档前，建议你了解：
- Java 基础：能看懂 Builder 模式、Lambda、Optional
- Maven 基础：知道怎么引入依赖
- AI Agent 基本概念：知道什么是 LLM、什么是 Prompt
- ReAct 模式（可选）：了解 Agent 的"推理-行动"循环
不需要了解的内容：Docker、Kubernetes、Reactive Programming（涉及时会解释）