https://waylan.org记录操作系统、软件工具、网络服务、脚本自动化和新技术体验。以实际问题为起点，写清环境、操作、结果与取舍。zh-CNhttps://waylan.org/post/a-room-on-the-internetecho:echo-001Sat, 31 Oct 2026 04:00:00 GMT正文在构建时渲染成完整 HTML，交互在水合后接管，登录与评论交给同一个 Worker。记录这个博客的架构取舍，以及为水合一致性处理的那些细节。https://waylan.org/post/urls-are-interfacesecho:echo-009Fri, 30 Oct 2026 04:00:00 GMTURL 一旦发布，就是对外承诺的接口。改版可以重写一切实现，但不应该让任何一个旧链接变成 404。https://waylan.org/post/svg-dotted-lineecho:echo-007Thu, 29 Oct 2026 04:00:00 GMT不需要 Canvas，也不需要额外的图片。把虚线的线段长度设为接近零，再配合圆形端点，一条 SVG 路径就会变成一串均匀的圆点。https://waylan.org/post/design-tokens-themingecho:echo-002Wed, 28 Oct 2026 04:00:00 GMT深色模式之所以难维护，往往是因为颜色直接写在了组件里。把 token 分成原始值、语义与组件三层，主题切换就只是换一组映射。https://waylan.org/post/project-waylanecho:echo-014Tue, 27 Oct 2026 04:00:00 GMT你正在浏览的这个网站。静态预渲染的 React 应用，部署在 Cloudflare Workers 上，支持私人划线、段落级批注，以及基于 GitHub Discussions 的公开讨论。https://waylan.org/post/devlog-anchor-migrationecho:echo-012Mon, 26 Oct 2026 04:00:00 GMT这周把批注的定位从“只认字符偏移”改成了“块标识 + 原文 + 前后文”的三段式查找，并补上了原文已变化时的展示。https://waylan.org/post/workers-d1-edge-dataecho:echo-003Sat, 24 Oct 2026 04:00:00 GMT静态站点只需要很少的服务端能力：登录、评论和批注。用一个 Worker 同时托管静态资源与 API，再配一个 D1 数据库，就能覆盖这些需求。https://waylan.org/post/stable-text-anchorsecho:echo-004Tue, 20 Oct 2026 04:00:00 GMT一条批注指向的是“某几个字”，而文章会被修改。精读 W3C Web Annotation 的选择器设计，并记录我在实现中采用的定位顺序与失败策略。https://waylan.org/post/read-tests-firstecho:echo-010Sun, 18 Oct 2026 04:00:00 GMT读一个陌生的仓库，我会先读测试。文档描述作者希望代码做什么，测试记录的是代码实际被要求做什么。https://waylan.org/post/slow-toolsecho:echo-005Fri, 16 Oct 2026 04:00:00 GMT读者写一条评论，中途去登录、切换标签页或误触返回，文字都不应该丢。记录评论框里草稿持久化与离开保护的实现细节。https://waylan.org/post/use-reduced-motionecho:echo-008Tue, 13 Oct 2026 04:00:00 GMT系统设置里的“减少动态效果”是读者明确表达过的偏好。动画开始之前先确认是否允许，并且在预渲染时给出确定的默认值。https://waylan.org/post/performance-budgetecho:echo-006Sat, 10 Oct 2026 04:00:00 GMT性能很少在某一次提交里突然变差，而是在几十次“只多了几 KB”之后。给资源体积设定预算，并让 CI 在超出时失败，是我目前最有效的做法。https://waylan.org/post/project-margin-echoecho:echo-015Thu, 08 Oct 2026 04:00:00 GMT把一段讨论锚定在原文的某几个字上。文章修改之后，按块标识、原文与前后文依次找回位置；找不到时明确标记，而不是悄悄贴错。https://waylan.org/post/component-boundariesecho:echo-011Sat, 26 Sep 2026 04:00:00 GMT当一个组件需要靠布尔 props 切换出完全不同的结构时，它通常是两个组件被写在了一起。https://waylan.org/post/devlog-offline-previewecho:echo-013Mon, 14 Sep 2026 04:00:00 GMT为了让人不装任何依赖就能看到网站效果，这周做了一个可以直接双击打开的单文件 HTML 预览。