项目 on Hardy Blog

Ragent项目开发

Wed, 27 May 2026 00:00:00 +0000

Ragent（官方介绍链接）是一个面向企业场景的 Agentic RAG 平台：从文档入库、向量索引到多路检索、意图识别、MCP 工具调用和流式问答，形成完整闭环。定位是 Java 后端开发者学习/落地 AI 应用的开源参考实现，而不是「调 API + 向量库」的 Demo。

技术栈#

类别	技术
后端框架	Spring Boot 3.5.7 (Java 17)
向量数据库	Milvus 2.6.6
文档解析	Apache Tika 3.2.3
ORM	MyBatis-Plus 3.5.14
对象存储	AWS S3
认证授权	Sa-Token 1.43.0
缓存/分布式锁	Redisson 4.0.0
消息队列	RocketMQ 2.3.5
MCP协议	MCP SDK 1.1.2
前端	React + TypeScript + Vite

项目模块#

ragent/
├── bootstrap/ # 业务启动模块（核心业务逻辑）
├── framework/ # 通用基础设施层（与业务无关）
├── infra-ai/ # AI基础设施层（屏蔽模型供应商差异）
├── mcp-server/ # MCP服务器模块
└── frontend/ # React前端（约18000行代码）

核心特性#

多路检索并行 + 后处理流水线

context_bridge项目开发

Thu, 30 Apr 2026 00:00:00 +0000

技术栈：React+TS+FastAPI+TailWind CSS

🎨 前端部分：用户看到和交互的界面#

React —— 界面的“积木工厂”#

是什么：一个用于构建用户界面的 JavaScript 库，由 Facebook 开发。
通俗理解：它让你像搭积木一样，把网页拆分成一个个独立、可复用的组件（比如一个按钮、一个输入框、整个聊天窗口）。当数据变化时，React 会自动高效地更新需要变化的部分，不需要手动操作整个网页。
为什么用它：开发效率高、组件化、生态极其丰富、大厂背书。

TypeScript (TS) —— JavaScript 的“严格教官”#

是什么：在 JavaScript 的基础上增加了静态类型检查。
通俗理解：写 JS 时如果变量类型弄错（比如把数字当字符串用），可能要等到运行时报错才发现。TS 在你写代码的时候就划红线提醒你，并且提供智能补全。就像给 JS 语言加了一套“安检系统”，大型项目里能减少大量低级错误。
为什么加它：让代码更健壮、更易维护、团队协作更顺畅。

Tailwind CSS —— “原子化”的样式工具箱#

是什么：一个实用优先的 CSS 框架。
通俗理解：传统 CSS 是自己起名字、写一大段样式。Tailwind 提供大量小工具类（如 p-4 代表内边距、bg-blue-500 代表背景色），你直接在 HTML 标签上组合这些类名，不用离开 HTML 文件就能快速布局。
为什么用它：开发速度极快、最终 CSS 文件体积小（未使用的样式会被清除）、样式一致性容易保证。

🖥️ 后端部分：处理数据和业务逻辑#

FastAPI —— 高性能的 Python API 框架#

是什么：一个基于 Python 的现代 Web 框架，专门用来快速构建 API（应用程序接口）。
通俗理解：你可以把它想象成一个“数据服务员”：前端 React 向它请求数据（比如“/users/123”），它去数据库查到用户信息，包装成 JSON 格式返回给前端。它之所以叫“Fast”，是因为性能极高（基于 Starlette 和 Pydantic），而且自带交互式 API 文档。

12306项目开发

Wed, 22 Apr 2026 00:00:00 +0000

一、知识记录#

Yarn（前端包管理工具）介绍#

全称为Yarn Package Manager（Yet Another Resource Negotiator 的缩写），是JavaScript / Node.js 的包管理器，用于管理项目依赖（类似于 npm）。

核心特点（相比 npm 的优势）：

安装速度更快：并行下载 + 离线缓存机制。
更安全可靠：生成 yarn.lock 文件，锁定所有依赖的精确版本，保证“一次安装，到处一致”。
支持 Workspaces：特别适合大型 monorepo 项目（一个仓库管理多个子包）。
安装过程更干净：输出信息简洁，错误提示友好。
其他实用功能：零安装模式（Plug’n’Play）、更好的依赖冲突解决等。

常用命令对比（与 npm）：

操作	npm 命令	Yarn 命令
安装依赖	npm install	yarn 或 yarn install
添加依赖	npm install xxx	yarn add xxx
添加开发依赖	npm install xxx –save-dev	yarn add xxx -D
全局安装	npm install -g xxx	yarn global add xxx
删除依赖	npm uninstall xxx	yarn remove xxx

npm是Node.js的默认包管理器，当你安装Node.js时，npm会自动安装；yarn 是Facebook开发的替代npm的包管理器，需要单独安装：npm install -g yarn。两者功能相同：都用于管理JavaScript/Node.js项目的依赖包，都读取同一个 package.json 文件。