Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

docs(release): v0.5.4 的发布正文

lmliheng010f1d0b4ea0
diff --git a/changelog/unreleased/2026-10-22-shader-backdrops.md b/changelog/unreleased/2026-10-22-shader-backdrops.md
new file mode 100644
index 00000000..b9c98bb2
--- /dev/null
+++ b/changelog/unreleased/2026-10-22-shader-backdrops.md
@@ -0,0 +1,40 @@
+# A family of GPU backdrops, with a static stand-in in the same colours
+
+- **Date:** 2026-10-22
+- **Type:** feat
+- **Scope:** `ui`, `ui-gallery`
+- **Breaking:** no
+
+[中文版](2026-10-22-shader-backdrops.zh.md)
+
+The component library (`@adelie/ui`) gains a family of backdrops: a **colour field** that drifts on its own
+(two colours moving through oklab under a whisper of noise, with an optional trail behind the pointer) and a
+**dot grid** (one colour, one pitch — engineering paper, still or twinkling). They are built on MIT's
+[`shaders`](https://www.npmjs.com/package/shaders) and drawn with WebGPU.
+
+What matters most about them is not the look but that they **never leave a hole**: the box first asks whether
+this device can draw at all (the WebGPU probe, plus the system's reduce-motion setting), and when it cannot it
+puts the caller's stand-in into the same box — a flat gradient in the same colours, or a row of CSS dots. A
+device that takes the canvas away mid-flight (out of memory, a lost driver) falls back at once. The first frame
+is always the stand-in: the probe is asynchronous, and guessing it would make the page flicker.
+
+Colours are **required props with no default of their own**: a GPU canvas cannot read a CSS custom property, so
+the caller hands in the active theme's values. The gallery gains a "Shaders" topic that drives both blocks from
+the active theme's ground, accent and separator ink, and reports whether the box is drawing a canvas or the
+stand-in right now.
+
+## Details
+
+- `packages/ui/src/components/shaders/`: `shader-support.ts` (the decision table as a pure function, plus a hook
+ that probes only after mount), `shader-surface/shader-surface.tsx` (the box; `<Shader>` only on the GPU branch,
+ and `aria-hidden`), `aurora-backdrop/` (MeshGradient + SimplexNoise + optional CursorTrail),
+ `dot-grid-backdrop/` (DotGrid, still or twinkling).
+- Gallery: the new `shaders` topic (`topics.ts` / `boards.tsx` / `boards/shaders.tsx` / `shader-colors.ts` and
+ both dictionaries).
+- Dependency: `shaders@^4.0.5`, only in `@adelie/ui`; the Web app's release bundle carries none of it (unused, and
+ tree-shaken away).
+
+## Compatibility
+
+- No API, data, config-format or existing-component change: this family is new.
+- **No page uses them yet**; they are available and visible in the gallery first.
diff --git a/changelog/unreleased/2026-10-22-shader-backdrops.zh.md b/changelog/unreleased/2026-10-22-shader-backdrops.zh.md
new file mode 100644
index 00000000..a43b2588
--- /dev/null
+++ b/changelog/unreleased/2026-10-22-shader-backdrops.zh.md
@@ -0,0 +1,33 @@
+# 组件库多了一族 GPU 背景,画不了就画同色的静态替身
+
+- **Date:** 2026-10-22
+- **Type:** feat
+- **Scope:** `ui`, `ui-gallery`
+- **Breaking:** no
+
+[English](2026-10-22-shader-backdrops.md)
+
+组件库(`@adelie/ui`)多了一族背景:一片会自己漂移的**色彩场**(两色在 oklab 里流动,压一层很轻的噪点,
+可选跟着指针的拖尾),和一排**点阵**(一个颜色一个间距的「工程纸」,可以静止也可以微闪)。它们建在 MIT 的
+[`shaders`](https://www.npmjs.com/package/shaders) 上,走 WebGPU 画。
+
+这族东西最要紧的一条不是好看,而是**不会破相**:盒子会先问这一台设备到底画不画得了(WebGPU 探针,加上系统
+的「减少动效」设置),画不了就把调用方给的静态替身放进同一个盒子里 —— 同色的渐变、或一排 CSS 点。设备中途把
+画布收回去(显存不够、驱动掉了),也会立刻切回替身。首帧永远是替身:探针是异步的,猜一次会让页面先闪一下。
+
+颜色是**必填的 props,组件自身没有颜色**:GPU 画布读不到 CSS 变量,所以谁用谁把当前主题的色值传进来。
+画廊里多了一个「着色器」话题,按当前主题的底色、强调色与分隔线色演示这两块,并显示它此刻画的是画布还是
+替身。
+
+## 细节
+
+- `packages/ui/src/components/shaders/`:`shader-support.ts`(决策表写成纯函数 + 挂载后才探针的 hook)、
+ `shader-surface/shader-surface.tsx`(那个盒子,GPU 那条路才渲染 `<Shader>`,并 `aria-hidden`)、
+ `aurora-backdrop/`(MeshGradient + SimplexNoise + 可选 CursorTrail)、`dot-grid-backdrop/`(DotGrid 静止 / 微闪)。
+- 画廊:新话题 `shaders`(`topics.ts` / `boards.tsx` / `boards/shaders.tsx` / `shader-colors.ts` 与两份文案)。
+- 依赖:`shaders@^4.0.5`,只进 `@adelie/ui`;Web 应用的发行产物里不带它(未被引用,树摇掉了)。
+
+## 兼容性
+
+- 没有接口、数据、配置格式或既有组件的变化;这一族是新增的。
+- 目前**还没有任何页面在使用**它们;先在画廊里可用、可看。
diff --git a/docs/releases/RELEASE-v0.5.4.md b/docs/releases/RELEASE-v0.5.4.md
new file mode 100644
index 00000000..2daa0c81
--- /dev/null
+++ b/docs/releases/RELEASE-v0.5.4.md
@@ -0,0 +1,61 @@
+# Adelie v0.5.4 —— 被拒绝的原因继续留在框里,组件库多了一族 GPU 背景
+
+这一版自 v0.5.3 起在 `main` 上落了 **14 笔提交,其中 4 个用户看得见的改动**(其余是每轮的记账与一处测试
+工具的修理)。数据根、配置格式、包名与既有 HTTP 接口都没有变化,装好的机器升级后不用改任何配置。
+
+## 这一版改了什么
+
+1. **插件设置里的操作被拒时,卡片留着、原因也在卡片里。** 插件卡片上的操作(部署必须在这台机器上做一次的
+ 事,比如 Windows 沙盒的「初始化」)执行前要先确认,而那张卡片过去在按下「执行」的那一刻就关掉了。请求
+ 被拒、或分组自己回答「此卡片上还有任务在运行」的时候,机器一点没变,原因却是一条六秒后自己消失、还浮在
+ 卡片上方的提示。现在卡片**拿到答复**才关:被拒就把服务端那句话画在句子下面,重试就是同一个按钮。
+
+2. **批量删除对话被拒时,框和勾选都留着,删了一半也说得清。** 批量删除是逐条发出去的(服务端没有批量
+ 路由),所以它可能只成了一半。过去用的是「一条被拒就丢掉其它行的结果」:列表与服务端已经对不上,而行却
+ 全还勾着,再看一眼分不清哪些已经没了。现在每条的结果都收下来 —— 删掉的行离开列表与勾选,**被拒的行留着
+ 勾**(卡片里的条数正好是「重试会动到的那几条」),框留着并画出服务端原话,整批都删掉才关框。
+
+3. **删除 MCP Server 被拒时,同样留着框与原因。** 智能体设置「工具」页的 MCP Server 表里,删除一行是先
+ 确认再整张表写回去;那张卡片过去在请求返回时就关,不管写没写成功,被拒的原因只剩一条会消失的提示。现在
+ 写成功之后才关,被拒就把原话画在句子下面,重试还是同一个按钮。
+
+4. **组件库多了一族 GPU 背景。** `@adelie/ui` 现在有会自己漂移的**色彩场**(两色在 oklab 里流动、一层很轻
+ 的噪点、可选跟着指针的拖尾)与**点阵**(一色一间距的「工程纸」,静止或微闪),建在 MIT 的 `shaders` 上、
+ 走 WebGPU 画。要紧的不是好看,而是**不会破相**:盒子先问这台设备画不画得了(WebGPU 探针 + 系统的「减少
+ 动效」设置),画不了就把调用方给的静态替身放进同一个盒子(同色的渐变、或一排 CSS 点),设备中途把画布
+ 收回去也立刻切回替身。颜色由调用方传(GPU 画布读不到 CSS 变量),画廊新增的「着色器」话题按当前主题的
+ 色值演示这两块,并显示它此刻画的是画布还是替身。**目前还没有页面在使用它们** —— 先在画廊里可用。
+
+看不见的一处:给工作区包加依赖时,pnpm 会把 `@adelie/ui` 装成 `node_modules` 里的副本,而打包那一步在那里
+找不到它的 tsconfig,退回老式 JSX 编译,于是 Web 与画廊的单测整片报 `React is not defined`。这个问题一直埋
+着,这版把两份测试配置写明用新版 JSX 运行时,两种装法都验过。用户看不见,但它会让以后每次加依赖都不再翻车。
+
+## 升级
+
+**桌面端**在应用内更新:账号菜单的更新入口,或应用菜单里的「检查更新」。Windows 安装包仍未签名,
+SmartScreen 会提示一次(「更多信息 → 仍要运行」)。
+
+**命令行与 Web**:`penguin update`(或重装 `npm install -g @adelie/cli`)。npm 上 24 个包都到了 0.5.4。
+
+## 安装
+
+```bash
+curl -fsSL https://github.com/lmliheng/Adelie/releases/latest/download/install.sh | sh
+```
+
+```powershell
+irm https://github.com/lmliheng/Adelie/releases/latest/download/install.ps1 | iex
+```
+
+也可以只装 CLI:`npm install -g @adelie/cli`(需要 Node.js >= 24)。
+
+## 要求
+
+- Node.js >= 24(单行安装脚本自带运行时,npm 安装需要本机有)。
+- Linux / macOS / Windows 的 x64 与 arm64;其他 POSIX 平台用 `--universal` 安装包。
+- 桌面端:Linux 提供 AppImage 与 deb,Windows 提供 exe;macOS 未签名,这一版不随 Release 发布。
+
+上一版(v0.5.3)把「写入被拒绝的原因」铺到模型库、定时任务、评估中心、插件市场与删除对话,并让桌宠真的
+拖得动;再往前(v0.5.2)加了桌宠、结束的定时任务自己移进 `expired/`、MCP Server 可以停用而不必删除。文档在
+<https://lmliheng.github.io/Adelie/docs/>。变更明细见仓库里的
+[`changelog/unreleased/`](https://github.com/lmliheng/Adelie/tree/main/changelog/unreleased)。