总览：Hexo 博客维护文档目录
Henry’s Blog - 维护文档项目信息 项目 说明 博客系统 Hexo 8.1.1 主题 Butterfly 5.5.4 网站地址 https://dhongli.cloud 仓库地址 https://github.com/Dhongli/HexoBlogDemo 部署方式 GitHub Actions → SSH Deploy 文档目录 文档 说明 01-快速入门 项目概览、目录结构、常用命令 02-文章管理 新建文章、Front-matter配置、Markdown语法 03-主题配置 Butterfly主题各项配置详解 04-部署指南 CI/CD配置、手动部署、域名配置 05-插件管理 已安装插件、安装/卸载/更新 06-自定义扩展 自定义CSS/JS、新页面、资源管理 07-常见问题 构建/部署/文章/主题问题排查 08-CSS样式自定义指南 CSS基础语法、遮罩层、日夜模式、调试技巧 09-JavaScript脚本与全局背景...
第七章：PPT Builder 智能体
07 - PPT Builder 智能体一、定位PPTBuilderAgent 是模板驱动的 PPT 生成智能体，采用状态机模式管理 PPT 从需求分析到渲染完成的完整生命周期。支持： 多种用户意图（CREATE / MODIFY / RESUME） 断点续传（任意状态中断后可恢复） AI 智能配图（自动生成幻灯片图片） 双引擎渲染（Python-pptx / PptxGenJS） 二、状态机123456789101112131415161718192021222324252627282930313233343536 ┌─────────────┐┌──────→ │ INIT │ ──意图识别│ └──────┬──────┘│ ↓│ ┌─────────────┐│ │ REQUIREMENT │ 需求澄清（可能转 FAILED）│ └──────┬──────┘│ ↓│ ┌───────...
第八章：Skills 智能体
08 - Skills 智能体一、定位SkillsReactAgent 是通用型智能体，将 Skills（技能）、搜索、文件、文件系统、Bash、Grep 多种能力按需挂载为工具，让 LLM 自动判断使用哪个工具/Skill。 二、核心特性 特性 说明 多工具融合 通过 ToolMergeUtils.mergeTools 合并所有工具 Skills 机制 加载 SKILL.md 技能文件，按需激活 上下文压缩 双层压缩（micro + auto）防止超长对话 事件流输出 Thinking/Text/ToolStart/ToolEnd/Error/Complete 6 类事件 重试机制 maxRetries 支持工具调用失败重试 三、两种 Skills 模式3.1 模式 1：Spring AI 原生（initSkillsReactAgent）通过 SkillsTool 将 Skills 注册为真实的 Tool 回调： 123456789101112131415161718192021priva...
第九章：RAG 与向量检索
09 - RAG 与向量检索一、定位EmbeddingService 是 RAG（Retrieval-Augmented Generation）的核心实现，封装了： Query 压缩重写（CompressionQueryTransformer） 多查询扩展（MultiQueryExpander） 向量检索（PgVector） 元数据过滤（fileid） 二、RAG 流水线1234567891011121314151617181920212223242526272829303132用户问题 question ↓┌───────────────────────────────────────┐│ Step 1: Query 压缩重写 ││ CompressionQueryTransformer ││ - 移除冗余/口语化表达 ││ - 保留核心语义 ││ 输出: compressed query ...
第十章：文件管理服务
10 - 文件管理服务一、模块组成文件管理涉及 3 个核心类： 类 职责 FileManageService 文件管理门面（上传、查询、删除、向量化编排） FileParserService 多格式文件解析（PDF/Word/TXT） MinioService MinIO 对象存储封装 FileContentService 对外暴露的文件加载 + RAG 工具 二、上传流程123456789101112131415161718192021222324252627282930HTTP POST /file/upload (MultipartFile) ↓FileController.uploadFile() ↓FileManageService.uploadFile(MultipartFile) ↓┌──────────────────────────────────────────────┐│ 1. 生成 fileId (UUID) + 提取 fileType ││ 2. 创建...
第十一章：会话与任务管理
11 - 会话与任务管理一、定位AgentTaskManager 是 Agent 的中介者，提供： 跨实例的任务注册 任务停止（支持 Redis Pub/Sub 跨实例广播） TTL 自动过期 并发控制（同一会话不能并发执行） 二、核心设计：Redis Pub/Sub 跨实例协调123456789101112131415161718Instance A Instance B │ │ ├─ registerTask (本地 Map) ──→│ │ │ │ 业务执行中... │ │ │ ├─ 收到 stop 请求 ───────────→│ │ 1. 检查本地 Map │ │ 2. 没有 → 检查 Redis │ │ 3. Re...
第十四章：配置与基础设施
14 - 配置与基础设施一、配置文件主配置文件：src/main/resources/application.yml 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687server: port: 9999 servlet: encoding: charset: UTF-8 force: true enabled: truespring: ai: openai: api-key: @dashscope.api.key@ base-url: https://dashscope.aliyuncs.com/compatible-mode/ chat: options: model: qwen-plus ...
第十五章：数据模型
15 - 数据模型一、Entity 持久化对象1.1 AiSession（会话表）entity/AiSession.java → ai_session 字段 类型 字段名 说明 id Long id 主键（ASSIGN_ID） sessionId String session_id 会话业务 ID agentType String agent_type websearch/file/pptx/plan-execute/skills question String question 用户问题 answer String answer AI 回复 tools String tools 使用的工具（逗号分隔） reference String reference 参考链接 JSON firstResponseTime Long first_response_time 首字响应时间（ms） totalResponseTime Long total_response_time 总响应时间（ms） cre...
总览：DodoAgent 前端技术文档总览
dodo-agent 前端技术文档 面向读者：HTML/CSS/JS 有基础、React 新手的前端小白目标：从「能看懂项目代码」到「能动手修改/添加功能」项目代号：豆豆 — 一个多 Agent AI 聊天界面 🆕 项目最新特性（重要！先看这里）1. 6 套主题系统（暗色 3 + 亮色 3）通过侧边栏底部「主题设置」按钮切换，状态持久化到 localStorage： ID 名称 风格 背景 主色 ink 墨韵东方 暗 #0e0d0b 浓墨 #c9a36b 古铜金 minimal 极简留白 暗 #0a0a0a 纯黑 #c8553d 朱砂 forest 森绿雅静 暗 #0f1611 深林 #8ba67b 苔藓 paper 素雅米黄 亮 #f5f0e6 宣纸 #a07a3e 古铜金 cream 乳白简约 亮 #fafaf7 乳白 #3a4a6b 靛蓝 matcha 抹茶清新 亮 #e8e6d8 抹茶绿 #5a6b3e 抹茶深绿 主题切换原理：document.documentElement.setAttribute...
第十三章：工具集
13 - 工具集一、工具总览tool/ 目录包含 Dodo-Agent 的所有内置工具： 工具 类 用途 Agent loadContent FileContentService 文件加载 + RAG File / Skills Skill SkillsTool 加载技能 Skills (原生) read_skill ReadSkillTool 读取技能内容 Skills (手动) read_file / write_file / edit_file FileSystemTools 文件系统操作 Skills list_files / glob_files FileSystemTools 文件查找 Skills grep GrepTool 内容搜索 Skills bash BashTool Shell 命令执行 Skills WeatherService WeatherService 天气查询 Demo / 自定义 二、FileContentServicetool/FileContent...
