文章目录第一章：项目概览与技术架构1.1 项目是什么？1.2 技术栈全景1.3 系统架构图1.4 项目目录结构（最终形态）第二章：环境准备与工具安装2.1 必需软件清单2.1.1 JDK 17+2.1.2 Maven 3.8+2.1.3 Node.js 20.x + npm 10.x2.1.4 Git2.1.5 IDE 推荐2.2 获取 API Key2.3 验证环境就绪第三章：后端项目搭建（Maven + Spring Boot）3.1 创建 Maven 项目结构步骤 1：创建根目录和基础结构步骤 2：编写 `pom.xml`3.2 编写 Spring Boot 启动入口3.3 Spring Boot 配置文件第四章：核心配置系统实现4.1 配置体系设计思路4.2 根配置对象 — AgentscopeConfig4.3 Agent 配置条目 — AgentConfigEntry4.4 通道配置条目 — ChannelConfigEntry4.5 路由绑定条目 — BindingConfigEntry4.6 通道类型注册表 — ChannelTypeRegistry4.7 其他配置类速查第五章：启动引导与运行时初始化5.1 ClawBootstrap 类结构5.2 Builder 内部类（★ 关键！）第六章：会话管理系统6.1 设计理念6.2 SessionStore — 持久化层6.3 SessionAgentManager — 会话管理核心（★ 937行的核心类）6.4 SessionsTool — Agent 的会话工具第七章：网关与消息路由7.1 HarnessGateway — 消息中枢7.2 消息流转完整链路第八章：外发消息系统8.1 架构8.2 OutboundTool — Agent 侧工具8.3 OutboundController — HTTP API8.4 OutboundRequest — 请求 DTO第九章：技能市场系统9.1 架构9.2 市场接口定义9.3 Git 市场9.4 Nacos 市场9.5 市场注册表第十章：Web API 控制器层10.1 API 端点总览10.2 AgentWorkspaceController 示例（★ 最具代表性的 Controller）第十一章：AI 辅助起草服务11.1 工作原理11.2 AgentDraftService11.3 AgentDraftController11.4 Prompt 模板第十二章：前端项目搭建（React + TypeScript + Vite）12.1 创建前端项目12.2 package.json12.3 Vite 配置（★ 关键配置）12.4 TypeScript 配置12.5 HTML 入口第十三章：前端路由与应用骨架13.1 路由设计13.2 入口文件13.3 AppShell — 应用外壳13.4 AgentLayout — Agent 作用域布局第十四章：前端 API 层与数据流14.1 API 层设计原则14.2 Agent API14.3 聊天 SSE API（★ 核心中的核心）14.4 其他 API 文件速查第十五章：前端页面组件详解15.1 页面组件清单与职责15.2 核心页面示例：AgentChatPage15.3 核心组件：ChatPanel（★ 前端最复杂的组件）15.4 ToolCallBlock — 工具调用展示第十六章：通道适配器集成16.1 通道架构16.2 支持的通道类型16.3 通道配置示例16.4 钉钉接入步骤（最简单的本地调试方案）16.5 企业微信接入要点第十七章：构建配置与部署17.1 完整构建命令17.2 构建流程详解17.3 运行方式17.4 首次启动后的自动行为第十八章：测试验证指南18.1 启动验证清单18.2 聊天功能测试18.3 通道集成测试（以钉钉为例）18.4 AI 起草功能测试18.5 技能市场测试常见问题解答（FAQ）Q1: 为什么选择 Java + Spring Boot 而不是 Python？Q2: 为什么用 WebFlux 而不是传统的 Spring MVC？Q3: 会话数据为什么用 JSON 文件而不是数据库？Q4: 如何替换 LLM 模型？Q5: 钉钉通道为什么不需要公网 IP？Q6: 前端构建产物如何部署到后端？附录：完整文件清单与依赖关系图A.1 后端 Java 文件（共约 55 个）A.2 前端文件（共约 38 个）A.3 核心依赖关系图第一章：项目概览与技术架构1.1 项目是什么？AgentScope Paw是一个个人 AI 助手管理平台，你可以把它理解为一个"AI 助手操作系统"：它运行在你自己的电脑上（单用户、本地部署）你可以创建多个 AI Agent（智能体），每个有独立的角色、提示词、工作区Agent 可以通过多种渠道与你交互：Web UI、钉钉、企业微信、飞书、GitHub、GitLabAgent 具备自进化能力：学会的技能、孵化的子智能体、积累的记忆都以文件形式存在工作区中1.2 技术栈全景层级技术版本后端框架Spring Boot (WebFlux 响应式)3.x后端语言Java17+构建工具Maven3.8+
