release: prepare WebUtils 2.2.0 (#219)

Author: chicogong

.github/workflows/lint.yml

@@ -80,7 +80,7 @@ jobs:
       - name: Check tools sync
         run: |
           npm run sync:tools
-          if [ -n "$(git diff --name-only -- index.html README.md sitemap.xml manifest.json llms.txt i18n tools)" ]; then
+          if [ -n "$(git diff --name-only -- index.html README.md README.en.md sitemap.xml manifest.json llms.txt i18n tools)" ]; then
             echo "❌ Error: generated sources are out of sync with tools.json"
             echo ""
             echo "Please run locally:"
@@ -89,7 +89,7 @@ jobs:
             echo "  git push --force-with-lease"
             echo ""
             echo "Diff:"
-            git diff -- index.html README.md sitemap.xml manifest.json llms.txt i18n tools | head -100
+            git diff -- index.html README.md README.en.md sitemap.xml manifest.json llms.txt i18n tools | head -100
             exit 1
           fi
           echo "✅ Tools are in sync"

.github/workflows/release.yml

@@ -94,7 +94,7 @@ jobs:
         run: npm run build
 
       - name: Verify generated sources are committed
-        run: git diff --exit-code -- index.html README.md sitemap.xml manifest.json llms.txt i18n tools
+        run: git diff --exit-code -- index.html README.md README.en.md sitemap.xml manifest.json llms.txt i18n tools
 
       - name: Scan release tree and verify license files
         run: |
@@ -106,19 +106,15 @@ jobs:
           VERSION: ${{ steps.version.outputs.version }}
         run: npm run build:release
 
-      - name: Generate changelog
-        id: changelog
+      - name: Read curated release notes
+        id: notes
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
         run: |
-          # Get commits since last tag
-          LAST_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
-          if [ -n "$LAST_TAG" ]; then
-            CHANGELOG=$(git log --pretty=format:"- %s" "$LAST_TAG"..HEAD)
-          else
-            CHANGELOG=$(git log --pretty=format:"- %s" -20)
-          fi
+          RELEASE_NOTES=$(node scripts/extract-release-notes.mjs "$VERSION")
           {
-            echo "CHANGELOG<<EOF"
-            echo "$CHANGELOG"
+            echo "RELEASE_NOTES<<EOF"
+            echo "$RELEASE_NOTES"
             echo "EOF"
           } >> "$GITHUB_OUTPUT"
 
@@ -133,14 +129,15 @@ jobs:
         env:
           VERSION: ${{ steps.version.outputs.version }}
           TOOL_COUNT: ${{ steps.tools.outputs.COUNT }}
-          CHANGELOG: ${{ steps.changelog.outputs.CHANGELOG }}
         with:
           tag_name: ${{ steps.version.outputs.tag }}
           name: WebUtils ${{ steps.version.outputs.version }}
           body: |
             ## WebUtils ${{ steps.version.outputs.version }}
 
-            **${{ steps.tools.outputs.COUNT }}+ 纯前端在线工具集**
+            **${{ steps.tools.outputs.COUNT }}+ 本地优先的浏览器工具集**
+
+            Local-first browser utilities with standalone HTML export and transparent network boundaries.
 
             ### 特性
             - 静态 HTML 工具集，可导出独立页面
@@ -159,7 +156,7 @@ jobs:
             3. 按 README 的隐私与网络边界使用；外部资源或网络工具仍需联网
 
             ### 更新日志
-            ${{ steps.changelog.outputs.CHANGELOG }}
+            ${{ steps.notes.outputs.RELEASE_NOTES }}
 
             ---
 

CHANGELOG.md

@@ -5,6 +5,38 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [2.2.0] - 2026-08-26
+
+本版本将 WebUtils 从“大量工具页面”收口为可持续维护的本地优先工具集，强化独立导出、隐私边界、浏览器验收和开源贡献入口。
+
+### 新增
+
+- 首页“最近使用”工作流，与搜索、分类、收藏和 URL 状态联动
+- 已登记工具的 standalone HTML 导出能力，自动内联仓库自有的共享 CSS/JavaScript
+- Playwright Browser Smoke 基线，覆盖首页发现、收藏、最近使用、移动端溢出与 5 个代表工具流程
+- 英文项目概览、中英文切换入口与可自动同步的工具数量
+
+### 改进
+
+- 工具规模更新为 1088 个，补齐工具页唯一 H1 及对应结构门禁
+- 收紧本地处理、浏览器权限、外部 API/CDN 和离线能力的文档表述，避免泛化的“纯前端即绝对离线”承诺
+- JSON 格式化、时间戳转换、URL 编解码与 Base64 工具的键盘、动态状态、Unicode 和文件处理可用性
+- Issue/PR 模板与贡献检查清单，补充复现环境、敏感信息与网络边界要求
+
+### 工程与发布
+
+- 单测基线扩展至 68 项，共享工具样式纳入 Stylelint，部署 Actions 升级至 Node.js 24 运行时
+- 发布工作流增加版本一致性、历史泄漏、个人路径、许可证、可重现归档与当前 `master` 标签校验
+- 部署包与发布归档均包含中英文 README、LICENSE 和 NOTICE，并验证与源文件一致
+
+### 修复
+
+- Base64 Unicode 编解码、文件导入导出与 UTF-8 BOM 保留
+- URL 编解码错误恢复、时间戳输入与 JSON 结果动态通知
+- 移动端搜索键盘、分类阴影裁剪、首页溢出与多项工具运行时异常
+
+---
+
 ## [2.1.0] - 2026-05-19
 
 工具规模 999 → 1086，抽出共享设计基座并完成全站统一。

index.html

@@ -54,7 +54,7 @@
         "applicationCategory": "DeveloperApplication",
         "operatingSystem": "Any",
         "browserRequirements": "Requires JavaScript. Works in Chrome, Firefox, Safari, Edge.",
-        "softwareVersion": "2.1.0",
+        "softwareVersion": "2.2.0",
         "inLanguage": ["zh-CN", "en"],
         "isAccessibleForFree": true,
         "offers": {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "webutils",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "浏览器端工具集；多数工具本地处理，网络类工具按需连接用户指定服务",
   "type": "module",
   "private": true,

package.json

@@ -0,0 +1,27 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+const version = process.argv[2] || pkg.version;
+const changelog = fs.readFileSync(path.join(root, 'CHANGELOG.md'), 'utf8');
+const headings = [...changelog.matchAll(/^## \[([^\]]+)\][^\n]*$/gm)];
+const headingIndex = headings.findIndex((match) => match[1] === version);
+
+if (headingIndex === -1) {
+  throw new Error(`CHANGELOG.md does not contain release notes for ${version}`);
+}
+
+const start = headings[headingIndex].index + headings[headingIndex][0].length;
+const end = headings[headingIndex + 1]?.index ?? changelog.length;
+const notes = changelog
+  .slice(start, end)
+  .replace(/^\s+|\s+$/g, '')
+  .replace(/\n---\s*$/, '');
+
+if (!notes) {
+  throw new Error(`CHANGELOG.md release notes for ${version} are empty`);
+}
+
+process.stdout.write(`${notes}\n`);

scripts/extract-release-notes.mjs

@@ -22,6 +22,7 @@ npm test          # 运行全部测试（node tests/run.js）
 | `html-structure.test.js` | 每个工具 HTML 的 `<head>`：doctype、lang、SEO 元数据、canonical                            |
 | `redirects.test.js`      | `_redirects` 与 `vercel.json` 重定向目标有效、两份配置一致                                 |
 | `assets.test.js`         | 静态资源与 i18n：sw 预缓存清单、manifest 图标/快捷方式、en/zh 翻译键一一对应               |
+| `release-notes.test.js`  | 发布说明：按当前版本提取 CHANGELOG 段落，拒绝缺失版本与跨版本内容                          |
 
 ## 新增测试
 

tests/README.md

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { section, test, assert, readText, ROOT } from './_harness.js';
+
+section('发布说明');
+
+const pkg = JSON.parse(readText('package.json'));
+const script = path.join(ROOT, 'scripts', 'extract-release-notes.mjs');
+
+test(`可提取当前版本 ${pkg.version} 的独立更新日志`, () => {
+  const notes = execFileSync(process.execPath, [script, pkg.version], {
+    cwd: ROOT,
+    encoding: 'utf8'
+  });
+
+  assert(notes.includes('### 新增'), '发布说明缺少“新增”段落');
+  assert(!notes.includes('## [2.1.0]'), '发布说明不应包含上一版本标题');
+  assert(!notes.trimEnd().endsWith('---'), '发布说明不应以 CHANGELOG 分隔线结尾');
+});
+
+test('拒绝提取 CHANGELOG 中不存在的版本', () => {
+  let rejected = false;
+  try {
+    execFileSync(process.execPath, [script, '999.0.0'], {
+      cwd: ROOT,
+      stdio: 'pipe'
+    });
+  } catch {
+    rejected = true;
+  }
+  assert(rejected, '不存在的版本应返回非零退出码');
+});

tests/release-notes.test.js

@@ -16,7 +16,8 @@ const TEST_FILES = [
   'redirects.test.js',
   'assets.test.js',
   'standalone-export.test.js',
-  'recent-tools.test.js'
+  'recent-tools.test.js',
+  'release-notes.test.js'
 ];
 
 let crashed = 0;