若依微服务 深入学习：认证授权体系
2026-06-22 4.6k 字 18 分钟

若依微服务 深入学习：认证授权体系

认证授权体系1. 模块概述RuoYi-Cloud 的认证授权体系是整个系统的 安全中枢，横跨多个模块： ruoyi-auth：登录、注册、Token 签发 ruoyi-gateway：入口鉴权（AuthFilter） ruoyi-common-security：权限校验引擎（AuthLogic）、AOP 切面（PreAuthorizeAspect）、Token 管理（TokenService） ruoyi-common-core：JWT 工具（JwtUtils）、安全常量 核心设计理念：JWT 负责无状态传递，Redis 负责有状态管理。JWT 中只存储最小必要的身份标识（user_key
若依微服务 深入学习：微服务架构与基础设施
2026-06-22 3.4k 字 13 分钟

若依微服务 深入学习：微服务架构与基础设施

微服务架构与基础设施1. 模块概述本章解析 RuoYi-Cloud 的 微服务整体架构，包括项目模块划分、服务注册与发现、配置中心、服务调用、熔断降级和监控体系。 模块全景1234567891011121314151617181920212223ruoyi-cloud (父工程)├── ruoyi-gateway # 网关服务（Spring Cloud Gateway）├── ruoyi-auth # 认证服务（登录/注册/Token管理）├── ruoyi-modules/│ ├── ruoyi-system # 系统管理（用户/角色
nanobot 深入学习：参考资料索引
2026-06-19 1.2k 字 5 分钟

nanobot 深入学习：参考资料索引

官方文档 文档 位置 说明 README nanobot/README.md 项目概览、安装、快速开始 Architecture nanobot/docs/architecture.md 架构设计文档 Concepts nanobot/docs/concepts.md 核心概念说明 Configuration nanobot/docs/configuration.md 配置参考 Development nanobot/docs/development.md 开发指南 Deployment nanobot/docs/deployment.md 部署指南 Quic
nanobot 深入学习：配置系统与安全边界
2026-06-19 1.5k 字 6 分钟

nanobot 深入学习：配置系统与安全边界

1. 模块概述本章涵盖两个基础设施模块： **Config 系统**（nanobot/config/）：基于 Pydantic v2 的配置管理，支持 JSON 配置文件、环境变量覆盖和 camelCase 别名 **Security 系统**（nanobot/security/）：SSRF 防护、工作区访问控制和网络安全策略 1.1 Config 系统架构graph TB subgraph "配置来源" JSON["~/.nanobot/config.json"] ENV["环境变量覆盖"] end subgraph "Confi
nanobot 深入学习：上下文构建与技能加载
2026-06-19 2.2k 字 9 分钟

nanobot 深入学习：上下文构建与技能加载

1. 模块概述ContextBuilder（nanobot/agent/context.py）负责为每次 LLM 调用构建完整的消息列表——包括系统提示（身份、记忆、技能）和用户消息（含运行时上下文、媒体附件）。 📍 源码：nanobot/nanobot/agent/context.py#L1-L281 1.1 系统提示的组成部分123456789101112131415161718┌──────────────────────────────────────┐│ 1. Identity (身份 + 运行时环境) │├─────────────────────────────
nanobot 深入学习：会话管理与历史回放
2026-06-19 2.2k 字 9 分钟

nanobot 深入学习：会话管理与历史回放

1. 模块概述Session 管理（nanobot/session/manager.py）负责会话的持久化、加载和历史回放。核心数据结构是 Session，由 SessionManager 管理其生命周期。 📍 源码：nanobot/nanobot/session/manager.py#L1-L876 1.1 会话文件格式会话存储为 JSONL 文件（sessions/<safe_key>.jsonl），第一行是元数据记录： 123{"_type":"metadata","key":"telegr
nanobot 深入学习：记忆存储与 Dream 巩固
2026-06-19 2.6k 字 10 分钟

nanobot 深入学习：记忆存储与 Dream 巩固

1. 模块概述记忆系统（nanobot/agent/memory.py）由两个核心类组成： **MemoryStore**：纯文件 I/O 层，管理 MEMORY.md、history.jsonl、SOUL.md、USER.md 的读写 **Consolidator**：基于 Token 预算的对话历史自动摘要引擎 📍 源码：nanobot/nanobot/agent/memory.py#L1-L1050 1.1 记忆文件体系 文件 用途 写入方式 memory/MEMORY.md 长期记忆（事实、偏好） Dream 巩固自动更新 memory/history
nanobot 深入学习：工具系统
2026-06-19 3k 字 12 分钟

nanobot 深入学习：工具系统

1. 模块概述工具系统（nanobot/agent/tools/）是 Agent 能力的核心。通过 Tool 抽象基类和 ToolRegistry 注册表，实现工具的自动发现、参数验证、并发执行和安全管理。 📍 核心源码：nanobot/nanobot/agent/tools/base.py#L1-L297、nanobot/nanobot/agent/tools/registry.py#L1-L183 1.1 内置工具一览 工具 模块 类型 说明 read_file filesystem.py 只读 读取文件内容 write_file filesystem.py 读写 写入
nanobot 深入学习：多渠道接入架构
2026-06-19 2.3k 字 9 分钟

nanobot 深入学习：多渠道接入架构

1. 模块概述Channel 系统（nanobot/channels/）通过抽象基类 BaseChannel 统一了 15+ 聊天平台的集成接口，由 ChannelManager 协调启动、停止和消息路由。 📍 核心源码：nanobot/nanobot/channels/base.py#L1-L257、nanobot/nanobot/channels/manager.py#L1-L490 1.1 支持的渠道 渠道 模块 流式支持 Telegram telegram.py ✅ (delta) Discord discord.py ✅ Slack slack.py ✅
nanobot 深入学习：LLM Provider 系统
2026-06-19 2.5k 字 10 分钟

nanobot 深入学习：LLM Provider 系统

1. 模块概述Provider 系统（nanobot/providers/）通过抽象基类 LLMProvider 统一了不同 AI 服务商的调用接口，提供智能重试、流式输出、错误分类和 fallback 回退等能力。 📍 核心源码：nanobot/nanobot/providers/base.py#L1-L965 1.1 支持的 Provider Provider 模块 特点 Anthropic anthropic_provider.py 扩展思考、提示缓存、工具使用 OpenAI Compatible openai_compat_provider.py 通用 OpenAI