技术随笔

自建 Supabase + Cursor MCP教程

说实话，Supabase 是个好东西，但它的官方 SaaS 版（supabase.co）对于国内开发者来说，有两个设定, 非常搞心态, ，直接劝退了不少人：免费版的“7天不活跃”自动暂停（Project Paused）物理距离导致的“高延迟”与“超时”所以，对于国内开发者，, “买台服务器自建”不仅是为了数据在自己手里，更是为了不掉线、不暂停、极速响应, 。但这玩意儿自建有个大坑：当你兴冲冲搭好服务，想用 Cursor 的 MCP 功能去连库时，发现死活连不上，报错永远是 , Tenant or user not found, 。这篇笔记就是为了解决这个问题，记录我从“自建部署”到“Cursor 完美直连”的全过程。一、搞清楚架构：别把工具装反了很多人卡在第一步，是因为没搞懂 MCP 到底该装哪儿。服务端（你的 VPS）, ：只需要装 Supabase Docker。不需要装任何 AI 插件。本地（你的电脑）, ：Cursor + Docker Desktop。这里的逻辑是：, Cursor 会在你电脑上临时起一个 Docker 容器（作为 MCP 客户端/驱动），这个本地容器通过 TCP 协议，去连你 VPS 上的 Supabase 端口。所以，你不需要在服务器上折腾 Python 环境或 Node 环境，, 只要保证你电脑能 ping 通服务器端口就行。二、服务端部署（几个关键修改）假设你已经有了一台 Linux 服务器（推荐香港 CN2 或者国内机器，图的就是个快），装好了 Docker。官方的部署其实很简单，但默认配置是, 不能用, 的，必须改。

2025/12/29

新手慎用 AI 写代码！这是在练依赖，不是在学编程

在 Copilot、Cursor 和 ChatGPT 横行的今天，编程似乎变得前所未有的简单。对于新手来说，只需输入一句人话，屏幕上就会自动流淌出一段完美运行的代码。这种“即时满足感”是极其诱人的，仿佛自己一夜之间就拥有了十年功力。但这里我必须泼一盆冷水。对于编程新手而言，过早、过深度地依赖 AI，可能不是在加速学习，而是在, 慢性自杀, 。因为 AI 把编程中最痛苦、但也是最核心的学习过程——, 思维的磨练, ，给彻底“外包”了。01编程的核心不是“敲代码”，是“解题”许多新手的误区在于，认为编程就是“敲键盘写代码”。因此，当 AI 能帮他们敲代码时，他们觉得自己已经掌握了编程。大错特错。编程的本质，是, 将一个模糊的现实需求，拆解为计算机可执行的严密逻辑。, 这包括：问题拆解：, 把大象装进冰箱，分几步？逻辑构建：, 先判断 A 还是先循环 B？技术取舍：, 为什么用 Map 不用 List？当你对 AI 说“帮我写一个贪吃蛇游戏”，AI 在几秒钟内替你完成了上述所有步骤。你得到的只是结果（Code），而错过了中间那个“因为所以”的推导过程。

2025/12/17

⛵ 苹果也翻车？App Store源码大泄漏，一场让程序员狂欢的“乌龙事件”

前几天，苹果刚上线了全新的 App Store 网页版，界面做得很漂亮。结果没多久，就有人发现：整个前端源代码都被扒下来，传到 GitHub 上了。堂堂苹果，居然也会犯这种低级错误？事情是怎么发生的？原因很简单：苹果忘了关一个开关。这个开关叫 , sourcemap, 。简单说，它就是一份"代码地图"，能把网站上那些压缩混淆的代码，还原成程序员写的原始代码。开发时很有用，但上线前必须关掉，不然就等于把源代码公开了。348a7a07258a30f3a83808cec2df3fde4669e2253929f267e208b0fe6146f3fb.jpeg苹果的工程师……就这么忘了。一个叫 rxliuli 的开发者发现后，用浏览器开发者工具轻松下载了整套代码，然后上传到 GitHub，说是"用于教育和研究"。开发者们嗨了这下开发者圈子炸了。能看到苹果官方项目的真实代码，这机会可不多。大家蜂拥而至，翻看代码结构、技术选型。很快就有人发现：苹果用的是 Svelte 框架！这在前端圈引起了不小的讨论。虽然只是前端代码，不涉及用户数据和安全问题，但对开发者来说，这就是现成的教材。苹果的反击苹果反应很快。直接给 GitHub 发了 DMCA（版权法）删除通知。

2025/11/07

🧠 告别 .d.ts：让 Nuxt 在 VS Code 中的“转到定义”直达 .vue 源码

如果你是一位 Nuxt 开发者，你一定对这个场景不陌生：在模板中满怀期待地按下 , Cmd + 点击, (或 , Ctrl + 点击, ) 试图跳转到一个组件的定义，结果却被 VS Code 带到了一个自动生成的 , .d.ts, 类型声明文件，而不是你真正想修改的 , .vue, 源码文件。这极大地拖慢了我们的开发、阅读和重构效率。本文将介绍一个必备的 VS Code 扩展和配套设置，彻底解决这个问题。恼人的“中间商”：为什么会跳转到 .d.ts？在 Nuxt（以及其他许多现代前端框架）中，自动导入（Auto-imports）机制会为项目中的组件、Hooks 和 API 自动生成全局类型声明文件（例如 , .nuxt/types/components.d.ts, ）。这些 , .d.ts, 文件通过 , typeof import(...), 语法指向真实的模块。VS Code 的 TypeScript 语言服务在执行“转到定义”时，会首先命中这个“类型别名”，并止步于此。问题所在：默认情况下，VS Code 的“转到定义”忠实地找到了变量的“类型定义”(.d.ts)，而不是我们开发者关心的“实现定义”(.vue 或 .ts)。核心解决方案：Goto Definition Alias 扩展为了解决这个痛点，, Anthony Fu, 开发了 , Goto Definition Alias, ( , antfu.goto-alias, ) 扩展。它的工作原理非常巧妙：当 VS Code 的“转到定义”命中一个类型声明（, .d.ts, ）时，这个扩展会介入，自动解析 , typeof import(...), 指向的真实模块路径，然后执行, 第二次跳转, ，直接带你““跟随别名””抵达最终的源文件。这样，你就绕过了 , .d.ts, 这一层，实现了从模板直达 , .vue, 组件的丝滑体验。最佳实践：安装与配置指南要获得最佳的跳转体验，光安装扩展还不够，推荐你完成以下“组合拳”配置。一、安装与配置扩展在 VS Code 扩展市场搜索并安装 , Goto Definition Alias, (, antfu.goto-alias, )。安装后重载 VS Code 窗口。

2025/11/03

Mac 下 Kilo Code 集成 Gemini CLI 报错 403 终极修复指南

适用环境操作系统：, macOS平台：VS Code + Kilo Code 扩展功能：集成 Google Gemini CLI问题背景在 macOS 上，Gemini CLI 命令行可正常用，但在 Kilo Code (VSCode 插件) 环境下报 , 403, 权限错误。主要是环境变量和 Google Cloud API 权限导致。常见报错及成因1. , Permission denied on resource project default原因:Kilo Code 读取不到正确的 , GOOGLE_CLOUD_PROJECT, 环境变量，导致默认项目为“default”。Mac 专属操作指引打开, 终端终端 (Terminal), ，进入配置目录：新建或编辑 , .env, 文件，, 用文本编辑器写入, ：保存并关闭。重启 VS Code, ，重启后 Kilo Code 才会加载 , .env, 。

2025/10/29

保姆级开通教程：白嫖一个月价值$20的ChatGPT Plus，解锁 Codex 编程神器

导语：, 最近开发者社区最火的"神器"是什么？非 OpenAI 的编码智能体 , CodeX, 莫属！它能帮你写代码、改 Bug、甚至重构整个项目，简直是 AI 编程伙伴的天花板。但现实很骨感：想用 CodeX，必须开通 ChatGPT Plus 会员。对国内用户来说，支付是最大的障碍。好消息来了！OpenAI 最近悄悄放出大福利：, 人人都能免费领取一个月的 ChatGPT Plus！本文将手把手教你如何绕过支付限制，成功领取并激活这次免费试用。第一步：准备工作开始之前,请准备好以下两样工具，缺一不可：稳定的欧洲区"科学上网"工具：, 必须使用欧洲节点（如德国、法国、英国等），因为 OpenAI 的支付策略在欧洲开放了特殊通道。可正常使用的 PayPal 国际版账号（中国区账号也可能适用）：, 请提前注册，并绑定一张银行卡（支持 Visa 或 MasterCard 的信用卡成功率最高）。【核心原理】为什么必须是"欧洲 IP + PayPal"？简单来说，就是, "换个地方，换个钱包", 。OpenAI 的支付系统 Stripe 不支持国内银行卡，直接付款基本都会失败。但在欧元区，它开放了 PayPal 支付通道。使用欧洲 IP 访问，就能看到 PayPal 选项；通过 PayPal 这个"中间人"付款，Stripe 会将其视为受信任的交易，从而顺利通过。第二步：领取免费 Plus 会员准备就绪，开始操作！1. 验证账号领取资格

2025/10/29

实战教程-突破端口封锁：如何使用1Panel在家庭网络中发布多个HTTPS服务

前言：家庭开发者的“甜蜜烦恼”你是否也想在家里搭建自己的服务？无论是 NAS、个人网站、代码仓库，还是影音中心，将这些服务安全地发布到公网，随时随地访问，是许多技术爱好者的乐趣所在。通常，我们会遇到两大“拦路虎”：动态公网IP, ：这个问题比较好解决，通过 DDNS（动态DNS）就能搞定。运营商端口封锁, ：这是一个更棘手的问题。国内的家庭宽带（如电信、联通）普遍封锁了网站服务的标准端口 , 80, (HTTP) 和 , 443, (HTTPS)。这导致我们无法通过 , https://你的域名.com, 这样标准的方式来访问服务。退而求其次，我们只能使用非标准端口，例如 , https://你的域名.com:8008, 。那么，如果我有, 多个服务, 需要发布呢？比如一个 , 8008, 端口的A服务，和一个 , 8009, 端口的B服务，我希望通过 , https://你的域名.com:8008, 和 , https://你的域名.com:8009, 分别访问它们。本文将以广受好评的服务器管理面板 , 1Panel, 为例，手把手教你如何实现这个目标。核心思路：端口映射的“移花接木”在开始之前，我们需要理解其中的核心逻辑。关键在于，我们的 Web 服务器（在1Panel中是 OpenResty）需要一种方法来区分发往 , 8008, 和 , 8009, 的请求。由于路由器的一个外部端口只能转发到一个内部端口，我们不能把 , 8008, 和 , 8009, 都转发到服务器的同一个 , 443, 端口上。正确的做法是：, 让服务器内部也监听多个端口，然后建立一一对应的转发关系, 。外部请求 , ...:8008, → 路由器转发到 → , 服务器 , :443, → 指向服务A外部请求 , ...:8009, → 路由器转发到 → , 服务器 , :444, → 指向服务B理解了这一点，接下来的操作就会非常清晰。准备工作

2025/10/29