游鹄君博客

自定义项目

自定义详细介绍

项目熟悉篇

一、项目整体定位与技术基线

项目名称：游鹄生态
核心框架：Laravel 12 + PHP 8
运行环境约束：【node.js22,imagick,redis,memcached,swoole,laravel-echo(websocket),supervisor,ES】
核心自研组件：
- laravel-fast-api-youhujun：API 快速开发核心组件=>youhu-base微服务(开源)
- laravel-shard-map-youhujun：分库分表映射表组件=>shard-map微服务(开源)
- php-tool-youhujun：工具集（开源）
- youhu：游鹄生态核心=>youhu微服务(私有不开源)
- yohushop：游鹄生态电商=>youhushop微服务(私有不开源)
- xuehu-xueer-youhujun：雪鹄城堡专属AI交互组件=>xuehu微服务(私有不开源,提供私有AI模型训练,对话交互)

游鹄君2026/3/6大约 3 分钟

vuepress中如何使用路径

一、核心前提：VuePress 的路径规则

VuePress 中「绝对路径」分两种场景，核心是基于 docs/.vuepress/public 目录（没有就新建）—— 这个目录是 VuePress 的静态资源根目录，相当于前端项目的 public 文件夹～

二、场景 1：在 Markdown 中使用绝对路径（最常用）

1. 静态资源（图片 / 文件）

把资源放到 docs/.vuepress/public/ 下，比如：

plaintext

游鹄君2026/3/6大约 2 分钟

ShardHelperFacade 使用手册

概述

ShardHelperFacade 是游鹄生态系统中处理分库分表操作的核心门面服务，封装了分片路由、查询、缓存等所有底层逻辑，提供简洁易用的 API 接口。

特点：

✅ 支持单体和微服务架构平滑切换
✅ 自动适配 youhu/youhushop/youhujun 不同模块配置
✅ 内置 Redis Hash 缓存，提升查询性能
✅ 全表遍历支持提前退出优化
✅ 缓存自动失效机制

游鹄君2026/3/6大约 5 分钟

ShardMapHelperFacade 使用手册

概述

ShardMapHelperFacade 是专门为分库分表映射库表设计的门面服务，继承自 ShardHelperFacade 的所有功能，并新增了映射表特有的查询方法。

特点：

✅ 继承 ShardHelperFacade 所有方法
✅ 专门用于映射表（Map表）操作
✅ 新增非业务ID查询功能
✅ 新增模糊查询功能
✅ 内置 Redis Hash 缓存

游鹄君2026/3/6大约 6 分钟

ModelMapRouterFacade 使用手册

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-05

📖 概述

ModelMapRouterFacade 是游鹄生态中用于兼容单体和微服务架构的映射表查询门面服务。它是业务代码重构时查询映射表的主要入口。

核心特点

✅ 单体/微服务自动适配：根据配置自动选择查询方式
✅ 智能路由选择：单体时直接查询数据库，微服务时调用API
✅ 映射表模型映射：通过 modelFlagMap 管理映射表模型
✅ 统一接口：业务层无需关心底层架构，使用统一方法调用
✅ 支持所有映射表：通用方法，适配所有映射表（UserMap、OrderMap等）

游鹄君2026/3/6大约 9 分钟

ApiRequestFacade 使用手册

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-04

📖 概述

ApiRequestFacade 是游鹄生态中用于微服务之间API通信的安全请求门面服务。它提供了跨服务的加密请求、认证和响应处理功能。

核心特点

✅ AES 加密通信：请求参数使用 AES 加密传输
✅ 服务认证管理：自动获取和管理各服务的认证信息
✅ 统一请求封装：统一的请求头格式和参数加密
✅ 日志记录：自动记录请求和响应日志
✅ 多服务支持：支持 youhu-base、shard-map、youhu、youhushop、xuehu 等服务

游鹄君2026/3/6大约 6 分钟

SyncDataFacade 使用手册

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-04

📖 概述

SyncDataFacade 是游鹄生态中用于同步数据到映射表的专用门面服务。它负责将主表的数据同步到对应的映射表中，以支持跨服务的数据查询和路由。

核心特点

✅ 自动创建/更新映射表：根据业务ID自动查询或创建映射表记录
✅ 分片路由支持：自动根据分片信息路由到正确的映射表分片
✅ 模型映射管理：通过 modelMap 管理不同模型映射表的同步逻辑
✅ 事件驱动：同步完成后自动触发事件通知
✅ 日志记录：自动记录同步操作日志

游鹄君2026/3/6大约 5 分钟

QueryMapFacade 使用手册

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-05

📖 概述

QueryMapFacade 是游鹄生态中用于微服务间映射表查询的专用门面服务。它提供了通过非业务ID查询映射表的 API 接口，支持跨服务的映射表查询功能。

核心特点

✅ 模型映射管理：通过 modelMap 管理不同模型映射表的查询
✅ 非业务ID查询：支持通过账号名、手机号等非业务ID字段查询
✅ 模糊查询支持：支持模糊查询获取业务ID列表
✅ DTO 参数封装：使用 DTO 对象封装请求参数
✅ 日志记录：自动记录查询操作日志

游鹄君2026/3/6大约 7 分钟

如何在微调模型

本人是windows电脑

方案选择

由于 Ollama 0.15.4 版本不支持 fine-tune 命令，推荐使用 llama.cpp 进行微调。

环境准备

提示

如果想自己编译就安装cmake,也可以通过第二步直接下载llama-b7917-bin-win-cpu-x64.zip,跳过camke

1. 安装 camake

如果已经安装可以跳过

游鹄君2026/2/17大约 2 分钟

密钥管理服务使用文档

概述

密钥管理服务提供了安全密钥生成功能,支持自定义字符类型和长度,使用密码学安全的随机数生成器。

安装

use YouHuJun\Tool\App\Facades\V1\Utils\Sign\KeyManagerFacade;

游鹄君2026/2/17大约 6 分钟

游鹄君博客-记录开发学习工作以及点点滴滴

一、项目整体定位与技术基线

一、核心前提：VuePress 的路径规则

二、场景 1：在 Markdown 中使用绝对路径（最常用）

1. 静态资源（图片 / 文件）

概述

概述

📖 概述

核心特点

📖 概述

核心特点

📖 概述

核心特点

📖 概述

核心特点

方案选择

环境准备

1. 安装 camake

概述

安装