逗号的博客

问题描述

我们有一个项目使用了 com.github.xiaoymin:knife4j-openapi2-spring-boot-starter:4.4.0 依赖，API 接口的出/入参参数使用了内部类，举个例子

1
2
3
4
5
6
7
8
9
10
11
12
13

@Data
@ApiModel(value = "Outer")
public class Outer {
    private String name;

    private Inner inner;

    @Data
    @ApiModel(value = "Outer.Inner")
    public static class Inner {
        private String name;
    }
}

注意第 9 行代码中 value 的值使用了点 . 来分割外部类与内部类的名称，当访问 API 文档时 inner 属性被当成了 string 类型而不是 object 类型

这篇文章将使用 Node.js 版 Playwright 来完成一个特定网站的在线课程学习任务。

课程网站介绍

这个网站是基于 Vue.js 构建的，在网页的源代码中可以发现引入了 vue.min.js、vue-router.min.js 和 vuex.min.js 等文件。这个网站需要使用用户名、密码和手机验证码登录，然后进入课程页面开始学习。课程页面包含课程列表，点击课程进入章节列表页面，点击章节进入视频列表页面，视频是使用 <video> 标签实现的，一个视频播放完成后会自动播放下一个视频。这些跳转都在一个浏览器页面中完成，因此这个网站是一个单页面应用？

最近遇到这样一个需求：从视频中提取音频并将语音转换成文字。在和 Qwen 进行一些讨论后决定使用 openai-whisper 来实现。

这篇文章将记录一下在 Windows 系统下搭建 FastAPI 开发环境的过程，包括安装项目管理工具 UV、使用 UV 初始化项目、使用 PyCharm 启动项目等，不包括 Python 的安装。

Java 语言本身提供了两个 COW 数据结构 CopyOnWriteArrayList 和 CopyOnWriteArraySet，但在某些场景下，比如配置信息热更新、缓存系统数据刷新和一些读多写少且需要保证数据一致性的场景，它们太重了。以 CopyOnWriteArrayList 的 add 方法为例，它在实现时使用了 synchronized 同步代码块。在这些场景下，我们可以使用一种轻量级的实现方式，即原子性地替换引用并利用 volatile 保证其他线程的可见性。

假设有如图一所示的线串，它在线段 2 和 6 处相交，如何把相交的部分删除得到如图三所示的简单线串呢？

在 Spring Boot 应用中使用 org.springframework.ai:spring-ai-starter-mcp-server-webflux:1.1.0 可以创建一个 MCP 服务器，如果想在一个应用创建多个 MCP 服务器，每个服务器使用不同的配置，比如不同的协议，该怎么实现呢？通过阅读 MCP 相关的源代码发现创建一个 MCP 服务器会向 Spring 容器注册 3 个对象（以异步的 Streamable HTTP 为例）：
WebFluxStreamableServerTransportProvider、RouterFunction、McpAsyncServer，只要能在应用启动中或启动后从配置文件或数据库读取配置然后创建这些对象，就可以实现动态创建/销毁 MCP 服务器。

创建一个最简 Spring AI 项目，只引入 spring-ai-starter-mcp-server-webmvc 依赖，版本为 1.0.1，spring.ai.mcp.server.type 配置为 SYNC，然后定义一个 MCP 工具，准备工作就完成了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

@Service
public class WeatherService {
    @Tool(description = "Get weather information by city name")
    public String getWeather(String cityName) {
        // Implementation
    }
}

@Configuration
public class McpServerConfiguration {
    @Bean
    public ToolCallbackProvider weatherTools(WeatherService weatherService) {
        return MethodToolCallbackProvider.builder().toolObjects(weatherService).build();
    }
}

后续分析只关注与工具调用相关的源码。

在我们的场景中访问内网资源需要通过奇安信天信，一个零信任网络访问系统，功能类似 EasyConnect，同时也需要安装奇安信天擎和微步两个软件。我们都知道奇安信天擎等产品一旦安装想要卸载非常麻烦，而奇安信天信目前还没有类似 docker-easyconnect 的软件，经过实践把这三个软件安装在虚拟机中，然后在虚拟机中安装 3proxy 代理服务器，在主机中通过 Clash.for.Windows 连接代理服务器从而避免在主机中安装奇安信天擎等产品

在这篇文章中只介绍在 Windows 下使用 Docker 封印 EasyConnect 的操作步骤。我们会使用到 4 个软件：Docker Desktop、VNC Viewer、Clash for Windows、Wintun 和 1 个镜像：docker-easyconnect。