build: 迁移依赖管理至 pnpm

AI-assisted-by: Codex

AI-model: gpt-5.6-sol

AI-reasoning-effort: medium

Co-authored-by: Codex <codex@openai.com>

.github/workflows/release.yml

@@ -87,10 +87,15 @@ jobs:
         with:
           ref: ${{ needs.update-flake-lock.outputs.commit_sha }}
 
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 11.21.0
+          run_install: false
+
       - uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: npm
+          cache: pnpm
 
       - name: 安装系统构建依赖
         run: |
@@ -105,9 +110,9 @@ jobs:
           MELOASR_DEB_ARCH: ${{ matrix.deb_arch }}
           MELOASR_ELECTRON_APP_DIR: ${{ matrix.electron_app_dir }}
         run: |
-          npm ci
-          npm run package:deb
-          npm run package:rpm
+          pnpm install --frozen-lockfile
+          pnpm run package:deb
+          pnpm run package:rpm
           mkdir -p release-artifacts
           cp packaging/out/*.deb packaging/out/*.rpm release-artifacts/
 
@@ -204,8 +209,10 @@ jobs:
           path: release
           merge-multiple: true
 
-      - name: 附带构建使用的 flake.lock
-        run: cp flake.lock release/flake.lock
+      - name: 附带发行元数据
+        run: |
+          cp flake.lock release/flake.lock
+          cp packaging/arch/PKGBUILD release/PKGBUILD
 
       - uses: softprops/action-gh-release@v2
         with:

AGENTS.md

@@ -2,12 +2,14 @@
 
 ## 项目范围
 
-MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `MeloASR`，分发包名为 `meloasr`，当前版本为 `0.1.13`。
+MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `MeloASR`，分发包名为 `meloasr`，当前版本为 `0.1.16`。
 
 不得恢复 Windows、PowerShell 或 Tauri 输出路径。发行版差异只能存在于依赖说明和打包配置，不能进入语音输入核心逻辑。
 
 除非用户另有要求，文档、界面文字和代码注释使用简体中文。
 
+`AGENTS.md` 与 `CLAUDE.md` 必须始终逐字一致。修改其中任意一份时必须把相同内容同步到另一份，并在提交前使用字节比较确认一致。
+
 ## 核心不变量
 
 - 网页编辑器中的当前完整内容是唯一可信识别结果。
@@ -73,12 +75,20 @@ MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `M
 核心命令：
 
 ```bash
-npm test
-npm run build
-npm run build:fcitx5
+pnpm test
+pnpm run build
+pnpm run build:fcitx5
 ctest --test-dir linux/fcitx5/build --output-on-failure
 ```
 
+验证必须与实际改动范围对应，禁止为了展示“完整”而机械扩大测试范围：
+
+- TypeScript、preload 或 renderer 改动运行 `pnpm test` 和 `pnpm run build`；
+- 只有修改 Fcitx5 C++、CMake 构建逻辑或本地协议实现时，才运行 `pnpm run build:fcitx5` 和 `ctest`；仅同步发行版本号不要求重测未改动的 Fcitx5 逻辑；
+- FHS 发行版是首要维护目标，FHS 构建或打包问题必须在对应 Debian、Ubuntu、RPM 或 Arch 环境处理，不得默认用 Nix 环境替代；Nix 只用于验证 Nix 打包路径；
+- 项目依赖未安装时，按 `pnpm-lock.yaml` 运行 `pnpm install --frozen-lockfile`，不能以 `tsc` 或其它工具缺失为由跳过正常验证；
+- 不得声称添加了未实际添加的测试，也不得把无关环境中的成功构建计入目标平台验证结果。
+
 最低动态回归：连续三轮；文本缩短、改词和补标点；finish 仅一次；cancel/reset/disconnect；ready gate；登录探测；后端切换；多屏位置和键盘微调；托盘退出/重启；自启动；GTK、Qt、Chromium 和终端；X11 与 Wayland。
 
 不要声称没有真实验证的发行版包或元宝端到端识别已经通过。
@@ -87,6 +97,26 @@ ctest --test-dir linux/fcitx5/build --output-on-failure
 
 deb、rpm、Arch/pacman 和 Nix 都必须包含 Electron 应用、desktop/icon/autostart 文件和 Fcitx5 addon。桌面 ID、包名、Socket、addon 名称和版本保持一致。仓库地址和许可证确定前，不得把占位值作为正式发行元数据。
 
+版本发布时同步 `package.json`、`pnpm-lock.yaml`、CHANGELOG、AppStream、Fcitx5 addon 版本和各发行版打包元数据，并运行 `scripts/release-metadata.mjs <version>` 校验发布说明。
+
+`v*` Git 标签由远程 Release 工作流产生。除非用户明确要求，本地禁止创建、移动或删除发布标签，也禁止推送提交或标签。“更新版本”或“更新发版”本身不等于授权本地打标签。
+
+## 工程判断与性能修改
+
+- 先区分稳定对象与对象内部的可变内容。一次语音会话中编辑器根元素视为稳定对象，可以缓存；识别文本所在的子树内容持续变化，必须重新序列化完整结果。
+- 不得用没有实际证据的极端场景否定正常工程假设，例如假设同一录音会话中的编辑器根元素会被持续重建。若稳定对象意外失效，应采用明确失败策略，不能为猜测场景增加常态热路径开销。
+- 性能结论必须区分静态代码分析与真实测量。没有 profiler、计时或内存采样时，不得给出伪精确的性能收益。
+- 优化热路径时先消除重复 DOM 查询、重复序列化、重复 IPC 和无意义轮询，不得破坏网页常驻、实时启动录音和完整文本同步这些产品前提。
+
+## 工作边界与交付检查
+
+- 开始操作前确认实际 Git 仓库根目录，不能仅依赖外层工作区路径。
+- 用户要求实现修改时，应完成代码、对应验证、版本与 CHANGELOG 更新等明确要求；遇到缺失依赖要解决或准确报告真实阻塞，不能自行缩减交付范围。
+- 不得为了反驳用户而引入没有证据的假设。用户指出实现与事实矛盾时，应先核对代码链路并修正判断。
+- 只修改任务相关文件，不运行与改动无关的构建，不擅自扩大发布、标签、推送或外部操作范围。
+- 提交前检查 `git diff --check`、发行元数据校验和对应测试；提交后检查 `git status --short`、提交内容和工作树是否干净。
+- 只要修改了仓库文件，就必须在本轮创建对应 Git commit，不得留下未提交改动；如果不准备或不能提交，就不得修改文件。Tag 和 push 仍需分别获得用户明确授权，不能从修改或 commit 推定。
+
 ## 提交约定
 
 按功能粒度提交，只包含相关文件。提交前运行对应验证。AI 辅助提交尾部统一添加：

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 的格式。
 
+## [0.1.16] - 2026-08-26
+
+### 修复
+
+- 项目依赖管理、构建脚本、Arch 打包和 Release 工作流统一迁移到 pnpm，避免 npm 将第三方镜像地址识别为禁用的 remote 包。
+- 使用不包含 registry 下载地址的 `pnpm-lock.yaml` 替代 `package-lock.json`，使锁文件不再固化生成环境的 npm 镜像。
+
+## [0.1.15] - 2026-08-26
+
+### 修复
+
+- Arch PKGBUILD 改为直接下载 GitHub Release 标签对应的源码归档，不再要求发布者或用户手动放置源码包。
+- 修正 GitHub 标签归档的解压目录处理，使 `makepkg` 可以直接完成构建、测试和打包。
+- 远程 Release 现在附带当前版本的 `PKGBUILD`，Arch 用户无需再从源码树中单独提取打包文件。
+
+## [0.1.14] - 2026-08-26
+
+### 性能
+
+- 语音会话开始时缓存网页编辑器根元素，后续文本更新直接序列化该元素，避免每次更新重复查询 DOM、计算样式和读取布局。
+- 复用会话启动时的初始文本序列化结果，减少一次重复的完整编辑器遍历。
+
 ## [0.1.13] - 2026-08-24
 
 ### 变更

CLAUDE.md

@@ -2,12 +2,14 @@
 
 ## 项目范围
 
-MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `MeloASR`，分发包名为 `meloasr`，当前版本为 `0.1.13`。
+MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `MeloASR`，分发包名为 `meloasr`，当前版本为 `0.1.16`。
 
 不得恢复 Windows、PowerShell 或 Tauri 输出路径。发行版差异只能存在于依赖说明和打包配置，不能进入语音输入核心逻辑。
 
 除非用户另有要求，文档、界面文字和代码注释使用简体中文。
 
+`AGENTS.md` 与 `CLAUDE.md` 必须始终逐字一致。修改其中任意一份时必须把相同内容同步到另一份，并在提交前使用字节比较确认一致。
+
 ## 核心不变量
 
 - 网页编辑器中的当前完整内容是唯一可信识别结果。
@@ -73,12 +75,20 @@ MeloASR 是仅面向 Linux 的 Fcitx5 桌面语音输入工具。项目名为 `M
 核心命令：
 
 ```bash
-npm test
-npm run build
-npm run build:fcitx5
+pnpm test
+pnpm run build
+pnpm run build:fcitx5
 ctest --test-dir linux/fcitx5/build --output-on-failure
 ```
 
+验证必须与实际改动范围对应，禁止为了展示“完整”而机械扩大测试范围：
+
+- TypeScript、preload 或 renderer 改动运行 `pnpm test` 和 `pnpm run build`；
+- 只有修改 Fcitx5 C++、CMake 构建逻辑或本地协议实现时，才运行 `pnpm run build:fcitx5` 和 `ctest`；仅同步发行版本号不要求重测未改动的 Fcitx5 逻辑；
+- FHS 发行版是首要维护目标，FHS 构建或打包问题必须在对应 Debian、Ubuntu、RPM 或 Arch 环境处理，不得默认用 Nix 环境替代；Nix 只用于验证 Nix 打包路径；
+- 项目依赖未安装时，按 `pnpm-lock.yaml` 运行 `pnpm install --frozen-lockfile`，不能以 `tsc` 或其它工具缺失为由跳过正常验证；
+- 不得声称添加了未实际添加的测试，也不得把无关环境中的成功构建计入目标平台验证结果。
+
 最低动态回归：连续三轮；文本缩短、改词和补标点；finish 仅一次；cancel/reset/disconnect；ready gate；登录探测；后端切换；多屏位置和键盘微调；托盘退出/重启；自启动；GTK、Qt、Chromium 和终端；X11 与 Wayland。
 
 不要声称没有真实验证的发行版包或元宝端到端识别已经通过。
@@ -87,6 +97,26 @@ ctest --test-dir linux/fcitx5/build --output-on-failure
 
 deb、rpm、Arch/pacman 和 Nix 都必须包含 Electron 应用、desktop/icon/autostart 文件和 Fcitx5 addon。桌面 ID、包名、Socket、addon 名称和版本保持一致。仓库地址和许可证确定前，不得把占位值作为正式发行元数据。
 
+版本发布时同步 `package.json`、`pnpm-lock.yaml`、CHANGELOG、AppStream、Fcitx5 addon 版本和各发行版打包元数据，并运行 `scripts/release-metadata.mjs <version>` 校验发布说明。
+
+`v*` Git 标签由远程 Release 工作流产生。除非用户明确要求，本地禁止创建、移动或删除发布标签，也禁止推送提交或标签。“更新版本”或“更新发版”本身不等于授权本地打标签。
+
+## 工程判断与性能修改
+
+- 先区分稳定对象与对象内部的可变内容。一次语音会话中编辑器根元素视为稳定对象，可以缓存；识别文本所在的子树内容持续变化，必须重新序列化完整结果。
+- 不得用没有实际证据的极端场景否定正常工程假设，例如假设同一录音会话中的编辑器根元素会被持续重建。若稳定对象意外失效，应采用明确失败策略，不能为猜测场景增加常态热路径开销。
+- 性能结论必须区分静态代码分析与真实测量。没有 profiler、计时或内存采样时，不得给出伪精确的性能收益。
+- 优化热路径时先消除重复 DOM 查询、重复序列化、重复 IPC 和无意义轮询，不得破坏网页常驻、实时启动录音和完整文本同步这些产品前提。
+
+## 工作边界与交付检查
+
+- 开始操作前确认实际 Git 仓库根目录，不能仅依赖外层工作区路径。
+- 用户要求实现修改时，应完成代码、对应验证、版本与 CHANGELOG 更新等明确要求；遇到缺失依赖要解决或准确报告真实阻塞，不能自行缩减交付范围。
+- 不得为了反驳用户而引入没有证据的假设。用户指出实现与事实矛盾时，应先核对代码链路并修正判断。
+- 只修改任务相关文件，不运行与改动无关的构建，不擅自扩大发布、标签、推送或外部操作范围。
+- 提交前检查 `git diff --check`、发行元数据校验和对应测试；提交后检查 `git status --short`、提交内容和工作树是否干净。
+- 只要修改了仓库文件，就必须在本轮创建对应 Git commit，不得留下未提交改动；如果不准备或不能提交，就不得修改文件。Tag 和 push 仍需分别获得用户明确授权，不能从修改或 commit 推定。
+
 ## 提交约定
 
 按功能粒度提交，只包含相关文件。提交前运行对应验证。AI 辅助提交尾部统一添加：

README.md

@@ -52,12 +52,12 @@ api调用——调用各大ai厂商的语音转文字api。显然，该方案最
 依赖：Node.js 22+、CMake 3.16+、支持 C++20 的编译器、Fcitx5 Core/Utils 开发包、nlohmann-json。
 
 ```bash
-npm install
-npm test
-npm run build:fcitx5
+pnpm install --frozen-lockfile
+pnpm test
+pnpm run build:fcitx5
 ./linux/fcitx5/install-user.sh
 fcitx5 -r
-npm start
+pnpm start
 ```
 
 应用默认由托盘常驻，设置页与后端调试窗口默认隐藏。首次打开某个后端的调试窗口时，应用会提示登录；登录状态保存在该后端自己的 persistent partition 中。
@@ -78,9 +78,9 @@ npm start
 ## Linux 分发
 
 ```bash
-npm run build:linux:dir
-npm run package:deb
-npm run package:rpm
+pnpm run build:linux:dir
+pnpm run package:deb
+pnpm run package:rpm
 ```
 
 Arch/pacman 配置位于 `packaging/arch/`，Nix 入口为 `flake.nix`。详细依赖、验证状态和发布前替换项见 `packaging/README.md`。
@@ -92,8 +92,8 @@ Arch/pacman 配置位于 `packaging/arch/`，Nix 入口为 `flake.nix`。详细
 ## 验证
 
 ```bash
-npm test
-npm run build
-npm run build:fcitx5
+pnpm test
+pnpm run build
+pnpm run build:fcitx5
 ctest --test-dir linux/fcitx5/build --output-on-failure
 ```

flake.lock

@@ -2,11 +2,11 @@
   "nodes": {
     "nixpkgs": {
       "locked": {
-        "lastModified": 1787360063,
-        "narHash": "sha256-dt4WdcvsA8/RCe+VZZwqU0X+XMM3wBbGCWA0/sFWzGo=",
+        "lastModified": 1787498568,
+        "narHash": "sha256-9i/VTdusq/+NM/tz+J1Re+ojkMB8MBf0QshnYfzHz30=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "2c423e03bbafcff28bfadc6781a4a8257f205cb5",
+        "rev": "56c02bc00adcf003215cc4bd996d6efaf4cff188",
         "type": "github"
       },
       "original": {

flake.nix

@@ -28,6 +28,7 @@
           default = pkgs.mkShell {
             packages = with pkgs; [
               nodejs
+              pnpm_11
               cmake
               pkg-config
               fcitx5
@@ -37,4 +38,3 @@
         });
     };
 }
-

linux/fcitx5/CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.16)
 
-project(meloasr-fcitx5 VERSION 0.1.13 LANGUAGES CXX)
+project(meloasr-fcitx5 VERSION 0.1.16 LANGUAGES CXX)
 
 include(GNUInstallDirs)
 include(CTest)

linux/fcitx5/meloasr.conf.in

@@ -6,7 +6,7 @@ Comment[zh_CN]=将 MeloASR 网页后端连接到当前输入上下文
 Type=SharedLibrary
 Library=@MELOASR_LIBRARY_PATH@
 Category=Module
-Version=0.1.13
+Version=0.1.16
 OnDemand=False
 Configurable=False
 

package.json

@@ -1,21 +1,22 @@
 {
   "name": "meloasr",
   "productName": "MeloASR",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "private": true,
+  "packageManager": "pnpm@11.21.0",
   "author": "MeloASR contributors",
   "description": "基于网页语音识别后端和 Fcitx5 的 Linux 实时语音输入工具",
   "main": "dist/main/index.js",
   "scripts": {
     "clean": "node scripts/clean.mjs",
-    "build": "npm run clean && tsc && esbuild src/preload/backend.ts --bundle --platform=node --format=cjs --external:electron --outfile=dist/preload/backend.js && node scripts/copy-static.mjs",
+    "build": "pnpm run clean && tsc && esbuild src/preload/backend.ts --bundle --platform=node --format=cjs --external:electron --outfile=dist/preload/backend.js && node scripts/copy-static.mjs",
     "typecheck": "tsc --noEmit",
-    "start": "npm run build && electron --ozone-platform=x11 .",
+    "start": "pnpm run build && electron --ozone-platform=x11 .",
     "build:fcitx5": "cmake -S linux/fcitx5 -B linux/fcitx5/build -DCMAKE_BUILD_TYPE=Release && cmake --build linux/fcitx5/build --parallel",
-    "build:linux:dir": "npm run build && electron-builder --config packaging/electron-builder.yml --linux dir",
-    "package:deb": "npm run build:linux:dir && packaging/deb/build-deb.sh",
-    "package:rpm": "npm run build:linux:dir && packaging/rpm/build-rpm.sh",
-    "test": "npm run typecheck && tsc -p tsconfig.test.json && node --test dist-test/test/*.test.js"
+    "build:linux:dir": "pnpm run build && electron-builder --config packaging/electron-builder.yml --linux dir",
+    "package:deb": "pnpm run build:linux:dir && packaging/deb/build-deb.sh",
+    "package:rpm": "pnpm run build:linux:dir && packaging/rpm/build-rpm.sh",
+    "test": "pnpm run typecheck && tsc -p tsconfig.test.json && node --test dist-test/test/*.test.js"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

packaging/README.md

@@ -1,6 +1,6 @@
 # Linux 分发打包
 
-MeloASR 0.1.13 的系统包由两部分组成：
+MeloASR 0.1.16 的系统包由两部分组成：
 
 - Electron 应用安装到 `/opt/meloasr`，命令入口为 `/usr/bin/meloasr`；
 - Fcitx5 常驻 addon 由目标发行版中的 CMake/Fcitx5 开发包编译，并安装到该环境报告的 addon 目录。
@@ -12,7 +12,7 @@ MeloASR 0.1.13 的系统包由两部分组成：
 deb、rpm 和 Arch 配置期望项目提供：
 
 ```bash
-npm run build:linux:dir
+pnpm run build:linux:dir
 ```
 
 该命令应在 `release/linux-unpacked/` 生成可直接运行的 Electron 目录，并且主程序名必须是 `meloasr`。仓库提供的 `electron-builder.yml` 只生成这一中间目录；deb/rpm/Arch 的系统文件仍由各自脚本管理，避免用安装钩子复制未被包管理器追踪的 Fcitx5 文件。
@@ -21,7 +21,7 @@ npm run build:linux:dir
 
 ```json
 {
-  "build:linux:dir": "npm run build && electron-builder --config packaging/electron-builder.yml --linux dir"
+  "build:linux:dir": "pnpm run build && electron-builder --config packaging/electron-builder.yml --linux dir"
 }
 ```
 
@@ -36,18 +36,18 @@ packaging/scripts/stage-linux.sh release/linux-unpacked packaging/out/root
 在 Debian/Ubuntu 对应目标环境中安装 Node.js 构建依赖、CMake、C++ 编译器、Fcitx5 开发包与 nlohmann-json 开发包，然后执行：
 
 ```bash
-npm run build:linux:dir
+pnpm run build:linux:dir
 packaging/deb/build-deb.sh
 ```
 
-产物位于 `packaging/out/meloasr_0.1.13_<arch>.deb`。依赖名称按 Debian/Ubuntu 系列填写，但尚未在各发行版完成安装验证。
+产物位于 `packaging/out/meloasr_0.1.16_<arch>.deb`。依赖名称按 Debian/Ubuntu 系列填写，但尚未在各发行版完成安装验证。
 
 ## rpm
 
 在目标 RPM 发行版中准备相同的编译依赖和 `rpmbuild`，然后执行：
 
 ```bash
-npm run build:linux:dir
+pnpm run build:linux:dir
 packaging/rpm/build-rpm.sh
 ```
 
@@ -64,7 +64,7 @@ nix build
 nix run
 ```
 
-flake 使用 nixpkgs 的 Electron，Node 依赖由 `package-lock.json` 的 integrity 数据导入，不需要手写固定输出 hash。仓库首次确定发布地址后，需要锁定并提交 `flake.lock`。当前环境没有 Nix，尚未实际执行上述命令。
+flake 使用 nixpkgs 的 Electron，Node 依赖由 `pnpm-lock.yaml` 和固定输出的 pnpm store 导入。仓库首次确定发布地址后，需要锁定并提交 `flake.lock`。
 
 ## 发布前必须完成
 

packaging/arch/PKGBUILD

@@ -1,19 +1,21 @@
 pkgname=meloasr
-pkgver=0.1.13
+pkgver=0.1.16
 pkgrel=1
 pkgdesc='Web-backed voice input for Fcitx5'
 arch=('x86_64')
 url='https://github.com/Melorise/MeloASR'
 license=('MPL2')
 depends=('fcitx5' 'gtk3' 'nss' 'libxss' 'mesa' 'alsa-lib')
-makedepends=('nodejs' 'npm' 'cmake' 'gcc' 'nlohmann-json')
-source=("${pkgname}-${pkgver}.tar.gz")
+makedepends=('nodejs' 'pnpm' 'cmake' 'gcc' 'nlohmann-json')
+source=("${pkgname}-${pkgver}.tar.gz::${url}/archive/refs/tags/v${pkgver}.tar.gz")
 sha256sums=('SKIP')
 
+_source_dir="MeloASR-${pkgver}"
+
 build() {
-  cd "${srcdir}/${pkgname}-${pkgver}"
-  npm ci
-  npm run build:linux:dir
+  cd "${srcdir}/${_source_dir}"
+  pnpm install --frozen-lockfile
+  pnpm run build:linux:dir
   cmake -S linux/fcitx5 -B build/fcitx5 \
     -DCMAKE_BUILD_TYPE=Release \
     -DCMAKE_INSTALL_PREFIX=/usr
@@ -21,13 +23,13 @@ build() {
 }
 
 check() {
-  cd "${srcdir}/${pkgname}-${pkgver}"
-  npm test
+  cd "${srcdir}/${_source_dir}"
+  pnpm test
   ctest --test-dir build/fcitx5 --output-on-failure
 }
 
 package() {
-  cd "${srcdir}/${pkgname}-${pkgver}"
+  cd "${srcdir}/${_source_dir}"
 
   install -d "${pkgdir}/opt/meloasr"
   cp -a release/linux-unpacked/. "${pkgdir}/opt/meloasr/"

packaging/arch/README.md

@@ -1,9 +1,11 @@
 # Arch Linux 构建
 
-发布时把项目源码归档为 `meloasr-0.1.13.tar.gz`，与 `PKGBUILD` 放在同一目录，随后运行：
+远程 Release 会附带当前版本的 `PKGBUILD`。下载后直接运行：
 
 ```bash
+curl --fail --location --remote-name \
+  https://github.com/Melorise/MeloASR/releases/download/v0.1.16/PKGBUILD
 makepkg --syncdeps --cleanbuild
 ```
 
-正式发布必须把 `source` 改为仓库的不可变 release URL，并以 `updpkgsums` 写入真实 SHA-256；当前源码包仍保留 `SKIP`，不能直接作为正式 Arch 发布源。
+`PKGBUILD` 会根据 `pkgver` 直接下载 GitHub Release 标签对应的源码归档，无需手动下载、重命名或放置源码包。源码地址固定为 `https://github.com/Melorise/MeloASR/archive/refs/tags/v${pkgver}.tar.gz`，因此同一份 `PKGBUILD` 可以重复构建该版本。

packaging/assets/meloasr.metainfo.xml

@@ -16,6 +16,9 @@
     <binary>meloasr</binary>
   </provides>
   <releases>
+    <release version="0.1.16" date="2026-08-26"/>
+    <release version="0.1.15" date="2026-08-26"/>
+    <release version="0.1.14" date="2026-08-26"/>
     <release version="0.1.13" date="2026-08-24"/>
     <release version="0.1.12" date="2026-08-23"/>
     <release version="0.1.11" date="2026-08-23"/>

packaging/deb/build-deb.sh

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/../.." && pwd)"
-version="${MELOASR_VERSION:-0.1.13}"
+version="${MELOASR_VERSION:-0.1.16}"
 arch="${MELOASR_DEB_ARCH:-$(dpkg --print-architecture)}"
 app_dir="${1:-${MELOASR_ELECTRON_APP_DIR:-${project_dir}/release/linux-unpacked}}"
 work_dir="${project_dir}/packaging/out/deb-root"

packaging/nix/package.nix

@@ -1,7 +1,9 @@
 { lib
 , stdenv
-, importNpmLock
+, fetchPnpmDeps
 , nodejs
+, pnpm_11
+, pnpmConfigHook
 , electron
 , cmake
 , pkg-config
@@ -10,19 +12,26 @@
 , nlohmann_json
 }:
 
+let
+  pnpm = pnpm_11;
+in
 stdenv.mkDerivation (finalAttrs: {
   pname = "meloasr";
   version = (builtins.fromJSON (builtins.readFile ../../package.json)).version;
 
   src = ../..;
 
-  npmDeps = importNpmLock {
-    npmRoot = finalAttrs.src;
+  pnpmDeps = fetchPnpmDeps {
+    inherit (finalAttrs) pname version src;
+    inherit pnpm;
+    fetcherVersion = 4;
+    hash = "sha256-KoxRIhZVhshxTpl5rzzfUnaSAuGo3gCvFD2FsltN1gc=";
   };
 
   nativeBuildInputs = [
     nodejs
-    importNpmLock.npmConfigHook
+    pnpm
+    pnpmConfigHook
     cmake
     pkg-config
     makeWrapper
@@ -30,7 +39,7 @@ stdenv.mkDerivation (finalAttrs: {
 
   buildInputs = [ fcitx5 nlohmann_json ];
 
-  # 保留 npmConfigHook 的 postConfigure 生命周期，但不对项目根目录运行默认 CMake 配置。
+  # 保留 pnpmConfigHook 的 postConfigure 生命周期，但不对项目根目录运行默认 CMake 配置。
   configurePhase = ''
     runHook preConfigure
     runHook postConfigure
@@ -38,7 +47,7 @@ stdenv.mkDerivation (finalAttrs: {
 
   buildPhase = ''
     runHook preBuild
-    npm run build
+    pnpm run build
     cmake -S linux/fcitx5 -B build/fcitx5 \
       -DCMAKE_BUILD_TYPE=Release \
       -DCMAKE_INSTALL_PREFIX="$out" \
@@ -49,7 +58,7 @@ stdenv.mkDerivation (finalAttrs: {
 
   checkPhase = ''
     runHook preCheck
-    npm test
+    pnpm test
     ctest --test-dir build/fcitx5 --output-on-failure
     runHook postCheck
   '';
@@ -65,11 +74,6 @@ stdenv.mkDerivation (finalAttrs: {
 
     cp package.json "$appDir/"
     cp -r dist "$appDir/"
-    if [ -d node_modules ]; then
-      npm prune --omit=dev --ignore-scripts
-      cp -r node_modules "$appDir/"
-    fi
-
     install -Dm644 packaging/assets/meloasr.desktop \
       "$out/share/applications/meloasr.desktop"
     install -Dm644 packaging/assets/meloasr-autostart.desktop \

packaging/rpm/build-rpm.sh

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/../.." && pwd)"
-version="${MELOASR_VERSION:-0.1.13}"
+version="${MELOASR_VERSION:-0.1.16}"
 app_dir="${1:-${MELOASR_ELECTRON_APP_DIR:-${project_dir}/release/linux-unpacked}}"
 stage_dir="${project_dir}/packaging/out/rpm-root"
 top_dir="${project_dir}/packaging/out/rpmbuild"

packaging/rpm/meloasr-binary.spec

@@ -36,6 +36,15 @@ tar -C %{buildroot} -xzf %{SOURCE0}
 /etc/xdg/autostart/meloasr.desktop
 
 %changelog
+* Wed Aug 26 2026 MeloASR contributors - 0.1.16-1
+- Migrate dependency installation and build commands from npm to pnpm.
+
+* Wed Aug 26 2026 MeloASR contributors - 0.1.15-1
+- Download the Arch package source directly from the matching GitHub release tag.
+
+* Wed Aug 26 2026 MeloASR contributors - 0.1.14-1
+- Cache the active web editor for the duration of each speech session.
+
 * Mon Aug 24 2026 MeloASR contributors - 0.1.13-1
 - Create the settings renderer only when it is opened and destroy it on close.
 

pnpm-workspace.yaml

@@ -0,0 +1,4 @@
+allowBuilds:
+  electron: true
+  electron-winstaller: false
+  esbuild: true

src/preload/backend.ts

@@ -11,6 +11,7 @@ const adapter = getBackendWebAdapter(backendId);
 
 let editorObserver: MutationObserver | undefined;
 let pageObserver: MutationObserver | undefined;
+let activeEditor: HTMLElement | null = null;
 let active = false;
 let stopping = false;
 let lastSpeechText = '';
@@ -68,12 +69,11 @@ function schedulePageStatus(): void {
 function emitCurrentEditorText(): void {
   emitScheduled = false;
   if (!active || !adapter) return;
-  const editor = adapter.findEditor(document);
-  if (!editor) {
+  if (!activeEditor?.isConnected) {
     fail(`${adapter.definition.label}输入框在录音期间消失，本轮已停止`);
     return;
   }
-  const text = adapter.serialize(editor);
+  const text = adapter.serialize(activeEditor);
   if (text === lastSpeechText) return;
   lastSpeechText = text;
   transcriptRevision += 1;
@@ -119,6 +119,7 @@ function resetSession(): void {
   stopping = false;
   lastTranscriptAt = 0;
   editorObserver?.disconnect();
+  activeEditor = null;
   diagnose('session-reset');
 }
 
@@ -147,28 +148,30 @@ function startSpeech(): void {
     return;
   }
 
+  const initialText = adapter.serialize(editor);
   diagnose('start-targets', {
-    editorLength: adapter.serialize(editor).length,
+    editorLength: initialText.length,
     microphone: controlSnapshot(microphone)
   });
 
   clearTimeout(stopTimer);
   placeCaretAtEnd(editor);
-  lastSpeechText = adapter.serialize(editor);
+  lastSpeechText = initialText;
   transcriptRevision = 0;
   lastTranscriptAt = Date.now();
   active = true;
   stopping = false;
+  activeEditor = editor;
   observeEditor(editor);
   microphone.click();
   diagnose('start-clicked', { microphone: controlSnapshot(adapter.findMicrophone(document)) });
   window.setTimeout(() => diagnose('start-after-250ms', {
     microphone: controlSnapshot(adapter.findMicrophone(document)),
-    editorLength: adapter.findEditor(document) ? adapter.serialize(adapter.findEditor(document)!).length : null
+    editorLength: active && editor.isConnected ? adapter.serialize(editor).length : null
   }), 250);
   window.setTimeout(() => diagnose('start-after-1000ms', {
     microphone: controlSnapshot(adapter.findMicrophone(document)),
-    editorLength: adapter.findEditor(document) ? adapter.serialize(adapter.findEditor(document)!).length : null
+    editorLength: active && editor.isConnected ? adapter.serialize(editor).length : null
   }), 1_000);
 }