JavaScript
用 View Transitions 做日出日落式主题切换
Tension 主题把明暗切换做成整页帷幕：浅色从上往下收，深色从下往上展。记录 View Transitions、clip-path、闪屏和太阳月亮按钮的实现过程。
2022–2026
编年碑目
按年份整包翻阅。站内共 122 篇，本页已载入最近 66 篇，更早的按年继续展开。
2026
AI
删除 Cursor Commit 时自带的 “Co-authored-by: Cursor” 附加信息
使用 Cursor 开发时，如果我们让 Cursor agent 帮我们 commit git changes…
技术总结
在 OpenCode 侧边栏显示 Go 套餐用量：TUI 插件实现与使用
一前言 OpenCode Go 有滚动 / 每周 / 每月三档配额，但 TUI 里默认看不到。我做了一个侧边栏…
技术总结
告别 ProxyCommand：Termius + VSCode 通过 Cloudflared 隧道连接内网服务器的完整指南
还在为 Termius 不支持 ProxyCommand 而苦恼？本文将手把手教你通过 C…
Server
解决 Cloudflare 522 超时错误：一次因 Apache MaxRequestWorkers 不足引发的深度排查
一背景 生产环境中的 Debian 服务器（Apache 2.4.38 + MySQL）上运行着若干 Word…
技术总结
.gitignore 为什么没生效？清理 Git 历史中已跟踪但应被忽略的文件
一前言 .gitignore 写好了，但文件还是被提交了？这不是你配置错了，而是 Git 的跟踪机制在起作用。…
技术总结
Vue + OpenLayers 6 地图海量用户 Marker 聚合实践
在物业巡更管理系统的仪表盘里，左侧总览地图需要同时展示数十名保安的实时 GPS 位置。若每个点都带姓名标签，远…
Flutter
Flutter 播放器迁移踩坑记：从 video_player 到 media_kit 的血泪史
近期将 Flutter APP 的播放器从官方 video_player 替换为 media_kit（基于 l…
Flutter
Flutter 应用中的用户级成人内容过滤：从拦截器到后端集中管理的架构演进
一前言 Yam TV 作为一个多源视频聚合平台，需要对成人内容做双重过滤——系统级管理员配置的全局过滤 + 用…
Flutter
HLS 广告过滤启发式算法：假阳性问题与修复
一前言 Yam TV 支持通过本地 HTTP 代理过滤 HLS 流中的广告分段。广告检测算法使用启发式方法分析…
Flutter
搜索→播放流程从 30 秒降到 3 秒：NDJSON 流式处理与页面合并实践
一前言 Yam TV 的推荐页中，用户点击一部电影后，需要先经过解析页搜索视频源，再跳转到播放页加载详情和解析…
Flutter
Flutter 语义树崩溃与骨架屏的艰难实现：一个 Flutter 3.41 框架 Bug 的修復之旅
一前言 在 Yam TV 的 Flutter 客户端中，我一直想實現首頁加载时的骨架屏效果。看似简单的需求——…
技术总结
从零构建纯浏览器端图片处理工具：ImgTools 的技术实践
一前言 本文分享了 ImgTools（一个纯浏览器端图片处理工具）的完整实现过程。从技术选型到架构设计，从核心…
Flutter
Flutter 图片加载之谜：Provider 时序导致的“全有或全无”现象
一前言 最近在开发 Flutter 应用时遇到一个诡异的图片加载 bug：源站列表的封面图要么全部加载不出来、…
Android
Flutter Android 画中画实现
一前言 在 Yam TV 的 Flutter 端中，用户希望在播放视频时能够切换到画中画模式——视频以悬浮小窗…
Android
Flutter 端 m3u8 视频下载管理器：从下载到播放的全链路实现
一前言 在 Yam TV 这个跨平台影视 App 中，Flutter 端需要实现一个完整的视频下载功能：支持 …
技术总结
Docker 镜像瘦身实战：从 489 MB 到 388 MB
一前言 一个 NestJS + Vue 3 的全栈项目，Docker 镜像接近 500 MB。是 node_m…
技术总结
Yam TV HLS 去广告方案：从启发式到规则引擎的演进
一前言 视频聚合应用中，第三方视频源的 HLS 流常携带贴片广告。如何在客户端侧干净地移除广告片段，同时避免误…
JavaScript
Vue 3 KeepAlive 多组件缓存踩坑记
一前言 在开发影视聚合站时，我们遇到了 Vue 3 KeepAlive 在多组件缓存场景下的严重 Bug——一…
技术总结
WordPress 下自定义接口慎用查询参数 name：踩坑与改参方案
在主题里用「单页 + $_REQUEST」做 JSON API（例如 c=PatrolSkipReason&a…
AI
广东移动 Token Plan 配置到 opencode
近期，广东移动推出了限时免费的 Token Plan（体验版一个月），能薅羊毛的好事肯定得好好利用起来😋。如图…
AI
CSS 网格背景与鼠标联动：从静态到动态的技术实现
在 Cyber Crayon 主题中，全站背景使用了一层 CSS 网格作为视觉基底。最近我们为它增加了两层交互…
技术总结
WP Beautify Articles：把 AI 润色引入 WordPress 的逐段审阅工作流
一前言 在内容生产里，“一键润色”很容易，但真正难的是可控地落地：既要用 AI 提升表达，又要能逐段校对、可回…
AI
零外部依赖！用 OpenCode Skill 实现自动发布技术博客到 WordPress
一前言 作为开发者，我们经常遇到这样的情况：花了大量时间解决一个棘手的技术问题，调试、查文档、反复试验，最终找…
Server
[ssl] 部署 Sectigo ssl 时 ca-certificates 缺少根证书的情况
从 ssl 后台下载了证书后，先测试证书链是否正常： 可知，bundle.crt 的证书链不正常。 我们用这种…
Server
[ssl] ssl 证书修 bug 大作战
事情起因于昨日同事更换新的 SSL 证书，今早另一位同事便来电反映证书出现问题，导致客户无法登录。 经检查，问…
JavaScript
[VitePress] 部署到 Vercel 后直接访问 url 出现 404 或者卡住的问题
使用 VitePress 将文档部署到 Vercel 后，首次直接访问一切正常，但一旦选择子路径或刷新页面，便…
AI
[AI] 分享由 cursor 生成的 wordpress smtp 插件
众所周知，在中国大陆，wordpress 默认的发信有时候会收不到。所以，配置自己的发信邮箱就很有必要。 以下…
2025
Python
[erpnext] WebForm 提交前添加 Loading
erpnext 默认 Web Form 页面提交时很呆，没有 Loading 提示。 于是，为了实现这个功能，…
Docker
[docker] Apple silicon 上用 docker compose 镜像运行 go 生成的程序提示 failed to open elf 的问题
图中的 tps-yeastar 是用 go build 出来的可执行程序，但 docker compose 构…
Python
[erpnext] DocType 通过 Client Script 实现选择框条件联动
需求是这样的，在一个叫 Task 的 DocType 中，要求： 1）当 Matter 字段为空时，Type …
Python
[erpnext] app 集成 tailwindcss 4.x
假设原始目录结构是 首先，在 apps/myapp 下执行 在 input.css 中写入： 然后，创建 ta…
Python
[erpnext] 添加类似设置的单一 DocType，非 List
首先，创建一个 Is Single 类型的 DocType 然后，可能会遇到 则可参考找不到 DocType …
Python
[paperless-ngx] 与 erpnext webhook 通讯
需要先去 erpnext 后台生成一个 api_key，否则 webhook 默认会以 Guest 用户访问，…
Python
[erpnext] 为 Project 添加 Timesheet（编程方式）
假设我们知道 Project Name 为 001，那么我们获取 Project 唯一标识： 创建 Times…
Docker
[paperless-ngx] docker compose 构建的 paperless 使用 webhook timeout 的问题
发现问题 我在 paperless 的工作流中添加了一个 webhook，用于 ocr 处理完毕后，自动将内容…
Python
[erpnext] translation 的使用
假设我要将 erpnext 的 Projects 相关字样改为 Matters： 然后我们在 Frappe F…
Python
[erpnext] 保存时出现 BrokenPipeError: [Errno 32] Broken pipe 的问题
发现问题 我在 Frappe Framework -> Build -> Views 添加新的展示…
PHP
[MantisBT] Rest API 使用注意事项
1. 请求头中必须携带 API Token 其中，API Token 可在这个位置获取 2. API 默认返回…
PHP
[wordpress] 文章或页面设置密码保护无效的问题
如果不使用 the_content() 或 get_the_content() 方法来展示文章或页面内容，那么…
PHP
[MantisBT] CORS 跨域问题
需要到 MantisBT 根目录下找到 api/rest/index.php 文件，在其顶部添加
PHP
[开源] 为 wordpress 添加顶部彩虹滚动进度条
原理是在 wp_head 钩子中添加一个 div，并赋予动画效果。效果如下： 将源码上传至 wordpress…
Python
[erpnext] 新建 DocType 保存时，出现找不到 DocType 或 Page 的情况
可以在你所在的项目的 apps 目录下查找是否生成了对应的 DocType，例如 如果缺失了 .py 文件，则…
Android
[Android] 非系统应用发送受保护的 Broadcast 时 crash 的问题: Intent Filter Verification Service has stopped
在本示例中，我通过手动方式发送了 android.intent.action.PTT.down 系统广播。这是…
JavaScript
[开源] 搜索指定国家或地区的 AppStore 应用
假设我需要知道在香港地区的 Apple App Store 是否上架了某个 App，但我本人并不身处香港，也无…
Flutter
[flutter/ios] exportArchive Unable to process request – PLA Update available
意思是 《Apple Developer Program 许可协议》（即 PLA）有更新，需要账户拥有者查阅并…
Flutter
[flutter/ios] exportArchive The operation couldn’t be completed. Unable to log in with account xxx
意思是 Xcode 中的登入信息已经过期，需要进入 Xcode - Settings - Accounts 重…
Docker
[docker] 记得设置 Timezone
在 .Dockerfile 中添加 在 docker-compose.yml 中添加
JavaScript
[nestjs/telegraf] polling fetchError: ETIMEDOUT 导致 bot 被停止的问题
当 polling 访问 telegram api 超时的时候，就会出现这个问题（node v22.4.1） …
JavaScript
[vben-admin] vxe-table edit-config 支持 antdv 组件库
安装 安装 @vxe-ui/plugin-render-antd 注意，在 vben-admin 中需要按以下…
JavaScript
[nestjs/typeorm] entity 字段置 null 出错的问题
起初，@Entity 中的某个字段这样定义： 当我为 dob 字段赋值 null 时： 解决方法： 我在 gi…
JavaScript
[vben-admin] vxe-table sort 状态无法保存的问题
可以看到，虽然 sort 的值是可以正常获取，当 table 表头的按钮没有高亮。 原来是因为在 query(…
Flutter
[flutter] 防止 stack 布局的组件被软键盘顶起导致的 overflow 错误
解决方法： 参考代码：
Flutter
[flutter/ios] 提交至 TestFlight 提示“缺少出口合规证明”
解决办法： 在 Info.plist 中添加
Flutter
[flutter/ios] type ‘StackParentData’ is not a subtype of type ‘FlexParentData’ in type cast
原因是：在 Stack 组件中使用了类似 Expanded、Flexible 组件
Flutter
[flutter] Using `dart run flutter_launcher_icons` destroys ios-project
提示错误： The project ‘Runner’ is damaged and cannot be ope…
Flutter
[flutter] ios unable to load contents of file list /.xcfilelist not found
运行 flutter build ios 即可生成
Android
[Android] 更新 Android Studio 后报错 Unknown Kotlin JVM target: 21
从2023.3.1升级至2024.3.1后，报错信息如下： 解决方法： 1. 升级 gradle 版本（按自己…
Android
[Android] webview 与 h5 upload（2）
解决了无法打开媒体选择器的问题之后，可能还会遇到这样的问题 上传进度一直卡在 0%，有可能是由于 CORS 跨…
Android
[Android] webview 与 h5 upload（1）
最近在做一个 webview 展示 h5 表单的功能，发现 <input type="file…
PHP
Server
[Debian] ufw 与 iptables 冲突
起因： 升级宝塔 v9.5.0 后，发现端口规则列表为空。根据bt论坛指引，使用 ufw 命令检查，发现并无此…
Android
[Android] 为 PopupWindow 设置遮罩
此处例子是为 fragment 添加的 extension function PopupWindow show…
PHP
composer 安装 phpmyadmin
首先，安装 composer 通过 composer 安装 phpmyadmin（注意安装所需的php扩展：m…
PHP
Debian 安装 php+mysql
安装 php7.4 安装 mysql / mariadb 创建 mysql 用户并授权
MySQL
mariadb 创建用户
创建并授权 刷新权限
