自定义博客皮肤VIP专享

*博客头图:

格式为PNG、JPG,宽度*高度大于1920*100像素,不超过2MB,主视觉建议放在右侧,请参照线上博客头图

请上传大于1920*100像素的图片!

博客底图:

图片格式为PNG、JPG,不超过1MB,可上下左右平铺至整个背景

栏目图:

图片格式为PNG、JPG,图片宽度*高度为300*38像素,不超过0.5MB

主标题颜色:

RGB颜色,例如:#AFAFAF

Hover:

RGB颜色,例如:#AFAFAF

副标题颜色:

RGB颜色,例如:#AFAFAF

自定义博客皮肤

-+
  • 博客(37)
  • 资源 (3)
  • 收藏
  • 关注

原创 若依(RuoYi)框架 MySQL 切 PostgreSQL 完整迁移指南(实战踩坑版)

将若依(RuoYi-Vue)从MySQL切换至PostgreSQL,需完成六大改造:①引入PG驱动并配置数据源;②修改建表脚本,替换自增、类型、注释等语法;③Mapper XML中替换sysdate()、find_in_set等函数;④适配代码生成器,重写元数据查询逻辑;⑤修复Java代码中的字符串拼接与类型转换问题;⑥关键参数stringtype=unspecified避免类型推断错误。重点解决boolean字段兼容性及find_in_set替代方案,确保一次成功切换。

2026-09-22 16:26:07 285

原创 第 30 章《Python SDK + OpenAI 兼容 API + 最佳实践》· nanobot SDK + OpenAI 兼容 API 源码解析:Nanobot 门面 + /v1/chat/co

本章解析 nanobot 的 Nanobot 门面类与 OpenAI 兼容 HTTP API,实现双入口集成:通过 Nanobot.from_config() 支持 Python 调用,或通过 /v1/chat/completions 端点支持任意语言客户端。两者共享同一 AgentLoop 核心,提供流式事件(如 reasoning_delta、tool_started)与完整 SDK 接口。部署后可用 curl 或 OpenAI SDK 直接调用本地实例,实现无缝对接。

2026-09-11 13:52:16 241

原创 第 29 章《安全策略》· 安全策略常见误区 4 个:workspace_policy + network + pairing 避坑(nanobot)

nanobot 采用三层安全防护:workspace_policy防路径穿越,限定操作范围;network_allowlist限制网络访问,仅允许可信域名;pairing配对码确保用户身份可信。默认严格,禁止未授权访问。常见误区包括关闭配对、使用软链绕过、开放全部网络及自动启用危险工具。建议配置白名单、禁用软链、启用审计日志,并通过WebUI密码增强防护。

2026-09-11 13:50:44 313

原创 第 28 章《关键工具链》· 关键工具链怎么做?MCP / Shell / Web / Cron / Long-task 全景实战(nanobot)

本文剖析 nanobot 中5个核心工具(MCP、Shell、Web、Cron、Long-task)的源码实现与实战坑点。MCP 通过 stdio 连接 Claude 兼容服务,注意子进程僵尸处理;Shell 工具限制工作目录与输出长度,防安全风险;Web 工具用 httpx + trafilatura 提升抓取质量;Cron 借 croniter 实现调度;Long-task 独立为异步任务,支持进度回调,避免阻塞主线程。关键在于:长任务需独立执行以保障系统稳定性。

2026-09-11 13:48:52 224

原创 第 27 章《ToolLoader 自发现 + entry_points》· 3 步发布自定义工具:Tool 子类 + entry_points + 作用域标签(nanobot)

本文详解 nanobot 如何通过 ToolLoader 自动发现23个内置工具及第三方工具包。开发者只需三步:实现 Tool 子类、编写 ToolSpec、在 pyproject.toml 中声明 entry_points,即可发布自定义工具至 PyPI。核心机制基于 pkgutil 扫描内置模块与 importlib.metadata.entry_points 检测第三方扩展,支持热加载与运行时启用/禁用。附常见误区解答,助力开发者高效集成自定义工具。

2026-09-11 13:47:34 52

原创 第 26 章《Tool 抽象与 ToolRegistry》· nanobot Tool 抽象源码深度解析:ToolResult + ContextAware + 作用域过滤

本文详解 nanobot 中 Tool 的抽象设计:通过 Tool 抽象类统一接口,定义 name、description、parameters_schema 和 execute;ToolResult 返回内容、错误状态及附件;ToolRegistry 实现自动发现与注册;作用域(read/write/network/dangerous)在执行时校验,保障安全。开发者可按规范自定义工具,如天气查询,实现安全可控的 Agent 扩展。

2026-09-11 13:46:07 550

原创 第 25 章《Feishu / Weixin 复杂通道解析》· 复杂 IM 通道怎么做?Feishu 流式卡片 + Weixin 扫码登录实战(nanobot)

<think>我们根据要求需要生成一个不超过150字的文章摘要。摘要应该概括文章回答的问题、目标读者、核心内容要点等。注意要简洁。</think>本文剖析 Feishu/Weixin 两大复杂 IM 通道的5项独有挑战:Feishu 长连接、富文本卡片、流式卡片增量更新、交互回调与多租户;Weixin 扫码登录、API 不稳定、限流、不支持流式及文件处理。对比 Telegram 阐明架构差异,适合深入复杂 IM 平台的开发者快速掌握关键实现。

2026-09-07 14:10:05 339

原创 第 24 章《WebSocket 通道》· nanobot WebSocket 通道源码深度解析:多路复用 + 重连空闲 + 媒体接入

<think>我们只需要根据用户提供的内容生成摘要,不超过150字。内容是关于WebSocket通道与Telegram通道的区别,WebUI用WebSocket的原因,多路复用和断线重连的实现。目标读者是开发者。摘要应简洁概括核心要点。</think>本文对比nanobot的WebSocket与Telegram通道,说明WebUI采用WebSocket实现毫秒级双向通信;通过连接字典支持多路复用,自动断线重连,并介绍协议与客户端实现。

2026-09-07 14:08:59 242

原创 第 23 章《通道自发现与配对》· 3 步自研聊天通道:manifest.py + pkgutil + pairing 配对码(nanobot)

<think>我们需要根据用户要求生成一个不超过150字的文章摘要。用户提供的内容是关于nanobot通道自发现机制和配对码的说明。摘要应该简洁地概括文章要点:自发现机制使用pkgutil.iter_modules和manifest.py,配对码是6位数字5分钟过期,第三方通道通过entry_points扩展。目标读者是聊天通道开发者和工程师。我们需要控制字数在150字以内。 首先,提取关键点: 文章回答:nanobot如何自动发现17个通道,manifest.py内容,配对码工作方式,第三方通道添加方法。

2026-09-07 14:07:49 199

原创 第 22 章《BaseChannel 抽象与 ChannelManager》· 聊天通道怎么做?BaseChannel + 17 内置通道自发现实战(nanobot)

你的启动逻辑pass# 你的发送逻辑passpass无需注册——自动发现。

2026-09-04 16:44:05 243

原创 第 21 章《图像生成与音频转录》· nanobot 多模态 Provider 源码解析:11 图像 + 6 转录注册表

<think>我们只需要根据提供的技术文档内容生成摘要,不超过150字。摘要应概括主要观点:多模态作为独立Provider接口,图像生成和音频转录独立于LLM,注册表支持11+6后端,Tool通过注册表调用,并提供自定义扩展。语言简洁。</think>nanobot将图像生成与音频转录设计为独立的多模态Provider接口,与LLM Provider并列,避免接口膨胀。内置11个图像后端和6个转录后端,通过注册表管理,Tool可调用image/audio工具完成多模态任务。开发者可自定义后端并注册,配置简便

2026-09-04 16:42:51 314

原创 第 20 章《FallbackProvider 兜底与重试》· 直连 Provider vs FallbackProvider:从 nanobot 源码看兜底路由

<think>我们根据要求,生成≤150字的摘要。摘要应基于给出的内容,概括主要要点。注意字数限制。</think>本文解析 nanobot FallbackProvider:主 Provider 因限流、故障或下架失败时,自动沿 fallback 链切换;采用指数退避重试(3次)与熔断器(5 分钟内 3 次失败禁用 5 分钟)。阐述 3 层重试、熔断机制、配置文件与监控钩子,并警示链长度、阈值及输出差异等误区,为系统稳定性提供核心容错方案。

2026-09-04 16:41:46 391

原创 第 19 章《Anthropic / OpenAI 兼容实现对比》· 3 步接入自定义 LLM:OpenAI 兼容 + Anthropic 原生 + 自定义 backend(nanobot)

<think>我们只需要输出≤150字的文章摘要。需要从内容概括,突出回答的问题和关键要点。忽略代码,只做摘要。字数严格限制。写中文。主要信息:比较Anthropic、OpenAI兼容和Bedrock三类Provider的坑,OpenAI兼容覆盖大部分第三方,Anthropic原生SDK用法,常见坑。</think>本文对比Anthropic、OpenAI兼容、Bedrock三类Provider的实现差异,指出OpenAI兼容协议覆盖80%第三方模型,仅需改base_url;详解Anthropic原生SDK

2026-09-03 11:09:09 279

原创 第 18 章《Provider 注册表与 factory》· nanobot Provider 工厂源码解析:ProviderSpec + 三层校验 + 动态 spec

<think>我们需要根据提供的文章内容生成一篇不超过150字的摘要。文章本身是技术文章,讲述nanobot如何注册8个Provider、ProviderSpec是什么、三层校验、动态加载第三方Provider。摘要需要精炼,突出核心点。 用户要求:根据以下内容,生成≤150字的文章摘要。目标读者是LLM Provider适配者/想加自定义Provider的工程师。 我们需提取关键信息: 文章回答nanobot注册8个Provider的过程,涉及ProviderSpec和ProviderFactory。 三

2026-09-03 11:00:09 210

原创 第 17 章《LLMProvider 抽象》· LLMProvider 抽象怎么做?ToolCallRequest + LLMResponse 双层契约(nanobot)

<think>我们根据内容生成摘要。要≤150字,涵盖核心:LLMProvider抽象、双层契约(chat接口+数据类)、8后端统一、ToolCallRequest和LLMResponse定义。语言简洁。</think>本文解答nanobot如何抽象LLM Provider:通过LLMProvider基类定义统一chat()接口,并以LLMResponse和ToolCallRequest数据类规范化输出,使AgentRunner无需关心8个后端差异。适合适配者阅读,核心代码约200行,包含ABC方法及数据类

2026-09-03 10:58:02 290

原创 第 16 章《自动压缩 AutoCompact》· 3 步实现 AutoCompact:token 阈值 + TTL + 回合续传实战(nanobot)

本文介绍了AutoCompact模块如何解决长会话超过LLM token限制的问题,适用于LLM Agent开发者。主要内容包括: 核心功能:当会话token超过阈值(默认80%模型上限)时,自动将旧消息压缩为200-500 tokens的摘要,保留最近20条消息,确保后续调用不超限。 三步实现: 触发检测:检查token数是否超过阈值 摘要生成:用LLM压缩旧消息为Markdown格式 回合续传:生成包含摘要和最近消息的续传spec 关键设计决策: 保留20条消息平衡上下文与压缩效果 使用LLM而非截断以

2026-08-14 10:19:57 169

原创 第 15 章《记忆与 Dream 整合》· nanobot Dream 记忆整合源码深度解析:真实 git diff 当 commit message

本文介绍了nanobot项目中从消息流提取长期记忆的机制设计,主要包含以下核心内容: 整体架构:通过MemoryStore+Consolidator实现消息流提炼,存储在MEMORY.md文件中,支持跨会话共享记忆。 关键设计: Dream后台任务每30分钟自动运行,调用LLM从最新500条消息中提取5-10条关键事实 采用真实git diff作为commit message的创新设计,增强可审计性 原子化写入和异步锁保障并发安全 特色实现: 全局和workspace级双层记忆存储 通过git进行版本管理

2026-08-14 10:18:33 439

原创 第 14 章《会话管理 SessionManager》· 会话管理怎么做?SessionManager 原子写 + fsync 持久化实战(nanobot)

本文介绍了SessionManager如何用JSONL格式原子化存储LLM会话消息,并解析关键技术决策。关键点包括:1) 采用JSONL实现易读/回放/压缩;2) 通过临时文件+fsync+原子替换确保消息不丢;3) 优化设计包括反向扫描最近消息、会话别名机制;4) 存储路径为~/.nanobot/sessions/<key>.jsonl。文章还解答了断电恢复、文件压缩等实践问题,适合LLM Agent开发者理解持久化核心机制。(149字)

2026-08-14 10:17:23 354

原创 第 13 章《Hook 系统》· Hook 系统常见误区 4 个:AgentHook vs TurnHook vs ProgressHook 边界(nanobot)

本文介绍了 nanobot 的 Hook 系统,主要回答三类 Hook 的类型、回调时机、自定义实现方法以及四个常见误区。核心内容包括: Hook 类型与用途 3类Hook:AgentHook(全局)、AgentTurnHook(回合级)、ProgressHook(流式进度) 主要用途:日志、监控、审批、消息改写等扩展功能 关键实现细节 5个回调时机:before_turn/before_iteration/on_stream/on_error/after_turn 注册方式:通过配置文件或构造函数注入 审

2026-08-13 16:43:28 232

原创 第 12 章《ContextBuilder 系统 Prompt》· 3 段式 ContextBuilder:bootstrap 引导文件 + skills + memory 注入实战(nanobo

本文介绍了 nanobot 框架中 System Prompt 的拼接机制与模块化设计。主要内容包括: System Prompt 被拆分为 8 个模块化段落,按优先级和功能划分,包括身份标识、引导文件、工具合约、记忆、技能等。 核心拼接逻辑在 context.py 的 build_system_prompt() 方法中实现,总长度约 4000-5000 tokens。 重点解析了 3 个可自定义的引导文件(AGENTS.md/SOUL.md/USER.md)的作用和存放位置。 说明了技能(Skills)和

2026-08-13 16:42:10 184

原创 第 11 章《AgentRunner LLM 循环》· nanobot AgentRunner 源码深度解析:_request_model + _execute_tools 多轮工具调用

本文深入解析了 AgentRunner 模块的核心工作机制,聚焦于如何实现多轮LLM调用与工具执行的协调运行。文章从五个方面展开: 模块定位:说明AgentRunner抽离模型层复杂度,使AgentLoop专注于调度(1500 vs 5000行) 主循环流程:通过run()方法展示200轮迭代控制,处理LLM响应与工具调用的交替执行 三大核心方法: _request_model():统一LLM调用接口,处理流式响应 _execute_tools():工具执行与权限校验 _finalize():生成最终输出

2026-08-13 10:07:15 322

原创 第 10 章《AgentLoop 编排核心》· AgentLoop 编排怎么做?6 阶段流水线 + TurnContext 实战(nanobot)

本文详细解析了 nanobot 框架中 AgentLoop 的 6 阶段流水线实现,主要面向 LLM Agent 开发者和核心循环修改工程师。AgentLoop 负责将用户消息转换为 Agent 回复的全过程,核心文件为 nanobot/agent/loop.py(约 2058 行)。 文章首先区分了 AgentLoop(管理回合级操作)和 AgentRunner(管理多轮循环)的不同职责,并介绍了 6 个处理阶段:Inbound 接入、session 解析、workspace 解析、TurnContext

2026-08-13 10:05:02 559

原创 第 09 章《WebUI + Gateway 协议》· nanobot Gateway 源码解析:WebSocket 多路复用 + 健康端点 + 静态资源分发

本文介绍了nanobot gateway的启动流程和核心功能: 定位与职责:作为长跑进程,整合WebUI/17通道/AgentLoop,提供多客户端服务、健康检查和静态资源托管。 启动流程:通过gateway/runtime.py加载配置、创建共享消息总线、初始化AgentLoop和ChannelManager,最后启动HTTP/WebSocket服务。 通信机制:WebSocket通过/ws路径与AgentLoop交互,每条连接独立处理,支持断线重连。 HTTP功能:提供/health健康检查端点,并通过

2026-08-13 10:02:42 254

原创 第 06 章《配置子系统 Config》· Pydantic 配置常见误区 5 个:camelCase alias + extra=“allow“ 实战避坑(nanobot)

本文介绍了nanobot配置系统的核心机制与常见误区。主要内容包括: 配置加载机制:使用Pydantic实现多源配置(YAML/环境变量/命令行/默认值)的自动合并,支持YAML的camelCase与Python的snake_case转换。 核心要点: 配置文件路径:~/.nanobot/config.yaml 优先级顺序:命令行 > 环境变量 > YAML > 默认值 关键机制:alias字段映射、env_prefix环境变量前缀、extra="allow"兼容旧配置 5个常见误区: 驼峰alias漏写导

2026-08-12 15:00:00 145

原创 第 08 章《CLI 入口与 typer 命令树》· 3 步拆解 typer CLI:app 命令树 + 子命令委派 + UTF-8 编码兜底(nanobot)

本文介绍了如何实现nanobot命令行工具及其子命令(如gateway和chat),并解决Windows UTF-8编码问题。主要内容包括: 框架选择:使用typer(基于Click和类型注解)实现CLI,支持自动help和子命令注册。 核心实现: 在app.py初始化typer.Typer实例并处理Windows UTF-8编码问题(sys.stdout.reconfigure)。 通过@app.command()装饰器在commands.py中注册7个子命令(如gateway/chat/webui等)。

2026-08-12 11:13:17 183

原创 第 07 章《上下文注入 contextvars》· 显式传参 vs contextvars:从 nanobot runtime\_context 看请求上下文注入

本文介绍了nanobot项目使用Python标准库contextvars注入上下文参数的设计。通过将channel/chat_id/session_key等参数绑定到请求上下文,避免了Tool函数签名膨胀的问题。核心实现包括:1)定义RequestContext数据结构;2)在AgentLoop._dispatch中绑定上下文;3)提供current_request_context()供Tool读取。相比全局变量或显式传参,contextvars方案具有asyncio任务隔离、线程安全等优势。开发者只需在T

2026-08-12 10:59:30 449

原创 第 05 章《事件协议:InboundMessage + OutboundEvent》· AI Agent 事件协议怎么做?10 种 OutboundEvent 联合类型实战(nanobot)

本文介绍了MessageBus中三类核心消息体的结构设计:InboundMessage(用户输入)、OutboundMessage(Agent回复)和10种OutboundEvent(类型化事件)。通过统一协议封装不同通道的异构消息,采用dataclass实现类型安全的联合类型,配合工厂函数简化消息构建。关键设计包括: 会话标识采用channel:chat_id默认拼接 通过event字段实现富交互(流式输出/进度条等) 元数据扩展机制支持内部指令 类型化事件体系确保演进兼容性 这种设计使业务层只需处理标准

2026-08-12 10:53:03 331

原创 优快云完整发布稿|MediaMTX公网部署完整教程|Linux安装配置 RTMP转WebRTC避坑指南

本文介绍开源媒体网关MediaMTX的生产环境部署方案。MediaMTX支持RTSP、RTMP、WebRTC等协议转换,适用于安防监控、边缘网关等场景。文章详细讲解Linux安装、systemd自启配置、公网端口规划、UDP端口检测、STUN穿透设置等关键步骤,并提供优化后的配置文件示例。重点说明WebRTC部署需要配置STUN服务器解决NAT穿透问题,以及如何通过热重载更新配置不影响现有流。最后总结MediaMTX轻量高效的优势,同时指出其不支持内置转码的局限性,建议与FFmpeg配合使用。全文提供可直接

2026-08-11 16:16:30 556

原创 第 04 章《消息总线 MessageBus》· 3 步实现消息总线:MessageBus + asyncio.Queue + publish/consume 实战(nanobot)

本文介绍了MessageBus在LLM Agent架构中的实现原理,重点分析其双向asyncio.Queue的设计思想。MessageBus通过分离inbound和outbound队列,解耦通道与AgentLoop,支持多通道扩展。核心实现包括:1) 使用两个独立asyncio.Queue分别处理输入/输出消息;2) 提供4个基础发布/消费方法;3) 采用单例模式确保多通道共享同一总线。设计决策考虑了消息顺序一致性、测试便利性和性能优化,适合单进程异步场景。文章还包含时序图、关键流程示例和常见问题解答,为开

2026-08-11 08:49:50 420

原创 第 03 章《整体架构与数据流》· nanobot 整体架构源码深度解析:InboundMessage → AgentRunner → OutboundEvent 全链路

本文深入解析了nanobot系统中用户消息从发送到Agent回复的完整处理流程,将其划分为6个核心阶段: Channel接收阶段:由各通道实现文件处理用户原始输入,生成InboundMessage MessageBus入站阶段:通过asyncio.Queue[InboundMessage]传递消息(nanobot/bus/queue.py) AgentLoop处理阶段:负责会话路由和工作区管理(nanobot/agent/loop.py) AgentRunner执行阶段:协调LLM调用和工具执行(nanob

2026-08-11 08:46:17 201

原创 第 02 章《源码结构与扩展点索引》· nanobot 源码结构解析:21 模块 / 17 通道 / 23 工具速查地图

本文为nanobot仓库开发者提供核心结构速查指南,主要涵盖以下内容: 仓库结构:包含5大核心目录(Python包、前端、测试、文档、脚本)和21个Python顶层模块,按DAG依赖分层组织。 模块分层: 基础层:bus/不依赖agent和channels/ 核心层:agent/包含2058行的AgentLoop等核心组件 扩展层:17个自包含聊天通道和8个LLM Provider 关键扩展点: 4个自发现系统:Channel/Tool(entry_points)、Provider(注册表)、Skill(目

2026-08-07 19:00:00 307

原创 第 01 章《项目概览与设计哲学》· AI Agent 端到端架构怎么做?1 张图 + 6 阶段流水线实战(nanobot)

本文介绍了超轻量级AI Agent框架nanobot的端到端架构,核心围绕6阶段流水线展开: Inbound接入:17个聊天通道将消息转为InboundMessage推入MessageBus(bus/queue.py) 回合预处理:AgentLoop处理会话状态、工作区等(agent/loop.py的_preprocess_turn()) 模型执行:AgentRunner调用LLM Provider并处理工具调用(agent/runner.py) 工具执行:执行23个内置工具(agent/tools/目录)

2026-08-07 13:35:13 426

原创 【2026保姆级教程】Windows Miniforge3安装配置完整指南|替代Anaconda|内置Mamba加速|根治镜像404报错(可直接商用)

导读:Anaconda企业大规模使用收费、Conda下载慢、依赖解析卡死、镜像repodata 404报错?本文带你从零安装配置Miniforge3,彻底替代Anaconda/Miniconda,内置Mamba高速加速、清华镜像专属配置永久无404、完全免费商用,全网最细Windows保姆级教程!

2026-07-06 15:06:02 1453

原创 日增量 300 万数据卡壳?行数据库 vs 列数据库:一篇理清差异,再也不选错

摘要:MySQL等行数据库和ClickHouse等列数据库的核心差异源于存储方式。行数据库按行存储,适合单行多字段查询(如订单详情);列数据库按列存储,适合多行少字段分析(如报表统计)。行数据库优化依赖索引,列数据库则通过分区键和排序键提升性能。实际应用中,混合架构(行库处理事务+列库处理分析)是应对中高量级数据(如日增300万条)的最佳方案。关键要理解两者特性差异,根据查询模式合理选择数据库类型。

2025-11-10 14:45:53 284

原创 Jenkins使用ssh方式拉取gitlab代码

【代码】Jenkins使用ssh方式拉取gitlab代码。

2025-07-30 19:19:57 658

原创 Jenkins pipeline使用篇

pipeline使用详解

2025-04-04 14:24:48 2101

原创 Linux环境Jenkins 安装配置篇

通过本手册,您可在无外网环境下完成 Jenkins 的完整安装和配置,支持自动化构建与部署。,登录后检查插件是否生效(如 Git、Pipeline)。创建测试任务,验证源码拉取和构建功能。下载 Linux 版 JDK(如。中的依赖列表,补全缺失插件。填写用户名、密码和邮箱。): 集成 Git 仓库。(插件已离线准备)。

2025-04-04 11:03:49 1771

docker-compose.yml

FastGPT v4.16.2相关docker-compose.yml

2026-09-10

Linux环境Jenkins 安装配置篇

jenkins搭建资源,包含jenkin.war,jdk17,常用的插件

2025-04-04

SourceHanSansCN7.zip

SourceHanSansCN-bold、normal、regular、Medium、Light、ExtraLight、heavy 以及安装方式

2020-03-17

boot2docker.iso

boot2docker iso 镜像文件 docker启动需要下载的一个boot2docker.iso,但是因为这个文件的官方位置是在 GitHub,所以在国内不一定能下载下来。

2017-12-13

parallel.txt

parallel desktop TNT版 好用不花钱 txt里面有百度盘链接和提取码 直接下载安装就好了

2019-11-21

空空如也

TA创建的收藏夹 TA关注的收藏夹

TA关注的人

提示
确定要删除当前文章?
取消 删除