Blog

在自己的 VPS 上用 GitHub self-hosted runner 做 push tag 自动部署。记录三个真正卡住的点:构建到底在哪台机器跑、跑 runner 的用户必须等于跑 app 的用户、pnpm 新版本把未声明的 build 脚本变成硬错误。

用 claude --worktree 开会话后,.claude/skills 里的项目 skill 全失效了。根因:它们是指回 .agents/skills 的 symlink,而 worktree 的 .worktreeinclude 拷贝跳过了 symlink。记录排查到用 --copy 物化成真实文件的根治。

在 GitHub issue 里 @claude 就让它自动建分支、改代码、开 PR。记录用 anthropics/claude-code-action 搭这套流程踩的两个权限坑：workflow 默认只读、GitHub 默认禁止 GITHUB_TOKEN 开 PR，以及解法和跑通条件 checklist。

给这个 Astro 博客的标签页、分类页做 SEO 收尾：35 篇文章却有 69 个标签，将近一半只挂着一篇，是典型的薄内容。本来第一反应是 robots.txt 里 Disallow 掉，结果发现这是个常见误区——Disallow 只挡爬取不挡收录，真正想让薄页面退出索引，得用 meta robots 的 noindex, follow，并且 robots.txt 还得保持全开。附 Astro 里的具体改法。

给这个 Astro 博客接入 llms.txt 和 llms-full.txt 的完整过程：用 content collection 在构建时生成索引文件，以及中文站在 Cloudflare 上一定会踩的 charset 乱码坑。

上一篇我把博客那套加工具的规矩做成了一个 Skill。这回换个角度：当我装的 skill 从「自己写的一个」变成「从别人仓库拉来的一堆」，怎么保证队友、CI、还有未来的我，装到的是同一批、同一个版本？答案是 skills-lock.json——Agent Skills 版的 package-lock.json。这篇按 WHW 捋一遍：它是什么、怎么工作怎么用、以及为什么一旦 skill 成了依赖，就该有把锁。老规矩，官方说的和我自己机器上看到的分开讲。

本地 next dev 启动后风扇狂转、CPU 长期高占用，但页面其实正常。本文记录完整的排查路径：用 macOS 自带的 sample 抓一份 CPU profile，先从「在睡觉的线程」里分出真正烧 CPU 的，再靠 Sort by top of stack 聚合表反推出「密集文件 I/O + 锁竞争」，层层下钻到 .next/dev/cache/turbopack 里 GB 级的 LSM SST 文件，最终定位到 Next.js 16 默认开启的 Turbopack 持久缓存在后台空转做 compaction。附止血与复发处理。

A2A（Agent2Agent）是 Google 去年放出、今年 3 月刚发布 1.0、现在挂在 Linux Foundation 名下的智能体互联协议。我平时泡在 MCP 那一套生态里，这篇把 A2A 的几个核心概念——Agent Card、Task、Message、Artifact——从头捋一遍，讲清它和 MCP 的分工，最后以一个独立开发者的角度说说：它现在值不值得碰。

聊 AI coding 的时候，大家总在比模型——Opus 还是 GPT，谁分高。但我自己每天用下来，真正决定一个 agent 好不好使的，常常是模型外面那层叫 harness 的东西：那个跑工具、管上下文、卡权限的循环。这篇把我理解的 harness 拆开讲讲，它是什么、由哪几块拼成、为什么同一个模型套不同的壳能差出十万八千里。

我的博客挂着一个小工具区，每加一个工具都有一套自己的规矩：文件放哪、逻辑写在哪、写完要去哪登记。以前每加一个都得重新跟 Claude 交代一遍。这次我把它们收进一个 Skill，顺手把 Agent Skills 这套东西从机制到取舍捋了一遍——它到底是什么、progressive disclosure 解决了什么、和 CLAUDE.md / MCP / 子代理差在哪一层，以及我保留的几点判断。

MCP 被叫做「AI 应用的 USB-C」，但这个比喻没说清它到底是什么。这篇从「为什么需要它」讲起，拆开它底下的 JSON-RPC 消息、Host/Client/Server 三层架构、初始化握手，以及 Tools/Resources/Prompts 三类原语分别由谁来控制——最后附我自己接 MCP 服务器时保留的几点判断。

上次写 Opus 4.8 时，我说dynamic workflows对我这种小项目用处不大。这次换了个场景重新试：从零搭一个全新的 MVP，5 个阶段、12 个子代理、约 31 分钟，第一遍 verify 就过了。记录一下它什么场景下有用，以及我保留的几点判断。

Opus 4.8 在 5 月 28 日发布。作为一个每天用 Claude Code 给自己的 App 和博客写代码的独立开发者，我把它接进日常开发用了两天，聊聊新出的并行子代理、effort 控制、代码自查能力到底好不好用，以及值不值得升级。

记录我给博客加上 YouTube 和 Bilibili 视频嵌入的过程：写一个 remark 插件，让我以后写文章只需要单独一行粘 URL，构建时自动变成响应式播放器。

记录我上架第一个 iOS 应用的经历，包括开发过程、上架流程和一些心得体会。

记录给这个 Astro 博客接入动态 OG 图片生成的过程，以及在 Cloudflare Workers 环境下踩的那些坑。

记录从零开始用 Astro + Cloudflare Workers 搭建个人博客的过程，以及选择这个方案背后的考量。

整理我在实际用 Docker 时遇到的三类问题：容器时区和宿主机不一致、用 --cap-add 精细控制容器权限而不是无脑 --privileged，以及从 Docker Desktop 换到 OrbStack 后的 malware 警告清理。

记录 Go 构建约束的两种方式：文件名后缀和 build tag，新旧语法的区别，以及几个一不小心就踩到的坑——比如把 darwin 写成 macos。

在 PVE 上跑多台虚拟机，DHCP 地址一变就要重新查 IP，太烦。用 mDNS 配好主机名后直接用 hostname.local 访问，一劳永逸。本文讲清 mDNS 原理、完整配置步骤，以及 Debian 12 和 Ubuntu 24 默认状态的差异。

用旧笔记本当 PVE 家庭服务器时绕不开的几个配置：关掉合盖自动休眠、让屏幕超时自动熄屏省电，以及把一块 NTFS 数据盘配置成开机自动挂载。

记录把 silk-v3-decoder 编译成静态库，再通过 Rust FFI 调用的完整过程。

记录在 VPS 上搭建 ZeroTier Moon 节点的完整步骤，先讲清 Planet/Moon 的原理，再解决国内直连官方根节点延迟高的问题，附客户端连接与排坑。

记录在 iStoreOS 上安装 passwall2、解决 OpenClash + SmartDNS DNS 污染问题、以及 OpenVPN + OpenClash 同时跑时的分流配置。

从零搭建 pyright LSP 服务端，再接上 Monaco Editor，实现浏览器里的 Python 代码补全和类型检查。附踩坑记录。

整理三个用 Node.js 时经常碰到、查一次又容易忘的问题：corepack enable pnpm 后报 keyid 错误怎么修、package.json 里 ^ 和 ~ 到底差在哪、以及在原生 ESM 项目里直接运行 .ts 文件的几种方式。

记录在 Tauri 2.0 中使用 dialog 插件打开文件选择框，以及用 convertFileSrc 播放本地 mp3 文件的方法。

内核模块是什么、为什么需要它，以及编写、编译、加载、卸载一个 Hello World 内核模块的完整步骤，逐行解释代码、Makefile 和相关命令。

介绍 JIT 编译原理、LuaJIT 的工作方式、NYI 问题，以及有无 JIT 的性能对比测试。

介绍 Rust 所有权机制的核心概念：作用域、move、clone、copy，以及引用和借用规则。

以一个 hello world 程序为例，拆解 C 代码从源文件到可执行二进制经历的四个阶段——预处理、编译、汇编、链接，每一步都用 gcc 命令单独跑出来看中间产物。

介绍 OpenResty 的处理阶段、各阶段对应的 Lua 指令，以及一个完整的 demo 验证执行顺序。

用 manim 实现冒泡排序的可视化动画，记录元素初始化、交换动画的实现过程。

记录如何从 Root 的安卓手机里提取微信数据库，解密 EnMicroMsg.db，解析聊天记录、图片、语音等媒体文件的存储结构。

介绍 Redis 的 RESP 协议，包括五种数据类型的格式、发送命令的方式、Pipeline 机制，以及用 Go 手写 Redis 客户端。

深入介绍 MySQL 客户端-服务端通信协议，包括握手包、能力标志、HandshakeResponse、响应包格式、结果集解析，以及用 Go 手写 MySQL 客户端的完整实现。

记录如何用 GitHub Actions 自动化交叉编译树莓派内核，并将编译结果上传到 Release。

从「为什么需要 OAuth」讲起，逐一说明 OAuth2.0 的四种主要授权类型各自适用什么场景，以及 JWT 令牌的三段结构、签名验证原理和使用时的注意事项。