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