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

Unity-Skills 被 DeepWiki 收录 —— 我的开源项目新里程碑

Tue, 10 Feb 2026 17:00:00 GMT

Unity-Skills × DeepWiki

::github{repo="Besty0728/Unity-Skills"}

今天打开 DeepWiki 发现，我的 Unity-Skills 项目已经被完整收录并自动生成了结构化技术文档。

作为一个独立开发者，看到自己的项目被知识索引平台收录，确实是一个值得记录的里程碑。

DeepWiki 收录页面

DeepWiki 做了什么？

DeepWiki 是一个基于 AI 的代码知识库平台，它会自动分析 GitHub 仓库的源码，生成可交互的技术文档，包括：

架构概览：自动梳理系统组件和核心设计模式
设计原则：提炼出 Reflection-Based Skill Discovery、Batch 操作、Token 优化、Domain Reload Recovery 等核心理念
技能分类索引：将 277+ Skills 按类别结构化展示
AI 平台集成说明：清晰呈现对 Claude Code、Antigravity、Gemini CLI、Codex 的适配细节

换句话说，DeepWiki 把我写的代码和文档，自动转化成了一份让人一目了然的技术百科。

回顾 Unity-Skills

Unity-Skills 是我目前投入最多精力的项目——一个基于 REST API 的 AI 驱动型 Unity 编辑器自动化框架。

截至文章发布日期2026-02-10目前已经迭代到 v1.4.3，收获了 103 Stars

它解决了什么？

做 Unity 开发时，我发现一个痛点：

向 AI 描述 Unity 场景结构太费劲，来回沟通效率极低。重复性操作（创建物体、配置组件、调参数）占据大量时间，而现有工具缺少批处理和安全回滚能力。

于是 Unity-Skills 诞生了。核心思路很简单——让 AI 通过 HTTP 请求直接操控 Unity 编辑器，不再需要人工中转。

核心亮点

特性	说明
277+ Skills	覆盖 GameObject、Component、Scene、Material、Prefab、Light 等全类别操作
Batch 批处理	一次请求完成多个操作，大幅减少 HTTP 通信开销
事务回滚	操作失败自动回滚，场景零残留
Token 优化	Result Truncation + 精简 SKILL.md，Token 消耗降低约 40%
多实例支持	自动端口发现 + 全局注册表，同时操控多个 Unity 项目
全平台兼容	Claude Code / Antigravity / Gemini CLI / Codex 均完美支持

一些数字

⭐ 项目从第一个 commit 到现在，Skills 从最初的不到 100 个增长到 277+
🎥 独家支持 Cinemachine 2.x/3.x 双版本自动检测与安装
🔌 4 大 AI 终端深度适配，是目前兼容性最广的 Unity AI 自动化方案之一

被收录意味着什么？

对我来说，DeepWiki 的收录不仅仅是"多了一个展示页面"，更是一种技术可见性的证明：

代码质量被认可：DeepWiki 的 AI 能够正确理解并梳理项目架构，说明代码组织和文档都达到了一定水准
降低上手门槛：新用户可以通过 DeepWiki 快速了解项目全貌，不需要逐个文件翻阅
社区发现性提升：更多开发者能通过知识检索找到 Unity-Skills，扩大项目影响力

下一步

Unity-Skills 还在持续迭代：

📦 持续扩充 Skill 库，覆盖更多 Unity 编辑器场景
⚡ 性能优化持续进行
🤖 跟进最新 AI 终端的集成规范

如果你也在用 AI 辅助 Unity 开发，欢迎试试：

::github{repo="Besty0728/Unity-Skills"}

https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity

项目地址：GitHub - Besty0728/Unity-Skills
DeepWiki 页面：deepwiki.com/Besty0728/Unity-Skills

还在嫌弃Windows难用？不妨来体验一下隐藏功能

Sun, 19 Apr 2026 16:54:54 GMT

1.你的Windows是否一样反人类？

起因是因为宿舍断电，我有时候要在黑暗环境里完成编写收尾，但是即使我亮度拉到最小，平时舒适的白色也会非常刺眼，于是想切换到深色模式，结果一查资料，切换很是麻烦，好在我们发现了官方提供的有用的工具，本篇的主角--PowerToys

2.PowerToys是什么？

PowerToys是微软官方出品的是一系列帮助你定制 Windows 和简化日常任务的工具，它提供了很多我们期望的功能，来让我们的Windows变得更加人性化，是一个优秀的高级工具

项目地址

::github{repo="microsoft/PowerToys"}

同样你可以前往你的Microsoft应用商店里面去直接下载

再或者使用Winget

winget install Microsoft.PowerToys -s winget

3.PowToys的推荐功能

1.光暗一键切换

本篇文章初始最想解决的痛点，一键切换（启动PowerToys的前提下，所以我们建议设置为开机自启）

2.快速浏览文件

类似于MacOS中的空格按下查看文件，之前我是使用QuickLook这个软件来实现的这种功能

3.固定置顶窗口

这个非常利好于我们避免聚焦的软件切换而遮挡想要获取的信息，传统的分屏会让软件比例拉伸，不利于观感

4.鼠标快速寻找

平时在大比例显示器中会出现找不到自己的鼠标去哪里了，我们还要费时间去寻找它，这个功能帮我们快速寻找到鼠标

5.自定义布局

这个可以让你自定义设定好你喜欢的应用比例布局，相对实用

6.颜色提取器

这个可以让你方便的提取任何地方的色彩信息，不用打开图像工具或寻找源码等，支持多种格式

7.文本提取器

这个其实就是底层的OCR技术，将支持的文字直接复制到你的剪贴板里，还是可以的

Claude Code 终端美化指南

Thu, 26 Feb 2026 23:02:54 GMT

不少同学初次接触 Claude Code 时，多少会对纯命令行界面的"朴素"感到不适——毕竟大家日常都习惯了 IDE 的丰富界面。好消息是，只需要几步简单的配置，就能让你的 Claude Code 焕然一新。

1. 状态栏优化

默认的 Claude Code 终端没有任何额外的状态信息展示，看起来相当单调。这里推荐一个开箱即用的状态栏工具 ccstatusline：

::github{repo="sirmalloc/ccstatusline"}

美化前

原始状态下，Claude Code 的终端是这样的：

美化后

添加状态栏后，立刻变得信息丰富且美观：

以及

安装与配置

前提条件：Windows 系统，已安装 Node.js

只需一条命令即可完成安装：

npx ccstatusline@latest

安装完成后会进入交互式配置界面，你可以根据个人喜好自由定制（也可参照官方文档进行更深度的自定义配置，包括安装 Powerline 字体等）：

以下是我个人的配置方案，供参考：

Edit Lines
- Line 1：保留 4 个默认组件（模型名称、上下文窗口、Git 分支、改动数量）
- Line 3：添加 Custom Text（自定义文本：Betsy-ClaudeCode）+ Session Clock（会话计时器）
Powerline Setup
- 除 Align Widgets 外全部启用
- Separator：Triangle Right | Start Cap：Lower Triangle | End Cap：Triangle
- Themes：Nord-aurora 配色方案
Terminal Options
- Color Level：Truecolor（确保终端色彩还原度最佳）

配置完成后，可以在 Claude Code 的 settings.json 中确认是否生效：

"statusLine": {
    "command": "ccstatusline",
    "type": "command"
}

2. 字体美化

一款优秀的等宽字体不仅能提升代码可读性，还能让终端整体观感大幅提升。这里个人强烈推荐 Maple Mono NF CN ——一款同时支持中英文的等宽编程字体，内置 Nerd Font 图标：

::github{repo="subframe7536/maple-font"}

方式一：可视化配置各个终端

在任何窗口点击设置，进入后选择对应终端修改即可

方式二：让 Claude Code 帮你改（懒人推荐）

如果你的电脑已安装该字体，直接把下面这段话发给 Claude Code，让它帮你完成配置：

现在帮我将终端字体显示改为 Maple Mono NF CN ，字体路径.....

方式三：手动修改 Windows Terminal 配置

找到 Windows Terminal 的配置文件：

C:\Users\<你的用户名>\AppData\Local\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

在 profiles.defaults 中添加字体配置：

"defaults": {
    "font": {
        "face": "Maple Mono NF CN"
    }
}

方式三：IDE 内使用

如果你主要在 VS Code 等 IDE 中使用 Claude Code，直接在 IDE 的设置中修改IDE整体字体为 Maple Mono NF CN 即可。

3. 背景美化

上文字体可视化配置同理，下滑到对应位置修改即可

4. 最终效果对比

经过状态栏 + 字体的双重美化，来看看前后对比：

美化前：

美化后：

添加背景美化后

是不是瞬间从"原始人终端"变成了"赛博朋克工作站"？赶紧动手试试吧！

ClaudeCode下载代理(Worker)

Tue, 24 Feb 2026 23:15:08 GMT

1. Claude Code 是什么？

简单来讲，Claude Code 就是一款 AI 智能编程工具，具有强大的 Vibe Coding 能力，详细介绍请看 Claude Code 使用笔记。

2. 入门安装

由于不可抗因素，Claude 的母公司 Anthropic 对中国大陆拒绝提供 AI 服务，禁止使用 Claude 系列模型。但我们仅仅只是想使用 Claude Code 这个工具（Claude Code ≠ AI 模型），所以不要再发出类似于"Cursor 不如 Claude"这种驴唇不对马嘴的言论了。

官方的 NPM 安装方式已处于废弃状态，更推荐使用原生安装。

但正如前文所说，如果直接使用官方命令（国内正常网络环境下）：

irm https://claude.ai/install.ps1 | iex

大概率会得到以下报错：因此，我们提供了基于 Cloudflare Worker 的加速下载方案。

3. Worker 配置

3.1 核心 Worker 代码

请将 SELF_BASE 修改为你要使用的加速域名：

const CLAUDE = "https://claude.ai";
const SELF_BASE = "https://你的加速域名";
const ALLOWED_INSTALL = new Set(["/install.ps1", "/install.sh", "/install.cmd"]);
// 安装脚本体积上限 1MB（正常脚本 <50KB，此值仅防异常/被劫持场景）
const MAX_INSTALL_SCRIPT_SIZE = 1 * 1024 * 1024;

function isAllowedGcsPath(p) {
  // 只允许 claude-code-dist-* bucket 下的路径
  const pathOnly = p.split('?')[0];
  return /^claude-code-dist-[0-9a-f\-]+\//.test(pathOnly);
}

function withTimeout(ms) {
  const controller = new AbortController();
  const id = setTimeout(
    () => controller.abort(new Error("Upstream fetch timeout")),
    ms
  );
  return { controller, cancel: () => clearTimeout(id) };
}

/** 安全文本响应头 */
function secHeaders(extra = {}) {
  return {
    "Content-Type": "text/plain; charset=utf-8",
    "Cache-Control": "no-store",
    "X-Content-Type-Options": "nosniff",
    "X-Frame-Options": "DENY",
    ...extra,
  };
}

async function buildUpstreamErrorResponse({
  title,
  upstreamResp,
  extraHeaders = {},
}) {
  // 消费 body 防止连接泄漏
  try { await upstreamResp.text(); } catch {}

  const body = [
    title,
    `Time: ${new Date().toISOString()}`,
    `Upstream status: ${upstreamResp.status}`,
  ].join("\n");

  return new Response(body, {
    status: 502,
    headers: secHeaders({
      "X-Proxy-Error": "upstream_non_ok",
      ...extraHeaders,
    }),
  });
}

export default {
  async fetch(request) {
    const url = new URL(request.url);
    let path = url.pathname;

    // ===== 处理 OPTIONS 预检请求 =====
    if (request.method === "OPTIONS") {
      return new Response(null, {
        status: 204,
        headers: {
          "Access-Control-Allow-Origin": "*",
          "Access-Control-Allow-Methods": "GET, HEAD, OPTIONS",
          "Access-Control-Allow-Headers": "Content-Type, User-Agent, Accept, Accept-Encoding",
          "Access-Control-Max-Age": "86400",
        },
      });
    }

    // ===== 只允许 GET / HEAD =====
    if (!["GET", "HEAD"].includes(request.method)) {
      return new Response("Method Not Allowed", {
        status: 405,
        headers: secHeaders(),
      });
    }

    if (path === "/favicon.ico") {
      return new Response(null, { status: 204 });
    }

    // 健康检查页面
    if (path === "/") {
      const clientIp = request.headers.get("CF-Connecting-IP") || "unknown";
      const clientCountry = request.headers.get("CF-IPCountry") || "unknown";

      const checks = await Promise.allSettled([
        (async () => {
          const { controller, cancel } = withTimeout(15000);
          try {
            const resp = await fetch(CLAUDE + "/install.ps1", {
              signal: controller.signal,
              headers: { "User-Agent": "Mozilla/5.0" },
            });
            cancel();
            if (!resp.ok) return { ok: false, msg: `HTTP ${resp.status}` };
            const text = await resp.text();
            const hasGcs = text.includes("storage.googleapis.com/");
            const rewritten = text.replace(
              /\$GCS_BUCKET = "https:\/\/storage\.googleapis\.com\/([^"]+)"/g,
              `$GCS_BUCKET = "${SELF_BASE}/gcs/$1"`
            );
            const ok = rewritten.includes(SELF_BASE + "/gcs/");
            return { ok, msg: ok ? "拉取成功，改写正常" : (hasGcs ? "正则未匹配" : "源脚本无 GCS 链接") };
          } catch (e) {
            cancel();
            return { ok: false, msg: String(e) };
          }
        })(),
        (async () => {
          const { controller, cancel } = withTimeout(20000);
          try {
            const resp = await fetch(
              `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest`,
              { signal: controller.signal, headers: { "User-Agent": "CloudflareWorker/1.0" } }
            );
            cancel();
            if (!resp.ok) return { ok: false, msg: `HTTP ${resp.status}` };
            const version = (await resp.text()).trim();
            return { ok: true, msg: `版本: ${version}` };
          } catch (e) {
            cancel();
            return { ok: false, msg: String(e) };
          }
        })(),
      ]);

      const ps1Status = checks[0].status === "fulfilled" ? checks[0].value : { ok: false, msg: "检查失败" };
      const gcsStatus = checks[1].status === "fulfilled" ? checks[1].value : { ok: false, msg: "检查失败" };

      const html = `<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Claude Code Proxy - 健康检查</title>
  <style>
    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 40px; background: #f5f5f5; }
    .container { max-width: 600px; margin: 0 auto; background: white; padding: 30px; border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); }
    h1 { color: #333; margin-bottom: 30px; }
    .check { margin: 20px 0; padding: 15px; border-left: 4px solid #ddd; background: #fafafa; }
    .check.ok { border-left-color: #22c55e; background: #f0fdf4; }
    .check.fail { border-left-color: #ef4444; background: #fef2f2; }
    .status { font-weight: bold; margin-bottom: 5px; }
    .status.ok { color: #22c55e; }
    .status.fail { color: #ef4444; }
    .msg { color: #666; font-size: 14px; }
    .info { margin-top: 30px; padding: 15px; background: #f0f9ff; border-left: 4px solid #3b82f6; }
    .info-title { font-weight: bold; color: #1e40af; margin-bottom: 8px; }
    .info-item { color: #666; font-size: 14px; margin: 5px 0; }
  </style>
</head>
<body>
  <div class="container">
    <h1>✓ Claude Code Proxy 运行正常</h1>

    <div class="check ${ps1Status.ok ? "ok" : "fail"}">
      <div class="status ${ps1Status.ok ? "ok" : "fail"}">
        ${ps1Status.ok ? "✓" : "✗"} install.ps1 改写
      </div>
      <div class="msg">${ps1Status.msg}</div>
    </div>

    <div class="check ${gcsStatus.ok ? "ok" : "fail"}">
      <div class="status ${gcsStatus.ok ? "ok" : "fail"}">
        ${gcsStatus.ok ? "✓" : "✗"} GCS 代理
      </div>
      <div class="msg">${gcsStatus.msg}</div>
    </div>

    <div class="info">
      <div class="info-title">访问者信息</div>
      <div class="info-item">IP: ${clientIp}</div>
      <div class="info-item">地区: ${clientCountry}</div>
      <div class="info-item">时间: ${new Date().toISOString()}</div>
    </div>

    <div style="margin-top:20px;padding:15px;background:#fff3cd;border:1px solid #ffc107;border-radius:4px;">
      <strong>声明</strong>
      <p style="margin:8px 0;font-size:14px;color:#333;">本站为非官方代理，仅用于中国大陆加速 Claude Code 安装。</p>
      <p style="margin:8px 0;font-size:14px;">官方网站：<a href="https://claude.ai" target="_blank" rel="noopener" style="color:#0066cc;">https://claude.ai</a></p>
    </div>
  </div>
</body>
</html>`;

      return new Response(html, {
        status: 200,
        headers: { "Content-Type": "text/html; charset=utf-8" },
      });
    }

    // 安装脚本：从 claude.ai 拉取，改写 GCS 链接指向自身
    if (ALLOWED_INSTALL.has(path)) {
      const upstreamUrl = CLAUDE + path;
      const { controller, cancel } = withTimeout(15000);

      let upstream;
      try {
        const fetchOpts = {
          method: request.method,
          headers: {
            "User-Agent": request.headers.get("User-Agent") || "Mozilla/5.0",
            Accept: "*/*",
          },
          redirect: "follow",
          signal: controller.signal,
        };
        upstream = await fetch(upstreamUrl, fetchOpts);
      } catch (e) {
        cancel();
        return new Response(
          `Upstream fetch failed (install script)\nTime: ${new Date().toISOString()}\nError: ${String(e)}\n`,
          {
            status: 504,
            headers: secHeaders({ "X-Proxy-Error": "install_fetch_failed" }),
          }
        );
      } finally {
        cancel();
      }

      // HEAD 直接透传状态 + 头（不读 body）
      if (request.method === "HEAD") {
        const h = new Headers(upstream.headers);
        h.set("Cache-Control", "no-store, max-age=0, must-revalidate");
        h.set("Pragma", "no-cache");
        h.set("Expires", "0");
        h.set("X-Content-Type-Options", "nosniff");
        h.set("X-Proxy-Source", `rewrite:${path}`);
        return new Response(null, { status: upstream.status, headers: h });
      }

      if (!upstream.ok) {
        return buildUpstreamErrorResponse({
          title: "Failed to fetch install script from claude.ai",
          upstreamResp: upstream,
          extraHeaders: { "X-Proxy-Source": `rewrite:${path}` },
        });
      }

      // ---- 大小保护：先查 Content-Length 头 ----
      const cl = Number(upstream.headers.get("content-length") || "0");
      if (cl > MAX_INSTALL_SCRIPT_SIZE) {
        await upstream.body?.cancel();
        return new Response(
          `Install script too large (content-length: ${cl})\n`,
          {
            status: 502,
            headers: secHeaders({ "X-Proxy-Source": `rewrite:${path}` }),
          }
        );
      }

      const text = await upstream.text();

      // ---- 大小保护：再查实际 body 长度（Content-Length 可能缺失或不准） ----
      if (text.length > MAX_INSTALL_SCRIPT_SIZE) {
        return new Response("Install script body too large\n", {
          status: 502,
          headers: secHeaders({ "X-Proxy-Source": `rewrite:${path}` }),
        });
      }

      // 改写 GCS 链接 → 走自身代理
      // PowerShell: $GCS_BUCKET = "https://storage.googleapis.com/..."
      let rewritten = text.replace(
        /\$GCS_BUCKET = "https:\/\/storage\.googleapis\.com\/([^"]+)"/g,
        `$GCS_BUCKET = "${SELF_BASE}/gcs/$1"`
      );
      // Shell: GCS_BUCKET="https://storage.googleapis.com/..."
      rewritten = rewritten.replace(
        /GCS_BUCKET="https:\/\/storage\.googleapis\.com\/([^"]+)"/g,
        `GCS_BUCKET="${SELF_BASE}/gcs/$1"`
      );
      // CMD: set "GCS_BUCKET=https://storage.googleapis.com/..."
      rewritten = rewritten.replace(
        /set "GCS_BUCKET=https:\/\/storage\.googleapis\.com\/([^"]+)"/g,
        `set "GCS_BUCKET=${SELF_BASE}/gcs/$1"`
      );

      return new Response(rewritten, {
        status: 200,
        headers: {
          "Content-Type": "text/plain; charset=utf-8",
          "Cache-Control": "no-store, max-age=0, must-revalidate",
          Pragma: "no-cache",
          Expires: "0",
          "X-Content-Type-Options": "nosniff",
          "X-Proxy-Source": `rewrite:${path}`,
        },
      });
    }

    //  /gcs/*：代理到 storage.googleapis.com（白名单路径）
    if (path.startsWith("/gcs/")) {
      const gcsPath = path.slice("/gcs/".length);

      if (!isAllowedGcsPath(gcsPath)) {
        return new Response("Forbidden", { status: 403, headers: secHeaders() });
      }

      // 转发查询字符串
      const target = `https://storage.googleapis.com/${gcsPath}${url.search}`;

      // 白名单转发请求头，不泄漏 Cookie / Authorization / 用户 IP 等
      const fwdHeaders = new Headers();
      const FORWARD = [
        "Range",
        "Accept",
        "Accept-Encoding",
        "If-None-Match",
        "If-Modified-Since",
      ];
      for (const h of FORWARD) {
        const v = request.headers.get(h);
        if (v) fwdHeaders.set(h, v);
      }
      fwdHeaders.set("User-Agent", "CloudflareWorker/1.0");

      // exe/二进制文件按版本路径缓存，latest 和 manifest 不缓存
      const isCacheable = !gcsPath.endsWith("/latest") && !gcsPath.endsWith("/manifest.json");
      const isExe = gcsPath.endsWith("/claude.exe");
      const timeoutMs = isExe ? 600000 : 20000;
      const { controller, cancel } = withTimeout(timeoutMs);

      let upstream;
      try {
        const fetchOpts = {
          method: request.method,
          headers: fwdHeaders,
          redirect: "follow",
          signal: controller.signal,
          cf: isCacheable
            ? { cacheEverything: true, cacheTtl: 86400 }
            : { cacheEverything: false, cacheTtl: 0 },
        };
        upstream = await fetch(target, fetchOpts);
      } catch (e) {
        cancel();
        return new Response(
          `Upstream fetch failed (gcs proxy)\nTime: ${new Date().toISOString()}\nError: ${String(e)}\n`,
          {
            status: 504,
            headers: secHeaders({
              "X-Proxy-Error": "gcs_fetch_failed",
              "X-Proxy-Source": `gcs:${gcsPath}`,
            }),
          }
        );
      } finally {
        cancel();
      }

      // 304 Not Modified：透传（CF 缓存层内部条件请求可能产生）
      if (upstream.status === 304) {
        const respHeaders = new Headers(upstream.headers);
        respHeaders.set("X-Proxy-Source", `gcs:${gcsPath}`);
        respHeaders.set("X-Content-Type-Options", "nosniff");
        return new Response(null, { status: 304, headers: respHeaders });
      }

      // 非 2xx：返回友好错误，状态 502（避免客户端工具误当正常内容）
      if (!(upstream.status >= 200 && upstream.status < 300)) {
        return buildUpstreamErrorResponse({
          title: "GCS upstream returned non-2xx",
          upstreamResp: upstream,
          extraHeaders: { "X-Proxy-Source": `gcs:${gcsPath}` },
        });
      }

      // 成功：流式透传 body
      const respHeaders = new Headers(upstream.headers);
      respHeaders.set("Cache-Control", isCacheable ? "public, max-age=86400" : "no-store, max-age=0");
      respHeaders.set("X-Proxy-Source", `gcs:${gcsPath}`);
      respHeaders.set("X-Content-Type-Options", "nosniff");
      // 确保保留 Content-Length 和 Content-Type
      if (!respHeaders.has("Content-Type")) {
        respHeaders.set("Content-Type", "application/octet-stream");
      }

      return new Response(upstream.body, {
        status: upstream.status,
        headers: respHeaders,
      });
    }

    return new Response("Not Found", { status: 404, headers: secHeaders() });
  },
};

3.2 Worker 路由

我们利用 Worker 的路由来进行转发（workers.dev 域名在大陆无法正常访问），请务必填写为 你的加速域名/*：

然后记录下你的 Worker 分配的子域名，例如 abc.abc.workers.dev：

4. 加速域名配置

来到你托管在 Cloudflare 的域名下，选择 DNS — 记录，将你预定的加速域名 CNAME 指向你的 Worker 分配的子域名，如图所示（记得开启小黄云）：

5. 使用

部署完成后，访问你的加速域名：

能否成功下载也取决于你的网络能否正常连接到 Cloudflare，请耐心等待，Worker 速度可能不太稳定。

然后选择适合你终端的下载方式（以 PowerShell 为例）：

irm https://c.ai0728.com.cn/install.ps1 | iex

成功效果：

Unity Skills - 让AI直接操控Unity编辑器

Wed, 04 Feb 2026 22:47:30 GMT

项目地址

::github{repo="Besty0728/Unity-Skills"}

为什么做这个？

Unity场景结构复杂，向AI描述时词不达意
重复性操作太多：创建GameObject、配置组件、调整参数...
Unity MCP理念不错，但缺少批处理、事务回滚等特性
日常使用多个AI工具，需要统一的自动化方案

核心特性

Token优化

Result Truncation：自动精简返回结果
精简的SKILL.md：减少上下文占用
相比于MCP实测消耗约降低40%

270+工具集

覆盖GameObject、组件、场景、资源等常用操作
Batch批处理：单次请求完成多个操作
搭建场景结构从多次调用变为一次请求

事务回滚

操作失败自动回滚，避免残留半成品对象
保持场景状态一致性

多实例管理

自动端口发现（8090-8100）
全局注册表，支持同时操控多个Unity项目

AI终端兼容

AI终端	集成方式
Antigravity	`/unity-skills`斜杠命令、workflow
Claude Code	自动意图识别
Gemini CLI	experimental.skills规范，自动使用
Codex	$skill显隐式均调用

安装

1. 安装Unity插件

通过Package Manager添加Git URL：

https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity

2. 启动服务

Window > UnitySkills > Start Server

3. 配置AI Skills

打开 Window > UnitySkills > Skill Installer
选择AI终端，点击 Install

自动生成：

SKILL.md - 技能说明
scripts/unity_skills.py - Python客户端
Antigravity额外生成workflows/unity-skills.md

使用示例

场景搭建：描述"创建一个包含Player、敌人生成器和相机控制器的基础场景"，AI完成具体操作。

批量操作：给场景中所有敌人添加血条UI，批处理一次完成。

后续计划

扩充技能库
持续优化性能

技术栈: Unity 2021.3+ | C# | Python | REST API
许可证: MIT
作者: Besty0728

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使用笔记

📌 概述

Claude Code 是 Anthropic 推出的 AI 智能编程工具，可在终端、IDE、桌面应用和浏览器中运行。它能直接读取代码库、执行命令、修改文件、管理 Git 工作流，并通过 MCP 协议连接外部服务。

文档目录

🧭ClaudeCode官方文档

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

::link{url="https://docs.claude.com/zh-CN/docs/claude-code/overview" title="Claude Code 概述 - Claude Docs" description="Claude Code 官方中文文档"}

🚀 安装与认证

安装方式

# macOS / Linux / WSL（推荐原生安装）
curl -fsSL https://claude.ai/install.sh | bash

# Windows 安装（Powershell）
irm https://claude.ai/install.ps1 | iex

# 更新到最新版本
claude update

# 健康检查
claude doctor

Setting.Json解析，个人开发适用

<details> <summary>键值与结构体</summary>

`cleanupPeriodDays`	非活动时间超过此期间的会话在启动时被删除。设置为 `0` 立即删除所有会话。（默认：30 天）
`model`	覆盖 Claude Code 使用的默认模型
`alwaysThinkingEnabled`	为所有会话默认启用扩展思考，默认开启
`autoUpdatesChannel`	配置 Claude Code 为自动更新默认为`latest` ，可改为`stable`
`statusLine` 结构体	配置自定义状态行以显示上下文。请参阅 `statusLine` 文档
`attribution` 结构体	是否在 git 提交和拉取请求中包含 `co-authored-by Claude` 署名，默认开启
`defaultMode`	打开 Claude Code 时的默认权限模式建议为plan

</details>

`ANTHROPIC_AUTH_TOKEN`	`Authorization` 标头的自定义值（您在此处设置的值将以 `Bearer` 为前缀）
`ANTHROPIC_BASE_URL`	自定义请求端点
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	设置触发自动压缩的上下文容量百分比（1-100）。默认情况下，自动压缩在约 95% 容量时触发。
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	提示建议，设置为`flase` 禁用
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	为大多数请求设置最大输出令牌数。默认：32,000。最大：64,000。增加此值会减少在自动压缩触发之前可用的有效上下文窗口。
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	覆盖文件读取的默认令牌限制。当您需要完整读取较大文件时很有用默认为`16000`，最大`100000`
`MAX_THINKING_TOKENS`	思考预算，默认为31999（最大）0为禁用，Opus4.6由努力级别控制
`MCP_TIMEOUT`	MCP 服务器启动的超时建议`60000`
`MCP_TOOL_TIMEOUT`	MCP 工具执行的超时建议`120000`
`BASH_DEFAULT_TIMEOUT_MS`	长时间运行的 bash 命令的默认超时建议`300000`
`BASH_MAX_TIMEOUT_MS`	模型可以为长时间运行的 bash 命令设置的最大超时建议`600000`
`CLAUDE_CODE_EFFORT_LEVEL`	Opus4.6加入的控制努力级别值：`low`、`medium`、`high`（默认）

</details>

<details> <summary>个人配置示例（2026.1.31）</summary>

补充：关于我的StatusLine，需要先安装依赖：npx ccstatusline@latest

GitHub - sirmalloc/ccstatusline: 🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

{
  "alwaysThinkingEnabled": true,
  "attribution": {
    "commit": " ",
    "pr": " "
  },
  "autoUpdatesChannel": "latest",
  "defaultMode": "plan",
  "enabledPlugins": {
    "context7@claude-plugins-official": true,
    "csharp-lsp@claude-plugins-official": true,
    "document-skills@anthropic-agent-skills": true,
    "example-skills@anthropic-agent-skills": true,
    "frontend-design@claude-plugins-official": true
  },
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的APIKey",
    "ANTHROPIC_BASE_URL": "自定义端点",
    "BASH_DEFAULT_TIMEOUT_MS": "300000",
    "BASH_MAX_TIMEOUT_MS": "600000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "70",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "52000",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_TELEMETRY": "1",
    "MAX_THINKING_TOKENS": "31999",
    "MCP_TIMEOUT": "60000",
    "MCP_TOOL_TIMEOUT": "120000"
  },
  "model": "opusplan",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(pnpm run:*)",
      "Bash(npx:*)",
      "Bash(node:*)",
      "Bash(git:*)",
      "Bash(dotnet:*)",
      "Bash(msbuild:*)",
      "Bash(python:*)",
      "Bash(uv:*)",
      "Bash(pip:*)",
      "Bash(pytest:*)",
      "Bash(where:*)",
      "Bash(dir:*)",
      "Bash(type:*)",
      "Bash(echo:*)",
      "Edit(src/**)",
      "Edit(tests/**)",
      "Edit(Assets/Scripts/**)",
      "Edit(Assets/Editor/**)"
    ],
    "deny": []
  },
  "statusLine": {
    "command": "ccstatusline",
    "type": "command"
  }
}

</details>

认证

请在启动前在你的***.claude.json***里面添加这行，即hasCompletedOnboarding 的值为true

或者使用CC-Switch里面设置跳过首次登陆即可

"hasCompletedOnboarding": true,

🎯 核心 CLI 命令

命令	中文说明	示例
`claude`	启动交互式 REPL 会话	`claude`
`claude "query"`	带初始提示启动会话	`claude "explain this project"`
`claude -p "query"`	单次查询后退出（适合脚本）	`claude -p "review this code"`
*`claude --dangerously-skip-permissions`*	彻底疯狂模式，给予所有权限

个人建议装载插件、Skil

命令	中文说明
`claude plugin install frontend-design@claude-plugins-official`	前端设计
`claude plugin install context7@claude-plugins-official`	提供较新文档给AI，有效防止因训练数据落后的"幻觉"
`claude -p "queryclaude plugin install csharp-lsp@claude-plugins-official`	为 C# 项目提供丰富的代码智能
`npx claude-plugins install @anthropics/anthropic-agent-skills/document-skills`	文档处理套件合集，包括Excel、Word、PowerPoint和PDF功能
`npx claude-plugins install @anthropics/anthropic-agent-skills/example-skills`	展示多种能力的示例技能集合，包括技能创建、MCP构建、视觉设计、算法艺术、内部沟通、网页测试、工件构建、Slack GIF和主题样式
`npx skills add [https://github.com/vercel-labs/skills](https://github.com/vercel-labs/skills) --skill find-skills`	这项技能帮助你发现并安装开放代理技能生态系统中的技能。
`npx skills add [https://github.com/vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) --skill vercel-react-best-practices`	由Vercel维护的React和Next.js应用综合性能优化指南。包含8个类别的57条规则，按影响优先级排序，指导自动重构和代码生成。
`npx skills add [https://github.com/nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) --skill ui-ux-pro-max`	设计很棒的原仓库：https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
`npx skills add [https://github.com/coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) --skill seo-audit`	SEO优化
在UnityPackageManager ：`https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity`	Unity-Skills，本人开发 https://github.com/Besty0728/Unity-Skills

⚡ 交互式斜杠命令（Slash Commands）

命令	中文说明
`/help`	显示所有可用命令（含自定义命令）
`/init`	初始化项目，创建 CLAUDE.md 记忆文件
`/memory`	编辑记忆文件 CLAUDE.md
`/compact`	压缩对话历史以节省上下文窗口（可加焦点：`/compact focus on tests`）
`/context`	查看当前上下文窗口使用情况
`/cost`	显示当前会话的 Token 用量与费用
`/stats`	查看使用统计信息
`/model`	切换 AI 模型（`/model opus`）
`/insights`	ClaudeCode对你的评价&总结
`/status`	查看当前会话状态（模型、设置等）
`/config`	打开设置交互界面
`/btw`	不会污染上下文的一个并行小对话功能
`/permissions`	管理权限设置
`/mcp`	配置 MCP 外部服务（`/mcp enable` / `/mcp disable`）
`/hooks`	查看 Hook 钩子配置
`/agents`	管理子智能体（创建、编辑、列表、删除）
`/resume`	恢复已命名的会话
`/rename`	给当前会话命名（`/rename feature-auth`）
`/fork`	分支对话，探索不同方向而不丢失上下文
`/clear`	清空对话历史，重新开始
`/rewind`	回退到上一个检查点（撤销更改）
`/export`	导出对话记录
`/vim`	启用 Vim 编辑模式
`/ide`	连接到 IDE（VS Code / JetBrains）
`/sandbox`	启用沙盒隔离模式
`/simplify`	三合一代码审查功能
`/output-style`	设置输出风格（`Explanatory` / `Learning` / `Concise`）
`/add-dir`	添加工作目录
`/doctor`	检查安装状态
`/release-notes`	查看版本更新日志

🔤 快捷前缀

前缀	中文说明	示例
`#`	添加内容到持久化记忆（CLAUDE.md）	`# Always use TypeScript`
`@`	引用文件或目录	`@src/index.ts`
`!`	直接执行 shell 命令	`! git status`
`/`	执行斜杠命令	`/help`
`&`	发送任务到云端异步执行	`& Build the API`

⌨️ 键盘快捷键（Windows）

快捷键	中文说明
`Ctrl+C`	取消当前操作
`Ctrl+D`	退出会话
`Ctrl+L`	清屏（保留历史）
`Ctrl+O`	切换详细输出模式（查看推理过程）
`Ctrl+R`	搜索命令历史
`Alt+V`	从剪贴板粘贴图片
`Ctrl+B`	将当前任务转为后台运行
`Esc Esc`	撤销/回退上一次更改
`Tab`	接受提示建议 / 切换扩展思考模式
`Shift+Tab`	循环切换权限模式
`Alt+P` / `Option+P`	输入时切换模型
`Ctrl+Enter`	换行输入
`Ctrl+U`	清空行输入

🧠 模型选择指南

官方还支持以下格式快捷调用：

模型别名	行为
`default`	推荐的模型设置，取决于你的账户类型
`sonnet`	使用最新的 Sonnet 模型（当前为 Sonnet 4.5）用于日常编码任务
`opus`	使用最新的 Opus 模型（当前为 Opus 4.6）用于复杂推理任务
`haiku`	使用快速高效的 Haiku 模型用于简单任务
`sonnet[1m]`	使用 Sonnet 和100 万 token 上下文窗口用于长会话
`opusplan` 推荐	特殊模式，在计划模式中使用 `opus`，然后在执行时切换到 `sonnet`

模型	适用场景	输入 / 1M tokens	输出 / 1M tokens
Haiku	简单任务、快速探索、子智能体	$1.00	$5.00
Sonnet（默认）	日常编程、功能开发、Bug 修复	$3.00	$15.00
Opus	复杂推理、架构设计、安全分析	$5.00	$25.00

<aside> 💡

选择建议： 日常用 Sonnet，子智能体探索用 Haiku（省 10-20 倍费用），只有架构设计或复杂调试才用 Opus。

</aside>

⚙️ 配置体系

配置文件层级（优先级从高到低）

企业级：/etc/claude-code/managed-settings.json — 全公司强制策略，用户不可覆盖
CLI 标志：命令行参数 — 当前会话
本地项目：.claude/settings.local.json — 个人，仅当前项目（应加入 .gitignore）
共享项目：.claude/settings.json — 团队共享，提交到 Git
用户级：~/.claude/settings.json — 所有项目

个人开发直接使用3、5即可

CLAUDE.md 记忆文件

用于持久化项目上下文，让 Claude 每次会话都能了解你的项目：

~/.claude/[CLAUDE.md](http://CLAUDE.md) — 全局，适用所有项目
./[CLAUDE.md](http://CLAUDE.md) — 项目级，团队共享
./[CLAUDE.local.md](http://CLAUDE.local.md) — 项目本地，个人笔记
.claude/rules/ — 分类规则目录（testing.md、security.md 等） <details> <summary>我的用户级别Claude.md</summary>

# 基础设置
- 始终使用中文交流
# 代码风格
- 代码注释使用中文
- 优先简洁实用，避免过度设计
- 保持现有代码风格一致性
# 技术栈偏好
- Unity: C#，遵循Unity最佳实践
- Web: TypeScript优先，Next.js/Astro
- Python: 类型注解，async优先
- 包管理: pnpm (Node) / uv (Python)
# 工作习惯
- 修改代码前先阅读理解现有逻辑
- 提交信息使用中文，格式：类型: 简述
- 遇到不确定的需求主动询问

</details>

<details> <summary>我的用户级别Claude.md（进阶）</summary>

# CLAUDE.md - 工作指导

- 必须使用中文回复

## 工作流程

**简单任务**（单文件修改、小 bug、拼写修正）：直接执行

**复杂任务**（多文件修改、架构设计、新功能）：
1. 研究：Read 相关文件 + memory 目录，理解上下文，禁止编码
2. 计划：EnterPlanMode 制定方案，用户确认后进入实施
3. 实施：编码 → 运行测试验证
4. 收尾：若产生了可复用的架构决策或调试经验，写入 memory 目录

## 知识管理

使用 Read/Write 操作 memory 目录（系统 prompt 会提供当前正确路径）：
- 任务开始前：查阅 memory 目录已有知识
- 发现可复用的架构决策、调试经验时：按主题存储（如 `patterns.md`、`debugging.md`）
- 一次性、临时性的上下文不存储

## 编码约束
- 必须使用中文回复
- 无明确编写指令时不主动编码
- 无明确授权时不修改现有文件
- 复杂修改前先分析影响范围
- **禁止幻觉代码生成**：编码时遇到不确定的 API，必须按优先级执行：①读取项目依赖/源码确认实际可用的 API → ②通过对应文档工具查证（microsoft-docs MCP / Context7 / Grok `web_search`） → ③询问用户确认。三者至少执行一项，禁止凭记忆猜测生成代码

## 工具优先级策略

- 代码搜索：Grep → Glob → Agent(Explore)
- Microsoft 技术文档：microsoft-docs MCP（microsoft_docs_search → microsoft_code_sample_search → microsoft_docs_fetch）
- 开源库/框架文档：Context7 MCP（resolve-library-id → query-docs）
- 网页搜索：见下方 Grok Search 规范
- Skill：已安装的 Skill 各自有触发条件，匹配时主动调用即可
- Plugin：`csharp-lsp` 为自动生效的 plugin，无需手动调用

## Grok Search 使用规范

内置 WebSearch/WebFetch 已禁用，所有网页搜索通过 **Grok Search MCP** 的工具完成：
- 简单查询：直接调用 `web_search`，无需走规划链
- 复杂/多步查询：`plan_intent` → `web_search` → 按需 `web_fetch` 补充完整内容
- 结果整合：交叉验证 + **强制标注来源** `[标题](URL)` + 时间敏感信息注明日期
- 错误恢复：连接失败 → `get_config_info` 检查 | 无结果 → 放宽查询条件重试
- 核心约束：搜索结果必含来源引用，禁止无来源输出

</details>

🔒 权限系统

权限模式（Shift+Tab切换）

模式	中文说明	适用场景
`default`	首次使用每个工具时提示确认	日常开发
`acceptEdits`	自动批准文件编辑，Bash 仍需确认	信任项目
`plan`	仅分析，禁止执行或编辑	代码审查
`bypassPermissions`	跳过所有确认提示（谨慎使用）	CI/CD 自动化

工具权限规则示例

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Edit(src/**)"
    ],
    "deny": [
      "Read(.env*)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)"
    ]
  }
}

🪝 Hooks 钩子系统

Hooks 在特定时机 确定性 执行 Shell 命令，不依赖模型判断，保证每次都会运行。

可用事件

事件	中文说明	可阻断？
`PreToolUse`	工具执行前（可验证、记录或阻止）	✅
`PostToolUse`	工具执行后（格式化、lint、构建等）	❌
`UserPromptSubmit`	用户提交提示时（注入上下文）	✅
`SessionStart`	会话开始时（环境校验）	✅
`Stop`	Claude 完成响应时（清理、记录）	❌
`Notification`	触发通知时（自定义提醒）	❌

示例：编辑后自动格式化

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write \"$FILE_PATH\""
      }]
    }]
  }
}

示例：完成后通知

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -c \"[System.Media.SystemSounds]::Asterisk.Play()\""
          }
        ]
      }
    ]
  }
}

🔌 MCP（模型上下文协议）

MCP 让 Claude Code 连接外部工具、数据库、API 和服务。

常用命令

# 添加 HTTP 类型服务
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 添加 stdio 类型服务
claude mcp add --transport stdio postgres -- npx -y @anthropic-ai/mcp-server-postgres

# 查看已配置的服务
claude mcp list

# 移除服务
claude mcp remove github

🤝 子智能体（Subagents）

子智能体是独立的 Claude 实例，拥有自己的上下文窗口，用于隔离复杂任务，避免主对话上下文膨胀。

内置子智能体

Explore（Haiku）：只读探索代码库，超快、超便宜
General（Sonnet）：全功能读写，处理复杂任务
Plan（Sonnet/Opus）：只读规划，制定实施方案

自定义子智能体

在 .claude/agents/ 目录创建 .md 文件：

---
name: security-reviewer
description: 安全代码审查专家
tools: Read, Grep, Glob
model: opus
---
你是一名高级安全工程师，负责审查代码中的漏洞...

<details> <summary>个人Subagents推荐 - Unity代码审查</summary>

---
name: unity-code-reviewer
description: Unity 代码静态审查专家，审查 Unity C# 代码的性能、GC、正确性、线程安全、序列化陷阱和可维护性。只读审查，不修改文件。
model: sonnet
---

You are a senior Unity code reviewer. You provide actionable review comments with Unity-specific rigor. You do NOT edit files—only analyze and report.

## Review Scope (prioritized order)

### 1. Correctness / Crashes (Blocker)
- NullReferenceException risks: uninitialized fields, destroyed objects, missing components
- Object lifetime: Destroy timing, scene transitions, DontDestroyOnLoad misuse
- Domain reload: static state assumptions, [RuntimeInitializeOnLoadMethod] missing
- Async misuse: Unity API called from background thread (must be main thread)
- Race conditions: coroutine timing, async/await without proper synchronization

### 2. Performance & GC (High)
Per-frame allocation sources:
- LINQ in Update/FixedUpdate/LateUpdate
- foreach on non-array collections (List<T>.Enumerator boxes on some Unity versions)
- String concatenation, ToString(), string.Format in hot paths
- Boxing: value types to object, nullable comparisons
- Closures capturing variables (creates delegate allocation)
- params array allocation

Hot path anti-patterns:
- GetComponent<T>() every frame → cache in Awake/Start
- Find*, FindObjectOfType → cache or use dependency injection
- Camera.main → cache (it calls FindGameObjectWithTag internally)
- Instantiate/Destroy churn → use object pooling
- Physics queries without NonAlloc variants

### 3. Architecture & Maintainability (Medium)
- Tight coupling between systems
- Hidden singletons, global state, unclear ownership
- Overuse of SendMessage, BroadcastMessage, magic strings
- Reflection in runtime code (slow, AOT issues on IL2CPP)
- Testability: dependencies injectable, logic separable from MonoBehaviour

### 4. Serialization & Asset Pitfalls (Medium)
- [SerializeField] on non-serializable types (silently fails)
- UnityEvent with missing targets after refactor
- Script rename/namespace changes breaking prefab references
- ScriptableObject mutation at runtime (shared state bug)
- Prefab override hazards in YAML changes
- GUID/meta file conflicts

## Review Process
1. If diff provided → focus on changed files first
2. If no diff → infer likely areas from request keywords
3. Use Glob/Grep to locate relevant code
4. Cross-reference with Unity best practices

## Output Format (strict)

### Summary (3-6 bullets)
Top risks and quick wins

### Findings Table
| Severity | File | Location | Issue | Recommendation | Evidence |
|----------|------|----------|-------|----------------|----------|
| Blocker/High/Medium/Low | path | class/method | what & why (Unity-specific) | concrete fix idea | snippet or grep match |

### Follow-up Questions (max 5)
Only if truly necessary for complete review

## Limitations

- **No code execution**: Cannot run tests, Play mode, or any runtime verification
- **No profiling**: Cannot measure actual CPU/GPU/memory usage; performance findings are based on static pattern recognition
- **No scene/prefab inspection**: Cannot open .unity or .prefab files visually; can only grep YAML text
- **No asset validation**: Cannot verify texture formats, mesh stats, audio settings, or material properties visually
- **Static analysis only**: All findings are based on reading source code; false positives are possible for runtime-dependent behavior

## Collaboration

- **Findings need fixing?** → Hand off Blocker/High issues to `unity-debugger` for targeted fixes, or to `unity-developer` for larger refactors
- **Need deeper error investigation?** → Hand off to `unity-error-hunter` for log scanning
- **Runtime verification needed?** → Tell the user to test in Unity Editor manually

</details>

🎨 Skills 技能系统

与斜杠命令不同，Skills 是 模型自动调用 的 — Claude 根据上下文自动识别并应用。

创建 Skill

在 .claude/skills/my-skill/[SKILL.md](http://SKILL.md) 中定义：

---
name: code-reviewer
description: 代码审查专家，检查安全漏洞、性能问题和最佳实践
allowed-tools: Read, Grep, Glob
---
# 代码审查专业知识
审查时检查以下方面：
- 输入验证与注入攻击
- 认证与授权缺陷
- 性能与内存问题

<aside> 📝

Skill vs Command vs Subagent

斜杠命令：你手动调用（/deploy），控制执行时机
Skill：Claude 自动识别场景并应用，无需手动触发
子智能体：隔离上下文窗口，适合复杂独立任务 </aside>

📋 自定义斜杠命令

在 .claude/commands/ 中创建 .md 文件即可：

---
description: 修复 GitHub Issue
allowed-tools: Read, Edit, Bash(git:*)
argument-hint: [issue-number]
---
修复 GitHub Issue #$ARGUMENTS，遵循我们的编码规范。

使用：/fix-issue 123

💰 费用管理

查看费用

> /cost

节省费用策略

子智能体探索用 Haiku（比 Opus 便宜 10-20 倍）
开启 Prompt Caching（默认开启）
设置 --max-turns 防止失控对话
定期执行 /compact 压缩上下文
设置 --max-budget-usd 限制单次花费上限

🏷️ 快速参考卡

╔══════════════════════════════════════════════════╗
║          CLAUDE CODE 快速参考                     ║
╠══════════════════════════════════════════════════╣
║ 模型选择                                         ║
║  haiku    → 简单任务、探索            ($1/$5/M)   ║
║  sonnet   → 日常编程（默认）          ($3/$15/M)  ║
║  opus     → 架构设计、复杂推理        ($5/$25/M)  ║
╠══════════════════════════════════════════════════╣
║ 必备命令                                         ║
║  /compact   压缩上下文（50%时执行）               ║
║  /cost      查看费用                              ║
║  /model     切换模型                              ║
║  /status    查看状态                              ║
║  /init      初始化项目配置                        ║
║  /mcp       管理外部集成                          ║
╠══════════════════════════════════════════════════╣
║ 前缀速查                                         ║
║  # 消息     → 保存到记忆                          ║
║  @ 路径     → 引用文件                            ║
║  ! 命令     → 执行 Bash                           ║
║  & 任务     → 云端异步执行                        ║
╠══════════════════════════════════════════════════╣
║ 决策规则                                         ║
║  简单任务？       → Haiku                         ║
║  复杂推理？       → Opus                          ║
║  其他所有？       → Sonnet                        ║
║  必须每次执行？   → Hook（非提示）                ║
║  自动应用知识？   → Skill（非命令）               ║
║  需要隔离上下文？ → 子智能体                      ║
╚══════════════════════════════════════════════════╝

本笔记整理自 Claude Code 官方文档及社区指南，信息截至 2026年初。

如何修改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" alt="Visual Studio MCP配置文件位置"></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="Github绑定教育邮箱" 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" alt="记事本手写英文材料"> 下一步里如果触发了你距离学校远的话，直接选择始终远程教学就行，拍摄再拍一次上面的就行 再提一嘴，如果不放心可以选择更改你的github个人资料，与你文件中的名字一致即可，学校选择你的学校就行，按照上述操作大概率认证成功 <img src="/images/image-1755016403916-475070115.webp" alt="Github个人资料设置"> 注意，认证成功后是批准，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://micostar0728.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

关于这个错误： <h2 class="gh-header-title flex-auto wb-break-word f1 mr-0">SyntaxError： Unexpected token 'd'， “data： {”id“...JSON 无效</h2> <img src="/images/image-1754148558836-843256870.webp" alt="JSON解析错误截图"> 这个是因为你的服务没有开启websocket导致的，开启的地方主要有两处： <ol> <li>nginx没有开启websocket支持（添加我标注的蓝色部分即可） <img src="/images/image-1754148814476-105309073.webp" alt="Nginx WebSocket配置示例" width="1321" height="786"></li> <li>你的域名服务商没有开启websocket支持（我个人踩过最深的坑） 以我使用的EdgeOne为例，EdgeOne默认不开启Websocket支持 <img src="/images/image-1754148546904-319018769.webp" alt="EdgeOne WebSocket设置"> CloudFlare默认全部计划均开启且支持Websocket <img src="/images/image-1754148603332-270641179.webp" alt="CloudFlare WebSocket设置"></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="天气查询UI界面搭建"> <img src="/images/image-1753347365939-458403350.webp" alt="天气查询UI层级结构"> <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="Get Post请求实现"> D.此处要深度对照API文档实例的各项数据 例如：geturl是对应地理编码API，这样才可以实现输入名称来查询，而不是对照编码查询 Varurl是对应当前天气数据的API(查询主力) UnityWebRequest是Unity提供用于网络请求Http(s)的类，SendWebRequest是发送网络请求 GetJsonYN是下面的一个统一处理方法 <img src="/images/image-1753347599242-521568104.webp" alt="API文档对照与URL构建"> E.更新文本UI绝对的对照Json文件 <img src="/images/image-1753347644717-22499377.webp" alt="更新文本UI代码"> <img src="/images/image-1753347661716-939041786.webp" alt="Json数据解析对照"> 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="挂载脚本到GameObject"> <a href="https://cloud.ai0728.com.cn/s/8LTv/OpenWeather" target="_blank" rel="noopener">源脚本</a>