Betsy Blog - 分享网络技术、服务器部署、Unity开发、AI技术应用与原理

Unity-PICO-共享空间锚点开发

Fri, 02 Jan 2026 17:01:48 GMT

Unity开发MR中应用空间锚点的场景

多人联机游戏需要对齐玩家元素（位置、物体位置等）
将物体持久化在某个现实对应的地方
没有大空间技术的普通消费级PICO头显设备MR玩家的同步

官方对于空间锚点的定义 ::link{url="https://developer-cn.picoxr.com/document/unity/spatial-anchors/" title="空间锚点 | PICO 开发者平台" description="空间锚点技术可以将虚拟环境中的位置与真实世界中的位置进行锚定。放置空间锚点并将其持久化至设备磁盘中后，用户再次走到放置锚点的位置时，系统可以找回该锚点并返回给应用。" image="https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2e96ba68be484bdc8e22457a6d5f2cf4~tplv-goo7wpa0wc-quality:q75.image"}

1.自身坐标的正确标定

在开始应用空间锚点之前，我们需要先将自身的坐标真实确定，比如身高1.7m，在你头显里面的坐标也应该贴近(x,1.7,x)

房间标定，查看官方
地面标定，位于PICO头显的设置-安全防护-调整地面高度

2.核心难点：多人开发的坐标系的统一与区分

每台PICO都有其独立的本地坐标系，而我们MR不同于VR的难点在于如何将两台及以上的坐标系统一起来；即虚拟坐标系（Coordinate System）统一到同一个物理参考系中
初期解决方法：我们通过手动标定自己的原点（XZ）来完成虚拟与现实的统一，但是及其考研玩家的现实校准的地方的一致性，不方便；基本的核心原理都是将XROrigin置于一个根Root下进行变换 <details> <summary>手动标定代码</summary>

    /// <summary>
    /// 标定入口
    /// </summary>
    public void OnCalibrateOriginPressed()
    {
        if (userCamera == null)
        {
            SetLogInfo("错误：无法找到用户相机，无法进行标定！");
            return;
        }

        SetLogInfo("正在根据当前玩家位置标定共享原点...");

        // 1. 获取玩家头显在地板上的投影位置（Y=0）
        Vector3 headPositionOnFloor = new Vector3(userCamera.position.x, 0, userCamera.position.z);

        // 2. 获取玩家头显的水平朝向（忽略俯仰和侧倾）
        Quaternion headYawRotation = Quaternion.Euler(0, userCamera.eulerAngles.y, 0);

        // 3. [核心] 调用对齐方法，传入我们计算出的、理想化的玩家姿态
        //    这个方法会计算一个逆向变换，将这个姿态“拉回”到世界的(0,0,0)
        AlignSharedSpaceOrigin(headPositionOnFloor, headYawRotation);
    }

    /// <summary>
    /// 坐标系的统一变换
    /// </summary>
    /// <param name="targetPosition">目标位置</param>
    /// <param name="targetRotation">目标旋转</param>
    private void AlignSharedSpaceOrigin(Vector3 targetPosition, Quaternion targetRotation)
    {
        if (xrSharedSpaceOrigin == null)
        {
            Debug.LogError("XR Shared Space Origin 未在Inspector中指定，无法对齐坐标系！");
            return;
        }

        // 计算将 targetPosition 和 targetRotation “拉回”到世界原点(0,0,0)所需的逆向变换
        Quaternion inverseRotation = Quaternion.Inverse(targetRotation);
        Vector3 inversePosition = inverseRotation * -targetPosition;

        // 将这个逆向变换应用到玩家的根节点上
        xrSharedSpaceOrigin.SetPositionAndRotation(inversePosition, inverseRotation);

        SetLogInfo("共享原点已成功标定！");
    }

</details>

以上的手动标定方案及其依赖双方对齐时的高度（因为这是是一个完全重设世界0点坐标系的过程），不精准，不稳定，只能作为开发过渡

3.空间锚点基本

对于空间锚点的基本应用（放置、持久化、销毁等）我的建议是多去研究上面那个官方基本文档，我这里碍于篇幅，只会提供不易发现，被垄断的部分，不过还是要注意以下几点核心

老老实实走PICO云端的方案，尽量不要尝试锚点数据走本地（因为其中的点云数据是加密的，解密成本高，不值）
锚点的主要传输依赖核心就是uuid，请在你的联机方案中重点聚焦于uuid的传输，放置、销毁、持久化均高度依赖uuid；
锚点的预制体一定要附带PXR_Spatial Anchor脚本
放置方面，更建议以手柄位置作为放置点，放置前的视觉预览体记得去掉（PXR_Spatial Anchor脚本）

4.共享空间锚点

1.流程

流程建议为联机-放置共享空间锚点-下载客户端-同步 <details> <summary>流程图</summary>

sequenceDiagram
    participant Host as 房主 (Host)
    participant Server as PICO Cloud
    participant Net as Network (RPC)
    participant Client as 客户端 (Client)

    Note over Host: 1. 放置 & 创建锚点
    Host->>Server: UploadSpatialAnchor
    Server-->>Host: 返回 UUID
    Host->>Host: 记录 P_Host, Q_Host

    Note over Client: 2. 新玩家加入 (OnNetworkSpawn)
    Client->>Host: RequestAnchorData (ServerRpc)
    Host-->>Client: 发送 UUID, P_Host, Q_Host (ClientRpc)

    Note over Client: 3. 对齐流程
    Client->>Server: Download (UUID)
    Server-->>Client: 锚点数据
    Client->>Client: Locate (获取 P_Client)
    Client->>Client: 计算 Offset (忽略Y轴)
    Client->>Client: 移动 XR Origin

</details>

2.详细解析

主机创建：房主记录下该锚点在自己坐标系下的位置 $P_{Host}$ 和旋转 $Q_{Host}$。
客机加入：通过 ClientRPC 拿到 $P_{Host}$ 与 $Q_{Host}$，然后再下载共享的空间锚点（已上传到云）。
加载锚点：获取其在自己本地坐标系的位置 $P_{Client}$ 与旋转 $Q_{Client}$，然后经过数学矩阵变换后移动 XROrigin 的父物体 Root 节点即可。
变换计算：我们需要计算一个变换矩阵 $T_{Align}$。
- $P_{Host}, Q_{Host}$：锚点在房主世界空间中的位置和旋转。
- $P_{Client}, Q_{Client}$：锚点在客户端本地空间中的位置和旋转（未校准前）。
- $Q_{Align}$：给客户端的旋转矫正。
- $P_{Align}$：给客户端的位置矫正。
旋转对齐：对齐水平朝向（Yaw），必须忽略 X/Z 轴的倾斜，以保证重力方向永远垂直向下。

1. 提取 Yaw 旋转 对于任一旋转四元数 $Q$，其 Forward 向量在水平面上的投影为： $\vec{F}{projected} = \text{ProjectOnPlane}(Q \cdot \vec{Z}{forward}, \vec{Y}{up})$ 提取后的 Yaw 旋转为： $Q{yaw} = \text{LookRotation}(\vec{F}{projected}, \vec{Y}{up})$ 房主与客户端均这样处理，得到 $Q_{H_Yaw}$ 和 $Q_{C_Yaw}$。

2. 计算旋转差值 需要一个旋转 $Q_{Align}$，使得客户端旋转后等于房主的旋转： $Q_{Align} \times Q_{C_Yaw} = Q_{H_Yaw}$ 推导得出： $Q_{Align} = Q_{H_Yaw} \times Q_{C_Yaw}^{-1}$

代码对应： Quaternion rotAlign = hostRot * Quaternion.Inverse(clientRot);

位置对齐：客户端锚点被父物体变换后，位置应等于房主锚点的位置。 公式推导： $P_{Host} = (Q_{Align} \times P_{Client}) + P_{Align}$ 其中 $Q_{Align} \times P_{Client}$ 是将客户端的锚点位置进行旋转矫正。需要求 $P_{Align}$，移项可得： $P_{Align} = P_{Host} - (Q_{Align} \times P_{Client})$

代码对应： Vector3 posAlign = hostPos - rotAlign * clientPos;

地面模式修正：虽然公式中得出了一定的 Y 轴数学解，但通常由地面标定误差引起，且我们采用 TrackingOriginMode.Floor，故丢弃 Y 轴偏移。公式对应： $P_{Align}.y = 0$

代码对应：posAlign.y = 0f;

玩家数据模拟

<details> <summary>数学矩阵推演</summary>

房主锚点：$P_{host} = (2.0, 0.0, 3.0)$，朝向 Yaw = 30°
客户端锚点：$P_{client} = (3.0, 0.0, 2.0)$，朝向 Yaw = 10°
Yaw 旋转矩阵： $R_y(\theta) = \begin{bmatrix} \cos\theta & 0 & \sin\theta \ 0 & 1 & 0 \ -\sin\theta & 0 & \cos\theta \end{bmatrix}$ 房主为：$R_{\text{host}} = R_y(30^\circ) = \begin{bmatrix} 0.8660254 & 0 & 0.5 \ 0 & 1 & 0 \ -0.5 & 0 & 0.8660254 \end{bmatrix}$ 客户端为：$R_{\text{client}} = R_y(10^\circ) = \begin{bmatrix} 0.98480775 & 0 & 0.17364818 \ 0 & 1 & 0 \ -0.17364818 & 0 & 0.98480775 \end{bmatrix}$
旋转对齐矩阵： $R_{\text{align}} = R_{\text{host}} R_{\text{client}}^{-1} \approx \begin{bmatrix} 0.939693 & 0 & 0.34202 \ 0 & 1 & 0 \ -0.34202 & 0 & 0.939693 \end{bmatrix}$

代码：Quaternion rotAlign = hostRot * Quaternion.Inverse(clientRot);
平移向量 $P_{Align}$： $R_{align}P_{client} \approx \begin{bmatrix} 0.939693 & 0 & 0.34202 \ 0 & 1 & 0 \ -0.34202 & 0 & 0.939693 \end{bmatrix} \begin{bmatrix} 3 \ 0 \ 2 \end{bmatrix} \approx \begin{bmatrix} 3.503118 \ 0 \ 0.853325 \end{bmatrix}$ $P_{align} = P_{host} - R_{align}P_{client} \approx \begin{bmatrix} 2 \ 0 \ 3 \end{bmatrix} - \begin{bmatrix} 3.503118 \ 0 \ 0.853325 \end{bmatrix} \approx \begin{bmatrix} -1.503118 \ 0 \ 2.146675 \end{bmatrix}$
4×4 齐次变换矩阵 $T_{align}$： $T_{\text{align}} = \begin{bmatrix} R_{\text{align}} & \mathbf{p}_{align} \ \mathbf{0}^\mathsf{T} & 1 \end{bmatrix} \approx \begin{bmatrix} 0.939693 & 0 & 0.34202 & -1.503118 \ 0 & 1 & 0 & 0 \ -0.34202 & 0 & 0.939693 & 2.146675 \ 0 & 0 & 0 & 1 \end{bmatrix}$

</details>

总结：经过 $T_{align}$ 变换后，客户端观测到的锚点将完美对齐到房主的位置。

代码实现： xrSharedSpaceOrigin.SetPositionAndRotation(_currentAlignPos, _currentAlignRot); </details>

3.详细代码（需要适配你的网络架构等我是NGO）

    /// <summary>
    /// 执行空间对齐算法
    /// </summary>
    /// <param name="hostPos">房主发来的锚点世界坐标</param>
    /// <param name="hostRot">房主发来的锚点世界旋转</param>
    /// <param name="clientPos">客户端本地读取到的锚点坐标</param>
    /// <param name="clientRot">客户端本地读取到的锚点旋转</param>
    private void ApplyAlignment(Vector3 hostPos, Quaternion hostRot, Vector3 clientPos, Quaternion clientRot)
    {
        // 1. 提取 Yaw (保持重力垂直)
        if (yawOnly)
        {
            hostRot   = ExtractYaw(hostRot);
            clientRot = ExtractYaw(clientRot);
        }
        
        // 2. 计算旋转偏移
        Quaternion rotAlign = hostRot * Quaternion.Inverse(clientRot);

        // 3. 计算位置偏移 (Host - Rot * Client)
        Vector3 posAlign = hostPos - rotAlign * clientPos;

        // 既然双方都是 Floor 模式，XR Origin 的 Y 轴必须与物理地面重合，也就是必须为 0。
        // 任何 Y 轴的偏移都会导致玩家浮空或陷地。
        // 我们完全忽略锚点在高度上的测量误差，只信任 X, Z 和 旋转。
        posAlign.y = 0f;

        // 4. 平滑应用
        if (_hasCurrentAlign && alignLerp < 1f)
        {
            _currentAlignRot = Quaternion.Slerp(_currentAlignRot, rotAlign, alignLerp);
            _currentAlignPos = Vector3.Lerp(_currentAlignPos, posAlign, alignLerp);
        }
        else
        {
            _currentAlignRot = rotAlign;
            _currentAlignPos = posAlign;
            _hasCurrentAlign = true;
        }

        if (xrSharedSpaceOrigin != null)
        {
            xrSharedSpaceOrigin.SetPositionAndRotation(_currentAlignPos, _currentAlignRot);
        }
        
        // 调试日志
        float heightCorrection = hostPos.y - clientPos.y;
        // 如果这个值很大（比如 > 0.2），说明其中一人的地面标定严重错误，需要重置系统边界
        Debug.Log($"[Align] 已强制锁定地面。忽略的高度误差: {heightCorrection:F3}m");
    }

</details>

4.辅助检验代码

using UnityEngine;
using TMPro;
using Unity.XR.PXR;
using Unity.Netcode;

public class DebugInfoManager : MonoBehaviour
{
    [Header("UI 设置")]
    [Tooltip("拖入用于显示坐标信息的 TextMeshProUGUI")]
    public TextMeshProUGUI debugText;

    [Header("对象引用")]
    public Transform headCamera;       // 拖入 Main Camera
    public Transform xrOriginParent;   // 拖入 XR_SHARED_SPACE (XR Origin的父物体)

    private void Update()
    {
        if (debugText == null) return;
        if (headCamera == null) headCamera = Camera.main?.transform;

        System.Text.StringBuilder sb = new System.Text.StringBuilder();

        // 1. 身份信息
        string role = "未连接";
        if (NetworkManager.Singleton != null && NetworkManager.Singleton.IsListening)
        {
            role = NetworkManager.Singleton.IsServer ? "房主 (Host)" : "玩家 (Client)";
        }
        sb.AppendLine($"身份: <color=yellow>{role}</color>");

        // 2. 关键坐标 (World)
        // 如果这个 Y > 2.0，说明你被错误的对齐逻辑抬飞了
        Vector3 worldPos = headCamera != null ? headCamera.position : Vector3.zero;
        sb.AppendLine($"World Head: {FormatVec(worldPos)}");

        // 3. 本地坐标 (Local - 相对于 Origin)
        // 正常站立时，Y 应该在 1.6 ~ 1.8 之间 (Floor模式)
        Vector3 localPos = headCamera != null ? headCamera.localPosition : Vector3.zero;
        sb.AppendLine($"Local Head: {FormatVec(localPos)}");

        // 4. 原点偏移 (XR Origin)
        // Client 的 Y 必须是 0.00，如果不是，说明对齐逻辑错了
        if (xrOriginParent != null)
        {
            sb.AppendLine($"Origin Pos: {FormatVec(xrOriginParent.position)}");
            sb.AppendLine($"Origin Rot: {xrOriginParent.eulerAngles.y:F1}°");
        }

        // 5. 锚点误差监控 (从 Manager 获取)
        if (PXRSample_SpatialAnchorManager.Instance != null && PXRSample_SpatialAnchorManager.Instance.isCalibrated)
        {
            sb.AppendLine("<color=green>[已对齐]</color>");
        }
        else
        {
            sb.AppendLine("<color=red>[未对齐]</color>");
        }

        debugText.text = sb.ToString();
    }

    private string FormatVec(Vector3 v)
    {
        // X, Y, Z (保留2位小数)
        return $"({v.x:F2}, <color=#00FFFF>Y:{v.y:F2}</color>, {v.z:F2})";
    }
}

</details>

5.简单的完美同步

基本实现：现实=虚拟，虚实合一

请注意房主再放置锚点后要细细观察锚点周围的空间，尽量保持平稳角度，确保上传是缓慢进行的，一般一下子上传完成均不准；客户端在确认房主上传完毕后请仔细以房主视角观察

::link{url="https://space.micostar.tech" title="Spatial Alignment Visualizer" description="空间锚点对齐算法的交互式可视化演示工具，帮助理解坐标系变换原理。访问密码：pico"}

Antigravity登陆FAQ解决方法！

Sun, 28 Dec 2025 12:16:50 GMT

首先我们要确保你的账号问题不是出自以下方面

节点问题

请确保你的节点干净一点，不要是很差的

账号国家归属地问题

请确保你的账号国家归属地为Antigravity支持的地区

查看你的账号地区

出现网页端提示成功，但FAQ

FAQ解决方法

原作者项目

::github{repo="lbjlaq/Antigravity-Manager"}

解决效果

这个强大的插件可以帮助我们实现FAQ登陆不了的问题，实测完美解决！！

解决步骤

按照源项目完成下载后，直接添加账号选择OAuth授权登陆即可，登陆完成则出现
然后直接选择从该工具页面切换账号启动Antigravity即可，如果是已经启动了Antigravity则按照提示，选择关闭即可（不要选择重启）

项目极其强大的另一点

项目不仅可以完美解决我们的FAQ登录问题，还可以让我们一键开启API反代服务，让我们的Antigravity可以使用的模型完美转化为外部接口，具体功能还请大家自行尝试

GeminiCLI账号切换插件，让你的开发之路不在繁琐！

Sun, 21 Dec 2025 22:00:16 GMT

项目地址

::github{repo="Besty0728/Gemini-CLI-Auth-Manager"}

为什么突然想要使用GeminiCLI以及要编写这个插件呢？

项目仍未带给我个人实际收益，不值得使用付费的ClaudeCode
项目内容越来越大，单一Web对话式AI已经很难在有限上下文下保持高开发效率了，不如使用“嵌入”式AI
Google大善人给了我n个AI Pro账号，在工作室电脑犯病登不上Antigravity的情况下，GeminiCLI同样对AI Pro用户有更高的额度供我使用

那为什么突然想到要开发这个插件呢？

1.Unity开发整体消耗较大

昨天一下午与Gemini共同燃烧了一下午修复遗留的奇妙BUG，结束后看到了消耗的Token高达百万，以及请求次数也很多（包括整体的第一次项目初始化）让我不得不担心一个账号的额度是否足够我一个人一天的开发

2.账号切换麻烦

账号的默认切换方式只有/auth然后再选择登录其他账号，不保证哪次登录又需要验证码了；很浪费时间

最后使用效果

如图所示，切换丝滑

Unity自定义添加模块

Tue, 02 Dec 2025 20:08:07 GMT

UnityHub安装Unity时手动添加模块

有些情况下，我们即使使用了正确的安装量设置等，但UnityHub在安装Unity时，仍然会出现没有“添加模块”这个选项的情况，如下图所示：

这个时候我们可以通过以下步骤手动添加模块：

1.打开Unity下载页面，选择“下载存档”

2.在存档页面选择对应的Unity版本，选择下载的“See all”（即查看所有）

3.在对应版本页面，选择Componment installers（组件管理器）下的需要的模块进行下载

4.下载完成后，运行对应的模块安装程序，选择Unity的安装路径进行安装

例如我的安装路径为E:\UnityEditor\2022.3.62f2\Editor

Unity对应版本\Editor

5.安装中文模块与文档需要安装在Editor/Data下

文档解压到Editor/Data下即可；中文模块为Localization文件夹，解压到Editor/Data下即可（就是zh-hans.po），官方找不到就搜索下载

6.完成后重启Unity即可

如果出现问题，可以尝试重新安装模块，或者检查（）路径是否正确，以及手动下载（例如OpenJDK（安卓打包组件））

Rider与VisualStudio的中文注释编码的爱恨情仇（转换兼容）

Sat, 25 Oct 2025 12:32:34 GMT

事情的起因

团队合作开发Unity项目时，一开始我单人使用Rider编写，但是后来的所有人都是使用VisualStudio，结果在代码注释中出现了乱码问题。所以我决定我去适配其他人，完成中文转换

在Visual Studio中，我们编写图中带有中文的代码及注释

但是切换为Rider后，中文注释就变成了乱码

Unity中视图

Rider中视图

原因分析

经过一番查找，发现这是由于Rider默认使用UTF-8编码，而Visual Studio使用的是GBK编码，导致中文注释无法正确显示，需要进行编码转换故我们选择进行重载，注意一定要选择重新加载！

然后发现Rider重新加载后，中文注释就能正确显示了

A.为了一劳永逸，我们可以在Rider中设置项目编码为GBK，避免每次打开文件都需要重新加载

B.使用更为统一的UTF-8（带BOM）编码，这样我们很多正常编译器均支持（推荐）

最后均可正常显示中文注释

解决Cloudflare搭建的图床跨域问题

Sun, 12 Oct 2025 18:31:33 GMT

1. 问题描述

最近在观察博客的控制台时发现有跨域问题,如下图所示:

2. 问题解决方法

对于这个我们只需要前往Cloudflare的控制面板,修改我们的规则即可

修改响应标头转换规则（Response Header Transform Rules）

前往Cloudflare的控制面板,选择你的域名,然后选择"规则"->"概述"->"响应标头转换规则",如下图所示: 然后如图依次添加以下标头以及其对应值，以及主机名=你的图床域名

[!NOTE]

Access-Control-Allow-Headers - *

Access-Control-Allow-MethodsAccess-Control-Allow-Methods - GET, HEAD, OPTIONS

Access-Control-Allow-Origin - *

国内使用Gemini的官方模型

Wed, 08 Oct 2025 17:37:02 GMT

通过EdgeOne的AI网关安全使用Gemini的官方模型

是否苦恼于具有Gemini的免费层级的API Key但是无法在国内使用？以及搭建中转服务器价格过于高昂？今天给大家带来一个新的解决方案，使用EdgeOne的AI网关来访问Gemini的官方模型

使用EdgeOne的AI网关的访问速度（国内）

这个速度可以说是比我们开启魔法或中转都要快，并且是官方模型，以下是AI网关的访问速度

1.获得AI Studio的API Key(Gemini官方且具有免费层级)

AI Studio请开启魔法进入

或者你已经具有自己的Gemini API Key也可以

2.注册EdgeOne并创建AI网关，进入该界面选择Gemini AI

[!NOTE] 记住以下内容

OE Key（请求头模板对应值）

Gateway Name（请求头模板对应值）

OE-AI-Provider（请求头模板对应值）

3.使用OpenWebUI来访问

3.1.进入OpenWebUI的函数页面来下载我的Pipe

::github{repo="Besty0728/OpenWebUI-EdgeOne-AI-Gemini"}

安装链接

https://github.com/Besty0728/OpenWebUI-EdgeOne-AI-Gemini/blob/main/edgeone_ai.py

3.2.安装后进行配置

对照上面的信息进行填写

自定义API请求地址（例：https://ai-gateway.eo-edgefunctions7.com/v1）
你的 API Key（使用负载均衡则使用,隔开）
模型名称（多个模型使用英文逗号,隔开）
OE Key（请求头模板对应值）
Gateway Name（请求头模板对应值）
OE-AI-Provider（请求头模板对应值）

3.3.开启后对话效果，十分迅速！

4.新更新：增加3系列支持、优化思维链、支持附加API调节特有信息

4.1.配置页面优化

4.2.支持思维链

4.3.支持附加API调节特有信息

关于在OpenWebUI中处理Base64返回的图片

Wed, 01 Oct 2025 17:59:24 GMT

::github{repo="Besty0728/OpenWebUI-Base64-Image"}

关于在OpenWebUI中处理Base64返回的图片

1.打开OpenWebUI的函数界面直接选择从新连接链接

https://github.com/Besty0728/OpenWebUI-Base64-Image/blob/main/image_decoder_pipe.py

2.安装完成后填写对应的参数

API基础URL：自定义请求模型供应商地址
API Key：自定义请求模型供应商的Key
模型ID：自定义请求模型供应商的模型名称
每次生成费用（元）：自定义请求模型供应商单次生成费用（可配合计费插件使用）
请求超时时间（秒）：自定义请求模型供应商的请求超时时间（等待图片）

完成后效果如下

使用云应用无服务器部署OpenWebUI

Wed, 01 Oct 2025 12:21:05 GMT

视频链接

雨云注册链接优惠码：star666

今天给大家带来无服务器部署OpenWebUI

雨云云应用商店选择OpenWebUI

然后选择创建即可，核心与内存建议2h2g，记住你的端口号（后续域名访问要用）

稍作等待，等你的公网ip+端口可访问后我们进入域名配置访问

Cloudflare配置域名访问

1.先去DNS配置，采取a记录，将你需要访问的域名（例：aiweb.cloudrunmax.top）;名称则为aiweb、解析内容为公网ip

2.配置端口转发规则，来到规则页面选择Origin Rules

名称随意，如下填写为：域名/*

传入端口则为上文你公网ip访问后的端口号

3.配置完成均激活后访问即可成功

关于如何在OpenWebUI中启用OpenAI的responses端点的模型

Sun, 21 Sep 2025 17:50:42 GMT

::github{repo="Besty0728/OpenWebUI-Cloudflare-OSS"}

关于如何在OpenWebUI中启用官方OpenAI的responses端点的模型

1.官方端点我们采用了社区关于responses端点的解决方案（实测正常使用官方端点）

社区解决方案链接先按照社区文档的步骤进行操作，安装这个Pipe；安装链接如下

https://github.com/jrkropp/open-webui-developer-toolkit/blob/main/functions/pipes/openai_responses_manifold/openai_responses_manifold.py

安装后需要我们对此Pipe进行一些修改，主要是修改你要请求的端点以及模型等

2.调用Cloudflare的OSS模型，采用我的Pipe

Cloudflare OSS模型调用文档

1.首先你需要去Cloudflare注册一个账号，然后创建一个API Token、获得你的账户ID，获得方法如图

账户ID获得方法
创建API Token，选择后续的WorkerAI模板即可

创建完成后你会获得一个API Token，复制保存好

2.然后我们安装我开发的Pipe

::github{repo="Besty0728/OpenWebUI-Cloudflare-OSS"}

安装链接

https://github.com/Besty0728/OpenWebUI-Cloudflare-OSS/blob/main/cloudflare_responses.py

Cloudflare Account ID处填写你刚才获得的账户ID
API Key处填写你刚才创建的API Token
模型名称处填写你要调用的模型名称，例如本次的@cf/openai/gpt-oss-120b，如果你要调用其他模型请参考Cloudflare的文档（以上只适用于responses端点的模型）

填入如图

3.最后别忘了启用该Pipe，以及某些模型的特定修改

例如本文的Cloudflare的OSS模型需要我们在参数处选择禁用Stream Chat Response（流式对话响应/流式输出；因为CF不支持流式输出调用该模型；也可以选择不修改，因为我的Pipe禁用了）

4.完成后即可愉快使用

实测支持OpenWebUI的联网工具等

我的ClaudeCode使用笔记

Sat, 20 Sep 2025 19:33:12 GMT

ClaudeCode使用笔记

或者前往这里

🧭ClaudeCode官方文档

有空更建议研究ClaudeCode官方文档

Claude Code 概述 - Claude Docs

🔥 重要指令

命令	功能	代码特殊示例
/mcp	管理 MCP 服务器连接与调试，查看可用服务、状态与权限	/mcp list 或 /mcp status
/init	生成CLAUDE.md；作为项目知识，每次对应项目对话都附带，是AI了解项目的基石《项目提示词》	无
/compact	压缩对话上下文，更节省Token消耗；可以附加提示词选择更侧重哪一方面（增加注意力）	/compact 主要保留前端部分对话
/clear	用于清除对话记录	无
think/thinkhard/thinkharder/ultrathink	这四个级别的提示词代表用于AI对问题的的思考程度	think “你的需求”
！	进入临时命令行模式，同时操作也可以被AI感知	！ npm install 安装依赖并通知AI
#	长期记忆模式，给项目或我们用户级别添加要Claude知道的东西（附加于CLAUDE.md文件下）用户级别的位于C/User/用户名/.claude文件夹下	# 用中文与我对话
/ide	开启ide集成（非常方便，注意要下载对应的插件）使用后，以VSCode举例，接近于VSCode原生Github Copilot下的Agent模式体验	无
claude -p “问题”	临时一次性对话，类似于一次性的Olllma本地模型
*Esc2/ /rewind**	claudecode2.0新增的检查点功能，回退代码！	无

📝 常用命令参考

<aside> ⭐高频操作集合，建议优先记忆 </aside>

基础命令

命令	功能	示例
claude	启动交互模式	claude
claude "task"	运行一次性任务	claude "fix the build error"
claude -p "query"	运行查询后退出	claude -p "explain this function"
claude -c	继续最近的对话	claude -c
claude -r	继续上一个对话	claude -r
claude commit	创建 Git 提交（个人不常用）	claude commit

交互模式命令

命令	功能
/clear	清除对话历史记录
/help	获取帮助信息
exit 或 Ctrl+C	退出 Claude Code

内置斜杠命令

<aside> ⚠️重要：IDE 绑定与上下文同步请使用 /ide（首次在 IDE 终端运行 claude 后，输入 /ide 选择要绑定的 IDE）。

环境变量：

ANTHROPIC_BASE_URL 自定义请求地址

ANTHROPIC_AUTH_TOKEN 自定义密钥

</aside>

命令	用途
/ide	重要绑定 IDE 并启用选择、诊断、差异等上下文同步
/add-dir	添加额外的工作目录
/bug	报告错误
/clear	清除对话历史
/config	查看/修改配置
/cost	显示令牌使用统计
/doctor	检查安装健康状况
/help	获取使用帮助
/init	使用 CLAUDE.md 初始化项目
/memory	编辑 CLAUDE.md 内存文件
/model	选择或更改 AI 模型
/permissions	查看或更新权限（Allow始终允许、Deny禁止使用、Workspace是项目始终允许）
/review	请求代码审查
/status	查看账户和系统状态
/vim	进入 vim 模式
/resume	找回历史话题（仅回退对话记录，无代码）
/export	将此次对话内容导出（粘贴板/文件）

<aside> 💡 小提示：遇到上下文不全时，先用 /permissions 检查权限，再用 /add-dir 补充目录。

</aside>

🧩 MCP 模块

MCP 工具与权限

工具	描述	需要权限
Bash	在您的环境中执行 shell 命令	是
Edit	对特定文件进行有针对性的编辑	是
Glob	基于模式匹配查找文件	否
Grep	在文件内容中搜索模式	否
MultiEdit	对单个文件原子性地执行多个编辑	是
NotebookEdit	修改 Jupyter notebook 单元格	是
NotebookRead	读取和显示 Jupyter notebook 内容	否
Read	读取文件内容	否
Task	运行子代理来处理复杂的多步骤任务	否
TodoWrite	创建和管理结构化任务列表	否
WebFetch	从指定 URL 获取内容	是
WebSearch	执行带有域过滤的网络搜索	是
Write	创建或覆盖文件	是

<aside> 🔧 在此处记录与 MCP（Model Context Protocol）相关的服务器、客户端、工具链与调试笔记。注意安装时建议退出ClaudeCode

</aside>

参考命令

命令	功能	示例
claude mcp add “mcp名称，建议与MCP相同”	增加MCP	claude mcp add context7 — npx @upstash/context7-mcp
这个就是按照文档里的来，结构为
claude mcp add MCP名称 — “command” + “args”
— scope user	添加为用户级别的MCP	就是在上文的MCP名称后添加
示例：claude mcp add context7 —scope user — npx @upstash/context7-mcp
/mcp	查看mcp服务器	无
claude mcp remove MCP名称	删除该MCP服务器	claude mcp remove context7
/permissions进入后选择Allow后mcp__MCP名称	位于Allow下面的工具/MCP无需确认，自动使用	mcp__ context7
claude —dangerously-skip-permissions	赋予最高权限	无

远程连接MCP视MCP文档命令即可

🔧工具与权限

工具	描述	需要权限
Bash	在您的环境中执行 shell 命令	是
Edit	对特定文件进行有针对性的编辑	是
Glob	基于模式匹配查找文件	否
Grep	在文件内容中搜索模式	否
MultiEdit	对单个文件原子性地执行多个编辑	是
NotebookEdit	修改 Jupyter notebook 单元格	是
NotebookRead	读取和显示 Jupyter notebook 内容	否
Read	读取文件内容	否
Task	运行子代理来处理复杂的多步骤任务	否
TodoWrite	创建和管理结构化任务列表	否
WebFetch	从指定 URL 获取内容	是
WebSearch	执行带有域过滤的网络搜索	是
Write	创建或覆盖文件	是

⚡自定义命令

1.项目自建自定义命令

项目文件的.claude文件夹下新建commands文件夹后，新建的.md文件名字即为命令名字

例如有一个code_review.md文件，内容为：对比当前这个分支与main分支的差异，提出你的review意见，并且生成应用过后的更新文件；或者是对比这个分支：$ARGUMENTS与main分支的差异，提出你的review意见，并且生成应用过后的更新文件

($ARGUMENTS 为占位符，可作为分支名称（变量）传入) 使用方法为/命令名字传入参数（可选）

2.用户级别自定义命令

将commands文件夹移动至C/User/用户名/.claude文件夹下即可（前文的CLAUDE.md同位置）

📞Hook（自动执行）

1.项目建立Hook

.claude文件夹下建立setting.json或·setting.local.json（更高权限）

例如以下这个自动修复 markdown 文件中缺失的语言标签和格式问题（适合编写我们的博客文件后检查）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/markdown_formatter.py"
          }
        ]
      }
    ]
  }
}

Hook调用时机：

PreToolUse：在工具调用之前运行（可以阻止它们）
PostToolUse：在工具调用完成后运行
UserPromptSubmit：当用户提交提示时运行，在 Claude 处理之前
Notification：当 Claude Code 发送通知时运行
Stop：当 Claude Code 完成响应时运行
SubagentStop：当子代理任务完成时运行
PreCompact：在 Claude Code 即将运行压缩操作之前运行
SessionStart：当 Claude Code 开始新会话或恢复现有会话时运行
SessionEnd：当 Claude Code 会话结束时运行

🛠️Sub Agent（子智能体并行执行）

使用方法：/agents 后选择是适用于项目还是用户级别

填写对应的描述以及结果（类似于我们的模型系统提示词）

使用这个的好处是可以将任务拆分为多个小任务，并且获得独属于每个确认子任务的精简上下文，不被上下文污染，效率与准确度更棒！

🚥代码回退（Claudecode2.0之前的依靠额外插件，但强烈支持）

下载Github开源项目ccundo

GitHub - RonitSachdev/ccundo: ccundo seamlessly integrates with Claude Code to provide granular undo functionality. It reads directly from Claude Code's session files to track file operations and allows you to selectively revert changes with full preview and cascading safety.

安装命令

npm install -g ccundo

使用：

ccundo list 列出对话记录

ccundo undo 编号 即可回退该对话的代码

🌐可视化版本推荐

Github项目opcode

如何修改Windows用户名

Fri, 19 Sep 2025 23:21:47 GMT

1.首先你需要打开你的命令提示符（管理员权限），然后输入以下命令来开启超级用户去修改你的用户名：

net user administrator /active:yes

2.然后按下Alt+F4，选择切换用户，切换到管理员账户（Administrator）

3.在任务管理器（Ctrl+Shift+Esc）关闭之前的用户所有进程

4.先重命名用户文件夹（C:\Users\原中文用户名）为（C:\Users\新英文用户名）

如果存在仍有进程在运行问题，则开启你的资源监视器（Ctrl+Shift+Esc下的性能页面右上角的“打开资源监视器”）

然后在资源监视器的CPU页面的关联句柄搜索框中输入你的用户名，找到相关进程并结束它们（需要重启则重启，后续仍选择超级管理员，误进入原来的用户导致错乱后果自负！！！）

5.然后打开注册表编辑器（Win+R，输入regedit回车），定位到以下路径：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList\S-1-5-21-1144158939-3632170427-3967875196-1001（一般是第三个，选中有你用户名的即可）

修改<ins>ProfileImagePath</ins>

6.更改完成注册表后，按下Alt+F4，选择切换用户，切换到你的新英文用户名即可

然后打开任务管理器（Ctrl+Shift+Esc）关闭管理员账户所有进程；再打开命令提示符（管理员权限），然后输入以下命令来关闭超级用户：

net user administrator /active:no

7.配置文件看的是你C盘根目录下的Users文件夹下的用户名文件夹，并非是设置里的用户名

Google AI Studio的汉化插件

Mon, 15 Sep 2025 00:00:00 GMT

首先确保你已经安装了暴力猴插件（Violentmonkey）/篡改猴插件（Tampermonkey）并且正常开启了它们的功能，如果没有安装请前往<a href="https://microsoftedge.microsoft.com/addons/detail/%E6%9A%B4%E5%8A%9B%E7%8C%B4/eeagobfjdenkkddmbclomhiblgggliao" target="_blank" rel="noopener">暴力猴</a>或<a href="https://microsoftedge.microsoft.com/addons/detail/%E7%AF%A1%E6%94%B9%E7%8C%B4/iikmkjmpaadaobahmlepeloendndfphd" target="_blank" rel="noopener">篡改猴</a>下载安装。 <img src="/images/monkey.webp" alt="monkey" /> <img src="/images/monkeyy.webp" alt="monkey" /> 安装完成后在暴力猴插件或篡改猴插件的仪表盘里点击“添加新脚本”，然后前往脚本安装地址<a href="https://greasyfork.org/zh-CN/scripts/549999-google-ai-studio-%E6%B1%89%E5%8C%96%E8%84%9A%E6%9C%AC" target="_blank" rel="noopener">此处</a>

考虑到翻译脚本过于冗长，不利于博客文章流畅性，因此不在此处贴出脚本内容，请前往上述标签安装即可

<img src="/images/aistudio.webp" alt="monkey" /> 安装完成后刷新 AI Studio 页面即可看到大部分界面已经被汉化了。

Unity配置MCP实现自动化

Tue, 12 Aug 2025 08:45:29 GMT

这里只介绍三种配置示例，不会的去看视频；链接：<a href="https://www.bilibili.com/video/BV1gqtozaE4G/?vd_source=2eb5b7bd2c2ae3d60105b79832451ecc">利用GithubCopilot实现Unity自动化（MCP）_哔哩哔哩_bilibili</a> VSCode傻瓜式一键即可 <div> <div> <pre><code>{</code> <code> "servers": {</code> <code> "github": {</code> <code> "type":"http"</code> <code> "url":"https://api.githubcopilot.com/mcp</code> <code> "gallery":true</code> <code> },</code> <code> "unityMCP": {</code> <code> "command": "C:\Users\Betsy\AppData\Roaming\Python\Python313\Scripts\uv.exe",</code> <code> "args": [</code> <code> "--directory",</code> <code> "C:\Users\Betsy\AppData\Local\Programs\UnityMCP\UnityMcpServer\src",</code> <code> "run",</code> <code> "server.py"</code> <code> ],</code> <code> "type": "stdio"</code> <code> }</code> <code> }, "inputs":[]</code> <code>}</code></pre> </div> <div>Rider：（以上的GithubMCP可以选择不要,只要servers里包含我们的UnityMCP即可）</div> <div> <div> <pre><code>{</code> <code> "servers": {</code> <code> "github": {</code> <code> "url": "https://api.githubcopilot.com/mcp/",</code> <code> "requestInit": {</code> <code> "headers": {</code> <code> "Authorization": "你的GithubPAT密钥"</code> <code> }</code> <code> }</code> <code> },</code> <code> "unityMCP": {</code> <code> "command": "C:\Users\Betsy\AppData\Roaming\Python\Python313\Scripts\uv.exe",</code> <code> "args": [</code> <code> "--directory",</code> <code> "C:\Users\Betsy\AppData\Local\Programs\UnityMCP\UnityMcpServer\src",</code> <code> "run",</code> <code> "server.py"</code> <code> ],</code> <code> "type": "stdio"</code> <code> }</code> <code> }</code> <code>}</code></pre> </div> </div> <div>Visual Studio：（这个是我最想喷的，官方给的mcp配置也是云里雾里的。。。目前最新版本是17.14，在你项目下面要建立一个<code>.mcp.json</code>文件才可以，重启才能生效！！！）</div> <div><img src="/images/image-1755016952760-375474964.webp"></div> <div>VS配置直接复用VSCode的UnityMCP即可，GithubMCP要使用和Rider一样的PAT认证</div> <div> <pre><code>{</code> <code> "servers": {</code> <code> "github": {</code> <code> "url": "https://api.githubcopilot.com/mcp/",</code> <code> "authorization_token": "你的GithubPAT密钥"</code> <code> }, </code> <code> "unityMCP": {</code> <code> "command": "C:\Users\Betsy\AppData\Roaming\Python\Python313\Scripts\uv.exe",</code> <code> "args": [</code> <code> "--directory",</code> <code> "C:\Users\Betsy\AppData\Local\Programs\UnityMCP\UnityMcpServer\src",</code> <code> "run",</code> <code> "server.py"</code> <code> ],</code> <code> "type": "stdio"</code> <code> }</code> <code> }, "inputs":[]</code> <code>}</code></pre> </div> </div>

如何获得Github教育优惠

Tue, 12 Aug 2025 08:35:00 GMT

前提： <ol> <li>具有一个教育邮箱（学校可能会给你，没有就去申请）</li> <li>学信网的认证材料或录取通知书照片</li> <li>认证时要获得你的ip位置，不要开启魔法！！！建议使用手机端认证（要求拍摄）</li> </ol> 我们进入你的Github页面，先绑定你的教育邮箱 <img src="/images/image-1755015434244-210524120.webp" alt="" width="2046" height="441"> 然后前往教育福利页面，直接选择你的教育邮箱即可 <img src="/images/image-1755015271686-94799935.webp" alt="" width="528" height="783"> 然后填写你的信息 <img src="/images/image-1755015645118-965159280.webp" alt="" width="776" height="723"> 后续选择认证材料你选哪个根据你的材料来（学信网选择ID） <img src="/images/image-1755015717542-789384846.webp" alt="" width="675" height="597"> 注意！！！不要直接提交你的材料，因为Github目前采用的是机器OCR（文字识别），对中文的成功率很低，建议使用英文版本的材料或者将你的材料用人为的方式手写成一个英文版本，不麻烦！！！（电脑记事本就可以） 以下是我学信网在线验证报告直接ai翻译得来的，实测成功 <img src="/images/image-1755016079865-815771810.webp" alt="" width="1616" height="947"> 然后在记事本里直接打出来 <img src="/images/image-1755016256695-316685712.webp"> 下一步里如果触发了你距离学校远的话，直接选择始终远程教学就行，拍摄再拍一次上面的就行 再提一嘴，如果不放心可以选择更改你的github个人资料，与你文件中的名字一致即可，学校选择你的学校就行，按照上述操作大概率认证成功 <img src="/images/image-1755016403916-475070115.webp"> 注意，认证成功后是批准，72小时内下发你的权益（GithubCopilotPro等）；不过判断是否通过还是很快的 Github学生认证后去仔细查看Github学生包，里面有很多超值服务；保底都4个免费一年的域名以及各种软件的教育优惠（JetBrain、Notion等等） 早认证，早享受！！！

Gemini-balance部署指南(非docker)

Sun, 10 Aug 2025 06:55:17 GMT

方便美观(我懒得重新编辑了) 网页版:<a href="https://geminiguide.ai0728.com.cn">Gemini Balance部署</a>或<a href="https://lizard-parcel-a96.notion.site/Gemini-Balance-24a5723cc6b580d9afd8c09a9f760a13">Notion笔记</a> Markdown文件:<a href="https://cloudrunmax.top/s/gXfx/GeminiGuide">Gemini-Balance部署Markdown</a>

关于OpenWebUI外部访问的细节错误

Sat, 02 Aug 2025 07:30:35 GMT

关于这个错误： <h1 class="gh-header-title flex-auto wb-break-word f1 mr-0">SyntaxError： Unexpected token 'd'， “data： {”id“...JSON 无效</h1> <img src="/images/image-1754148558836-843256870.webp"> 这个是因为你的服务没有开启websocket导致的，开启的地方主要有两处： <ol> <li>nginx没有开启websocket支持（添加我标注的蓝色部分即可） <img src="/images/image-1754148814476-105309073.webp" alt="" width="1321" height="786"></li> <li>你的域名服务商没有开启websocket支持（我个人踩过最深的坑） 以我使用的EdgeOne为例，EdgeOne默认不开启Websocket支持 <img src="/images/image-1754148546904-319018769.webp"> CloudFlare默认全部计划均开启且支持Websocket <img src="/images/image-1754148603332-270641179.webp"></li> </ol>

Unity调用OpenWeatherAPI查询天气

Thu, 24 Jul 2025 01:03:07 GMT

<h2>1. 准备资源</h2> A. 网站官方：<a href="https://openweathermap.org/">https://openweathermap.org/</a> (创建账户，获得免费API Key) B. 网站API文档调用示例：<a href="https://openweathermap.org/current">当前天气数据 - OpenWeatherMap</a> C. 网站地理编码API文档示例：<a href="https://openweathermap.org/api/geocoding-api">地理编码 API - OpenWeatherMap</a> D. 网站天气图标获取(采用F12检查台来获取源图片)：<a href="#How-to-get-icon-URL">天气状况 - OpenWeatherMap</a> <h2>2. 界面搭建</h2> <img src="/images/image-1753347351824-766386576.webp" alt=""> <img src="/images/image-1753347365939-458403350.webp" alt=""> <h2>3. 编写详细脚本</h2> A.创建按钮与输入框，检查事件/监听事件 <img src="/images/image-1753347438843-50591915.webp" alt=""> <img src="/images/image-1753347452518-259337095.webp" alt="" width="468" height="28"> <img src="/images/image-1753347467202-834195448.webp" alt=""> <img src="/images/image-1753347479053-641590858.webp" alt=""> B.创建天气图标加载，采用字典，从持久化文件夹的一个文件夹中加载该图标集合 <img src="/images/image-1753347500126-612710467.webp" alt=""> <img src="/images/image-1753347511105-915289023.webp" alt=""> <img src="/images/image-1753347523858-994668070.webp" alt=""> C.创建协程，进行网络查询请求(Get Post) <img src="/images/image-1753347553329-184317497.webp" alt="" width="808" height="127"> <img src="/images/image-1753347572391-956391829.webp" alt=""> D.此处要深度对照API文档实例的各项数据 例如：geturl是对应地理编码API，这样才可以实现输入名称来查询，而不是对照编码查询 Varurl是对应当前天气数据的API(查询主力) UnityWebRequest是Unity提供用于网络请求Http(s)的类，SendWebRequest是发送网络请求 GetJsonYN是下面的一个统一处理方法 <img src="/images/image-1753347599242-521568104.webp" alt=""> E.更新文本UI绝对的对照Json文件 <img src="/images/image-1753347644717-22499377.webp" alt=""> <img src="/images/image-1753347661716-939041786.webp" alt=""> Cache为上文创建的字典 F. 风向选择解析 内部包含16方向360/16=22.5，按照索引排序选择对应风向 这是将角度转换为数组索引的核心计算。 degrees + 11.25: 将角度偏移半个区间 (22.5 / 2 = 11.25)。这样做是为了让每个风向区间的中心对齐。例如，0度（正北）应该落在 "北风" 区间。加上11.25后，0度就变成了11.25，除以22.5是0.5，取整后是0，对应 "北风"。22.5度（东北偏北和东北的边界）加上11.25是33.75，除以22.5是1.5，取整后是1，对应 "东北偏北风"。 / 22.5: 将调整后的角度除以每个风向区间的宽度，得到一个浮点数索引。 (int)(...): 将结果转换为整数，截断小数部分，得到初步的索引。 % 16: 取模16，确保索引值始终在 0 到 15 之间，以对应 directions 数组的有效索引范围。例如，360度（等同于0度）经过计算后也能正确映射到 "北风"。 return directions[index];: 使用计算得到的 index 从 directions 数组中取出对应的风向字符串并返回。 <img src="/images/image-1753347697499-969070799.webp" alt=""> G.挂载脚本 <img src="/images/image-1753347718981-523560948.webp" alt=""> <a href="https://cloud.ai0728.com.cn/s/8LTv/OpenWeather" target="_blank" rel="noopener">源脚本</a>