首页

2023 年，我借助 AI 把两百多行 beautifier.js 嵌入 Go、通过 goja 执行，快速做出了 soulteary/nginx-formatter。三年后，为了让它在 CI 中更可靠，我用原生 Go 的 Lexer、Parser、AST 和 Printer 重写了格式化内核。本文记录 v2.0.0 到 v2.2.0 的三步重构：替换内核、支持单文件、用 Cobra 拆出 format、serve、version 子命令，并复盘转义丢失、单引号 JSON、Lua RawBlock 等历史问题的处理结果。 阅读全文

延续之前用 Split DNS 提升跨系统双机开发体验的做法，手工维护 macOS 的 /etc/resolver 配置在设备和项目变多后越来越麻烦：覆盖前要备份、改完要刷新缓存、排错要在 dig、scutil 和 dscacheutil 之间来回切换。本文介绍我为此写的开源小工具 soulteary/splitdns，用来创建、修改和检查 Mac 上的 resolver 配置，并覆盖双机联动与单机使用两种场景。 阅读全文

从 Docker Desktop 换到 Podman 后，Linux Rootless Podman 用 pasta 发布 80、443、22、53 这类低位端口时会因权限不足失败，把宿主机端口换成 8080 才能启动。本文介绍我为此写的小工具 soulteary/portmap：让 Rootless Podman 继续发布高位端口，再由宿主机上一个功能单一的进程提供标准端口入口。 阅读全文

两年前用不到三十行的 Dockerfile 把 WordPress、SQLite 和官方镜像拼在一起，两年后这个 Dockerfile 明显变长了。本文继续拆解 soulteary/docker-sqlite-wordpress，随着上游从 WordPress 6.5.2、PHP 8.3、SQLite Integration 2.1.9 升级到 WordPress 7.0.2、PHP 8.5、SQLite Integration 3.0.0-rc.8，SQLite 接入方式依旧靠 db.php 接管数据库层，新增代码主要集中在上游 Monorepo 组装、Rust 原生解析扩展、五种架构的多架构发布、旧数据卷自愈修复，以及后台只读的 SQLite Diagnostics 运行诊断页面。文章同时说明了根目录 Loader、id/ID 结果键兼容修复、挂载卷权限、WAL 备份与并发，以及需要核对实际 SQLite 引擎版本等容易忽略的限制。 阅读全文

趁着周末老设备磁盘告急，顺手做了一次完整的 macOS 迁移与开发环境重建，并把整个过程整理成一套可复用、可迁移、可重建的初始化方案。本文按照“从零恢复一台开发机”的顺序，依次展开：Xcode CLI 与系统基础工具链、Homebrew 包管理器、Oh My Zsh 与自动补全插件、基于 gpg-agent 统一托管 SSH/GPG 的 Git 签名体系，以及 Go（GVM）、Python（Miniforge）、Node.js（nvm）、Bun 四类多语言运行时的版本管理与隔离，每一步都给出可执行命令、真实日志输出和验证方式，最后补充新设备到手后的系统层面初始化清单。 阅读全文

前两篇文章把 OtterIO 的来龙去脉和代码线整理交代清楚了，这篇文章回到操作层面：如果过去的项目、文章示例、CI 环境或小型私有化部署里用了 MinIO，现在想切换到 OtterIO，应该怎么改镜像、怎么换环境变量、怎么部署、怎么验证迁移、哪些地方不兼容。文中给出一条 Docker 命令起 OtterIO、用 docker compose 跑多版本 MinIO 与 OtterIO 共存的可复现实验环境，再用 AWS CLI、s3cmd 通过标准 S3 API 把不同版本 MinIO 中的对象同步到 OtterIO，并用对象级 ETag/大小/数量做迁移校验，最后老老实实说明 mc admin、企业特性、商标与发行物层面的兼容边界。 阅读全文

上一篇文章交代了为什么要重新审视 MinIO，以及为什么会有 soulteary/minio 这条 Apache 2.0 基线。这篇文章接着往下聊：从 soulteary/minio 到 OtterIO，中间到底做了什么。我把这次整理拆成十二步：从项目身份和命名独立、把 2021 年的代码带到 2026 年、用 gofiber/fiber/v3 重做 HTTP 入口、缩小 Bucket Notification 与 Gateway 的维护面，到把 2021 年 4 月之后上游 CVE / GHSA 逐项入账、按攻击面拆解安全修复、补齐 LDAP DN 规范化与迁移流程，再到完善 CI、自动化 Release、多架构镜像、控制台 listener 拆分，以及在保留原有 S3 使用体验的前提下，诚实说明 OtterIO 的适用范围与风险边界。 阅读全文

MinIO 仍然是开源软件，但它已经不再是过去那个“Apache 2.0、社区仓库持续维护、预编译二进制直接使用”的默认选择：许可证从 Apache 2.0 切换到 AGPLv3，公开 GitHub 仓库被归档并标注不再维护，社区版预编译二进制也不再继续发布。本文重新审视 MinIO 当前的开源状态，比较 PGSTY/Silo 与 JuiceData/minio 两个社区 fork 的定位与许可证边界，并整理出我自己的 soulteary/minio 主线：基于 RELEASE.2021-04-22T15-44-28Z 这一切换 AGPLv3 之前的最后 Apache 2.0 版本，把 HTTP 路由切到 gofiber/fiber/v3、收敛 Bucket Notification 与 Gateway、升级到 Go 1.26，作为后续 OtterIO 项目的代码基线。 阅读全文

Kakapo 是一个基于 Wails v3、Go 和 Echo 构建的本地桌面翻译工作台，它把多个 OpenAI 兼容模型（Kimi、DeepSeek、OpenAI 等）收拢到同一个界面里，支持多模型并行翻译、结果比较、回译、系统朗读和本地历史记录。普通配置保存在 settings.json，API Key 使用 macOS Keychain 保存，历史记录保存在 history.json。本文记录这个项目的实现过程，以及 Wails v3、Go、Echo、系统 WebView、Keychain 和 OpenAI 兼容接口这套技术栈在桌面工具场景下的实践与取舍。 阅读全文