一本开源的 AgentScope Java 中文教程：7 篇 44 章、900+ 页成书体量的完整 Markdown 源稿，由浅入深覆盖从第一个 Agent 到生产级 Agent 平台的全部主题。
本书是对 AgentScope Java 官方中文文档（v2）的系统性重排与整合：按学习曲线重新组织为教程结构，每章配有场景化导读与章首导览图，全书 97 张 mermaid 架构图 / 时序图 / 部署图（GitHub 原生渲染），并对 10 家模型提供商等重复性文档做了合并精编。仅供学习与交流使用，具体声明见 NOTICE.md。
- 由浅入深的教程结构 —— 不是文档的搬运：序言给出三类读者（Java 应用开发者 / 平台建设者 / 质量与评估）的学习路线，每章有导读与前后衔接
- 97 张 mermaid 图 —— 章首导览图 + 时序图、流程图、部署图，全部可在 GitHub / VS Code / Typora 中直接渲染
- 案例驱动 —— 6 个 Service 实战案例（每个都配时序图）+ 4 个行业级案例（物流 / 金融 / AIDC / Coding Agent）
- 生产视角 —— 多副本部署、分布式存储选型、沙箱隔离、权限与人工介入（HITL）、上生产清单
- 进阶专题 —— JEV 语义判断（高频小决策的类型化处理）与 Agent 轨迹评估
每篇另有篇导读（chapters/part-1-intro.md … part-7-intro.md），概述本篇内容与阅读方式。
跨境电商 Agent 多租户平台 Demo 与第五篇（第 29–34 章）配套，提供主线 8 步与延伸 2 步，每步包含教程和 Bash 脚本。支持一键运行、断点续跑、隔离断言与可逆停用；实测范围和剩余限制见 Demo 验证记录。
环境要求：JDK 17+，Maven 3.9+，任一模型提供商的 API Key（推荐从 第 2 章 快速开始 的 DashScope 开始）。
// 10 行代码跑起第一个 Agent（详见第 2 章）
var builder = HarnessAgent.builder()
.name("notes-assistant")
.model("dashscope:qwen-plus")
.workspace(Path.of(".agentscope/workspace"));
try (var agent = builder.build()) {
agent.call(new UserMessage("你好，介绍一下你自己"), ctx).block();
}三条学习路线（完整版见序言）：
| 你是 | 建议路线 |
|---|---|
| Java 应用开发者 | 第 1-20 篇主线 → 第 22 章（RAG）→ 第 24 章（存储）→ 第 42 章（上生产） |
| 平台建设者 | 第 29-34 章（Service 平台）为主 |
| 质量与评估方向 | 第 35-38 章（JEV 语义判断） |
- GitHub 在线阅读：直接点上方目录，mermaid 图原生渲染
- 本地阅读：
git clone后用 VS Code（装 Markdown Preview Mermaid Support 插件）或 Typora 打开 - 导出 PDF：本仓库只含 Markdown 源稿。可用任意 Markdown 工具链自行导出，例如：
pandoc chapters/*.md -o book.pdf --pdf-engine=xelatex -V CJKmainfont="Microsoft YaHei"本书的 900+ 页 PDF 版本由一条 Markdown → HTML → Edge 打印的构建管线生成；如你需要该管线，欢迎提 Issue 交流。
发现错别字、内容过时、链接失效，或希望补充某章内容，欢迎提 Issue / PR：
- Fork 本仓库 → 新建分支 → 修改对应章节
- 注意保持章节 frontmatter（
chapter/title/source）与图片相对路径规范 - 提交 PR 并说明修改动机
- GitHub：github.com/ybak
- 交流群：打开小红书扫码加入「AgentScopeJava 学习群」 👇
如果这本书对你有帮助，欢迎点一个 ⭐ Star，或分享给身边正在做 Agent 开发的同学——这是我持续整理更新的最大动力。
本书基于 AgentScope Java 官方文档（Apache License 2.0）整理而成，包含大量重组与增补，非官方文档，与原项目及其维护者无隶属关系。技术内容以官方文档为准。完整的来源、许可与用途声明见 NOTICE.md。本书仅供学习与技术分享，禁止用于商业用途。