发布于

2026-第四十一周

作者

该周报主要为各个地方内容的汇总整理

技术

繁忙机器上的 Node.js 线程池

本文讨论了 Node.js 线程池自动扩容的问题:作者 Matteo Collina 反对根据 CPU 数量自动设置线程池大小,认为 os.availableParallelism() 只反映进程可用的并行能力,并不代表 CPU 真的空闲;在繁忙主机上盲目增加 worker 反而会拖慢事件循环、增加请求延迟。文章建议按实际测量结果手动调优,并在繁忙主机上同时关注吞吐量与慢请求,尤其对 bcrypt 这类 CPU 密集型任务更需谨慎。

  • 🧠 核心异议:反对"按 CPU 数自动决定线程池大小",因为系统不清楚机器上还有谁在占用 CPU
  • 📊 "可用"不等于"空闲":os.availableParallelism() 只估算进程可用的并行度,并不检查 CPU 是否真的空闲
  • ⚔️ 多进程竞争:多个进程都读到 16 就各起 worker,会一起抢占同一批 CPU 时间,没有预留机制
  • 🐌 nice 值不等于空闲:降低到 nice 10 只是减少份额,仍会占用 CPU、内存与缓存带宽,还可能拉长请求完成延迟
  • 🖥️ 一 vCPU 的例外:Nub 检测到 ≤1 vCPU 时仍保留 4 个 worker(10 是 nice 值,不是线程数),对容器配额而言仍可能过多
  • 📉 gzip 实测反例:2 MiB 输入、8:1 压缩下,1 worker + 1 job 达 49.3 MiB/s,4 worker + 4 job 只有 37.3 MiB/s,增加并发反而更慢
  • 💾 等待存储与计算不同:I/O worker 等待存储时几乎不耗 CPU,多起 worker 可能有收益;bcrypt 是计算密集型,无法享受这种好处
  • 🧪 基准测试的矛盾:Node.js PR 中更大线程池提升了 crypto 基准,却让某个文件系统基准变慢,不能据此一刀切定默认值
  • ✅ 结论与建议:应针对具体应用在繁忙主机上测试,兼顾吞吐与慢请求;nice 值解决不了这个问题,且队列的 job/字节预算满时必须停止接收工作

CSS 现在负责你的工具提示定位 - Matt Smith

CSS 锚点定位让元素可跟随指定锚点自动定位,内置滚动/缩放重算和溢出翻转,适合 tooltip、popover 和下拉菜单,且多数场景无需 JavaScript。

  • 🧰 旧方案:用 getBoundingClientRect() 和 top/left 定位,需监听 resize/scroll,并手动计算溢出或翻转,或依赖 JS 库。
  • 🎯 新方案核心:给锚点设 anchor-name,给目标设 position: fixed/absolute、position-anchor 和 position-area,即可定位。
  • ♻️ 浏览器会自动在滚动、窗口调整时重新计算位置;仅适用于已绝对或固定定位的元素。
  • 🏷️ anchor-name 不必全页唯一,但每个锚点与其匹配目标之间必须唯一;组件复用时需为每个实例生成独立名称。
  • 📐 position-area 用 bottom、top、bottom span-right 等描述放置,替代手写 top: calc() 偏移。
  • 🔄 position-try-fallbacks: flip-block, flip-inline 可在溢出视口时自动翻转到另一侧,省去 resize 监听和手动检测。
  • 🪟 与原生 popover 配合可实现下拉菜单:自动置顶渲染、避免 z-index 争斗、点击外部轻关闭。
  • 📏 anchor-size(width) 可让下拉菜单宽度直接匹配触发按钮,无需 JS 测量。
  • 👁️ 锚点定位只解决“放在哪”,不解决“何时显示”;显示切换仍需 :has()、popover 或少量 JS。
  • 🧩 非兄弟元素可借助共同祖先上的 :has(),根据锚点状态显示注释。
  • 🧭 经验法则:相对特定元素定位用 anchor-name/position-anchor;相对自身容器用 absolute + relative 父级即可。
  • 🌐 现代 Chrome、Firefox、Safari、Edge 支持良好,但 Safari/Chrome 在回退定位边缘情况有差异,popover 默认 margin 可能干扰,旧浏览器需 @supports 回退。
  • ♿ 锚点关系是纯视觉的,屏幕阅读器仍按文档顺序朗读;aria-describedby 只能部分弥补,不应视为无障碍方案。

React 的新浏览器 API:仅在浏览器中渲染组件 - Certificates.dev

React Canary 新增 browser API,配合 use() 和 Suspense,让组件跳过服务端渲染、只在浏览器中渲染,从而避免 localStorage、window、DOM 等浏览器专属值引发的 hydration 不匹配。

  • 🌐 SSR 要求服务端 HTML 与首次客户端渲染一致;组件渲染时读取 localStorage 或 window 会导致服务端失败或 hydration 问题。
  • 🧩 browser() 从 react-dom 导入,必须与 use() 搭配使用:use(browser('原因'));单独调用没有效果。
  • ⏳ 服务端遇到 use(browser()) 时会停止渲染该子树,并使用最近的 Suspense fallback;浏览器中则返回 undefined 并继续渲染。
  • 🚧 Suspense 边界是必需的;浏览器 API 在服务端永远不会可用,没有 fallback 会导致服务端渲染失败。
  • 🔍 可选字符串用于说明组件为何需要浏览器,便于在日志中识别有意的浏览器专属渲染。
  • 🧱 fallback 会进入初始 HTML 并持续到 hydration,应提供有用状态并预留空间;边界应尽量靠近浏览器专属组件。
  • ⚠️ 旧方案有局限:typeof window 分支可能造成 hydration 不匹配;isMounted + Effect 会增加状态和额外渲染。
  • 🧭 与 'use client' 不同:'use client' 标记客户端组件边界但仍可在服务端出 HTML;use(browser()) 明确让该子树跳过服务端渲染。
  • 💾 典型用例包括:从 localStorage 读取草稿、依赖 DOM 的代码编辑器、显示用户时区等浏览器专属数据。
  • 🧪 该 API 目前仅在 React Canary/Experimental 中可用;可安装 react@canary 和 react-dom@canary,并用 --save-exact 固定版本。
  • ✅ 结论:browser API 为首次有意义渲染依赖浏览器状态的组件提供了明确路径;服务端完成其余页面并发送有意 fallback,代价是 hydration 前显示 fallback。

Claude Code mods

Claude Code mods 是运行在会话内的小型 JavaScript/TypeScript 文件,可通过 hooks 观察、改写或扩展 Claude Code,并绘制终端或桌面 UI;教程从零构建约 80 行的 Token Weather,并展示 Blast Radius、Replay Theater、分享方式与最佳实践。

  • 🧩 mod 是 Claude Code 插件的模块,能监控事件、改变行为或绘制自定义界面。
  • ⚡ 无需先学 API:运行 claude,描述想要的 mod,并允许热重载即可开始。
  • 🔗 mod 本质是 hooks,事件如 tool.call、turn.complete、session.start、ui.render 都会进入链式处理。
  • 🎛️ hook 可采取三种动作:观察、改写事件,或直接拒绝/回答而不调用 next。
  • 🧱 与 settings hooks 不同,mod 加载一次并留在会话中,可保存状态、绘制动态 UI、注册命令和工具。
  • 🛠️ Claude Code 自身也用 mod 实现部分功能,例如 AGENTS.md 支持和 /diff 面板,源码在公开仓库。
  • 🌦️ 教程项目 Token Weather 在提示上方显示上下文窗口占用:天气图标、百分比、token 数、迷你图和上轮增量。
  • 📁 构建步骤包括创建插件目录、plugin.json、hooks/hooks.json 和导出 register(on) 的模块。
  • 🖥️ 第一个目标是 AbovePrompt 组件,通过 ui.render 返回 Box、Text 等元素。
  • 📊 使用 $.session.usage() 读取真实上下文数据;历史状态应放入 $.state,以在热重载后保留。
  • 📝 状态需要在类型契约中声明,如 types/index.d.ts,否则 claude plugin validate 会报错。
  • 📈 绘制时注意 e.props、hasSurvey、bodyColumns,并用单宽符号保证终端字体对齐。
  • ✅ 用 claude plugin validate 检查插件,用 claude plugin test 在真实运行时中测试 hooks 和 UI。
  • 📦 mod 通过插件市场分享,可用 /plugin marketplace add、/plugin install、/reload-plugins 安装。
  • 🔒 mod 运行在本机并拥有 Claude Code 同等权限,因此应只安装可信来源,并先阅读仓库。
  • 💥 Blast Radius 示例拦截危险 Bash 命令,预览影响并提供 Proceed/Cancel,必要时降级到提示上方显示。
  • 🎬 Replay Theater 示例记录 Edit/Write,回合结束后通过 /replay 或快捷键逐步查看 diff。
  • 🧠 四个习惯:依赖自动生成类型、从 e.props 读属性、热重载状态放 $.state、UI 不显示时用 claude --debug 查日志。
  • 💡 可继续做成本/速率表、团队规范提示注入、文件阅读地图、专注计时器、kubectl/terraform 防护等 mod。

单体优先

Martin Fowler 认为,新项目应优先采用“单体优先”策略:即使未来可能受益于微服务,也先从单体开始。因为成功微服务案例大多来自过大的单体拆分,而从零构建微服务常陷入严重麻烦;微服务适合复杂系统,但存在显著“微服务溢价”,早期应优先速度与反馈,待边界稳定后再逐步演进。

  • 🏗️ 几乎所有成功的微服务故事,都始于一个变得过大、随后被拆分的单体。
  • ⚠️ 几乎所有从零构建微服务系统的案例,最终都遇到了严重麻烦。
  • 💸 微服务是有效架构,但有“微服务溢价”,即管理一组服务的成本会拖慢团队,简单应用更适合单体。
  • 🚀 新应用初期应验证想法是否有用,优先快速迭代和反馈,避免承担微服务开销。
  • 🧭 微服务只有在边界良好且稳定时才有效,但即使经验丰富的架构师在初期也很难划对边界。
  • 🧩 单体优先可先探索正确边界,并逐步发展微服务所需的前提条件。
  • 🛠️ 执行方式包括:精心设计模块化单体;从边缘逐步剥离微服务;整体替换并用“可牺牲架构”快速上市;先做粗粒度服务再细化。
  • 🔁 不能假设任意单体都能拆成微服务;多数系统模块依赖过多,强行拆分容易混乱。
  • 🤔 反方观点认为,从微服务开始可适应开发节奏、按服务划分团队、便于扩展,尤其适合系统替换;但团队最好已有微服务经验。
  • 📊 目前证据仍少,关于单体优先的建议应视为暂定,远未达成一致。

工具

Pascal Editor

Pascal Editor 是一个开源、本地优先的 3D 建筑编辑器,基于 React Three Fiber 与 WebGPU 构建,可在浏览器或 CLI 中运行,并通过 MCP 为人类和 AI agent 提供实用工作流。

  • 🏗️ 核心定位:开源 3D 建筑编辑器,面向 BIM、CAD、平面图、参数化设计与 AI agent 协作。
  • ⭐ 社区数据:约 24.7k stars、3.1k forks、135 watchers,采用 MIT 许可证。
  • 🌐 在线预览:editor.pascal.app 展示下一代 Pascal,包括爆炸视图、剖切、X-ray、漫游、交互与环境切换,但预览功能尚未进入开源版本。
  • 🎥 视频素材:六个原始视频可按 CC BY 4.0 用于教程、文章或社交内容,需署名 Pascal 并链接许可证。
  • 💻 本地运行:Node.js 22.13+ 下运行 npx @pascal-app/cli editor,CLI 会启动编辑器与认证 MCP 服务,项目默认存于 ~/.pascal/data/pascal.db。
  • 🔌 MCP 与 agent:支持 pascal mcp connect,本地连接无需账号或 API key;每个本地 CLI 服务应只使用一个活跃 agent 客户端。
  • 🧠 Agent skills:通过 npx skills add pascalorg/editor --skill pascal-3d --skill furniture-fit 安装,也可作为 Claude Code、Codex 等插件使用。
  • ☁️ 托管 MCP:Claude 插件还包含 pascal-hosted,连接 https://editor.pascal.app/api/mcp,可选 Pascal API key 并存入系统钥匙串。
  • 📦 发布包:查看器与内置节点定义分离,需安装 @pascal-app/core、@pascal-app/viewer、@pascal-app/editor、@pascal-app/nodes 并加载 builtinPlugin。
  • 🧱 仓库架构:Turborepo monorepo,包含 Next.js 应用及 core、viewer、editor、nodes、cli、mcp、ui 等包。
  • 🗂️ 状态管理:useScene 管理场景节点与持久化,useViewer 管理查看器选择与层级模式,useEditor 管理编辑器工具与面板。
  • 🧩 核心概念:节点是以 parentId 连接的扁平字典;层级为 Site → Building → Level → Wall/Slab/Ceiling/Roof/Zone/Scan/Guide。
  • 🎛️ 渲染与系统:渲染器创建 Three.js 对象并注册到 sceneRegistry,系统通过 useFrame 处理 dirty nodes 来更新几何体。
  • 🖱️ 编辑器工具:包括选择、墙体、区域、物品、楼板工具,以及层级选择管理器和可视化数据流。
  • 🧱 插件机制:插件通过统一 Plugin manifest 提供节点类型、2D/3D 渲染、放置工具、检查器参数和面板;示例仓库为 pascalorg/plugin-trees。
  • 🛠️ 技术栈:React 19、Next.js 16、Three.js WebGPU、React Three Fiber、Drei、Zustand、Zod、Zundo、three-bvh-csg、Turborepo、Bun。
  • 🚀 开发与发布:bun install、bun dev 启动开发服务器(localhost:3002),turbo build 构建,发布由 GitHub Actions 统一 bump 七个包并按依赖顺序发布。
  • 🤝 贡献:欢迎 bug 修复、功能、文档和想法;新节点类型和侧栏面板建议以插件形式发布,安全漏洞按 SECURITY.md 报告。

更新

Video.js v10

  • 🚀 Video.js v10.0.0 于 2026 年 10 月 1 日正式 GA,结束 Beta/RC 阶段,稳定版可投入生产。
  • 🧱 v10 是底层重建,汇集 Video.js、Plyr、Vidstack、Media Chrome 和 Mux Player 的经验与贡献者。
  • 📦 默认包体积较 v8 减少约 60%,可组合架构让你只打包真正使用的功能。
  • ⚛️ 提供 React 一等组件、原生 HTML Web Components、TypeScript 与 Tailwind 支持,状态、UI 和媒体解耦。
  • 🎨 默认皮肤设计更完善,并可通过 Shadcn CLI 将皮肤源码加入项目,自由修改布局、控件和样式。
  • 🤖 面向编码代理优化,发布官方 Video.js skill,可用 npx @videojs/cli agents skills 安装。
  • 🌐 支持 HLS、DASH、YouTube、Vimeo、Mux 和 Cloudflare Stream 等多种源与服务。
  • 🧭 文档与安装流程重新设计,并提供从 Video.js v8、Mux Player、Media Chrome、Vidstack 迁移的指南。
  • 🧩 GA 新增标题显示、章节展示改进,以及 Compat 皮肤,浏览器兼容回溯至 Safari 16。
  • ⚙️ SPF 新流媒体引擎带来显著体积节省,但暂不支持广告或真正低延迟直播;这些场景可用 HlsJsVideo。
  • 📦 v10 以 @videojs/react 和 @videojs/html 发布;npm 上的 video.js 包目前仍是 v8。
  • 🆓 仍为 Apache 2.0 免费开源;作者邀请用户试用、迁移并反馈体验。

ink-v8

Ink v8.0.0 发布:这是一次包含破坏性变更、新 API 和大量渲染、文本、输入、焦点及可访问性修复的重大更新,要求 React 19.3+。

  • 🚀 v8.0.0 由 sindresorhus 于 10 月 3 日发布,包含 Breaking、New 和 Fixes。
  • ⚛️ 破坏性变更:要求 React 19.3+。
  • 📏 <Box> 的 minWidth 和 maxWidth 现在只接受数字,不再支持百分比字符串。
  • 🔌 stdin、stdout、stderr 改为泛型 Node.js 流类型,stdout.columns 等 TTY 属性不再包含在类型中。
  • ⌨️ useInput 不再接收未识别的终端控制序列,例如鼠标报告、焦点事件、光标位置报告等。
  • 🆕 <Box> 新增 contentOffsetX 和 contentOffsetY,配合 overflow="hidden" 可构建可滚动视图。
  • 📐 useBoxMetrics() 和 measureElement() 新增 clientWidth、clientHeight,表示不含边框的内容尺寸。
  • 🌊 render() 的 stdin、stdout、stderr 可接受任意 Node.js 流,如 PassThrough、Readable、Writable。
  • ⚡ incrementalRendering 模式会跳过未变化行前缀,只写入变化部分,减少输出和闪烁。
  • 🔗 React DevTools 移除 ws 依赖,改用原生 WebSocket。
  • ↩️ 应用键盘区 Enter 现在可识别为 key.return。
  • 🖥️ 渲染修复:保留滚动回看、清屏后恢复帧、终端行数缩小时保留内容、恢复光标位置等。
  • 🧱 <Static> 修复:停止全清帧重放、恢复备用屏幕时重放、隐藏祖先输出、空白行、并发渲染等问题。
  • 📝 文本修复:多行文本逐行截断、自然宽度、控制字符清理、Tab/CRLF、ANSI 样式跨换行、组合字符、宽字符裁剪。
  • ⌨️ 输入修复:旧式键盘修饰键、SS3、Kitty 键盘解析、Ctrl+C 与普通输入同时到达、Meta 键解析、终端挂起时副作用。
  • 🎯 焦点修复:共享焦点 ID 视为一个 Tab 停靠点、disableFocus() 按文档模糊、自动焦点 ID 防冲突、空字符串可作焦点 ID。
  • ♿ 其他修复:屏幕阅读器输出、错误展示、renderToString()、useWindowSize()、动画暂停重置、文本缓存、Yoga 节点释放。
  • 🧭 迁移指南:升级 React 19.3+;宽高用数字计算;TTY 属性改用 useWindowSize();useInput 不再解析终端控制序列。

设计

其他

你如何应对那些强烈反对你观点的人?

有效沟通与理性讨论的关键在于:先理解对方,再通过提问厘清立场,寻找共识,并以可信度和恰当表达推进对话;同时用故事增强共鸣,坚决避免人身攻击。

  • 👂 先真诚倾听并确认理解:复述对方观点,转身面对他们,交谈时不看屏幕。
  • ❓ 多问真问题而非挑战:用提问厘清对方真正想法,暴露未经思考的立场,建立讨论基础。
  • 🤝 聚焦共同点:分歧常比想象中小,先建立广泛一致可避免冲突。
  • 📊 先建立可信度再表达观点:引用事实、数据、资料,事前做研究和反思,不空谈。
  • 🗣️ 使用适合议题的语言:学习并运用专业术语,同时解释清楚以保持易懂。
  • 📖 用故事说明:情感与理性同样重要,故事应真实并有硬证据支持。
  • 🛡️ 避免并不容忍人身攻击:若被冒犯,可指出感受、要求道歉,攻击“侮辱行为”而非回骂。

可持续的 Web 职业,等这一切都过去之后

网络行业正经历非理性低谷,财务与职业前景承压,但人们仍需要网络。作者建议不要在没有后路时辞掉有薪工作,并认为应回归基础、修炼稀缺技能,等行业回暖时占据有利位置。

  • 📉 网络行业陷入阶段性困境,长期职业前景不稳,但网络需求本身并未消失。
  • 🍺 不要在没有备用方案时辞职;先熬过这轮风波,等待情况好转。
  • ♿ 无障碍是可持续职业重点:从第一天融入决策,学习指南,与真实用户测试,并尊重专家意见。
  • 🎨 深入学习 CSS:掌握层叠层、低特异性选择器等,别依赖 CSS-in-JS 等限制性抽象。
  • 🗣️ 沟通是稀缺软技能:简洁表达、敢于提问、提前处理顾虑、不指责,保持积极。
  • ✊ 拒绝法西斯主义:科技界极右与仇恨抬头,不要沉默,警惕否认威胁的人。
  • ⚛️ 不再值得投入 React:遗留框架、代码生成快于阅读、高薪岗位将减少。
  • 🔒 GitHub 已成负担:私有仓库用自托管 git forge(如 Forgejo),CI/CD 本地化或选独立服务,并学基础 git。
  • 📵 不要被影响者叙事主导:他们推销新奇事物,普通用户仍在使用网络,注意力经济不再重要。
  • 🧭 结论:网络是为人服务的创造;丢掉繁荣期积累的负担,回归基础,为需求回归做好准备。

TBM 436:基于张力的优先级排序(一种非框架)

John Cutler 在《TBM 436: Tension-Based Prioritization (A Non-Framework)》中主张:团队不该只沉迷于“要优先做哪些事项”和更精细的框架/表格,而应关注反复出现的张力。真正困难通常不在判断什么是重要的,而在执行层面:为什么大家明知该停止、该投入、该重置,却缺乏承诺、政治意愿和组织条件去行动。文章提出用“张力”作为信号,并给出填空练习,帮助团队先暴露真实取舍,再套用任何优先级框架。

  • 🎯 优先级排序分为两部分:优先判断(什么值得投入)与优先执行(实际如何让资源与行动对齐)。
  • 🧭 多数优先级讨论只是在制造可接受的叙事,避免困难对话,很少产生真正承诺。
  • 🔁 回顾时人们很少谈框架,更多谈为何缺乏停止的勇气、为何惯性获胜、为何集体合理化。
  • 🚫 团队通常不缺更多选项或表格,而是缺面对眼前不对称问题和应修复事项的意愿。
  • ⚖️ 真正缺失的不是信念,而是在当下不便中仍愿意承诺。
  • 🌫️ 对远期存在性威胁,大家往往同意却无法动员,因为威胁抽象、无明确负责人、跨团队且行动难想象。
  • 🎉 对有趣、有意义、显性价值的优先事项容易习惯性说“是”,可能过度投入并挤占更重要但更难受的事。
  • 🧩 常见张力模式包括:默认同意、需要大重置、永远差一点完成、反复回旋、早期培育、能力缺口、80/20 缩范围、真假紧迫窗口、间接价值与公地危机。
  • 🧲 这些张力彼此对立,不能同时全做;更像管理风险组合:知道哪些张力要维持、释放或正视。
  • 🧠 真正问题常在“已经知道该做什么”之后:如何创造组织条件去行动,而非再算一遍价值、风险与成本。
  • 📝 练习方法是让团队填空,暴露反复回避的张力与潜在决策,再使用任何优先级框架。
  • ✅ 目标不是更数学化地理性排序,而是用张力信号形成跨时间、价值与紧迫性的平衡下注组合。