← 返回首页← Back to home

更新日志Changelog

最新版本 1.0.11 · 2026-11-18 · 共 62 个版本Latest version 1.0.11 · 2026-11-18 · 62 versions

本页由仓库里的 CHANGELOG.md 生成,内容逐条一致;每个版本下中文与英文逐条对应。This page is generated from CHANGELOG.md in the repository and matches it item by item; under each version, the Chinese and English texts correspond item by item.

1.0.11

改动

  • 空设置时关闭胶囊主开关不再弹说明框(#255):没有标题、图标和收起内容时,从「按设置」切回「原样」不再弹「打开后页面不变」——关掉就是恢复正常显示,弹框与刚做的动作矛盾。说明框现在只在打开开关时出现
  • 首次引导第 3 步与图里的控件一一对应(#254):原三条要点与图里从左到右的面具、圆圈、闭眼、⋯ 对不上,「点它」没有指代对象;现在一颗控件一条、同序四条,拖动说明并入首句

文档与商店材料

  • 落地页全页文案压缩:功能卡、怎么用、安装、隐私卡、FAQ 每段只说一件事;演示新增第 7 步「遮住这一页」,写明整页空白是正常效果、点「恢复」回来
  • 隐私政策页:正文行宽收到 760px;「不收集」与本地保存的矛盾改为「不上传、不出售、不分享」;CSS 选择器、读屏名称、标签页静音补一句白话;权限按 storage / activeTab / scripting / 按网站主机权限拆条
  • README / 商店材料:标题和图标描述同步压缩;版本口径与版本历史同步 1.0.11

面向审阅者

  • 功能与权限集合与 1.0.10 完全一致(storage / scripting / activeTab + 按站点可选主机权限);本轮只改两处交互文案与对外文档,界面视觉无变化,商店截图沿用
  • 门禁:编译、单测 897 项(58 文件)、E2E 十二脚本全绿(1.0.11 构建实测)、check:docs / check:package 通过

Changes

  • Turning the floating switch off on an empty site no longer opens the explanation box (#255): when no title, icon or hidden items are set, switching from "Your settings" back to "As is" no longer shows "the page stays as it is" — turning it off is simply a return to normal, so the box contradicted the action. It now appears only when the switch is turned on
  • Onboarding step 3 now matches the controls in the picture (#254): the old three bullets did not line up with the mask, circle, closed eye and ⋯ shown left to right, and "click it" had no clear referent. There is now one bullet per control, in the same order, with dragging folded into the opening sentence

Docs and store listing

  • Landing page copy tightened across the whole page: feature cards, how-to, install, privacy cards and FAQ now say one thing per paragraph; the demo adds a seventh step, "Cover this page", stating that a blank page is the intended effect and that "Restore" brings it back
  • Privacy policy page: body text is capped at 760px; the contradiction between "collects nothing" and local storage is replaced by "we don't upload, sell or share"; CSS selectors, screen-reader names and tab muting each get a plain-language gloss; permissions are listed one by one
  • README / store listing: the title-and-icon description is shortened to match; version references and history are on 1.0.11

For reviewers

  • Features and the permission set are identical to 1.0.10 (storage / scripting / activeTab + optional per-site host permissions); this round changes two interaction messages and outside documentation only, so the interface looks the same and the store screenshots are unchanged
  • Gates: compile, 897 unit tests (58 files), all twelve E2E scripts green (measured on the 1.0.11 build), check:docs / check:package pass

1.0.10

改动

  • 弹窗与站点设置页改为「配置摘要」(#252):开关下面那行现在把开关管的三样一起说——「已设置标题和图标 · 6 项收起设置」。只改过标题的网站也会如实写「已设置标题和图标」;三样都没设置时,整行换成「还没有设置标题、图标和收起内容,打开后页面不变」,不再只有一句「打开后页面不变」让人猜原因。待授权时摘要临时回到站名下面(面具卡还没出现)
  • 设置页保存后不再静默(#252,ADR-0021):在站点设置页改过标题或图标、而「按你的设置显示」关着时,卡内当场问「已保存;「按你的设置显示」还关着,现在打开吗?」,给「先保持原样 / 现在打开」两个出口;不弹窗、不挡继续编辑。弹窗进入的单步表单仍是「编辑 → 保存 / 退出」,两套保存模型各自保留
  • 向导退出提示按流程说后果(#252):「收起内容」流程说「页面回到上次保存的收起设置」;「标题和图标」流程说「标签页回到上次保存的标题和图标」。原来两条都提标签页标题,而标题流程并没有动页面
  • 死路都补下一步(#252):未设置站点提示补「从下面任选一项开始」;受限页面与快捷键被挡的每条原因补「换一个普通网页再试」(本地文件是「打开网上的页面再试」);导入文件不对补「请换一个文件再试」;删除站点 / 恢复内容确认框写明「删掉后不能撤销」,可重设的标题和图标恢复不写
  • 导入空文件不再自相矛盾(#252):合法但没有网站设置的文件,原来被说成「不是 PageMask 导出的设置文件」;现在是独立一句「这个文件里没有能导入的网站设置,本机的数据没有改动,请换一个文件再试」
  • 首次引导(#252):第 3 步一大段拆成一句说明 + 三条要点;「跳过引导」从说明文字中间挪到右上角、与标题同基线
  • 用词统一(#252):标签页「名字 / 样子」回到「标签页标题」;「网站本来」改「网站原来」;悬浮按钮开关标签写「显示悬浮按钮」;标题与图标卡的条件句同构

文档与商店材料

  • README 中英(#253):安装改为先装 Releases 的 zip(商店未上架时不用编译),源码构建归到开发者;已知限制改用「嵌在页面里的另一层页面 / 组件内部区域」的白话
  • 落地页(#253):安装说明如实写「还没上架」;更新日志页从本文件重新生成
  • 商店材料(#253):详细描述去掉内部叫法「幕布」,直接写「遮住这一页」;英文侧补齐漏掉的「快捷键」;版本口径与版本历史同步 1.0.10,截图 4 按 1.0.10 构建重拍(配置摘要入图,开关名改为「显示悬浮按钮」)

面向审阅者

  • 功能与权限集合与 1.0.9 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点;本轮只改界面文案、提示位置与两处问答流程
  • 门禁:编译、单测 897 项(58 文件)、E2E 十二脚本全绿(1.0.10 构建实测)、check:docs / check:package 通过

Changes

  • The popup and the site settings page now show a settings summary (#252): the line under the main switch names everything the switch controls — "Title & icon set · 6 items set to hide". A site with only a title now says "Title & icon set" instead of "Nothing set to hide"; when none of the three is set, the line becomes "No title, icon or hidden items yet — the page stays as it is", so the result is no longer left without a reason. While access is pending, the summary temporarily sits under the site name (the mask card isn't drawn yet)
  • Saving on the settings page no longer falls silent (#252, ADR-0021): after a title or icon is saved while "Show this site your way" is off, the card asks "Saved. The switch is still off — turn it on now?" with "Keep as is" / "Turn on now". No modal, and editing continues freely. The single-step form opened from the popup keeps edit → save / exit; both save models remain
  • The wizard's exit message now states what each flow restores (#252): the hide-items flow says "the page returns to the last saved hidden items"; the title-and-icon flow says "the tab returns to the last saved title and icon". Both used to mention the tab title, even though the title flow never touched the page
  • Dead ends now say what to do next (#252): the unconfigured-site hint adds "start with either option below"; every limited-page reason and every blocked-shortcut notice adds "Try a normal web page" (local files say "Open a page on the web instead"); import errors add "Choose another file"; the delete-site and restore-content dialogs state "This can't be undone", while the redoable title/icon restore does not
  • An empty but valid import no longer contradicts itself (#252): a file with no site settings used to be reported as "not a settings file exported by PageMask"; it now has its own message — "This file has no site settings to import, so nothing on this computer was changed. Choose another file"
  • Onboarding (#252): step 3's wall of text is now one sentence plus three bullet points; "Skip" moved from the middle of the description to the top right, on the title's baseline
  • Wording unified (#252): "name / look" of a tab is back to "tab title"; "originally" replaces "actually" for the site's own title; the floating-button switch reads "Show floating button"; the two condition sentences in the title and icon card share one pattern

Docs and store listing

  • README, both languages (#253): install now starts with the Releases zip (no build needed while the store listing is pending), with the source build under developers; known limitations use plain words ("an embedded page / a widget's internal area")
  • Landing page (#253): the install note now says the store version isn't live yet; the changelog page is regenerated from this file
  • Store listing (#253): the detailed description drops the internal name "Curtain" and says "Cover this page"; the English side now lists shortcuts too; version references and the version history are on 1.0.10, and screenshot 4 is re-shot on the 1.0.10 build (the summary is now in the picture, and the switch reads "Show floating button")

For reviewers

  • Features and the permission set are identical to 1.0.9 (storage / scripting / activeTab + optional per-site host permissions); nothing is granted at install time. This round changes interface copy, hint placement and two question-and-answer flows only
  • Gates: compile, 897 unit tests (58 files), all twelve E2E scripts green (measured on the 1.0.10 build), check:docs / check:package pass

1.0.9

改动

  • 草稿残留清扫只留在浏览器启动时(#249,收紧 1.0.8 的 #247):清扫原本也挂在扩展更新上,且抢在「重新注入后的孤儿清理」前面执行——「向导开着过夜」(预览 24 小时没动)的文档遇上后台更新,残留记录会被先删掉,孤儿预览又没人能撤了。现在清扫只在浏览器启动时做:重启后旧的文档标识必不可能复活,全量清扫安全;更新场景的记录跨更新保留,孤儿清理一定读得到
  • 一处注释改为如实表述(#250):「删除后残留的授权下次对账 / 管理页可收」不成立——对账从不收权、管理页列表来自站点配置(删除后站点已不在列表里);残留授权只能由用户在 Chrome 的站点权限设置里手动撤。罕见且无害不可见,注释如实记录

面向审阅者

  • 功能与权限集合与 1.0.8 完全一致(storage / scripting / activeTab + 按站点可选主机权限);两处都是后台侧的时序与注释,界面零变化
  • 门禁:编译、单测 881 项(57 文件)、E2E 十二脚本全绿(1.0.9 构建实测)、check:docs / check:package 通过

Changes

  • Draft-record sweeping now happens only at browser startup (#249, tightening 1.0.8's #247): sweeping also ran on extension update, ahead of the orphan cleanup that follows script re-injection — for a document whose wizard sat open overnight (preview untouched for 24h), a background update would sweep the record first and the orphan preview would again be unremovable. Sweeping at startup only is safe: after a restart the old tab/document identifiers can never come back; on update the record survives and the orphan cleanup always finds it
  • One comment corrected to state what actually happens (#250): "the leftover grant can be collected at the next reconcile / in the management page" is wrong — the reconcile never revokes and the management list comes from site configs (the deleted site is gone); a leftover grant can only be revoked by hand in Chrome's site permission settings. Rare, harmless, and invisible; the comment now says so

For reviewers

  • Features and the permission set are identical to 1.0.8 (storage / scripting / activeTab + optional per-site host permissions); both changes are background-side timing and comments; the UI is untouched
  • Gates: compile, 881 unit tests (57 files), all twelve E2E scripts green (measured on the 1.0.9 build), check:docs / check:package pass

1.0.8

改动

  • 向导预览的恢复副本改记 storage.local(#247,修正 1.0.7 的 #239 修复):1.0.7 把副本记在 storage.session——但 session 区随扩展更新 / 重载被清空(官方文档原句),而「扩展更新时开着的向导」恰是孤儿预览的目标场景,副本在更新瞬间就没了,撤不掉。改记 storage.local(跨更新持久,扩展卸载才清),值带写入时间,onInstalled / onStartup 清扫超 24 小时的残留键防累积
  • 一键清空的删除先于收权(#248,补全 #243):1.0.7 的「删除失败叫醒页面」发生在收回权限之后——叫醒后悬浮按钮和自定义标题回来了,但隐藏样式重新插入因无权限必败,页面停在半截态。顺序改为:还原已打开页面 → 删配置 → 收回权限 → 注销;删除失败就不收权限,叫醒后的页面可完整恢复

面向审阅者

  • 功能与权限集合与 1.0.7 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点;两处改动都在后台与消息顺序,界面零变化
  • 门禁:编译、单测 880 项(57 文件)、E2E 十二脚本全绿(1.0.8 构建实测)、check:docs / check:package 通过

Changes

  • The wizard-preview recovery copy now lives in storage.local (#247, correcting 1.0.7's #239 fix): 1.0.7 kept the copy in storage.session — but the session area is cleared when the extension is disabled, reloaded, or updated (per the official docs), and "wizard open during an extension update" is exactly the orphan-preview scenario: the copy vanished at the moment it was needed. It now lives in storage.local (persists across updates, cleared on uninstall), values carry a timestamp, and onInstalled / onStartup sweep leftovers older than 24 hours
  • Reset deletes the profile before revoking the permission (#248, completing #243): 1.0.7's "wake the page up on delete failure" ran after permissions.remove — the wake-up brought the floating button and title back, but re-inserting the hidden-item CSS then failed for lack of permission, leaving a half state. The order is now: restore open tabs → delete profile → revoke permission → unregister. If the delete fails, the permission stays and the woken page recovers fully

For reviewers

  • Features and the permission set are identical to 1.0.7 (storage / scripting / activeTab + optional per-site host permissions); nothing is granted at install time. Both changes are background-side logic and message ordering; the UI is untouched
  • Gates: compile, 880 unit tests (57 files), all twelve E2E scripts green (measured on the 1.0.8 build), check:docs / check:package pass

1.0.7

改动

  • 扩展更新 / 重载时开着的向导,预览样式不再永久残留(#239):旧实例冻结交接后撤预览的请求发不出去,草稿文本又不可由配置重算——预览残留成「免保存临时隐藏」,只有刷新页面能除掉。现在后台把每份文档实际插入的草稿文本记入会话存储(SW 回收不丢、浏览器重启即清),孤儿清理时一并撤掉;新实例首次换草稿也先撤残留再插入
  • 「界面语言」的说明与兜底标题展示对齐实际行为(#240):说明原写「默认标题仍跟随浏览器语言」——那是旧决策的残留,实际显式选了语言就跟所选语言走,仅「自动」跟浏览器;「留空就用「阅读」」的展示值原来取浏览器语言且创建后不随设置重算(浏览器中文 + 界面锁英文时页面写「阅读」、标签页实际显示 "Reading"),改为与标题生效逻辑同一份口径
  • 产品内直述数据去向(#241,2026-07 商店政策更新要求披露写在产品界面里、商店描述不算数):插件设置「关于」卡与首次引导各加一句「你的设置和点选记录只保存在这台电脑的浏览器里,PageMask 不上传任何数据」;同类清扫修掉「没添加的网站完全不碰 / never touches」两处绝对化表述(「遮住这一页」在那类网站可用)
  • 「清成完全空白再保存,Chrome 会显示网址」的过时警告删掉(#246,交接关目检新眼睛发现):标题兜底自「永不返回空白」起,清空保存显示的是兜底标题——这句警告与前半句「留空就用「阅读」」自相矛盾且陈述了不存在的后果,三处常驻脚注一并收短
  • 一键清空删配置失败不再把页面留在「像被删光」的假象(#243):存储异常时配置还在、页面却已清空且从此不再恢复。现在后台删除失败会叫醒已清空的页面恢复界面,并把失败如实报给入口(弹窗 / 管理页显示既有的失败提示)
  • 导入路径收口(#242):规则 id 超长按码点截到 100(与标题同口径);候选 8 条 / 范围行 20 条 / 规则 500 条上限,超量规则如实计入「跳过」计数
  • 样式档位收口(#245):图标格圆角 6px 并入控件档 8px;两处共用行距 10px 收进 --pm-space-2(8px);组件内微间距在设计规范登记为允许值

文档与商店材料

  • 对外材料去掉「未添加的网站不运行任何内容」类绝对化表述(幕布正是用一次性脚本在那类网站上运行的):商店详细描述中英、单一用途、§10 答问、README 中英标语六处一次改齐(#238)
  • 商店材料与历史记录一致性六项:CHANGELOG 两处 404 版本链接改指实际提交;「全量发版史」措辞自洽;编辑入口列举顺序对齐实际界面(「标题和图标」在前);两处逐字引用的弯引号对齐 _locales;历史审查记录一条「已修」更正(随机 id 未落地且不该落地);API 版本核实表补 commands 两行(#244)
  • 商店截图:设置页 / 列表页那张(截图 5)按 1.0.7 构建重拍入库;其余五张无内容变化沿用 1.0.0 重拍的版本

面向审阅者

  • 功能与权限集合与 1.0.6 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点
  • 门禁:编译、单测 878 项(57 文件)、E2E 十二脚本全绿(1.0.7 构建实测)、check:docs / check:package 通过

Changes

  • No more leftover wizard-preview styles after an extension update or reload (#239): the old instance's teardown freezes its style record, so the request that removes the preview never goes out, and preview text cannot be recomputed from settings — the preview stayed as unsaved hiding until a manual refresh. The background now keeps each document's last-applied preview text in session storage (survives service-worker restarts, cleared on browser restart), removes it along with the other orphan styles, and clears a leftover before inserting a new draft in a fresh instance
  • The interface-language copy and the fallback-title display now match actual behavior (#240): the description still said the default tab title follows the browser language — the old decision's leftover; it follows the language picked here, and only Automatic follows the browser. The “leave it empty to use 「阅读」” display value was taken from the browser language and never recomputed (a Chinese browser with the interface locked to English showed 阅读 while the tab actually said "Reading"); it now shares one code path with the actual title logic
  • A plain-language data disclosure inside the product (#241, the 2026-07 store policy update requires prominent disclosure in the product UI; the listing doesn't count): Settings → About and onboarding each say "Your settings and the items you pick are stored only in this browser on this computer — PageMask uploads nothing". Same-class sweep also fixed two "never touches sites you didn't add" absolutes (Cover this page works on those sites)
  • The stale “clear it completely and Chrome shows the address” warning is gone (#246, caught by a fresh-eyes visual review): the title fallback has guaranteed a non-blank result for a long time, so clearing and saving shows the fallback title — the warning contradicted its own first half and described behavior that no longer exists; all three footnotes got shorter
  • A failed reset no longer leaves the page looking deleted (#243): when the final delete step fails (storage error), the settings remain but the page had already cleared itself and never recovered. The background now wakes those pages back up and reports the failure honestly to the entry point
  • Import-path hardening (#242): rule ids are truncated to 100 code points (same as titles); caps of 8 candidates / 20 scope rows / 500 rules per site, with overflow rules counted honestly in the import result
  • Style tokens consolidated (#245): the icon tile's fourth radius literal 6px joined the control tier at 8px; two shared row gaps of 10px became --pm-space-2 (8px); component-internal micro-spacing is now a registered exception in the design spec

Docs & store materials

  • The absolute claims "on every other site PageMask runs nothing" are gone (the cover is exactly a one-shot script running on those sites): six places aligned at once — the zh/en detailed descriptions, the single purpose, a §10 answer, and the README taglines (both languages) (#238)
  • Six store-material/records consistency fixes: two 404 version links in CHANGELOG now point at real commits; the "full release history" wording is self-consistent; the edit-entry order matches the actual UI (Title & icon first); two verbatim quotes now use the same curly apostrophes as _locales; one "fixed" claim in the historical review record corrected; two commands-API rows added to the API-version table (#244)
  • Store screenshots: the settings/management shot (screenshot 5) was re-shot on the 1.0.7 build; the other five carry no content change and are kept

For reviewers

  • Features and the permission set are identical to 1.0.6 (storage / scripting / activeTab + optional per-site host permissions); nothing is granted at install time
  • Gates: compile, 878 unit tests (57 files), all twelve E2E scripts green (measured on the 1.0.7 build), check:docs / check:package pass

1.0.6

改动

  • 未添加的网站上,「遮住这一页」的恢复按钮也说界面语言:这类网站没有内容脚本,遮住时由一次性脚本铺幕布——它此前从不应用界面语言设置,英文界面上恢复按钮的文字与读屏名称始终是中文、shadow 根的语言标记也是中文(WCAG 3.1.2)。现在铺幕布时应用语言,幕布开着时在设置里切换语言也立即生效
  • 语言判定从界面层移到 core/i18n(不依赖 Vue),扩展页面、内容脚本与一次性幕布脚本共用同一份实现

面向审阅者

  • 功能与权限集合与 1.0.5 完全一致(storage / scripting / activeTab + 按站点可选主机权限);只影响页内恢复按钮的语言与无障碍名称
  • 门禁:编译、单测 866 项(57 文件)、E2E 十二脚本全绿(含新增「未添加网站的一次性幕布语言」断言,1.0.6 构建实测)

Changes

  • The cover's restore button now speaks the interface language on sites you haven't added: those sites have no content script, so covering the page injects a one-shot script — it never applied the interface-language setting, leaving the English UI with a Chinese restore button and screen-reader name, plus a Chinese language tag on the shadow root (WCAG 3.1.2). The language is now applied when covering, and switching the interface language while the cover is up takes effect immediately
  • The language decision moved from the UI layer to core/i18n (no Vue dependency), so extension pages, content scripts and the one-shot cover script share one implementation

For reviewers

  • Features and permission set are identical to 1.0.5 (storage / scripting / activeTab + optional per-site host permissions); only the in-page restore button's language and accessible name change
  • Gates: compile, 866 unit tests (57 files), E2E across twelve scripts all green (including the new "one-shot cover language" assertion, measured on the 1.0.6 build)

1.0.5

改动

  • 英文界面的页内读屏发音:页内小胶囊、向导、幕布恢复按钮所在容器的界面语言标记此前固定为中文——英文界面上读屏会按中文念;现在跟着界面语言走(WCAG 3.1.2)
  • 快捷键被挡的提示结束后,图标说明还在:在不支持快捷键的页面按一下,图标角标 3 秒后消失时,悬停说明恢复为默认文案;此前被清成空标题,Chrome 里只剩扩展名
  • 弹窗不会永远停在「读取中」:读取当前标签页失败时,落到「这个页面用不了」的说明,而不是一直转圈(与 #168 同一口径)

文档与商店材料

  • 隐私政策与商店描述里「没有第三方代码」改为可核对的「不加载外部脚本或远程代码,不发起网络请求」——界面运行时等开源库随包分发,列在 THIRD_PARTY_NOTICES
  • 提交指南与商店材料中的示例包名 / 版本号统一到当前构建,不再引用 1.0.1、1.0.0 的旧包

面向审阅者

  • 功能与权限集合与 1.0.4 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点
  • 门禁:编译、单测 864 项(57 文件)、E2E 十二脚本全绿

Changes

  • Screen-reader language for in-page UI on the English interface: the shared container for the floating button, picker and restore button had its language fixed to Chinese, so screen readers pronounced the English UI with Chinese phonetics; it now follows the interface language (WCAG 3.1.2)
  • The icon tooltip survives the blocked-shortcut hint: after the 3-second badge on an unsupported page, the tooltip now returns to the default text; it used to be cleared to an empty title, leaving only the extension name in Chrome
  • The popup no longer hangs on "Loading": if reading the active tab fails, it falls back to the existing "this page is not available" explanation instead of spinning forever (same rule as #168)

Docs and store materials

  • Replaced "no third-party code" in the privacy policy and store copy with the verifiable "no external scripts or remote code is loaded, and no network requests are made" — open-source libraries such as the UI runtime ship inside the package and are listed in THIRD_PARTY_NOTICES
  • Aligned example package names and version numbers in the submission guide and store materials with the current build; removed references to the old 1.0.1 / 1.0.0 packages

For reviewers

  • Features and permission set are identical to 1.0.4 (storage / scripting / activeTab + optional per-site host permissions); no site access is granted at install time
  • Gates: compile, 864 unit tests (57 files), E2E across twelve scripts all green

1.0.4

改动

  • 键盘操作一致:悬浮按钮「⋯」菜单打开后,焦点直接落在第一个菜单项上——与站点设置页行尾菜单同一行为,键盘用户不再需要按 Tab 摸进菜单

面向审阅者

  • 功能与权限集合与 1.0.3 完全一致;单行交互修复
  • 门禁:编译、单测 864 项(57 文件)、E2E 十二脚本全绿

Changes

  • Consistent keyboard behavior: opening the floating button's "⋯" menu now puts focus on the first menu item — same as the site settings row menu, so keyboard users no longer have to Tab into the menu

For reviewers

  • Features and permission set are identical to 1.0.3; a one-line interaction fix
  • Gates: compile, 864 unit tests (57 files), E2E across twelve scripts all green

1.0.3

改动

  • 收起「没有特征」的元素后规则不再悄悄失效:裸段落这类没有 class、id 的元素,此前点选时留在网页上的临时光标样式会被当成它的「特征」写进收起规则——点选结束光标撤走,规则就匹配不到元素了(开关打开页面纹丝不动)。现在点选不再在网页上留下任何痕迹,保存的都是稳定特征
  • 极简页面也能正常收起无特征元素:整页都挑不出稳定特征的页面(祖先元素同样没有 class / id),现在改用「从页面根逐级锚定的精确位置」保存,规则命中点选的那一个元素;页面改版导致位置变化时,失效体检照常提醒重新选一次

面向审阅者

  • 功能与权限集合与 1.0.2 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点
  • 门禁:编译、单测 864 项(57 文件)、E2E 十二脚本全绿、审核员八步走查全绿(夹具站点,含无特征元素点选→保存→生效全流程)
  • 走查另一现象(向导保存后刷新链停摆)定界为走查脚本编排缺陷:脚本没应答「先保持原样」一问,向导未关期间页面刷新按设计被屏蔽——运行时零改动,脚本已修(#226)
  • 测试基建两处:E2E 门禁链卡死修复(check-orphan-css 漏关测试服务器,#227)、一处断言跟进光标通道改动

Changes

  • Hide rules for "featureless" elements no longer silently break: for bare paragraphs and other elements without a class or id, the temporary pick cursor left on the page used to be mistaken for a "feature" of the element and baked into the saved rule — once picking ended and the cursor was removed, the rule matched nothing (flipping the switch did nothing on the page). Picking now leaves no trace on the page at all, so only stable features get saved
  • Featureless elements can now be hidden on minimal pages too: on pages where nothing has a stable feature (ancestors without classes or ids as well), rules are now saved as a precise position path anchored from the page root, matching exactly the picked element; if a redesign moves things, the rule health check still prompts to pick again as usual

For reviewers

  • Features and permission set are identical to 1.0.2 (storage / scripting / activeTab + optional per-site host permissions); no site access is granted at install time
  • Gates: compile, 864 unit tests (57 files), E2E across twelve scripts, full eight-step walkthrough green (fixture site, including pick → save → effect for a featureless element)
  • Another walkthrough observation (refresh chain stalling after wizard save) was scoped to a test-orchestration flaw: the script never answered the "keep as is" prompt, and page refreshes are blocked by design while the wizard is open — zero runtime changes, script fixed (#226)
  • Two test-infrastructure fixes: E2E gate chain hang (check-orphan-css leaked its test server, #227) and one assertion updated to follow the cursor channel change

1.0.2

改动

  • 「盖住」不再首屏闪现:给元素选「盖住」方式后,打开该网站的瞬间目标内容不会先露一帧再被盖住(首屏遮挡现在会等遮罩层就位才撤)
  • 扩展更新后旧设置立即接管:隐藏了悬浮按钮的网站在扩展更新 / 重载后,旧实例留下的样式由新实例正确接管——此前删规则、关灰度会"看起来没反应",要手动刷新页面
  • 切换界面语言立即生效:只靠语言兜底标题的网站,切换界面语言后已打开标签页的假标题立刻跟着换
  • 慢设备上「遮住这一页」不再误报:遮罩铺开所需时间较长时不再提示失败
  • 键盘操作不断线:站点设置页删行、撤销,以及三处「允许访问」授权完成后,焦点回到列表中正确的位置,不再跳回页首
  • 深色界面下的点选框:向导的选中 / 悬停描边颜色跟随网页底色而非界面主题——深色界面 + 浅色网页时描边依然清晰(对比度 ≥3:1)
  • 向导清单更好读:收起项清单底部新增"下面还有"的渐隐提示;「盖住」的幽灵号牌改为半透明,不再完全盖住底下的文字
  • 界面小修:欢迎页一处用词与术语表对齐;透明度过淡提示改为"所在的位置"(原"原来的位置"易误解为默认位置);导入结果统一用"跳过";插件设置页快捷键入口文字与卡内其他行对齐
  • 文档:隐私政策的短标签长度口径与实现对齐(自动填好、可编辑、最长 60 字符;在线页同批更新)

面向审阅者

  • 功能与权限集合与 1.0.1 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点
  • 门禁:编译、单测 862 项(57 文件)、E2E 十二脚本(新增"扩展重载后样式接管"与"深浅色 tokens"两道)、真机站点验证(匿名页)、check:docs / check:package 全绿(1.0.2 构建实测)

Changes

  • "Cover" no longer flashes on first paint: after choosing the "cover" method for an element, opening that site no longer shows the target for a frame before it gets covered (the first-paint shield now stays until the cover layer is in place)
  • Old settings take over correctly after extension updates: on sites where the floating button is hidden, styles left by the old instance after an update / reload are now taken over by the new one — previously deleting a rule or turning gray off could "look like nothing happened" until a manual reload
  • Switching the interface language applies immediately: on sites relying on the language-fallback tab title, already-open tabs now follow the switch right away
  • "Cover this page" no longer reports failure on slow devices: when the cover takes longer to spread, no more false failure notice
  • Keyboard path stays connected: after deleting a row or undoing on the site settings page, and after all three "Allow access" confirmations, focus returns to the right place in the list instead of jumping to the top of the page
  • Pick outline in dark UI: the wizard's selection / hover outline color now follows the page background instead of the UI theme — with a dark UI on a light page the outline stays clearly visible (contrast ≥3:1)
  • Easier-to-read wizard lists: the items list gains a bottom fade hinting "more below"; ghost badges for covered items become semi-transparent so they no longer fully hide the text underneath
  • Small UI fixes: one welcome-page wording now matches the glossary; the low-opacity hint says "where the button is" instead of "its original position"; import results consistently say "skipped"; the shortcut entry on the Settings page aligns with the card's other rows
  • Docs: the privacy policy's short-label length now matches the implementation (auto-filled, editable, up to 60 characters; online copy updated in the same batch)

For reviewers

  • Features and permission set are identical to 1.0.1 (storage / scripting / activeTab + optional per-site host permissions); no site access is granted at install time
  • Gates: compile, 862 unit tests (57 files), E2E across twelve scripts (two new: "style takeover after extension reload" and "light/dark tokens"), real-site verification (anonymous pages), check:docs / check:package all green (verified on the 1.0.2 build)

1.0.1

改动

  • 无障碍:幕布「恢复」按钮的读屏名称现在以可见文字「恢复」开头(语音输入「点击恢复」能命中,WCAG 2.5.3);弹窗「查看使用说明」链接的读屏名称包含可见文字;「恢复网站原来的标题和图标」补上二次确认框(站点设置页与向导两处入口,与「恢复网站原来的内容」同款)
  • 删除站点时权限收得干净:「删除这个网站的设置」现在只收回浏览器实际授予的站点权限——Chrome 的收回是整批原子的,旧版把从未授予的模式一并塞入会导致整批失败、权限残留
  • 一键清空更稳:页面卡住时多等一轮再收回授权,避免个别慢页面留下删不掉的隐藏样式(到下次导航为止)
  • 后台提示跟随界面语言:快捷键在不支持的页面上被挡时,工具栏角标的悬停说明不再固定中文
  • 导入兼容:导入文件里带显式默认端口(如 :443)的生效范围会先归一,不再静默永不生效
  • 向导健壮性:极端并发下不会再出现两个向导叠加把整页点死;收起项名称超长按码点截断到 60(与标题、范围标签同口径)
  • 界面一致性:向导全部对话框与扩展页面的对话框统一宽度;错误消息句尾标点全表统一,并新增两条自动化守门(错误族句尾、中英同键句尾对称)
  • 文案小修:欢迎页第 2 步补全真实边界「刷新或离开页面就恢复」
  • 文档:隐私政策与在线版逐字对齐、数据清单补全三个本机界面偏好字段(在线页同批更新);上架指南快照更新

面向审阅者

  • 功能与权限集合与 1.0.0 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点;改动集中在正确性与无障碍修复
  • 门禁:编译、单测 860 项(57 文件)、E2E 十脚本 1112 项断言、真机站点验证(匿名页)、check:docs / check:package 全绿(1.0.1 构建实测)

Changes

  • Accessibility: the curtain's "Restore" button accessible name now starts with the visible label "Restore" (voice-control "click Restore" matches; WCAG 2.5.3); the popup's "View the guide" link accessible name contains the visible text; "use the site's own title and icon" now asks for confirmation first (both entry points — site settings and the wizard — matching the existing "restore hidden items" dialog)
  • Site deletion revokes permissions cleanly: "Delete this site's settings" now revokes only the host permissions the browser actually granted — Chrome's revocation is all-or-nothing per call, and the old batch including never-granted patterns silently failed, leaving permissions behind
  • Clear-all is more robust: a stuck page gets one extra wait round before permissions are revoked, so a slow tab can no longer keep an unremovable hidden stylesheet until the next navigation
  • Background notices follow the UI language: when a shortcut is blocked on an unsupported page, the toolbar badge tooltip no longer stays Chinese for English users
  • Import compatibility: a scope prefix with an explicit default port (e.g. :443) in an imported file is normalized, instead of silently never matching
  • Wizard robustness: double-opening the wizard in a tight race can no longer stack two wizards and block the whole page; over-long item names are truncated to 60 code points (same rule as titles and scope labels)
  • UI consistency: all wizard dialogs share one width with the extension-page dialogs; error-message punctuation is unified across the table with two new automated gates (error-family tails, Chinese–English per-key tail symmetry)
  • Copy fixes: the onboarding step 2 states the full boundary ("reloading or leaving the page restores it")
  • Docs: the privacy policy is verbatim-aligned with the online version and its data list now covers three local interface preferences (online page updated in the same batch); the submission guide snapshot refreshed

For reviewers

  • Features and permissions are identical to 1.0.0 (storage / scripting / activeTab plus per-site optional host permissions, nothing granted at install); the changes are correctness and accessibility fixes
  • Gates: typecheck, 860 unit tests (57 files), 1112 assertions across ten E2E scripts, real-site checks on anonymous pages, check:docs / check:package all green (measured on the 1.0.1 build)

1.0.0

改动

  • 商店名称与简介换新措辞:简介里的「只处理你添加的网站」改成「只对你添加的网站起作用」(用词纪律),英文补上 "only"(排他语义与中文对齐);工具栏按钮的悬停提示改成具体动作「改这个网站的标题和图标、收起内容」
  • 界面文案小修:向导与站点设置页两处「某一项找不到了」的说明改成同一句式;站点设置页「留空就用『阅读』」点明来源是默认标题;「上一步」按钮写清退回去做什么;三处常驻说明去掉句尾句号(中英同步)
  • 商店描述按审核口径打磨:权限申请时点写全(收起内容 / 标题和图标 / 未添加网站上开整页变灰)、按钮名按界面实名(「整页变灰」钮)、中英描述逐条取齐、单一用途一句话简化
  • 上架指南修正:三处官方引文改指现行页面、Trader 官方操作链接换官方政策页(原链接已失效)、发版流程补 README 同步步骤
  • 文档一致性收口:隐私政策首段的旧功能名(「图片 / 视频变灰」)改成「整页变灰」;CHANGELOG 四十四个版本标题的链接补齐(GitHub 上从纯文本变成可点);README 的「插件设置」说明补全

面向审阅者

  • 这是首次提交 Chrome 应用商店的版本;功能与权限集合与 0.9.8 完全一致(storage / scripting / activeTab + 按站点可选主机权限),安装时不授予任何站点
  • 门禁:编译、单测 847 项(57 文件)、E2E 十脚本 1110 项断言、check:docs / check:package 全绿(1.0.0 构建实测)

Changes

  • Store name and description reworded: the short description now says "only on sites you choose" (exclusive scope, aligned with the Chinese text), and the Chinese copy replaces a banned term with the approved wording; the toolbar tooltip now names the concrete actions (change this site's title & icon, hide items)
  • Small copy fixes in the UI: the two "item can no longer be found" notices (wizard and site settings) now share one sentence pattern; the site-settings title hint names where the fallback title comes from; the "back" button says what going back does; three persistent hints drop their trailing periods (Chinese and English alike)
  • Store listing copy polished for review: the permission-request moments are stated in full, button names match the real UI labels ("Turn the whole page gray"), the Chinese and English descriptions are aligned item by item, and the single-purpose sentence is simplified
  • Submission guide corrected: three official quotes now point at the live pages, the Trader statement link points at the official policy page (the old one is gone), and the release process gained a README-sync step
  • Documentation consistency: the privacy policy's first paragraph now says "the whole page gray" (it still described the pre-0.8.18 pictures-and-videos version); all 44 version headings in this changelog got working links; the README's "Settings" description lists everything that page actually holds

For reviewers

  • This is the first version submitted to the Chrome Web Store; features and permissions are identical to 0.9.8 (storage / scripting / activeTab plus per-site optional host permissions, nothing granted at install)
  • Gates: typecheck, 847 unit tests (57 files), 1110 assertions across ten E2E scripts, check:docs / check:package all green (measured on the 1.0.0 build)

0.9.8

改动

  • 欢迎页第 1 步的图示改成真实 Chrome 的样子:原来把工具栏和扩展菜单画成同一条横条,还用一个字母方块代替插件图标;现在画的是「点拼图图标 → 在扩展列表里找到 PageMask → 点行尾图钉」这两步,图标用的是插件自己的真实图标
  • 删除这个网站的设置,确认框不再贴着弹窗边缘:宽度算法没把四周留白算进去,288 像素的框实际撑到 330,而弹窗只有 320 像素宽。现在左右各留 16 像素;管理页与设置页里同类的确认框也统一了内边距和边框
  • 插件里的隐私政策网址换新地址:随这次更新指向 https://cherishfall.github.io/page-mask/privacy.html。PageMask 的所有页面现在都收在 /page-mask/ 路径下,旧地址 https://cherishfall.github.io/privacy.html 已移除,访问会返回找不到页面(404)——0.9.8 之前的版本还写着旧地址,升级后即指向新页
  • 仓库文档整理:术语表、隐私政策、商店提交材料三份文档从根目录收进 docs/;面向用户的说明书、开发约定里的位置信息和链接全部同步。根目录只留 GitHub 与各类工具默认会去找的 6 份文件
  • 落地页改到 /page-mask/ 路径:https://cherishfall.github.io/page-mask/ 是 PageMask 的主页,站点根页改成项目索引,以后加别的项目不会挤在一起

面向审阅者

  • 确认框仍然出现在它原本的窗口里:插件弹窗里的停在弹窗中,网页里的停在网页中。这是 Chrome 原生确认框的行为,改变不了;本次统一的是三处确认框的外观
  • 门禁:编译、单测 845 项(57 文件)、E2E 十脚本 1110 项断言、check:docs / check:package 全绿

Changes

  • The first onboarding illustration now matches real Chrome. It used to show the toolbar and the extensions menu as a single bar, with a letter block standing in for the extension icon. It now shows the actual two steps — click the puzzle icon, find PageMask in the list of extensions, click the pin at the end of that row — and uses the extension's real icon
  • "Delete this site's settings" no longer fills the popup edge to edge. The dialog width was calculated without its padding, so a 288 px box rendered at 330 px inside a 320 px popup. It now leaves 16 px on each side, and the same dialogs in the management and settings pages share one set of padding and border styles
  • The privacy policy link inside the extension points at the new address: https://cherishfall.github.io/page-mask/privacy.html. Every PageMask page now lives under the /page-mask/ path; the old address, https://cherishfall.github.io/privacy.html, has been removed and returns not found (404). Versions before 0.9.8 still carry the old address and point at the new page once updated
  • Repository docs tidied up. The glossary, privacy policy and store submission material moved from the root into docs/; location references and links in the user-facing docs and contributor guidance were updated. Six files remain at the root because GitHub and common tools look for them there
  • The landing page moved to /page-mask/: https://cherishfall.github.io/page-mask/ is now PageMask's home, and the site root is a simple index of projects, so future projects get their own paths

For reviewers

  • Confirmation dialogs still appear in the window they belong to: one inside the popup, one in the web page. That is how Chrome's native dialogs behave and cannot be changed; what is now consistent is how the three dialogs look
  • Gates: typecheck, 845 unit tests (57 files), 1110 assertions across ten E2E scripts, check:docs / check:package all green

0.9.7

改动

  • 插件设置页「关于」卡补「隐私政策」入口:一行链接指向在线隐私政策页。Chrome 商店的隐私披露要求「显著披露必须在扩展界面内」,商店描述页不算——此前扩展里没有政策入口,现在有了
  • 在线落地页上线:https://cherishfall.github.io/(中英双语,含功能说明、三步用法、安装方式、隐私四问、常见问题),隐私政策页 https://cherishfall.github.io/privacy.html(该地址已随 0.9.8 迁移至 /page-mask/privacy.html,旧地址现为 404)与仓库里的 PRIVACY.md 逐条等义
  • 隐私政策链接改指已上线的页面:商店材料、README、隐私政策文件的链接统一指向上面那个公开地址,不再依赖仓库是否公开(商店对隐私政策死链直接拒审)
  • 「关于」卡原为每行各自排布,各行值起点不齐(英文态 127/144/138/163 像素),改成两列网格后齐平

面向审阅者

  • 新增 docs/store-submission-guide.md:从注册开发者账号到提交审核、发布、后续更新的逐步操作指南,每条政策事实都附官方来源链接;含审核员备注写法、常见拒审原因与本项目的预防动作对照表
  • 门禁:编译、单测 840 项(56 文件)、E2E 十脚本 1108 项、check:docs / check:package 全绿

Changes

  • "Privacy policy" link added to the About card in plugin settings, pointing at the online policy page. The store's disclosure rules require prominent disclosure inside the extension UI (a store listing does not count) — there was no policy entry before, now there is
  • Landing page is live: https://cherishfall.github.io/ (bilingual: features, three-step usage, install, four privacy answers, FAQ), with the policy at https://cherishfall.github.io/privacy.html (that address moved to /page-mask/privacy.html in 0.9.8; the old one is a 404 now), equivalent item by item to the repository's PRIVACY.md
  • Privacy policy links now point at the live page in the store materials, README and the policy file itself — no longer dependent on whether the repository is public (a dead privacy-policy link is an automatic rejection)
  • The About card's rows now share a two-column grid, so their values line up (previously 127/144/138/163 px in English)

For reviewers

  • New docs/store-submission-guide.md: a step-by-step guide from developer account to submission, review, publication and updates, every policy fact carrying an official source link; includes reviewer-notes guidance and a table mapping common rejection reasons to this extension's preventive actions
  • Gates: typecheck, 840 unit tests (56 files), ten E2E scripts (1108 assertions), check:docs / check:package all green

0.9.6

改动

  • 真实网站 E2E 恢复全绿:测试工具的站点身份计算没跟上 0.9.0 的「一个网站 = 可注册域名」改造,真站(微信读书 / 得到 / 墨问)的测试档案写错了键、流程停在第一步。现测试侧直接复用扩展内核的同一份实现(构建时转译,附三层一致性单测),三站完整流程(点选 → 看效果 → 保存 → 规则真实命中)恢复通过;顺带修掉脚本两层旧失配(裸域授权、保存后的「先保持原样」确认)
  • 小修:权限匹配对显式 :* 通配端口按官方语义处理;管理页「⋯」展开态在高对比度模式下可见;下划线离字距离收口成共享 token;两处开发文档旧说法同步
  • 加固:导入文件超 20MB 给人话报错(不再卡住页面);收起项名称超长按码点截断(与标题同口径);向导打开消息补来源校验(与其他特权消息同口径)

面向审阅者

  • 第二轮独立审查(真站 E2E / 夜间新增代码复审 / 安全与隐私探针)结论:无功能坏点;安全探针七项全安全(零远程资源、零 HTML 注入通道、特权消息全校验、权限申请全部用户手势同步回合)
  • 门禁:编译、单测 840 项(56 文件)、E2E 十脚本 1107 项、真站三站、check:docs / check:package 全绿

Changes

  • Real-site E2E restored to green: the test harness computed site identity by full hostname, missing the 0.9.0 change to registrable domains — test profiles landed under wrong keys on real sites (WeRead / Dedao / Mowen). The harness now reuses the extension's own implementation (transpiled at test time, with three-layer consistency tests); the full flow (pick → preview → save → rules actually match) passes again on all three sites, plus two older script mismatches fixed (bare-domain grants, the save-time "keep as is" dialog)
  • Small fixes: explicit :* wildcard ports follow Chrome's documented semantics; the management-row "⋯" expanded state is visible in forced-colors mode; text-underline offset consolidated into a shared token; two stale doc mentions synced
  • Hardening: imports over 20 MB get a plain-language error instead of freezing the page; hide-item names longer than 60 code points are truncated (same as titles); the open-wizard message now validates its sender like other privileged messages

For reviewers

  • Second independent review round (real-site E2E / fresh-code review / security & privacy probe) found no functional defects; the probe's seven areas all came back safe (zero remote resources, zero HTML-injection channels, all privileged messages validated, every permission request in a user-gesture turn)
  • Gates: typecheck, 840 unit tests (56 files), ten E2E scripts (1107 assertions), three real sites, check:docs / check:package all green

0.9.5

改动

  • 站点设置页:「标签页标题」「标签页图标」合并为一张「标题和图标」卡。向导、弹窗、胶囊菜单里它们本来就是一项,设置页是唯一拆开的地方(0.3.0 的旧结构一直没跟着合)。合并后卡内仍是「标签页标题」「标签页图标」两个字段,自动保存不变;「恢复网站原来的标题和图标」收进卡内底部,与「恢复网站原来的内容」同款
  • 站点设置页「整页变灰」的说明气泡修复。此前悬停只见问号光标、气泡渲染到了页面外(宿主行少一个定位锚);位置从行中央移到开关左侧、与弹窗一致。新增两条机器守门(锚类静态检查 + 三处页面逐枚悬停断言),同类问题第四次出现的路被堵死
  • 带非默认端口的页面不再误报「还没允许访问」。此前匹配模式未写端口时按「只匹配默认端口」判定,与 Chrome 官方语义(未写端口 = 所有端口)相反:已授权网站打开带端口的页面会照常生效,不再陷入「允许访问也没用」的死循环
  • 健壮性。悬浮按钮上开关 / 拖动定位写入失败时回滚并提示(此前静默失败);幕布「恢复」按钮换到更小的窗口后不再停在屏幕外;页面还没加载完就打开「标题和图标」「收起内容」不再无响应;另修六处小问题(导入不再接受非法站点名、瞬时读权限失败不再全量注销注入、遮罩结果误报等)
  • 文案精修。数量单位统一为「项」;说明句句尾句号清零并新增标点守门测试;撤掉幕布的动作统一叫「恢复」;待授权提示不再承诺「允许之后就会按设置显示」(开关若在「原样」,这句话是假的);英文侧修正单复数、冠词、指代与开关命名("Show the floating button")
  • 视觉统一。立「文字入口」规则(导航蓝 / 次级灰 / 危险红,能点的文字看得出来能点)并全项目归档;暗色模式下未选中的单选圆点对比补足(1.41 → 5.98:1);欢迎页功能顺序对齐权威表、插图与胶囊选中底对比补足、演示状态与文案一致、补讲「整页变灰」段;「⋯」菜单展开时按钮有选中态;插件设置与管理页若干对齐(同词卡头去重、说明位置统一到字段下方、小控件点击区补足)
  • 商店材料。6 张截图脚本修通(虚构域名映射本地,截图不再出现 127.0.0.1)、权限描述与版本史更正

面向审阅者

  • 机器守门新增:ⓘ 宿主锚类静态检查 + check-info-tips(三处页面逐枚悬停断言气泡在视口内);说明句标点守门;欢迎页顺序从权威对照表派生断言;暗色单选对比断言
  • docs/design-ui.md 新增「文字入口」一节(五档,含 GOV.UK / Carbon / Ant 出处)与「危险色两档」登记;站点设置页区块「五改四」,docs/design-surfaces.md 对照表、GLOSSARY.md、docs/design.md 同步
  • 界面用词变更仅两处英文侧:辅助行开关 "Show the floating button"、灰度卡名 "Whole-page gray"(对照表逐字同步);中文用词不变
  • 门禁:编译、单测 835 项(55 文件)、E2E 十脚本(含新增 check-info-tips)、check:docs / check:package 全绿;产物 .output/page-mask-0.9.5-chrome.zip

Changes

  • Site settings: "Tab title" and "Tab icon" are now one "Title & icon" card. The wizard, popup and capsule menu already treat them as one item; the settings page was the only place still splitting them (a 0.3.0-era structure). The card keeps both field names, autosave unchanged; "Use the site's own title and icon" now sits inside the card bottom, matching "Use the site's own content"
  • Fixed the info bubble on the site settings "Whole-page gray" row. Hovering used to show only the help cursor — the bubble rendered off-page (its host row lacked a positioning anchor); the bubble also moved from mid-row to the left of the switch, matching the popup. Two machine guards added (a static anchor check plus per-instance hover assertions on three pages)
  • Pages on non-default ports no longer report "not allowed yet". Match patterns without an explicit port were treated as default-port-only, the opposite of Chrome's documented semantics (no port = all ports): authorized sites now work on ported pages instead of looping on a pointless permission prompt
  • Robustness. Floating-button toggle / position writes roll back with a notice on failure (previously silent); the curtain's restore button no longer lands off-screen on smaller windows; opening "Title & icon" / "Hide items" before the page has finished loading no longer no-ops; six smaller fixes (imports reject invalid site keys, a transient permission-read failure no longer unregisters every site, cover-result false negatives, etc.)
  • Copy refinement. Counts unified to "items"; trailing full stops removed from standing hints with a new punctuation guard; uncovering the curtain is now consistently "Restore"; the pending-authorization hint no longer promises "shown your way" (false when the site switch is off); English fixes for plurals, articles, references, and the toggle label ("Show the floating button")
  • Visual consistency. A documented "text entry" rule (nav blue / secondary gray / danger red; clickable text looks clickable) applied across surfaces; dark-mode unchecked radios fixed (1.41 → 5.98:1); the welcome guide aligns with the canonical order, illustration and capsule selected-state contrast fixed, demo state now matches its copy, the gray segment is introduced; the "⋯" button shows a selected state while its menu is open; several alignments in plugin settings and management pages (duplicate card/field headings removed, hints moved below their fields, small-control hit areas)
  • Store materials. Screenshot script fixed (fictional domains mapped locally, no more 127.0.0.1 in shots), permission wording and version history corrected

For reviewers

  • New machine guards: a static ⓘ-anchor check and check-info-tips (hover assertions on three pages); a hint punctuation guard; welcome order derived from the canonical surfaces table; dark radio contrast assertions
  • docs/design-ui.md gains a "text entry" section (five tiers with GOV.UK / Carbon / Ant sources) and a two-tier danger-color note; the site settings page goes from five blocks to four, with docs/design-surfaces.md, GLOSSARY.md and docs/design.md synced
  • Only two English wording changes: "Show the floating button" and "Whole-page gray" (table-synced); Chinese wording unchanged
  • Gates: typecheck, 835 unit tests (55 files), ten E2E scripts (including the new check-info-tips), check:docs / check:package all green; artifact .output/page-mask-0.9.5-chrome.zip

0.9.4

改动

  • 三个开关右边缘对齐:原来「按你的设置显示」「整页变灰」两个开关在一条竖线上,「悬浮按钮」那个往外偏了 13 像素,看着像三样东西。现在三个落在同一条竖线上
  • 底部三行与上方对齐:「全部网站设置」「插件设置」两个入口改成左右各贴一边(原来各占一半、文字居中),「删除这个网站的设置」与卡片里的说明文字左对齐。分隔线仍横跨整张卡——它是分组线,跨整卡是有理由的例外
  • 「悬浮按钮」补上图标:另外三行标签前都有图标,唯独这行没有,文字比别人靠左 24 像素。现在补了一颗与页面上那颗悬浮按钮同源的轮廓图标,四行文字起点齐了;名字仍是「悬浮按钮」
  • 两枚说明气泡位置统一:「整页变灰」那枚本来贴着开关,「悬浮按钮」那枚被挤在行中间。现在都在各自开关左边、间距一致
  • 界面上没有增删任何文字,术语与说法一处未改

面向审阅者

  • 「同一屏所有行共用一条内容边线」写成成文规矩(docs/design-ui.md §五第 8 条),并进一致性复查清单第 13 条;内容内缩量只在 --pm-card-inset 一处定义
  • 新增自动检查:中英两种语言下逐项比对三个开关右缘、底部三行左右落点、四行图标位置、两枚气泡右缘与分隔线宽度;另加 4 项单测守住「内缩量只有一处来源」
  • 控件类型按语义保留、不改:开关管记住的状态(按你的设置显示 / 整页变灰 / 悬浮按钮),按钮做一次性动作(遮住这一页刷新即还原)。Apple HIG、Carbon、Ant Design 三家规范同此口径
  • 遗留观察:「整页变灰」标签前的圆形图是功能图标,与信息标外形相近;换图形要连悬浮按钮、菜单、站点设置页一起换,另批再议
  • 门禁:编译、单测 807 项(51 个文件)、E2E 九个脚本 1067 项断言全绿、文档与打包检查通过

Changed

  • The three switches now share one edge: “Shown your way” and “Grayscale whole page” sat on one vertical line while “Floating button” was 13 px further out, so the row read as a different kind of thing. All three now line up on the same edge
  • The bottom rows line up with the cards above: “All site settings” and “Settings” now hug the left and right ends of the content area (they used to split the row in half with centered text), and “Delete this site’s settings” lines up with the explanatory text inside the cards. The divider still spans the full card width — it separates groups, which is a deliberate exception
  • The floating button row got an icon: the other three rows have an icon before the label, this one had none, so its text started 24 px further left. It now carries an outline icon taken from the floating button itself, so all four labels start at the same place. The name is still “Floating button”
  • Both info tips moved to the same spot: the one beside “Grayscale whole page” already sat against its switch, the one beside “Floating button” had been pushed into the middle of the row. Both now sit against their own switch, the same distance away
  • No wording was added or removed, and no name changed

For reviewers

  • “Every row on one screen shares one content edge” is now a written rule (docs/design-ui.md §五, rule 8) and a new entry in the consistency checklist; that inset is expressed in exactly one place (--pm-card-inset)
  • New automated checks compare, in both Chinese and English, the right edges of the three switches, the left and right edges of the bottom rows, the four icon slots, the two info tips and the divider; four new unit tests guard the single source of that inset
  • Control types stay as they are, by meaning: switches manage remembered state (“Shown your way” / “Grayscale whole page” / “Floating button”), buttons perform a one-off action (“Cover this page” is gone on reload). Apple HIG, Carbon and Ant Design all draw the same line
  • Known leftover: the round glyph before “Grayscale whole page” is a function icon that resembles the info tip; replacing it means changing the floating button, its menu and the site settings page together, so it waits for its own round
  • Gates: type check, 807 unit tests (51 files), 1067 E2E assertions across nine scripts, doc and package checks — all green

0.9.3

修复

  • 默认快捷键撞了 Chrome 自带的按键:原来的 Ctrl+Shift+G / ⌘⇧G 是 Chrome 查找栏的「查找上一个」(macOS 上也是访达的「前往文件夹」),Chrome 会静默不绑定这条命令,装完就没有键可用。换成 Ctrl+Shift+Y / ⌘⇧Y:逐项核对过 Chromium 的两张保留快捷键表,这组没有被占用,也是 Chrome 官方 commands 文档示例使用的组合。幕布的 Ctrl+Shift+X 不变
  • 弹窗上的键帽跟着真实绑定走:绑上了就显示,没绑上不显示一个不存在的键。上一版「整页变灰」那一行没有键帽,根因就是这条命令没绑上;换键后与「遮住」那一行一致

改动

  • 没绑上时给得出下一步:插件设置页把「到 Chrome 里设置快捷键」放到整张卡下面、两条命令共用,不再挤在第一行让人以为只管那一条;提示改成「可能被系统或其他扩展占用了」。Chrome 不允许扩展替用户改键,只能把用户送到它自己的快捷键页
  • 改完键切回来就能看到新键:设置页与欢迎页在标签页重新可见时重读一次绑定。原来只监听窗口聚焦,而 Chrome 快捷键页是同一窗口的新标签页,切回来窗口焦点没变,会漏掉
  • 弹窗文字再收一轮:删掉「悬浮按钮」那行只复述标签的说明,以及未设置网站多余的「设置后会出现」,已设置网站的常驻说明从三行减到两行;灰度卡不再用「上面的开关」这种位置指代,也不再把「按网站记」与「独立于主开关」混成一句;遮住卡只留还原时机。状态、错误、危险后果的说明一条没删(见 docs/design-copy.md)

面向审阅者

  • ADR-0020 补 0.9.3 修订节,写明根因、保留表核对结论与界面引导的改动;开发日志同步
  • 新增 tests/shortcut-binding.test.ts 守门 6 项:建议键不许回到被保留的 G、三处界面都读两条真实绑定、长驻页面重读并移除监听、改键入口在两行之后、没绑上不显示假键
  • 注意:本地已装过的扩展只「重新加载」不会重算建议键,需要卸载重装,或到 chrome://extensions/shortcuts 手动给这条命令设一个键;用户在那里设过的键不会被新版本覆盖

Fixed

  • The default shortcut collided with a Chrome built-in: Ctrl+Shift+G / ⌘⇧G is Chrome's "Find previous" (and Finder's "Go to Folder" on macOS), so Chrome silently left the command unbound — the feature shipped with no key. It is now Ctrl+Shift+Y / ⌘⇧Y: both Chromium reserved-accelerator tables were checked line by line and this combination is free; it is also the combination used in Chrome's own commands documentation examples. The curtain shortcut (Ctrl+Shift+X) is unchanged
  • Popup keycaps follow the real binding: shown when bound, hidden when not, instead of implying a key that does not exist. The missing keycap on the gray row was a symptom of the unbound command

Changed

  • A next step when unbound: the settings page now puts "Manage shortcuts in Chrome" below both rows so neither looks unmanageable, and the notice says the system or another extension may have taken the key. Chrome does not let extensions change bindings themselves; the user is sent to the browser's own shortcuts page
  • Rebound shortcuts show up without reopening the page: the settings page and the welcome page re-read bindings when their tab becomes visible again. The old focus listener missed the common path, because Chrome's shortcuts page opens in a new tab of the same window
  • A leaner popup: dropped the line under "Floating button" that only restated its label, plus the extra "appears once set up" line on unset sites, so a set-up site now shows two persistent hints instead of three. The gray card names the other switch instead of pointing "above" and no longer mixes persistence with independence into one line; the cover card states only when the page comes back. Status, error and consequence copy is untouched (see docs/design-copy.md)

For reviewers

  • ADR-0020 gains a 0.9.3 revision section covering the root cause, the reserved-accelerator check and the UI changes; the dev log is updated too
  • A new tests/shortcut-binding.test.ts guard (6 checks) locks the fix in: suggested keys must not return to G, all three surfaces must read both live bindings, long-lived pages must re-read and clean up listeners, the manage button must sit below both rows, and no fake keycap when unbound
  • Note: reloading an already-installed local build does not re-evaluate a changed suggested key. Remove and reinstall the extension, or assign a key to this command at chrome://extensions/shortcuts. Keys the user set manually are preserved across updates

0.9.2

新增

  • 整页变灰也能按快捷键了:默认 Ctrl+Shift+G(Mac 是 ⌘+Shift+G),按一次变灰、再按一次恢复彩色,状态按网站记;第一次按键当场申请这个网站的权限,不必先打开弹窗。幕布那条快捷键仍是临时的、刷新就还原,两条的性质写在插件设置页的同一句说明里(ADR-0020 修订 ADR-0010「全产品只有一条命令」)

改动

  • 键帽提示补齐并区分 Mac / PC:弹窗的灰度卡、插件设置页的快捷键卡、欢迎页示意图都显示 Chrome 里当前实际绑定的键;没绑定就隐藏(插件设置页给一句「没有绑定快捷键」)。Mac 键帽按 Apple 的键盘规范把 Shift 排在 Command 前面(⇧⌘G),Windows / Linux 仍写 Ctrl+Shift+G;幕布键帽同步改成同一种写法
  • 界面文案:插件设置页一句话说清两条快捷键的差别(遮住是临时的、变灰按网站记),英文按同一个意思重写而不是逐字硬译;Chrome 的快捷键设置页里两条命令也都有中英文说明了

面向审阅者

  • 新增 ADR-0020 正式修订 ADR-0010,并同步「永不做」清单、术语表与商店提交材料
  • 后台变灰命令分支补 7 个单测(含拒绝授权、用户手势丢失、不支持页面、关掉时字段消失);既有幕布快捷键 6 个用例保持通过
  • 变灰开关关闭时写「字段消失」而不是 false,与弹窗开关的落库形状一致

Added

  • A shortcut for turning the whole page gray: Ctrl+Shift+G by default (⌘+Shift+G on Mac). Press once to turn gray, press again to turn back to color; the setting is remembered per site. The first press asks for that site's access right there, so you don't have to open the popup first. The curtain shortcut is still temporary and disappears on reload — the settings page now spells out the difference in one line (ADR-0020 revises ADR-0010's "only one command" decision)

Changed

  • Shortcut hints now cover both commands and both platforms: the popup's gray card, the settings page shortcut card and the welcome page illustration all show the shortcut currently bound in Chrome; an unbound shortcut is hidden (the settings page says so). On Mac the keycaps follow Apple's keyboard guideline by putting Shift before Command (⇧⌘G); Windows/Linux still read Ctrl+Shift+G. The curtain keycap uses the same order now
  • Interface copy: the settings page explains in one sentence that covering is temporary while turning the whole page gray is remembered per site, rewritten in English rather than translated word for word; both commands now have localized descriptions in Chrome's keyboard shortcuts page

For reviewers

  • ADR-0020 formally revises ADR-0010; the "never do" list, glossary and store submission materials were updated with it
  • Seven unit tests cover the new gray command branch (including declined permission, lost user gesture, unsupported pages and the field disappearing when switched off); the six existing curtain shortcut tests still pass
  • Turning the gray switch off now removes the field instead of writing false, matching what the popup switch stores

0.9.1

修复

  • 带非默认端口的站点管理页打不开(#166,#162 遗留):localhost:3000、example.com:8443 这类站点在「全部网站设置」里点了没反应、手输地址也显示「没有这个网站的设置」。现在列表行能进、地址能直达
  • 向导点选嵌套内容给提示(#167):点中网页组件内部区域(shadow DOM)或网页里嵌的另一层页面(iframe)时,提示「收起设置管不到它,所以没有选中」并拒绝选中——这类选择生成的规则永远不生效,还可能误伤外层同名元素。设计文档承诺的提示从此兑现
  • 弹窗不再可能停在「读取中」(#168):设置读取失败时落到空态并给一句「重新打开弹窗再试一次」;点「收起内容」没反应时页面也给一句话

改动

  • 「在哪些页面收起」改成原生单选分段(#142):与「收起方式」同一套控件,读屏统一报「N 选 1」,同屏不再有两种互斥语义
  • 弹窗的失效提醒可以点了(#175):「N 项可能失效」现在是一个入口,点它直接打开「收起内容」重新选;原样态保存的确认按钮补了「保存」二字(「保存,先保持原样」/「保存,现在打开」);设置面板的「收起 / 展开」改成「收起面板 / 展开面板」,不再与「收起内容」撞名;删除入口与失效项带下划线、看得出来能点;站点设置页的收起项清单加了序号,同名条目分得清;欢迎页可以「跳过引导」;向导「看效果」的清单带上总数(「这次要收起的内容(6 项)」),行多时最后一行藏在滚动区里也不会漏
  • ⓘ 说明气泡加了指向箭头(#175):气泡与它解释的那一行连在一起,不再像在解释上一张卡
  • 文案全面梳理(#172 / #173 / #174):界面禁词(如「生效」)清零;同一概念全项目一种叫法(「检查一样的」「默认标题」「悬浮按钮」);常驻提示一律不加句尾句号(立了成文规矩);标题留空说明改成一句有因果的话(「留空就用「阅读」——如果清成完全空白再保存,Chrome 会改成显示网址」);站点设置页灰度卡两段说明合并成「行内短句 + ⓘ」
  • 界面细节(#169 / #170 / #171):开关动效与悬停 / 按下态补齐并符合成文动效规矩;页内浮层遮罩统一一份浓度(暗色自动加深);键帽样式两套合一;幕布上的恢复按钮补方向键移动(与胶囊同一份步长)

面向审阅者

  • 商店提交材料、README、隐私政策同步了 0.8.x 以来的旧名与过期状态(「整页变灰」口径、悬浮按钮叫法、插件设置内容清单),中英一致(#163)
  • CI 新增版本三方一致性校验(package.json / 更新日志 / 商店材料)(#176)

Fixed

  • Sites on a non-default port were unreachable from the list (#166, #162 regression): localhost:3000-style sites did nothing when clicked in “All site settings”, and typing the address directly showed “no settings for this site”. Both paths work now
  • Picking nested content now explains itself (#167): clicking inside a widget’s inner area (shadow DOM) or a page embedded in the page (iframe) says hide settings can’t reach it and declines the pick — such rules could never work and could even hide look-alike elements in the outer document. This delivers what the design doc promised
  • The popup can no longer get stuck on “Loading” (#168): if settings can’t be read, it falls to the empty state with “reopen the popup and try again”; a dead click on “Hide items” now shows a notice on the page instead

Changed

  • “Where it applies” is now a native radio segment (#142): the same control as the hide method — screen readers announce it as one-of-N, and the panel no longer mixes two kinds of exclusive choice
  • The stale-items notice in the popup is actionable (#175): “N may be broken” now opens “Hide items” to pick again; the “As is” save dialog buttons say Save (“Save, keep as is” / “Save, turn it on now”); the panel labels are “Collapse panel / Expand panel” so they no longer collide with “Hide items”; the delete entry and stale marks are underlined and look clickable; hidden-item rows are numbered so look-alike names are tellable; the welcome page has “Skip this guide”; the wizard’s review list carries a total (“What will be hidden (6 items)”) so a long list can’t hide its last row from you
  • ⓘ bubbles point at their row (#175): a small caret ties each bubble to the row it explains instead of the card above
  • Copy pass across every surface (#172 / #173 / #174): banned words are gone; one concept one name everywhere; resident hints never end in a full stop (a written rule now); the blank-title note is one causal sentence (“Leave it empty to use “Reading” — if you clear it completely, Chrome will show the address instead”); the site-settings gray card carries one short line plus an ⓘ instead of two stacked paragraphs
  • Interface details (#169 / #170 / #171): switch motion and hover/press states fixed to the written motion rules; in-page dialogs share one backdrop shade (darker in dark mode); keycap styles merged; the curtain’s restore button gains arrow-key movement with the same step as the floating button

For reviewers

  • Store listing, README and the privacy policy are in sync with post-0.8.x naming and states (“Turn the whole page gray”, “floating button”, the Settings page contents), Chinese and English alike (#163)
  • CI now checks that package.json, the changelog and the store materials agree on the version (#176)

0.9.0

改动

  • 网站身份改成可注册域名(#162):weibo.com、www.weibo.com、s.weibo.com 现在是同一个网站——一份设置、一次授权、列表一行;weibo.com 与 weibo.cn 仍是两个。升级后第一次读到旧配置时自动合并:收起项取并集,冲突的取最近改过的那份,旧数据不丢。规则仍按每个页面的实际网址生效,「只在 weibo.com 首页收起」不会套到子域页面
  • 收起内容多了「恢复网站原来的内容」(#160):站点设置页「收起的内容」卡底部与向导的选内容步骤底部各一个入口,与「恢复网站原来的标题和图标」对称。只清收起项,标题、图标、开关、整页变灰一概不动;清之前先确认一次,并写明几项会没了
  • 原样态下点保存先问一句(#159):之前会静默保存、页面毫无变化,看着像没生效。现在弹一个框问「现在打开吗」——两条路都完成保存,不替你自动打开
  • 没有可生效的设置时,开关旁写明「打开后页面不变」(#158):弹窗、悬浮按钮、站点设置页三处同一句话、同一个判断;开关照常可拨,不再让人以为坏了
  • 界面上的长说明收掉(#161):只在前几次有用的引导文字收进 ⓘ 或折叠起来;状态、后果、边界这类「不知道就会做错」的话仍留在界面上,但压成一句
  • 三处界面对齐并加了自动检查(#157):弹窗、悬浮按钮菜单、站点设置页的排列顺序、叫法与控件来源统一,对照表是唯一权威——改一处漏两处会在提交前报出来;站点设置页的「整页变灰」卡归位,旧名「图片和视频」彻底退场

取舍(如实说明)

  • 同一注册域名下的不同子域共用一份设置与一次授权。这是「用户认为它们是一个网站」的直接后果:本来想分开配的两个子域会被合并
  • 只允许过 weibo.com 的老用户,打开 s.weibo.com 时弹窗会说「这个页面还没允许访问」,点一次「允许访问」补上——升级不会自动替你扩权
  • 迁移时新增的授权是「裸域 + 子域」两条模式;带非默认端口的站点用 http、https 两条精确模式(浏览器的匹配模式不支持 *://主机:端口/*)。IP 地址、localhost 与带端口的地址保持原样,不合并子域
  • 公共后缀表只内置常见子集(com.cn / co.uk / github.io 等):表外的后缀会把同后缀的两个独立站点当成一个(共用设置与授权),不会丢数据

Changed

  • A site is now its registrable domain (#162): weibo.com, www.weibo.com and s.weibo.com are one site — one set of settings, one permission grant, one row in the list; weibo.com and weibo.cn remain two. Existing settings are merged the first time they are read after upgrading: hidden items are unioned and the more recently edited copy wins for shared fields, so nothing is lost. Rules still apply per page URL — “hide only on the weibo.com home page” does not leak onto subdomains
  • “Use the site’s own content” for hidden items (#160): one entry at the bottom of the “Hidden items” card and one at the bottom of the wizard’s pick step, mirroring “Use the site’s own title and icon”. It clears hidden items only — title, icon, switch state and grayscale stay; a confirmation first says how many items will go
  • Saving while the site shows “As is” now asks once (#159): previously it saved silently with nothing changing on the page, which looked broken. A dialog now asks whether to turn “Show this site your way” on; both answers save, and it never turns it on for you
  • When nothing applies, the switch says “Nothing changes on the page” (#158): same sentence and same test in the popup, the floating button and the site settings page; the switch still works, so it no longer looks broken
  • Long explanations trimmed (#161): guidance that only matters the first few times now lives behind an ⓘ or a disclosure; state, consequences and limits — the things you get wrong if you don’t know them — stay on screen, one short sentence each
  • The three surfaces are aligned and checked automatically (#157): order, wording and control source for the popup, the floating menu and the site settings page now have a single authoritative table, and changing one but not the others fails before commit; the “Grayscale whole page” card moved back into place and the old name is gone

Trade-offs (stated plainly)

  • Subdomains of one registrable domain share one set of settings and one grant. That is the direct consequence of treating them as one site: two subdomains you wanted to configure separately will be merged
  • If you only ever allowed weibo.com, opening s.weibo.com shows “This page isn’t allowed yet” with one “Allow access” button — upgrading does not widen permissions for you
  • A site is granted with two patterns (bare domain plus subdomains); sites on a non-default port use explicit http and https patterns, because match patterns do not support *://host:port/*. IP addresses, localhost and addresses with a port stay exact and do not merge subdomains
  • The public suffix list is a built-in subset (com.cn, co.uk, github.io and other common ones): an unknown suffix makes two independent sites on that suffix share settings and a grant. No data is lost

0.8.19

改动

  • 「媒体」钮与弹窗开关行的图标换成对比度符(半填充圆):0.8.18 把功能从「图片和视频变灰」升级为「整页变灰」后,画着一张图片的图标已经答不上「这是什么东西」;半填充圆是灰度 / 对比度的通行符号(M3 的 contrast 符号、macOS 与 GNOME 的对比度设置同款)。关态 = 描边(圆 + 中线),开态 = 右半填实——与面具图标同一套「描边 / 填实」状态语言,关与开一眼可辨

Changed

  • The “Media” button and popup switch icon is now a contrast symbol (half-filled circle): after 0.8.18 upgraded the feature to “Turn the whole page gray”, the old picture glyph (mountain + sun) no longer answered “what is this”; the half-filled circle is the standard glyph for grayscale / contrast (M3's contrast symbol, also macOS and GNOME contrast settings). Off = outline (circle + midline), on = right half filled — the same outline / filled state language as the mask icon, clearly distinguishable at a glance

0.8.18

改动

  • 「图片和视频变灰」→「整页变灰」(#156):打开后整个页面变成黑白——文字、图片、视频、按钮、背景图、canvas、连 iframe 里的内容全都一样;位置大小不变、链接还能点、文字照样读。此前按媒体类型灰度的路线修了三轮仍不断出现「某类图没灰」(书封走背景图的多抓鱼、登录态的推特),整页灰从机制上消灭这类问题。依据:iOS/macOS 系统灰度同为整屏方案,市面 grayscale 类扩展全部是一条 CSS 规则;技术实测 fixed 元素不受影响、文字保持可读
  • 叫法同步:弹窗、站点设置页、欢迎页、悬浮按钮读屏名统一为「整页变灰」(中英同改);开关的记忆、三处入口、与「按你的设置显示」的独立性全部不变

取舍(如实说明)

  • 本扩展自己的悬浮按钮等界面也会跟着页面变黑白(页面上无法豁免整页滤镜,功能不受影响——状态靠形状与明度仍然可辨,与 iOS 系统灰度对浮层的处理一致)
  • ≤32px 小图标豁免退场:页面自己的按钮图标也变灰
  • 自动播放视频的「点击放行」保留:放行的是播放动作,画面本来就是黑的

Changed

  • “Turn pictures & videos gray” → “Turn the whole page gray” (#156): flipping it turns the entire page black & white — text, pictures, videos, buttons, background images, <canvas>, even content inside iframes; same place, same size, links still work, text stays readable. The per-media approach kept hitting “this kind of image didn't turn gray” after three rounds of fixes (covers drawn as background images, logged-in X); whole-page gray eliminates that class of problem mechanically. Precedent: iOS/macOS system grayscale is a whole-screen toggle, and every grayscale extension is one CSS rule; verified that fixed-position elements stay put and text remains readable
  • Naming synced: popup, site settings, the guide and the floating button's accessible name all say “Turn the whole page gray” (Chinese and English); the switch's memory, its three entries and its independence from “Your settings” are unchanged

Trade-offs (stated plainly)

  • PageMask's own interface (the floating button and friends) turns black & white with the page — a page-level filter cannot exempt it, and it keeps working (states stay distinguishable by shape and lightness, matching how iOS system grayscale treats overlays)
  • The ≤32px icon exemption is gone: the site's own button icons turn gray too
  • The click-to-allow rule for autoplaying videos stays: it releases the playback, and the picture is already black & white

0.8.17

修复

  • 弹窗 ⓘ 信息标对读屏不可达:聚焦时只播报「更多信息」三个字,浮层正文读不到——补 aria-describedby 指向浮层正文,聚焦即播报完整内容
  • 弹窗「页面还没加载好」的说明行是异步出现的,读屏感知不到——补 role="status"
  • 触屏点击胶囊时系统默认的灰色高亮闪一下,叠在自有反馈上显脏——有意关掉(按钮自带悬停 / 按下 / 选中底反馈)
  • 弹窗删除确认框内容超高时滚动会连动到弹窗页面——滚动限制在框内
  • 两处措辞:ⓘ 浮层与站点设置页对「点击放行视频」统一说成「点一下视频就能看」;不透明度滑杆说明补上方向(数值越小越淡)

Fixed

  • The popup's ⓘ info tags were unreachable for screen readers: focusing announced only “More information” without the popover text — wired aria-describedby to the popover body so focus reads the full content
  • The “page hasn't finished loading” notice appears asynchronously but was invisible to screen readers — added role="status"
  • The system tap-highlight flash on touch overlaid the capsule's own hover / press / selected feedback — turned off intentionally
  • Scroll chaining from the popup's delete dialog into the popup page when content overflows — contained to the dialog
  • Two wording nits: the ⓘ popover and the site settings page now use the same phrasing for click-to-allow (“click a video to watch it”); the opacity slider hint spells out the direction (lower = fainter)

0.8.16

改动

  • 悬浮按钮开启态重做(#152):0.8.15 的「强调色图标 + 分段底部 2px 指示条」退场——指示条紧贴胶囊边框,看着像两道重复的线;改成图标开关的通行做法(Material 3 图标按钮 / Carbon 工具栏选中态 / iOS 控制中心同路):填实图标换墨色、分段铺一层淡灰选中底,「开」靠形状(填实 vs 描边)与墨色浓淡两个信号辨认,不再依赖颜色;悬停 / 按下用一层更深的透明薄层表达,状态切换保留 150ms 过渡
  • 弹窗观感(#153):组件间距 4→8px、卡片内边距 4→12px,把 0.8.15 为英文高度红线压掉的呼吸感还回来;说明文字砍短——已设置网站的卡头不再有说明行,灰度卡、遮住卡、悬浮按钮行的说明各收成一句短话,被砍掉的细节(黑白但可读可点、自动播放的视频会暂停、快捷键照常可用)移进两个 ⓘ 信息标,鼠标悬停或键盘聚焦时浮出、Esc 撤下;删除悬浮按钮行上方的独立分割线;底部「全部网站设置」「插件设置」改回文字链接(muted + 下划线),不再占按钮的视觉档;「标题和图标」「收起内容」两颗入口同为次操作档——已设置网站里「收起内容」不再独占实心蓝主按钮(待授权网站的「允许访问」仍是实心)
  • 灰度补两个缺口(#154):① 书封 / 封面这类用 CSS 背景图画的内容图现在一并变灰(多抓鱼实测:首页 18 个背景图元素全部变灰,≤32px 小图标照旧豁免)——0.8.15 及之前这类站点等于没开;② 页面没加载好时(比如网络代理抖动出现的 Chrome 错误页)打开灰度不再失败:设置照常保存,弹窗改为一句「这个页面还没加载好。打开之后,图片和视频会自动变黑白」,等页面真正打开灰度自动生效——0.8.15 及之前这种场景只会留下「没能在这个页面上启动」

修复

  • 灰度在多抓鱼等「封面走 CSS 背景图」的站点上不生效(根因:纯 img/video 选择器盖不住背景图,本版由内容脚本扫描打标)
  • 在没加载好的页面上打开灰度,设置没能保存、灰度永远开不上(根因:Chrome 错误页拒绝脚本注入,配置写入被一并跳过)

修复(发版审查,0.8.16 收口前)

  • 弹窗顶部的站点名不带端口,和「全部网站设置」列表里的同一个网站对不上号(现在与列表、悬浮按钮用同一套展示名规则)
  • 同一个「图片和视频变灰」在浮层说明里被写成「变成黑白」:全项目统一「变灰」的说法(弹窗 ⓘ 浮层、站点设置页说明、欢迎页,中英同步)
  • 站点设置页的提示句引用「原样」「按设置」这些要先学的状态名,改成「上面的开关关着 / 打开时」
  • 「留空就用『阅读』——标题不能设成空白」读起来自相矛盾,重写成一句连贯的话(向导、站点设置页、插件设置页三处同源)
  • 站点设置页「恢复网站原来的标题和图标」看不出能点,补下划线;清单里的序号徽章改成和页面号码牌同一个颜色
  • 悬浮按钮选中态的悬停反馈太弱(和选中底几乎一个颜色),加深一档

Changed

  • Floating button's on state redesigned (#152): 0.8.15's accent icon + 2px bottom rule are gone — the rule sat flush against the capsule border and read as a doubled line. The state now follows the common icon-toggle pattern (Material 3 icon button, Carbon selected toolbar icon, iOS Control Center): the filled icon turns ink, the segment gets a quiet gray selected fill, and "on" is carried by shape (filled vs outline) plus ink weight instead of color. Hover and press deepen a translucent state layer; the 150ms transition stays
  • Popup made breathable (#153): component spacing 4→8px, card padding 4→12px, giving back the air 0.8.15 traded away for the English height limit. Copy is halved — the set-up site's mask card no longer has a hint line, and the gray / cover / floating-button hints are each one short sentence; the details that were cut (black-and-white but readable and clickable, autoplaying videos pause, shortcuts keep working) moved into two ⓘ info tags that appear on hover or keyboard focus and dismiss with Esc; the standalone divider above the floating-button row is removed; the two footer entries are text links again (muted + underline) instead of buttons; “Title & icon” and “Hide items” are equal secondary buttons — “Hide items” no longer holds the only solid primary (a pending site's “Allow access” still does)
  • Gray closes two gaps (#154): ① content images drawn as CSS background images (book covers and the like) now turn gray too — on such sites the switch used to do nothing; ② turning gray on from a page that hasn't finished loading (say, a Chrome error page after a proxy hiccup) no longer fails: the setting is saved, the popup explains “once the page is open, pictures and videos turn gray automatically”, and it takes effect without another toggle

Fixed

  • Gray had no effect on sites like duozhuayu whose covers are CSS background images (root cause: an img/video selector can't reach background images; this release marks them via the content script)
  • Turning gray on from an error page silently failed to save the setting (root cause: script injection is refused on Chrome error pages, skipping the profile write)

0.8.15

改动

  • 弹窗重排(#148):新老网站共用同一套四块卡,顺序与悬浮按钮四段一一对应——① 面具卡(开关 + 「标题和图标」「收起内容」两颗入口并排一行,主操作在右)② 灰度卡 ③ 遮住卡(与前两张同款卡片框,但卡内没有开关,只有按钮 + 快捷键 + 一句「只是临时挡住、刷新就还原」)④ 辅助行(悬浮按钮开关,不带卡片框)。「查看使用说明」从底部挪到标题右侧;没设置过的网站不显示假开关,改用一句肯定句说明设置好之后开关做什么;两颗编辑入口不再置灰——任何状态、开关开或关都能点
  • 悬浮按钮开启态收敛(#149):去掉整颗墨底反白(真机上太扎眼),改成三个低调但可辨的信号——中性底 + 强调色图标填实 + 分段底部 2px 指示条;悬停 / 按下改用底色变化,不再把整颗压暗;状态切换补 150ms 颜色过渡,系统开启「减弱动态」时保留 120ms 纯色淡变;高对比度模式改用系统高亮色
  • 设置面板收窄且可收起(#150):选内容 / 看效果两步的面板由 720px 收到 480px(两步仍同宽),标题栏新增「收起 / 展开」——收起后只剩一条标题栏,原本被面板挡住的页面元素可以直接点,草稿不丢;拖动抓手的常态底色与对比度提高,看得出能拖
  • 文案专项(#151):叫法统一、中英对齐、去口语化——说明文字里不再混用开关全称(全称只留给开关标签本身);「遮住整页 / 遮住整个页面」等几套叫法统一为「遮住这一页」;英文把 "Hidden items"(概念名)当数量单位的地方改回 "N items set to hide",「除了这类页面」统一为 "Except these pages";去掉「有人走过来时」「人走开了」「想收拾的网站」这类不专业说法;「编辑面板」「工具条」「现成的标题」等内部名词退出界面;同一句删除失败提示、同一句「标题不能留成空白」的坑提示各收成一份出处;删掉三个没人用的文案键

修复

  • 英文弹窗在「已设置」状态下会超过 Chrome 弹出的 600px 上限(英文说明比中文长),收紧卡片内边距后回到 588.9px

Changed

  • Popup rebuilt around four cards (#148): new and already-set-up sites share one layout, matching the floating button's four segments — ① mask card (switch plus “Title & icon” / “Hide items” side by side, primary action on the right) ② gray card ③ cover card (same card frame, but no switch inside: a button, the shortcut key, and one line saying the cover is temporary) ④ helper row (the floating-button switch, deliberately not a card). “View the guide” moved up next to the title; an unset site shows no fake switch but one plain sentence about what the switch will do; both edit entries are always clickable, whatever the switch says
  • Floating button's on state toned down (#149): the solid ink fill is gone (too loud on a real screen); the state now reads through three quiet signals — neutral fill, accent-coloured filled icon, and a 2px accent rule along the bottom of that segment. Hover and press change the background instead of dimming the whole button. State changes get a 150ms colour transition, kept at 120ms of plain colour fade under “reduce motion”, and high-contrast mode uses the system highlight colours
  • Setup panel narrower and collapsible (#150): the pick / check panel drops from 720px to 480px (both steps stay the same width), and its title bar gains Collapse / Expand — collapsed it is a single bar, the page underneath is clickable, and drafts are kept; the drag grip got a resting background and stronger contrast so it reads as draggable
  • Copy pass across the whole interface (#151): one name per thing, Chinese and English aligned, casual phrasing removed — explanatory text no longer reuses the switch's full label (that label is now the only place it appears); the several names for covering a page collapse into “Cover this page” / 「遮住这一页」; where English used “Hidden items” (a concept name) as a count it now says “N items set to hide”, and the scope option is “Except these pages”; 「有人走过来时」「人走开了」「想收拾的网站」 and their English counterparts are rewritten in plain professional language; internal names (“editor”, “toolbar”, “ready-made titles”) are gone from the interface; the delete-failure line and the “a title can't be blank” caveat each have a single source of truth now; three unused copy keys removed

Fixed

  • The English popup in the set-up state exceeded Chrome's 600px popup limit (English runs longer than Chinese); tightening the card padding brings it back to 588.9px

0.8.14

修复

  • 删掉这个网站的设置后,页面彻底回到原样:会话标记(这一页挂出过悬浮按钮)一并清掉——之后这个网站即便以「什么都没设置」的形态再出现,页面也不会莫名冒出悬浮按钮
  • 在弹窗里重新打开「悬浮按钮」,页面上真的会出现:从「关」拨到「开」是明确要求这一页有按钮,页面照办(此前刷新过页面再打开开关会出现「弹窗说开着、页面没按钮」)
  • 顺手修掉两处会偶发变红的测试断言(等胶囊真的出现再断言、圆点判断改成精确匹配)

Fixed

  • Deleting this site’s settings now clears the page completely: the keep-alive marker is dropped too, so the site coming back with nothing configured no longer makes a floating button appear out of nowhere
  • Turning “Floating button” back on in the popup really brings it back: switching from off to on explicitly asks for the button on that page, and the page complies (previously, after a reload the popup said “on” while the page had no button)
  • Two flaky test assertions fixed as well (wait for the button to actually appear; exact class matching for the step dots)

0.8.13

修复

  • 遮住/恢复之后悬浮按钮还在:会话保留(按钮在本次浏览期间不因设置清空而消失)现在按「这一页挂出过」判断,而不是「此刻按钮还在不在」——遮住整页与进设置向导都会临时收起按钮,按新判断它们返回时按钮会挂回来
  • 同族场景一并修好:关掉灰度后进设置向导、再退出,按钮同样会挂回来

Fixed

  • The floating button is back after covering and restoring: the keep-alive rule now asks “did this page ever show it” instead of “is it on screen right now” — covering the page and opening the wizard both take the button down for a moment, and it now comes back when they close
  • The same fix covers the sibling case: unchecking gray, opening the wizard and closing it again keeps the button in place

0.8.12

修复

  • 向导选同类:取消勾选不再弄丢导航——勾了两组同类时,取消其中一组(哪怕不是亮着的那组),另一组的「第 i / N 个」导航不再消失;换组瞬间强调框也不再闪现在上一组成员上
  • 同类号牌的定位标记不再被文案污染:位置号牌「第 i / N 个」用固定标记,不影响其他测试按号牌前缀统计
  • 向导遮罩预览所见 = 保存所得:预览遮罩底色改用与运行时同一套算法(按被遮元素背后的实际底色计算、圆角跟随),不再硬编码灰色——深色或彩色页面上预览不再与保存后不一致
  • 悬浮按钮的图标钮补上读屏名称:面具主钮与「媒体」钮此前只靠悬停提示当名称(部分读屏不播报),与「遮住」钮统一
  • 填实(开启)状态补悬停/按下反馈:设计规范要求五种状态缺一不可,此前只有关着的状态有
  • 失效项按钮统一叫「重新选一次」:与失效提示、GLOSSARY 同一套叫法;向导文字链命中区垫到 24px
  • 文案:自动播放的视频「被按住」改说「会暂停」;欢迎页第 3 步不再引入「媒体」这个要学的叫法(直接说图片图标);「盖住」统一为「遮住」;选内容的取消动作统一为「取消选中」(GLOSSARY 登记)

Fixed

  • Wizard: unchecking one group no longer kills the other group's navigator; the highlight no longer flashes on the previous group when switching
  • The position badge no longer leaks localized text into its test id
  • Wizard mask preview now matches what saving produces: the preview tint uses the same color logic as the runtime masks (computed from the real background, following the element's radius) instead of a hardcoded gray
  • The floating button's icon buttons have screen-reader names now, consistent with the cover button
  • The filled (ON) state has hover/pressed feedback, completing the five required states
  • The stale-row button is now uniformly “Pick again”, matching the stale hint and the glossary; text links in the wizard get a 24px hit area
  • Copy: autoplaying videos are “paused” (not “held down”); the welcome page no longer introduces a second name for the gray switch; “cover” unified to the product verb; deselection wording unified

0.8.11

变更

  • 欢迎页分步单屏:一次只显示一步,内容列放宽到 720px,常态不用滚动;第 2 步补上「图片和视频变灰」的介绍(共四件事),第 3 步按最新胶囊形态重写
  • 弹窗新增「重看插件介绍」:在弹窗底部,随时能回看
  • 向导选内容时同类可逐个查看:勾上「另外 N 个一样的也一起收起」后,行内出现「第 i / N 个」和「上一个 / 下一个」,页面上当前成员用实线框标出并自动滚到视野中央;整组虚线框保留
  • 向导面板定宽:选内容与看效果两步面板宽度不再随内容变来变去

修复

  • 欢迎页与插件功能的同步加了一份守门测试:以后加新功能,欢迎页文案没跟上会直接挂测试

Changed

  • The welcome page now shows one step per screen: the content column widens to 720px and fits without scrolling; step 2 now introduces “Turn pictures & videos gray” (four things in all), and step 3 matches the current floating button
  • “See the intro again” in the popup: the intro is reachable at any time from the popup footer
  • Step through similar matches in the wizard: after checking “Also hide the other N like this one”, the row shows “i of N” with Previous / Next; the current match on the page gets a solid highlight and is scrolled into view, while the dashed group outline stays
  • Stable wizard width: the panel no longer resizes as rows appear during picking

Fixed

  • A guard test now keeps the welcome page in sync: adding a feature without updating the intro fails the tests

0.8.10

变更

  • 面具卡:「按你的设置显示」开关成为卡片头部(带与悬浮按钮主钮同源同态的面具图标),卡内是「收起内容」与「标题和图标」两颗钮——看一眼就知道这颗开关管着哪两件事
  • 开关关着时,卡内两颗钮置灰暂不可用,卡底一行说明「打开开关就能改」(iOS / Windows 设置的通行做法)
  • 灰度卡与悬浮按钮卡:「图片和视频变灰」「悬浮按钮」也换成同一款卡片容器,三张卡一个样子
  • 卡片分组不改任何行为:开关怎么拨、按钮进哪个流程、设置存在哪,全都和之前一样

Changed

  • The mask card: the "Show this site your way" switch now heads a card (with the same mask icon as the floating button's main button), and "Hide items" / "Title & icon" sit inside it — the popup now shows what that switch governs at a glance
  • With the switch off, the two buttons inside are paused and a one-line hint says turning the switch back on lets you edit (the usual iOS / Windows settings pattern)
  • Matching cards: "Turn pictures & videos gray" and "Floating button" use the same card container — one look across the panel
  • Pure regrouping: switches, flows and storage behave exactly as before

0.8.9

变更

  • 主按钮换威尼斯面具图标:横长圆润轮廓 + 两道弯眼缝,与产品名 PageMask 对应——旧版实心蛋形加两只小圆眼在 13px 下像骷髅/头套剪影,装机反馈「太吓人」;填实态眼缝镂空,读得出「面具」
  • 开关状态整钮填实:功能开着 = 那颗钮整颗变成墨色底、图标反白(iOS 控制中心同类做法);关着 = 透明底描边,比开着明显低调。开/关不再只靠 13px 图标内部的填实差异来猜
  • 对比发生在胶囊自己的墨底/白底上,任何网页底色下都看得清(深浅主题反色对 ≥11:1)

Changed

  • The main button is now a venetian mask icon: a rounded, horizontal outline with two curved eye slits, matching the PageMask name — the old solid egg shape with two dot eyes read like a skull at 13px and users called it scary; the filled state keeps the eye slits hollow so it still reads as a mask
  • Switch states now fill the whole button: a feature that is ON turns its button into a solid ink chip with an inverted icon (like iOS Control Center); OFF is an outlined icon on transparent background, clearly quieter than ON. You no longer have to guess from fill differences inside a 13px icon
  • The contrast happens on the capsule's own ink/white surfaces, so it stays readable over any web page (inverted pair ≥11:1 in both themes)

0.8.8

变更

  • 拖动不再需要把手:按住悬浮按钮的任何位置拖动即可移动——按下后移动超过 8 像素才算拖动,不足就是正常点击,按钮不会误触(与 iOS 辅助功能的悬浮球同类做法);拖动把手整段退场,静止宽度 126 → 约 101 像素,高度 26 不变(无障碍下限)
  • 键盘移动保留:Tab 聚焦到按钮本体后用方向键移动(每次 15 像素),位置照旧按网站记住、拖动越界自动收回视口内
  • 触屏补齐:主按钮在触屏上与其他图标钮一样放大到 40×40(0.8.6 起它漏在放大档外)

Changed

  • No more drag handle: press and drag the floating button anywhere to move it — moving more than 8px after pressing counts as a drag, less is a normal click, so buttons never misfire (the same approach as iOS AssistiveTouch); the handle segment is gone, resting width shrinks from 126 to about 101px, height stays 26 (the accessibility floor)
  • Keyboard moving stays: Tab to the button body and use arrow keys to move it (15px per press); position is still remembered per site and drags are clamped back into the viewport
  • Touch catch-up: on touch screens the main button now enlarges to 40×40 like the other icon buttons (it was missing from that tier since 0.8.6)

0.8.7

修复

  • 「只灰度」网站在胶囊上关掉灰度,悬浮按钮不再当场消失:胶囊挂载判据只在页面加载时评估;会话中间把最后一项设置关掉(胶囊或弹窗均可),已经挂着的按钮当页保留——页面上始终有入口能拨回来;刷新后按判据该藏就藏。「删除这个网站的设置」仍然立即清理页面

Fixed

  • Turning gray off from the floating button no longer removes the button itself on gray-only sites: the mount check now runs only when the page loads. Clearing the last setting mid-session (from the button or the popup) keeps the mounted button for the rest of the page visit, so there is always an entry point to switch back; after a reload the usual visibility rule applies. "Delete this site's settings" still clears the page right away

0.8.6

变更

  • 主按钮换成面具图标:填实=按你的设置显示、描边=原样;不再用「圆点+文字」
  • 单一形态:mini 形态、折叠钮与文字标签退场,⋯ 菜单常驻——原来的 mini 用户因此获得拖动与菜单
  • 位置自由定位:不再限制在浏览器两侧,窗口变化自动夹回视口
  • 拖动把手悬停才出现(触屏常显),静止时少一颗钮

Changed

  • The main button is now a mask icon: filled = "Your settings", outline = "As is"; the dot + label pair is retired
  • One single form: the mini form, collapse button and text label are gone, and the ⋯ menu is always at hand — former mini users gain dragging and the menu
  • Free positioning: the button is no longer confined to the browser's sides; window changes snap it back into the viewport
  • The drag handle appears on hover only (always visible on touch), so the resting button carries one less piece

0.8.5

新增

  • 弹窗在还没设置过的网站上直接提供灰度开关:打开它会像第一次设置一样申请这个网站的访问权限,然后 PageMask 补一份只带灰度的配置、当前页面立即变灰、悬浮按钮挂载——收起的内容和标签页标题图标一概不碰
  • 这类「只灰度」站点的主按钮暂无可视效果(收起与标题图标都为空),属已知形态;之后通过向导添加收起或标题后照常生效

Added

  • The popup offers the gray switch on sites that have never been set up: turning it on asks for that site's access, first-time-style; PageMask then creates a profile that carries only the gray setting, and the current page turns gray right away with the floating button mounted — nothing about hidden elements or the tab title is touched
  • Such gray-only sites show a main button without a visible effect yet (nothing but the gray is configured) — a known shape; adding rules or a title via the wizard later works as usual

0.8.4

修复

  • 原样态+灰度的首帧遮挡按时撤掉:切「原样」时首帧遮挡会换成灰度样式文本,之前落地后没显式撤、靠 1.5 秒兜底超时——极端情况下刷新后立刻进向导,向导里页面会先发灰再突然恢复。现在与清爽态路径对称,正式样式落地即撤

Fixed

  • The first-paint shield is released on time in "As is" + gray: switching to "As is" swaps the shield to the gray stylesheet text, but it was never explicitly released — it relied on a 1.5s fallback. In the worst case, opening the wizard right after a reload showed a gray-tinted page that suddenly regained color. Now symmetric with the "Your settings" path: the shield is released as soon as the formal styles land

0.8.3

变更

  • 主开关收窄:「按你的设置显示 / 原样」现在只管两件定制——收起的内容、标签页标题和图标。切「原样」= 把你收起的正经内容还给你、标签页回到本来的样子
  • 灰度独立:图片和视频的变灰按自己的开关走,原样态下照常生效——恢复正经内容的时候,页面该低调还是低调;胶囊「媒体」钮在任何状态下按下都有可见反应
  • 胶囊顺序:媒体钮挪到遮住钮前面(全功能与 mini 相同)——媒体是随看随切的高频状态,遮住是应急动作,离主按钮最远
  • 媒体钮开启态图标:只填实框里的山和太阳、外框保持描边(此前整颗填实会糊成一个方块);弹窗开关行的小图标同步同一套状态
  • 灰度的说明文案改为讲独立(不再有「只在按设置时起作用」句)

Changed

  • The main switch is narrowed: 「按你的设置显示 / 原样」 ("Your settings" / "As is") now governs exactly two customizations — what's hidden and the tab title & icon. "As is" gives you back the parts you hid and the site's own title
  • The gray switch is fully independent: pictures and videos follow their own switch and stay gray in either state — restoring the real content no longer drags the gray along, and the capsule "Media" button always has a visible effect
  • Capsule order: the Media button now sits before the Cover button (both forms) — a frequently flipped state belongs near the main button, the emergency action farthest away
  • Media button's on-state icon: only the mountain and sun inside the frame are filled while the frame keeps its stroke (the fully-filled version read as a plain square); the popup's row icon follows the same state
  • The gray switch's hint copy now describes its independence

0.8.2

修复

  • 扩展更新后的静音清扫覆盖未配置的站点:一次性幕布页不在内容脚本重注入范围内,它的残留静音之前要等到下一次导航才解除;现在更新 / 重载时对所有标签页清扫一遍(只解除本扩展设的那份)
  • 放行记录随容器子树移出也清掉:信息流把整张卡片换掉时,卡片里放行过的视频同样不再被内部记录钉住(补子树分支的回归单测)
  • 幕布静音的导航兜底与遮 / 撤消息确认共用同一条队列(补交错回归单测)

Fixed

  • The update-time mute sweep now covers unconfigured sites: a one-shot curtain page is not in the content-script reinjection range, so its leftover mute used to wait for the next navigation; updates and reloads now sweep every tab (only the extension's own mute is removed)
  • Allow records clear with the subtree: when a feed swaps out a whole card, a video the user unblocked inside it is no longer pinned by the internal record (regression test for the subtree branch added)
  • Regression tests for the navigation fallback sharing the same per-tab queue as cover / restore messages

0.8.1

修复

  • 放行过的视频被信息流移出文档后不再被钉住:内部记录会随元素移出页面一并清掉;同一个视频再插回来按新一轮算,超出去过的点击窗口后自动播放重新被压制(补回归单测)
  • 快速连按遮住 / 恢复不再留下哑掉的标签页:同一标签页的静音写入改为按消息到达顺序串行执行,连发时最终状态 = 最后一条消息的方向(补三连发回归单测)
  • 扩展更新 / 重载瞬间不再残留静音:上一个实例在幕布静音中失效时它的解除消息发不出去;新实例启动时补一次单向解除(只解除本扩展设的那份)
  • 测试稳定性:滚动跟手断言由固定两帧改为「3 秒内追上」,不再因 scroll 事件与动画帧的先后抖动而误报

Fixed

  • A video you unblocked is no longer pinned after the feed removes it: the internal record is cleared together with the element leaving the page; if the same video element comes back it starts a new round, and autoplay is held again once your click window has passed (regression test added)
  • Rapid cover / restore no longer leaves a muted tab behind: mute writes for one tab now run serially in message order, so the final state always matches the last message (regression test added)
  • No mute residue across extension updates / reloads: when the previous instance dies under the curtain its unmute message dies with it; the new instance releases any leftover of ours when it starts
  • Test stability: the scroll-follow assertion now waits up to 3 seconds instead of a fixed two frames, so it no longer misfires on scroll-event / animation-frame jitter

0.8.0

新增

  • 图片和视频变灰:一个按网站记的开关。图片和视频变成黑白的,位置不变、大小不变、链接还能点、截图里的字还能看清——整个页面从花花绿绿降到像一篇图文资料;≤32px 的小图标与表情保持原样。声音完全不参与:音量归播放器自己的按钮和 Chrome 右键标签页「静音网站」
  • 自动播放的视频被按住:站点自己让视频播起来的(X 刷信息流那种自动播放)一律按停,页面上没有会动的东西;你点击某个视频区域,那一个视频就放行正常播放,画面保持黑白。被按停的视频不替网站恢复播放
  • 遮住这一页连声音一起按住:幕布遮住哪个标签页就静哪个标签页,恢复(或刷新、离开页面)时声音跟着回来;只解除本扩展设的那份静音,你自己用 Chrome 右键或播放器静音的不受影响。没添加过的网站用弹窗遮住,同样连声音一起遮
  • 胶囊上的「媒体」钮:全功能与 mini 形态都有,一点就变灰 / 还原;弹窗一行开关、站点设置页「图片和视频」卡,三处是同一组设置。弹窗重排:「遮住这一页」带上与胶囊同源的闭眼 / 睁眼图标、媒体开关行带上媒体图标

变更

  • 0.7.x 的「收起图片 / 收起视频 / 静音网页」三个开关退场:原来开着收起图片或收起视频的网站,升级后自动等于「图片和视频变灰」开着;「静音网页」的常设开关不再提供——想让某个网站一直没声,用 Chrome 自带的右键标签页「静音网站」(按域名持久)。悬浮按钮「⋯」菜单里的媒体三行随之移除

说明

  • 「变灰」只是去掉颜色:图片 / 视频请求照发,不省流量、不代替广告过滤工具;CSS 背景图、iframe 内嵌播放器、<canvas>、内联 SVG 不变灰
  • 不新增权限:黑白观感是一条样式表,幕布静音用 Chrome 自带的标签页静音(不需要 tabs 权限,只解除本扩展设的那份)

Added

  • Turn pictures & videos gray: one per-site switch. Pictures and videos turn black & white — same place, same size, links still work, text in screenshots stays readable — and a loud feed reads like a quiet article; icons and emoji up to 32px stay as they are. Sound is not touched at all: volume belongs to the player's own button and Chrome's "Mute site"
  • Autoplaying videos are held down: videos the site starts by itself (a scrolling feed on X, for example) are paused, so nothing on the page moves; click a video and that one plays normally, still in black & white. Videos we paused are not resumed for the site
  • Covering a page holds its sound: the tab under the curtain is muted; uncovering, reloading or leaving the page brings the sound back. Only the mute this extension set is removed — a mute you set via Chrome or the player is untouched. It works on sites you have not added too (cover from the popup)
  • A "Media" button on the floating capsule: both the full and mini forms have it — one click turns the gray on or off. The popup gets one switch row and the site's settings page a "Pictures & videos" card, all the same setting. The popup is re-laid out, and its "Cover this page" button and gray switch now carry the same icons as the capsule

Changed

  • The 0.7.x "Hide images / Hide videos / Mute this page" switches are retired: a site that had hiding enabled automatically becomes "gray" after the update; the always-on mute switch is gone — to keep a site silent, use Chrome's own right-click "Mute site" (persistent per site). The floating menu's three media switches are removed accordingly

Notes

  • "Gray" only removes color: image and video requests still happen — not a data saver, not an ad blocker; CSS background images, embedded players inside iframes, <canvas> and inline SVG are not grayed
  • No new permissions: the black & white look is one stylesheet, and the curtain mute uses Chrome's own tab mute (no tabs permission; only the extension's own mute is ever removed)

0.7.1

修复

  • 删掉某个网站的设置,不会把别的标签页重新静音:此前手动取消过静音的标签页,删除别的网站时不再被按回去;只解除本扩展设置、且按当前设置已经不该继续静音的那一份
  • 收回站点权限、整体导入替换设置时也不留哑掉的标签页:这两条删除类路径现在和「删除这个网站的设置」一样收尾
  • 小图标判定更稳:一律按页面上实际显示的尺寸算;还没排好版时宁可先灰一帧,等图片加载完或样式变了再重判,写着小尺寸、实际被放大的大图不会再漏出来
  • 视频被替换、开关反复拨动、播放器在页面里挪位置都能正确还原:挪位置不再被当成移除,静音不会闪断;关掉开关时放回这一轮开始前的声音状态
  • 图片加载完立刻重判:懒加载的小图标不再一直灰着,不必等页面上恰好还有别的变动
  • 界面与商店材料的小处收口:讲整组开关的那句话和每行的说明分开、菜单未选中项也有看得见的空框、三处开关分组让读屏软件认得;商店材料如实写明会读取标签页地址、菜单默认项数与实际一致

Fixed

  • Deleting one site's settings no longer re-mutes other tabs: a tab you had manually unmuted is no longer muted again when you delete a different site. PageMask only removes the mute it set itself when the current settings no longer call for it
  • No muted tabs left behind when site permission is revoked or an import replaces all settings; both paths now clean up the same way as deleting a site's settings
  • Small-icon detection is more reliable: it always uses the size actually shown on the page. Until an image is laid out it stays grey for a frame, then re-checks after loading or a style change, so a large image declared as 16×16 cannot slip through
  • Videos restore correctly when replaced, when switches are flipped repeatedly, and when a player is moved around the page. Moving a player is no longer treated as removal, so sound does not flicker back; turning a switch off restores the sound state from the start of that round
  • Images are re-checked as soon as they load: lazy-loaded small icons no longer stay grey until something else happens to change the page
  • Interface and store-listing polish: the note about the whole group is separated from the per-switch notes, unselected menu items show a visible empty box, all three switch groups are announced properly by screen readers, and the store listing now states accurately that tab URLs are read and matches the menu's real item count

0.7.0

新增

  • 收起图片:网页上的图片变成灰块,位置不变、链接还能点,按钮上的小图标与表情保持原样。这是「看起来收起」,图片请求照发,不省流量、不代替广告过滤工具
  • 收起视频:视频变成灰块,并且暂停、不出声。网站脚本反复调播放也会被按住;切回原样时只把声音放回改动前的状态,不替网站恢复播放
  • 静音网页:用 Chrome 自带的标签页静音让这个标签页不出声,画面照常,标签页上会出现静音的小喇叭。只解除本扩展设置的那一份静音,不动你手动静音、Chrome 自带的「静音网站」或其他扩展设置的静音
  • 三处入口,同一组设置:站点设置页新增「图片、视频和声音」卡片(每行一句说明),弹窗底部收成一组三行,悬浮按钮「⋯」菜单新增一组带勾选标记的开关(点一下不关菜单,可以连着拨几个)。改哪一处,另两处和页面效果都跟着变
  • 原样态连声音一起还原:切「原样」会把灰块、视频停播、标签页静音一并还原;切回「按你的设置显示」重新生效。删除这个网站的设置也不会留下哑掉的标签页
  • 不新增权限:标签页静音走浏览器自己的开关,不需要 tabs 权限;没有拦请求、没有新增主机权限。已知边界写进界面说明、README 与商店材料

Added

  • Hide images: pictures turn into grey blocks that stay in place with their links still working; small icons on buttons and emoji are left alone. This changes only what you see — image requests still happen, so it is neither a data saver nor an ad blocker
  • Hide videos: videos turn into grey blocks, pause and go silent. Repeated calls to play by the site's own scripts are held back too. Switching back restores the previous sound state rather than resuming playback for the site
  • Mute this page: uses Chrome's own tab mute so the tab makes no sound while the picture stays as it is (Chrome shows a muted speaker icon on the tab). PageMask only removes the mute it set itself and leaves your own mute, Chrome's "Mute site" and other extensions' mutes alone
  • Three places, one set of settings: a "Pictures, videos & sound" card on the site's settings page (a plain-language note under each switch), a compact three-row group at the bottom of the popup, and a group of ticked switches in the floating button's "⋯" menu (which stays open so you can flip several). Change any one of them and the other two and the page follow
  • "As is" brings the sound back too: switching to the original view restores the grey blocks, the paused/silenced videos and the tab mute together; switching back applies them again. Deleting a site's settings does not leave a muted tab behind
  • No new permissions: tab mute uses the browser's own switch and needs no tabs permission; no requests are blocked and no host permission was added. The limits are spelled out in the interface, the README and the store listing

0.6.7

变更

  • 「右下角的小按钮」改叫「悬浮按钮」:原来那个是位置描述,不像个名字。弹窗开关、插件设置的卡片标题、欢迎页第 3 步同步改(#124)
  • 两个管理页的互跳入口对齐:都在页面标题行右侧、同一个次要按钮(有边框、深色字),插件设置页顶部不再另放一条「← 全部网站设置」(#124)

修复

  • 「插件设置」入口的字色是蓝的:链接做成按钮时,全局的链接色盖住了按钮文字色;补一条 a.button 的字色,现在和旁边的按钮同色(#124)

Changed

  • "The small button in the corner" is now "Floating button": the old label described where it sits instead of naming it. The popup switch, the settings card and the welcome step all use the new name (#124)
  • The two management pages now link to each other the same way: same secondary button in the title row on the right; the settings page no longer has a separate "← All site settings" link at the top (#124)

Fixed

  • The "Extension settings" link was blue: the global link colour overrode the button's text colour when a link is styled as a button; a.button now keeps the button colour (#124)

0.6.6

修复

  • 「看效果」那一屏太挤:面板最大宽度 560 → 720,正文字号不变但一行放得下「名字 / 范围 / 调整 / ✕」;左右内边距恢复到 16——上批把内边距挪到标题栏时连左右一起挪走了,文字会顶到面板边缘(#123)
  • 拖动工具条不再贴死视口边缘:四边至少留 16,视觉上不再是「被截断」(#123)

变更

  • 「退出设置」按钮每次都先问一次:0.6.4 起整条标题栏可拖,按在按钮上不拖动、松手就是一次点击,误触一次这次选的内容全没;现在无论有没有改动都会确认,没改动时说明「这次还没有未保存的改动」。Esc 仍然只在真有未保存内容时才问(#123)

Fixed

  • The "see how it looks" panel was cramped: max width 560 → 720 so the four columns (name / scope / adjust / remove) fit on one line, and the body's horizontal padding is back to 16 — the previous release moved the padding onto the title bar and took the left/right padding with it, so text ran to the panel edge (#123)
  • Dragging the toolbar no longer pins it to the viewport edge: it keeps a 16px gap on all sides (#123)

Changed

  • "Exit setup" now always asks once: since 0.6.4 the whole title bar is draggable, so a slightly-off press lands as a click and throws away the current picks; the confirmation now appears whether or not anything changed, and says so plainly when nothing is unsaved. Esc still only asks when there is unsaved work (#123)

0.6.5

修复

  • 10 个内置图标改成同一套画法:统一描边粗细、统一字形框、圆头圆角,只有细节点缀用实心。此前一半是描边、一半是实心,凑成一排不像一套(#121)
  • 图标选中态不再只靠颜色:选中的那一格右上角多一枚勾选角标,色弱用户也分得出选的是哪一个(WCAG 1.4.1,#121)

Fixed

  • The 10 built-in icons now share one drawing system: same stroke weight, same glyph box, rounded caps and joins, with fills only for small details. Previously half were outlines and half were solid — side by side they didn't read as a set (#121)
  • The selected icon no longer relies on colour alone: the chosen tile gets a check badge in its top-right corner, so colour-blind users can still tell which one is picked (WCAG 1.4.1, #121)

0.6.4

修复

  • 页内浮层在白底网页上分不出边界:向导工具条与确认框原来只有一层几乎看不见的阴影,白底上等于没有边界;现在有 1px 描边 + 近 / 中 / 远三层阴影,系统强制颜色模式下也有边(#118)

新增

  • 向导工具条的整条标题栏都能拖:按在标题、进度或空白处都能移动,按钮照常点击;把手可点区从 24 加到 32(触屏 44),图形不变(#119)
  • 小胶囊「⋯」菜单多了「调整不透明度」:点了直接打开插件设置的不透明度那一栏,滚到卡片、焦点落在滑杆上(#120)
  • 标签页图标改成三选一:网站原来的图标 / 不显示图标 / 换成内置的 10 个图标——不用再自己找图上传(#121)

变更

  • 插件设置里不再有「默认图标」:图标三态之后它没有要解决的问题(#121)
  • 只换标题、不动图标的网站,标签页上会保留网站自己的图标(#121)
  • 遮住整页时标签页图标固定为空白,不跟着站点设置走;撤掉幕布后换回该站自己选的那一张(#121)

文档

  • README 新增「升级:换版本不丢设置」:固定目录覆盖 + 刷新,别卸载(#122)

Fixed

  • In-page panels no longer disappear into white pages: the wizard toolbar and dialog had only a barely visible shadow; they now have a 1px border plus near / mid / far shadows, and keep an edge in forced-colors mode (#118)

Added

  • The whole title bar of the wizard toolbar is draggable: press the title, the step text or empty space to move it — buttons still click normally; the grip's hit area went from 24 to 32 (44 on touch) with the artwork unchanged (#119)
  • The small button's ⋯ menu gained "Adjust opacity": opens the extension settings on the opacity card, scrolls to it and focuses the slider (#120)
  • Tab icon is now a three-way choice: the site's own icon / no icon / one of 10 built-in icons — no more hunting for image files (#121)

Changed

  • The default-icon setting is gone: the three-way choice leaves it nothing to do (#121)
  • Sites that only change the title now keep the site's own tab icon (#121)
  • Covering a page always uses a blank tab icon regardless of the site's choice, and restoring brings back the icon that site picked (#121)

Docs

  • README gained "Upgrading without losing your settings": overwrite the same folder and hit reload, don't remove (#122)

0.6.3

修复

  • 向导开着时弹窗不再报「没能遮住」:页面控制器拒遮(向导正开着)时不再触发重新注入——重新注入会把用户正开着的向导关掉(#115)
  • 一次遮住请求不再可能被两个控制器互相推让掉:控制器接口补「遮住进行中」标记,接管方据此把这次请求接住补遮(#115)
  • 「遮住」报成功更严谨:注入后的回查避开一次性脚本还在加载的窗口(等一拍重查);毫秒级的「读配置还没读完」窗口也并入「遮住进行中」(#115)
  • 删除确认框关闭后焦点不再被菜单的收起事件拽走;列表「⋯」快速点两行不再可能报错(#115)

变更

  • 表单与视觉细节:向导和胶囊面板的标题输入也不再触发密码管理器;弹窗底部链接文字颜色与按钮一致;欢迎页示意图显式不可点;单选行间距与命中区补齐;清理不再使用的文案键(#115)

Fixed

  • The popup no longer reports "couldn't cover" while the wizard is open: when the page controller refuses (the wizard owns the page), the fallback no longer re-injects — which would tear down the user's open wizard (#115)
  • A cover request can no longer be dropped between two controllers: the controller interface gained a "covering in progress" flag so the adopting controller picks up and completes the request (#115)
  • "Covered" reporting is stricter: the post-injection check waits out the one-shot script's module load; the millisecond window while it reads storage now also counts as "in progress" (#115)
  • Focus is no longer yanked out of the delete dialog by the menu's collapse event; clicking "⋯" on two list rows quickly can no longer throw (#115)

Changed

  • Form and visual details: the wizard and capsule-panel title inputs no longer trigger the password manager; popup footer links use the same text colour as buttons; the welcome-page artwork is explicitly non-interactive; radio rows got back spacing and hit-area padding; an unused copy key was removed (#115)

0.6.2

修复

  • 删除确认框可能被跳过:弹窗里的删除失败过一次后,再按 Esc 关闭确认框会被当成「确认」,直接再次删除。现在与站点设置页同一口径,关闭即复位(#114)
  • 遮住功能可能在一个标签页里永久失效:极少数时序下(页面注入与启用站点赛跑),一次性脚本会静默退位却留下「初始化中」标记,之后这个标签页再也遮不上。修复退位路径,标记总会复位(#114)
  • 遮住/恢复的状态更可信:幕布遮住后注入不再假报成功(注入后回查一次);弹窗的「恢复」不再拿打开时的旧状态比对(期间页面可能已被别处改过)(#114)
  • 列表「⋯」菜单快速点两行不再报错;弹窗底部两个入口变成真链接,中键 / Cmd+点击也能开新标签页(#114)

变更

  • 表单细节:标题输入框不再触发密码管理器(autocomplete=off,三处);单选行点击区没有死区;返回链接与所有链接悬停有反馈;长域名标题换行不出孤行(#114)
  • 真站冒烟脚本跟上 #98 的行为(只收起内容不改标签页标题),微信读书 / 得到 / 墨问重跑全绿(#114)

Fixed

  • The delete confirmation could be skipped: after one failed delete in the popup, pressing Esc on the dialog was treated as confirmation and deleted again. It now resets on close, same as the site settings page (#114)
  • Covering could permanently fail in a tab: in a rare race (one-shot injection vs. enabling the site), the one-shot script bowed out but left an "initializing" flag behind, after which that tab could never be covered. The bow-out path now always resets the flag (#114)
  • Cover state is more trustworthy: injection now verifies the curtain is really up before reporting success; the popup's "Restore" no longer compares against a snapshot taken when the popup opened (the page may have changed meanwhile) (#114)
  • Clicking "⋯" on two list rows quickly no longer errors; the two popup footer entries are real links now — middle-click / Cmd+click open them in a new tab (#114)

Changed

  • Form details: title inputs no longer trigger the password manager (autocomplete=off, three places); radio rows have no dead zones; the back link and all links show hover feedback; long hostnames don't leave orphan lines when wrapped (#114)
  • The real-site smoke script now matches #98 (content-only sites keep their tab title); re-run green on weread / dedao / mowen (#114)

0.6.1

修复

  • 幕布三处入口(胶囊 / 弹窗 / 快捷键)现在互相认账:以前页面上可能同时有两套幕布控制器,「遮 → 撤 → 再遮」第三次会失灵。现在每个页面只有一个控制器,任何一处遮住、另外两处都能恢复;没添加过的网站也能反复遮 / 撤(#107)
  • 欢迎页在矮窗口里显示不全:窗口只有几百像素高时,底栏压住第 2 步卡片、切步也不滚动。现在滚动只发生在内容区,底栏固定在底部;切「下一步」自动把当前步骤带进视野,读屏同步播报当前步(#108)

变更

  • 胶囊收到 WCAG 允许的最小尺寸:高 32 → 26,全功能宽 170 → 164、mini 宽约 80 → 74;可点区仍是 24×24,触屏仍 40×40。不做大小档——现在就是上限(#109)
  • 不透明度改成 10%–100% 的滑杆:原来的三档(100% / 85% / 70%)换成一档 10% 的滑杆,拖动即时预览、松手保存;鼠标移上去、键盘选中或拖动时立刻恢复全清楚。旧设置里的三档自动迁移(清晰 → 100%、淡一点 → 90%、很淡 → 70%)(#110)

新增

  • 「右下角的小按钮」可以按网站关掉:插件弹窗里一个开关,关掉后这个网站不显示胶囊;再打开时胶囊回到右下角、完整形态。关掉不影响收起规则、标题和图标、遮住整页的快捷键(#111、#112)
  • 弹窗里能删除这个网站的设置:藏在弹窗最底部的红字入口,二次确认后删除配置、收回权限——胶囊被藏起来之后,删除从这里仍然够得着(#112)
  • 「全部网站设置」列表可以逐行删除:每行行尾一个「⋯」菜单,点开就是「删除这个网站的设置」;不用再先进详情页。确认框与详情页是同一个,不加编辑按钮、不做多选(#113)

Fixed

  • The three curtain entries (capsule / popup / shortcut) now agree with each other: two curtain controllers could coexist on a page, so cover → restore → cover again failed on the third press. There is now exactly one controller per page; covering from any entry can be undone from any other, and unadded sites can be covered and restored repeatedly (#107)
  • The welcome page was cut off in short windows: with a few hundred pixels of height the bottom bar covered step 2 and switching steps didn't scroll. Scrolling now happens only in the content area with a fixed bottom bar; moving to a step brings it into view and a screen-reader announcement follows (#108)

Changed

  • The capsule shrunk to the smallest size WCAG allows: height 32 → 26, full width 170 → 164, mini width ~80 → 74; hit areas stay 24×24 (40×40 on touch). No size presets — this is the ceiling (#109)
  • Opacity is now a 10%–100% slider: the three presets (100% / 85% / 70%) became a slider with 10% steps, previewing instantly and saving on release; it turns fully clear on hover, keyboard focus or drag. Old presets migrate automatically (Clear → 100%, Softer → 90%, Faintest → 70%) (#110)

Added

  • The small button in the corner can be turned off per site: a switch in the popup hides the capsule on that site; turning it back on restores the capsule at the bottom-right corner in full form. Hiding doesn't affect hide rules, the title and icon, or the cover shortcut (#111, #112)
  • The popup can now delete a site's settings: a red text entry at the very bottom with a confirmation — reachable even when the capsule is hidden (#112)
  • The site list supports per-row deletion: each row ends with a "⋯" menu containing "Delete this site's settings" — no need to open the details page first. Same confirmation dialog as the details page; no edit button, no multi-select (#113)

0.6.0

新增

  • 幕布快捷键:默认 Ctrl+Shift+X(Windows)/ ⌘+Shift+X(Mac),按一下遮住整页、再按一下恢复;没添加过的网站也能遮。全产品只有这一条快捷键(#101)
  • 胶囊不透明度三档:清晰 / 淡一点 / 很淡(0.6.1 起改为 10%–100% 滑杆),只调它闲着的时候有多淡,一碰就恢复清楚(#102)

变更

  • 只改保存过「标题和图标」的网站:只收起内容的网站不再被顺手改掉标签页标题(#98)
  • 保存过标题的网站可以恢复原样:站点设置页里一键还原网站自己的标题和图标,收起的内容不动(#99)
  • 向导同类组统一用描边:删掉 1.1 / 1.2 子号牌,组与组的边界一眼可辨(#100)
  • 欢迎页改用真实组件:三步三功能,示意图就是真的弹窗与胶囊,不会再过期(#103)
  • 新插件图标:一副歪着放在纸上的面具,16px 起每一档都单独核对(#104)

Added

  • Curtain keyboard shortcut: Ctrl+Shift+X (Windows) / ⌘+Shift+X (Mac) by default — press to cover the page, press again to restore; works on unadded sites too. This remains the product's only shortcut (#101)
  • Capsule opacity presets: Clear / Softer / Faintest (replaced by the 10%–100% slider in 0.6.1) — only how faint it sits when idle, instantly clear on touch (#102)

Changed

  • Only sites with a saved title and icon get renamed: sites that only hide content no longer have their tab title changed as a side effect (#98)
  • Saved titles can be restored: one click in the site settings puts back the site's own title and icon without touching hidden content (#99)
  • Wizard groups share one outline: the 1.1 / 1.2 sub-badges are gone; group boundaries read at a glance (#100)
  • The welcome page renders real components: three steps, three features — the artwork is the actual popup and capsule, so it can't go stale (#103)
  • A new extension icon: a mask resting tilted on a page, verified at every size from 16px up (#104)

0.5.5

修复

  • 密行里的号码牌归属不明:在 24 像素高的列表行上,号码牌浮在元素上方、视觉上落在上一行里——看着像上一行的编号,同组最后一行像漏了牌子。密行的号码牌现在放在该行左侧、与该行同高,归属一眼确定,也不遮行首文字;够高的卡片与横幅维持原样
  • 测试脚本加固:真站冒烟/真机脚本在无头浏览器里动画帧不触发时不再整条崩掉

Fixed

  • Badges were ambiguous in dense rows: on a 24-pixel list row the badge floated above the element and visually landed in the previous row — it read as that row’s number, and the last member of a group looked like it had none. Dense-row badges now sit to the left of their row, aligned with it, so ownership is obvious and the row’s text stays clear; taller cards and banners are unchanged
  • Test scripts no longer crash when animation frames don’t fire in a headless browser

0.5.4

修复

  • 全功能胶囊拖动被钉在右缘:上一版重构位置逻辑时删掉了「拖动中跟手」分支——右半视口里拖动只能上下滑。现在拖动全程跟手,松手后仍按停靠边贴靠(往右收不变)(#94)

Fixed

  • The capsule was pinned to the right edge while dragging: the position refactor dropped the follow-the-pointer branch — dragging in the right half only moved vertically. Dragging now follows the pointer the whole way; releasing still docks to the nearest edge (#94)

0.5.3

变更

  • 引导页文字减负:四段长文各砍成一句具体动作;每步配一张小图——工具栏固定示意(SVG)、弹窗微缩模型(真实按钮名)、「点选 → 看效果 → 保存」流程、胶囊微缩模型
  • 小提示压成一行;上一轮的贴底「下一步」保留

Changed

  • Welcome page text diet: each of the four long paragraphs is now one concrete action, with a small illustration — toolbar pinning (SVG), a miniature popup (real button names), the pick → preview → save flow, and a miniature capsule
  • One-line tip; the bottom-docked “Next” from the previous release stays

0.5.2

修复

  • 站点设置页与插件设置页的「打开开关后」说法:站点页指名为「上面的『按你的设置显示』开关」;插件设置页那两处删掉开关说法——那页没有开关,条件本来就是「网站自己没设置时」
  • 首次引导页的主按钮不再压在折叠线下:整页内容超过一屏,底部「下一步」一栏滚动时贴着视口底走
  • 遮住整页后「恢复」二字常显:此前只有图标,右侧留空看着像没渲染完整;唯一的出路不该靠悬停才自我解释

Fixed

  • “When the switch is on” copy: the site page now names the switch (“Shown your way” at the top); the two spots on the Settings page drop the switch wording — that page has no switch, the condition is simply “when a site has none of its own”
  • The onboarding primary button no longer sits below the fold: the page is taller than one screen, so the bottom bar sticks to the viewport while scrolling
  • “Restore” on the curtain button is always shown: icon-only with blank right half read as a rendering glitch; the only way back shouldn't need hover to explain itself

0.5.1

修复

  • 点选阶段页面滚不动:全屏捕获层吞掉了滚轮的默认滚动——信息流站(滚动放在内层容器上)完全滚不了。现在滚轮转交给指针下的滚动容器,边选边滚、随下随加载(#88)
  • 「另外 N 个一样的」不随懒加载更新:向导开着时页面变了就重算(事件驱动,不做轮询),新卡片加载进来计数与成员标记实时跟上(#88)
  • 看效果阶段没法确认同类勾得对不对:勾了同类的行新增「检查同类」,跳回点选亮出整组,看完回来草稿不丢(#88)
  • 遮住整页后的恢复按钮几乎看不见:常态半透明在白底幕布上对比度不足 3:1,而它是唯一的出路;改常态全不透明(#87)
  • 收起/展开按钮悬停底色溢出胶囊圆头:圆角跟着实际的端点元素走(#85)
  • 拖动把手两副样子:胶囊与向导工具条统一为同一枚六点 SVG(#83)
  • 全功能 ↔ mini 切换位置跳:改为按贴边侧锚定——右停靠往右收、左停靠往左收;幕布恢复按钮松手同规则贴最近边(顺带修掉「恢复按钮拖到中间、胶囊悬在半空」的潜伏 bug)(#84)
  • 收起/展开按钮悬停范围超出胶囊本体:同上圆角修正(#85)

变更

  • 「网站设置」改名「全部网站设置」:弹窗里它会读成「这个网站的设置」;弹窗入口、列表页标题、返回链接、首次引导提及全部同步,英文 All site settings(#86)
  • 管理列表页加「插件设置」入口:插件设置页本有返回,两页从此互达(#87 审查)
  • 默认标签页标题跟随显式选择的界面语言:选了 English 就得到 "Reading";「自动」档仍按浏览器语言(#89,推翻旧决策,理由见票)
  • 按钮在默认位时「⋯」菜单不再显示「按钮放回右下角」:不起作用的项不摆;拖过之后照常出现(#90)
  • 弹窗空状态提示与实物一致:不再说「两颗按钮」(漏了「遮住这一页」)(#87)

Fixed

  • The page couldn't scroll while picking: the full-screen capture layer swallowed wheel scrolling — sites that scroll in an inner container (infinite feeds) couldn't scroll at all. Wheel input is now routed to the scrollable container under the pointer, so you can pick and scroll as the feed loads (#88)
  • “Also hide N alike” didn't follow lazy loading: with the wizard open, page changes now recompute counts and member badges (event-driven, no polling) (#88)
  • No way to check a "similar" match in the preview: rows with the checkbox ticked get a “Check matches” button that jumps back to picking with the whole group lit; your draft is kept (#88)
  • The restore button on the curtain was nearly invisible: its semi-transparent look fell below 3:1 contrast on white pages — and it is the only way back. Now fully opaque by default (#87)
  • The fold/unfold button's hover background spilled outside the pill: cap radii now follow whichever element actually sits at each end (#85)
  • Two different drag handles: the capsule and the wizard toolbar now share one six-dot SVG grip (#83)
  • The button jumped when switching full ↔ mini: positions anchor to the docked edge — right-docked shrinks rightward, left-docked leftward; the curtain restore button snaps the same way on release (also fixes a latent bug where the capsule could end up mid-screen) (#84)

Changed

  • “网站设置” renamed “全部网站设置” (All site settings): in the popup it read as "this site's settings"; popup entry, list title, browser tab title, back links and onboarding mentions all follow (#86)
  • The site list page links to “插件设置” (Settings): the two pages now reach each other (#87 review)
  • The default tab title follows an explicitly chosen interface language: picking English yields "Reading"; “自动” still follows the browser language (#89, overturning the old decision — see the issue for why)
  • The “⋯” menu hides “按钮放回右下角” while the button is at its default spot: a no-op item isn't shown; it returns once you drag (#90)
  • The popup's empty-state hint now matches what's on screen: it no longer says “two buttons” and skip “Cover this page” (#87)

0.5.0

变更

  • 改收起的内容只剩一条路:页面内那个独立的编辑面板删掉了。点「编辑收起的内容」直接进设置向导的「看效果」——页面按你的设置显示着,逐行改名、换收起方式、换范围、重新选这一项;「上一步」回到点选,可以再加新的。已经收起的项在页面上用虚线框加「之前收起了」标出来
  • 「只这一个 / 同类一起(N)」换成一道勾选框:「页面上另外 2 个一样的也一起收起」,回答一个是非题,不用先学会「同类」这个词。页面上没有第二个一样的,这道勾选框根本不出现;勾上或取消,页面当场变,工具条上说一句「另外 2 个也收起了」/「现在只收这一个」
  • 「收起更多内容」也标出已收起的:从这个入口进去,页面上已经收着的项同样画虚线框加「之前收起了」;再点其中一个是重复添加,会提示「这一项已经收起了」而不会新增一条
  • 「看效果」每行只放一件事:序号、名称、一句摘要(例如「消失 · 整个网站」)、「调整」、✕。收起方式、在哪些页面收起、重新选、高级(选择器原文)都折进「调整」
  • 页面右下角的小按钮:这个网站只要有设置就出现(只改过标题也算,以前不出现);「⋯」菜单补上「收起更多内容」,按用途分三组——标题和图标 / 收起更多 / 编辑收起 | 按钮放回右下角 | 删除这个网站的设置(永远排在最后)
  • 「你添加的网站」改名「网站设置」:和「插件设置」配成一对。这个页面上那个「在页面上编辑」删掉了——它不知道该去哪个页面;改成一句说明:想到页面上改,就点工具栏图标再点「编辑收起的内容」
  • 按钮全项目一套:主操作(实心)/ 次操作(有底有边)/ 轻操作(无底无边)/ 危险(红字红边),五种状态齐全。一屏最多一个实心主按钮;能不禁用就不禁用
  • 删除只有两种:从清单里去掉一项,一律是行尾一个 ✕;删除整个网站的设置,才是红字按钮加二次确认
  • 向导底栏只放按钮:退出改成文字按钮「退出设置」;「上一步」带上目的地(「上一步:改标题」「上一步:重新选内容」)
  • 文案:「按你的设置显示 / 网站原样」缩成「按设置 / 原样」(开关的标签仍用全称);「全部删掉」→「全部取消选择」;「N 项已收起」这类说法彻底不用
  • 扩展改名:PageMask · 页面清爽模式 → PageMask · 收起网页上不想看的部分(英文 PageMask — Hide the Parts You Don't Want)

修复

  • 「盖住」的预览原来只盖住点中的那一个,保存后却盖住整组;现在预览与保存结果一致
  • 保存中的按钮不显示「正在保存…」(状态没跟着变)
  • 页面右下角三个小图标按钮的可点区域太小(16 / 22 像素),提到 24×24,触屏 40×40
  • 界面里最后一处 10 像素的字没有了
  • 弹窗底部「网站设置」「插件设置」原来是无框小字,看着像不能点;改成了普通按钮
  • 标题小面板右上角的裸 ✕ 改成文字「关闭」(✕ 只留给「从清单里去掉一项」)

Changed

  • One way to edit what's hidden: the separate in-page editor is gone. “Edit hidden items” now opens the setup wizard at its last step — the page is showing your settings, and you rename, change the hide method, change where it applies, or pick the element again, row by row. “Back” takes you to picking, to add more. Items you already hid are outlined with a dashed border and a “Hidden before” tag
  • “Just this one / All N alike” is now a checkbox: “Also hide the other 2 like this one” — a yes-or-no question instead of a word to learn. When there's no second one on the page, the checkbox doesn't appear at all. Tick or untick and the page changes right away, with a line in the toolbar: “The other 2 are hidden too” / “Only this one is hidden now”
  • One decision per row in the result step: number, name, a one-line summary (e.g. “Disappear · The whole site”), “Adjust”, ✕. Hide method, where it applies, pick again, and the advanced selector all live inside “Adjust”
  • The small button in the corner: now appears whenever the site has any setting (a changed tab title counts; it used to stay hidden). Its “⋯” menu gained “Hide more” and is grouped by purpose — title and icon / hide more / edit hidden | put the button back | delete this site's settings (always last)
  • The corner button has a mini form: just the state dot (click to switch “Your settings / As is”), Cover (one click when it matters), and Expand — no text, no menu, no grip; a pair of icons switches between mini and full, and each site remembers its own choice
  • “Hide items” also marks what's already hidden: the wizard stops at picking, items already hidden get the same dashed outline and “Hidden before” tag; clicking one again replaces that rule in place instead of creating a second one
  • “Your sites” renamed “Site settings”, pairing with “Settings”. The “Edit on the page” button there is gone — it couldn't know which page to open; a sentence now says: use the toolbar icon, then “Edit hidden items”
  • One set of buttons everywhere: primary (solid) / secondary (filled, bordered) / quiet (no fill, no border) / danger (red text and border), with all five states. At most one solid primary button per screen; avoid disabling buttons where possible
  • Only two kinds of removal: taking one item off a list is always a ✕ at the end of its row; deleting a whole site's settings is a red button plus a confirmation
  • The wizard's bottom bar holds buttons only: exit is a text button “Exit setup”; “Back” names its destination (“Back: tab title”, “Back: pick again”)
  • Wording: “Shown your way / As the site is” shortened to “Your settings / As is” (the switch keeps the full label); “Remove all” became “Deselect all”; “N items hidden” is no longer used anywhere
  • Renamed: PageMask — Clean & Focused Pages → PageMask — Hide the Parts You Don't Want (Chinese: PageMask · 收起网页上不想看的部分)

Fixed

  • “Cover” used to preview only the element you clicked, but covered the whole group once saved; the preview now matches the result
  • Buttons didn't show “Saving…” while saving (the state wasn't reactive)
  • The three small icon buttons in the corner were too small to hit (16 / 22 px); they're 24×24 now, 40×40 on touch screens
  • The last 10 px text in the interface is gone
  • The two footer entries in the popup (“Site settings” / “Settings”) were borderless small text that didn't look clickable; they're regular buttons now
  • The bare ✕ atop the title panel became a text “Close” button (✕ is reserved for taking an item off a list)

0.4.1

变更

  • 按钮和菜单改成说人话:主按钮「为当前网站开启清爽模式」→「设置这个网站」;「编辑当前网站」→「编辑收起的内容」;底部入口「管理全部网站」→「你添加的网站」;「遮住本页 / 恢复本页」→「遮住这一页 / 恢复这一页」
  • 两个状态换了名字:「清爽 / 原样」→「按你的设置显示 / 网站原样」。开关标签、页面右下角小按钮的悬停提示、网站列表里的状态都跟着改,不用先猜「清爽」是什么意思
  • 技术词全部下架:「授权 / 待授权 / 授权并启用 / 一次授权全部」→「允许访问 / 需要允许访问 / 允许访问 / 全部允许」;「生效范围」统一成「在哪些页面收起」;「规则」→「收起设置 / 收起项」;「去处理」→「重新选一次」;「快捷填入」→「现成的标题」;「小胶囊」→「页面右下角的小按钮」
  • 同一件事全项目只留一个叫法:设置第 3 步和页面内编辑面板原来一个叫「在哪些页面收起」、一个叫「生效范围」,现在统一;「整站 / 仅 / 除外」这类缩写全部删掉
  • 说不清的地方补足:用不了的页面说清原因(「Chrome 自己的页面不让扩展改动,换一个普通网页再试」);第一次打开时说清能做什么(改标签页标题和图标、点选页面内容收起来);失效提醒改成「「顶部导航栏」最近找不到目标了,可能网站改版了。在哪些页面收起:整个网站」
  • 数量说法不再自相矛盾:网站显示原样时,「已收起 N 项」是句假话,改成中性的「N 项收起设置」
  • 扩展简介与工具栏提示:简介去掉「一键收起」,悬停提示从「让当前网站更清爽」改成「设置这个网站的标签页标题、收起内容」

修复

  • 插件设置页的标签页标题现在跟随界面语言(原来固定是中文)

Changed

  • Buttons and menus now say what they do: the main button "Turn on clean mode for this site" → "Set up this site"; "Edit this site" → "Edit hidden items"; the bottom entry "Manage all sites" → "Your sites"; "Cover this page / Restore this page" stays, and the page-side wording matches
  • The two states were renamed: "Clean / Original" → "Shown your way / As the site is". The switch label, the small button's tooltip and the site list follow, so nobody has to guess what "Clean" means
  • Jargon is gone: "authorize / needs access / allow and turn on / allow all" → "allow access / needs access / allow access / allow all"; "where it applies" is one name everywhere; "rule" → "hidden item / items set to hide"; "fix it" → "pick again"; "quick fill" → "ready-made titles"; "the small capsule" → "the small button at the bottom-right"
  • One name per thing: step 3 and the on-page editor used to call the same setting two different things; they now match, and abbreviations like "whole site / only / except" are gone
  • Where it was vague, it now explains: unsupported pages say why ("Chrome's own pages don't let extensions change them. Try a normal web page"); the first-time hint says what you can do; broken items read "“Nav bar” can't be found any more — the site may have changed. Where it applies: the whole site"
  • Counts no longer contradict the state: "N items hidden" was untrue while a site showed as-is; it is now the neutral "N items set to hide"
  • Store blurb and toolbar tooltip: dropped "with a click" from the short description, and the tooltip now names the action instead of "make this site clean & focused"

Fixed

  • The Settings page tab title now follows the interface language (it used to stay Chinese)

0.4.0

新增

  • 面板只留三件事:主操作、编辑当前网站、还有一个能来回点的「遮住本页 / 恢复本页」;底部并排两个入口——「管理全部网站」与「插件设置」。原来的「设置标题和图标」从面板移除,改到页面右下角小胶囊的菜单里
  • 设置分成两个独立页面:「你添加的网站」是网站列表,点进去是一个网站的设置页;「插件设置」单独一页,放默认标题、默认图标、导出 / 导入、界面语言与版本信息,也注册成了扩展的「扩展程序选项」
  • 默认标签页图标:插件有一张自己的默认图标,生效顺序是网站自己设的 > 插件默认 > 透明(不显示)。改了默认图标,没单独设过图标的网站会一起变
  • 设置向导变成三步:标签页标题和图标 → 点选要收起的内容 → 看效果。选中的内容列成清单、可逐项删掉;生效范围也在「看效果」这一步定;点保存即完成
  • 页面右下角小胶囊的菜单变成四项:标签页标题和图标 / 编辑收起的内容 / 按钮放回右下角 / 删除这个网站的设置
  • 「一键清空」改叫「删除这个网站的设置」:确认框里写清删的是什么、影响哪些东西;网站的设置页和页面菜单里是同一个名字
  • 遮住整页后是一颗睁眼的小按钮:和平时那根小胶囊同一套长相,可以拖动、记住位置;鼠标移上去(或键盘聚焦)才显出「恢复」两个字
  • 导出文件更完整:除了全部网站的设置,还带上插件设置(默认标题、默认图标)与导出时的版本号;文件名形如 pagemask-0.4.0-20261030120000.json
  • 全界面中英双语:面板、管理页、向导、页面内的按钮与提示都有中文和英文两套文案;「插件设置」里可以选界面语言(跟随浏览器 / 简体中文 / English),切换立即生效

修复

  • 标签页标题不再和网站"对抢":个别网站反复改写标签页标题时,插件补写频率受控;实在抢不过(网站用定时器死守)就彻底放手,浏览器保持流畅,不再卡顿

Added

  • The popup keeps three things: the main action, "Edit this site", and a two-way "Cover this page / Restore this page" switch; two side-by-side entries at the bottom — "Manage all sites" and "Settings". The old "Set tab title & icon" is gone from the popup; it moved into the menu of the small capsule at the bottom-right of the page
  • Settings split into two pages: "Your sites" lists the sites you added; clicking one opens that site's settings page. "Settings" is its own page with the default title, default icon, export / import, interface language and version info, and it is registered as the extension's "Options" page
  • Default tab icon: PageMask now has its own default icon; the order is the site's own icon > the default icon > transparent (nothing shown). Change the default and every site without its own icon follows
  • The setup wizard is now three steps: tab title and icon → pick what to hide → check the result. Everything picked is listed and can be removed item by item; the scope is decided on the "check the result" step too; saving finishes it in one click
  • The capsule's ⋯ menu now has four items: tab title and icon / edit what's hidden / put the button back at the bottom-right / delete this site's settings
  • "Reset" is now "Delete this site's settings": the confirmation spells out what is deleted and what it affects; the site's settings page and the on-page menu share the same name
  • After covering the page there is a small open-eye button: same look as the capsule, draggable, remembers its position; hover (or keyboard focus) reveals the word "Restore"
  • Export files are more complete: besides every site's settings they now include the plugin settings (default title, default icon) and the version at export time; the file name looks like pagemask-0.4.0-20261030120000.json
  • The whole interface is bilingual: the popup, management pages, wizard and on-page controls all have Chinese and English; pick the interface language ("follow the browser" / 简体中文 / English) in Settings and it takes effect immediately

Fixed

  • The tab title is no longer fought over: on sites that rewrite their title in a loop, PageMask now writes back at a controlled rate; if the site simply won't yield (a timer keeps resetting it), PageMask lets go entirely — the browser stays smooth, no more freezing

0.3.0

修复

  • 新站点授权后直接进入设置向导:原来点「允许」之后什么都不发生,得再点一次扩展图标(权限确认框会关闭扩展弹窗,后面的步骤没能继续)。现在弹窗只发一条消息,由后台在用户手势里请求权限并接着完成注入与开向导,一次点击即可
  • 「已收起 0 项」这类写法:只想改标题的网站没有任何收起项,现在显示「没有收起任何内容」

新增

  • 只想改标签页标题也可以:popup 新增「设置标题和图标」,直接进管理页把标题、图标填好保存,一个元素都不用收起
  • 管理页拆成「网站」与「设置」两个 tab:网站是已添加网站的列表,点进去是这个网站的设置页(开关、标签页标题、图标、已收起的项、一键清空);设置里放全局默认标题与导出 / 导入
  • 站点设置页:已收起的项可以删除(5 秒内可撤销),换收起方式与重选元素仍然在页面上做(那里才有上下文)
  • 设置向导更顺手:点选阶段新增「清空」,一步清掉已选;「退出」改叫「取消」,确认框里危险按钮改成红色实底,安全按钮默认聚焦
  • 预览清单行内编辑:每一行直接换收起方式、改名、删除;范围标签显示「同类 3 处」这样的命中数,点一下只收起这一处
  • 三种收起方式的界面叫法改为「消失 / 留空 / 盖住」:消失 = 下面的内容往上补;留空 = 位置留着不动;盖住 = 盖一块和背景同色的板
  • 幕布:一键把整页连同标签页标题一起遮住,再一键回到点击前的样子(原来是什么状态就回什么状态)。没添加过的网站也能用:popup 点「遮住本页」,当场遮住,不留任何配置

工程

  • 元素命名改进:文字都在子元素里的容器不再叫「div 元素」
  • E2E 覆盖管理页三视图、预览清单、幕布(含未添加站点的一次性脚本);测试收尾失败不再影响用例结论

Fixed

  • Adding a new site now opens the setup wizard right away: after clicking "Allow" nothing used to happen and you had to click the extension icon again (the permission prompt closes the popup, so the following steps never ran). The popup now only sends a message; the background asks for permission inside the user gesture and then injects and opens the wizard in one go
  • Wording like "0 items hidden": a site that only changes its tab title has nothing hidden — it now says "nothing hidden"

Added

  • Tab title only is fine: the popup gains "Set tab title & icon" — open the management page, fill in the title and icon, save, and not a single element is hidden
  • The management page splits into "Sites" and "Settings" tabs: Sites lists the sites you added; clicking one opens its settings page (switch, tab title, icon, hidden items, reset). Settings holds the default title and export / import
  • Site settings page: hidden items can be deleted (undo for 5 seconds); changing the hide method and re-picking an element still happen on the page itself, where the context is
  • A smoother wizard: "Clear" empties your selection in one click; "Exit" is now "Cancel"; the destructive button in the confirmation is solid red and the safe button has focus
  • Inline editing in the preview list: change the hide method, rename and delete right on each row; the scope label shows how many match ("3 alike"), and one click hides just this one
  • Hide methods are now "Disappear / Keep space / Cover": disappear pulls the following content up; keep space leaves the gap; cover puts a sticker the colour of the background over it
  • Curtain: cover the whole page and the tab title in one click, and go back exactly to what it was before. It works on sites you have not added too — "Cover this page" in the popup covers it on the spot and leaves no configuration behind

Engineering

  • Better element names: containers whose text lives in child elements no longer become "div element"
  • E2E now covers the three management views, the preview list, and the curtain (including the one-shot script for un-added sites); cleanup failures no longer affect the verdict

0.2.0

修复

  • 遮罩覆盖:页面后加载的元素会被自动补上遮罩;遮罩颜色取自元素背后的真实底色(深色页面不再刺眼);页面静止时不再逐帧运行;遮罩下的链接点不到
  • 设置向导:取消某个选择后序号重新编号;改一个元素的方案不会让其它预览标记坍缩;预览标记不再盖住重排上来的内容、也不拦截点击;Esc 分层处理(有浮层只关浮层、退出确认框上 Esc 等于继续编辑);「继续选择」保留已改的方案;滚动后点击选中的是指针下的元素;工具条默认在底部、可拖动也可用方向键移动
  • 编辑规则:popup 增加「编辑当前网站」入口;「重选元素」取消后旧规则原样保留,保存时在同一次写入里替换;面板跟随存储变化,SPA 换页后规则列表随之更新;高级选择器逐行校验并指出第几行;删除后 5 秒内可撤销;失效规则给出可读说明与「去处理」按钮
  • 悬浮按钮:点菜单项不再误切开关;菜单自动避开视口边缘;按钮可用键盘操作(Tab 聚焦、回车切换);拖动改用专用把手,触屏不再残留监听;位置贴边保存,窗口变化后仍够得着
  • 扩展页面:开关改为原生 switch 语义;弹窗、管理页、引导页的对比度与深色模式达标;确认框改为原生对话框,焦点进入框内
  • 存储:所有站点配置经统一校验 + 原子更新写入,避免并发覆盖;导入先校验后写入

新增

  • 新图标(16 / 32 / 48 / 128),悬浮按钮使用配套单色图标
  • 默认标签页标题「阅读」/ "Reading"、默认透明图标;管理页提供常用标签页标题快捷选择
  • manifest 多语言(英文默认 + 简体中文),最低支持 Chrome 116
  • 设计 tokens 与自动对比度测试;界面统一使用 tokens
  • 内容脚本宿主隔离:页面样式(含 !important)压不到插件界面;扩展更新后新实例接管旧页面
  • 站点生命周期对账:撤销授权后显示「待授权」并可重新授权;一键清空时已打开页面立即还原
  • 首次安装的四步引导页

工程

  • CI、打包门禁(npm run check:package)、第三方组件声明、SECURITY.md
  • 依赖锁定精确版本;可移植 E2E(Chrome for Testing),覆盖主流程与各界面专项

Fixed

  • Cover: elements inserted after page load get covered automatically; the cover color is taken from the real background behind the element (no more glare on dark pages); nothing runs per frame while the page is still; links under a cover are not clickable
  • Setup wizard: badge numbers renumber after unselecting; changing one element's method no longer collapses other preview markers; markers no longer cover reflowed content or block clicks; Esc is handled by layer (only the open overlay closes; Esc on the exit dialog means keep editing); "continue selecting" keeps your adjustments; after scrolling, a click selects the element under the pointer; the toolbar sits at the bottom by default, can be dragged or moved with arrow keys
  • Edit rules: the popup gains an "Edit this site" entry; "re-pick element" keeps the old rule if you cancel, and replaces it in the same write when you save; the panel follows storage changes and updates its rule list after SPA navigation; the advanced selector backdoor validates line by line and names the failing line; deletions can be undone for 5 seconds; broken rules show a readable explanation with a "fix it" button
  • Floating button: clicking a menu item no longer flips the switch; the menu stays inside the viewport; the button is keyboard operable (Tab to focus, Enter to toggle); dragging uses a dedicated handle and leaves no listeners behind on touch; the position is saved against the nearest edge and stays reachable after resizing
  • Extension pages: the switch uses native switch semantics; contrast and dark mode meet the thresholds on the popup, management and onboarding pages; confirmations are native dialogs with focus moved inside
  • Storage: every site profile is written through a single validator and atomic updates, avoiding lost updates; imports are validated before writing

Added

  • New icons (16 / 32 / 48 / 128), with a matching monochrome icon for the floating button
  • Default tab title "Reading" (「阅读」) and a transparent default icon; quick title presets in the management page
  • Localized manifest (English default + Simplified Chinese), minimum Chrome 116
  • Design tokens with automated contrast tests; the UI uses tokens throughout
  • Host isolation: page styles (including !important) cannot reach PageMask UI; after an extension update a new instance takes over open pages
  • Site lifecycle reconciliation: a revoked site shows "pending" and can be re-authorized; resetting a site reverts open pages immediately
  • Four-step first-run onboarding

Engineering

  • CI, a packaging gate (npm run check:package), third-party notices, SECURITY.md
  • Dependencies pinned to exact versions; portable E2E (Chrome for Testing) covering the main flow and each UI area

0.1.0

  • 按网站生效:仅用户主动添加的网站生效,未配置网站零注入、零影响
  • 点选向导:悬停高亮、连续多选、选大/选小调整层级、整页防呆提示、Esc 二次确认
  • 三种收起方式:彻底移除 / 原地留白 / 遮罩覆盖,预览期可随时切换
  • 收起规则:多候选选择器(语义属性优先,过滤构建工具生成的类名),生效范围零输入(整站 / 仅这类 / 排除这类)
  • 标签页标题与图标:可设置自定义标题与图标,网站动态改写标题时自动改回
  • 每网站开关:页面内悬浮按钮(可拖动、记住位置),同站多标签页联动,状态按网站记忆
  • 页面内编辑面板:当前页面规则列表、换方案/改范围即时生效、删除、重选、高级选择器后门(保存前必须现场命中)
  • 管理页:全站总览、标签页标题/图标设置、失效状态、一键清空(二次确认)、导出/导入(合并或整体替换)
  • 失效体检:仅在清爽态采集,用人话提醒
  • 首次安装引导
  • 隐私:配置只存在本机,PageMask 自身不发起网络请求,权限最小化(按网站的可选主机权限)
  • Works per site: only user-added sites are affected; zero injection elsewhere
  • Pick wizard: hover highlight, multi-select, bigger/smaller level adjustment, whole-page guard, Esc double-confirm
  • Three hiding methods: remove / blank-in-place / cover, switchable during preview
  • Hide rules: multi-candidate selectors (semantic attributes first, build-tool generated class names filtered), zero-typing scope (whole site / only these pages / except these pages)
  • Tab title & icon: custom title and icon per site; titles rewritten by the site are changed back automatically
  • Per-site switch: an on-page floating button (draggable, remembers its position); all tabs of a site switch together; state remembered per site
  • On-page editor panel: rule list for the current page, live method/scope changes, delete, re-pick, advanced raw-selector backdoor (must match live before saving)
  • Management page: all-sites overview, tab title/icon settings, health state, one-click reset with confirmation, export/import (merge or replace)
  • Rule health check: collected in clean mode only, plain-language notices
  • First-run onboarding
  • Privacy: settings stay on your device, PageMask itself makes no network requests, minimal permissions (per-site optional host permissions)