打工人的侧边栏摸鱼浏览器。一款 Electron 应用，贴屏幕边缘自动收起、只露 3px 触发条，鼠标离开还会自动暗化/模糊，手机 UA 让网页按手机版渲染，登录态跨重启持久。挂在显示器边上随时瞟一眼推/B 站/工单，老板路过——鼠标移开，窗口自动暗下去。
这个仓库的所有代码、测试、文档和 milestone 计划，都是 Claude（Anthropic，主要是 Opus）在 Claude Code 里写出来的——早期配合 superpowers 插件 的工作流，M16 起改用 Claude Code 自带的规划 / 子 agent 能力，流程更轻（spec + plan 文档照旧放在 docs/superpowers/）。人类（仓库 owner）只负责提需求、做决策、手动冒烟测试。
换句话说，这是一个"AI 主导开发"的实验项目，拿来给好奇这套工作流的人看的——不是产品级品质，是个人玩具，但它能用。
Windows only，暂无移植 macOS 的计划。
- PDF 阅读：新标签页点「Open PDF」或按 Ctrl+O 选择本地文件，在新标签页用内置阅读器打开。地址栏支持 Windows 绝对路径（包括资源管理器「复制文件地址」得到的带引号路径）；下载列表里点击已完成的 PDF，也在应用内打开。
.pdf地址、网页链接及重定向自动切到桌面模式；服务器强制下载的链接仍先下载。 - PDF 阅读器配色：Settings → Appearance → PDF colors 支持 System / Dark / Light / Custom。Custom 提供预设色块、色相与明暗调色板、HEX 输入和预览；工具栏、侧栏、页间背景、菜单、对话框、批注面板、查找栏和滚动条统一配色，文字、图标、选中与悬停状态自动适配对比度；改色后立即生效，已打开或稍后打开的控件均会更新。PDF 页面内容保持原色；颜色会保存，刷新和重启后仍生效。
- 贴边自动隐藏（左/右均可）：窗口收起后留 3px 触发条，鼠标悬停即呼出。多屏交界处若收起会露在邻屏上，则保持可见，仅自动暗化；移到屏幕外侧边缘即可收起
- 鼠标离开自动变暗/模糊：离开窗口后触发暗化 + 模糊滤镜，强度和效果均可在设置里调
- 手机模拟（M10 hybrid CDP）：UA + Client Hints 头 + Chromium device emulation + CDP touch/pointer override，让 X.com / B 站等靠 Client Hints 路由的站点也按真移动版渲染
- 可定制搜索引擎（M11）：默认 Google，内置 4 项（Google / DuckDuckGo / Bing / 百度）+ 用户可添加/删除自定义条目（含
{query}占位符的 URL 模板） - 网页缩放（M11 / M16）：Ctrl+滚轮、Ctrl+= / Ctrl+- 或右键菜单调整当前 tab 大小（每 tab 独立、50–300% / ±10% 步进），Ctrl+0 复位 100%；手机模式下同样可用（按缩放重排版面，不是放大镜式缩放）
- 新标签页 + 网址栏自动补全（M12 / M17）：about:blank 时显示「常去网站」网格（按域名合并）和最近访问记录（点击直接打开、单条可删除）；点地址栏弹出 Spotlight 搜索框（背后是当前页面的模糊截图），输入时实时按 URL/标题过滤历史（最多 8 条），↑/↓ 键盘选择 + Enter 跳转 + Esc 关闭。历史按 URL 去重，500 条 LRU 上限
- 登录态持久化：所有 tab 共享
persist:sidebrowsersession partition，cookies 跨重启保留 - 页内查找 / 下载 / 视频全屏（M16）：Ctrl+F 页内查找；下载直接存到「下载」文件夹（重名自动加序号），顶栏下载按钮看进度、打开、在文件夹中显示；网页视频全屏铺满侧边窗口，Esc 退出
- 隐身与隐私（M16）：网站的通知 / 定位 / 摄像头 / 麦克风等权限请求默认全部拒绝（不会弹系统通知）；窗口贴边藏起时自动静音、页面停止渲染（可在设置里关）；tab 抽屉里可单独静音
- 省资源（M16）：重启后只加载当前 tab，其余点到才加载；后台 tab 不渲染；闲置超过设定时间（默认 30 分钟）的 tab 自动卸载，点回来恢复，前进/后退记录不丢
- 标签页（M16）：Ctrl+Shift+T 恢复刚关闭的 tab；Ctrl/中键点链接在后台打开；重启后每个 tab 的前进/后退记录都在；网页崩溃时显示重新加载提示
- 存储清理（M16）：设置 → Storage 查看占用，「Clear cache」只清缓存不掉登录，「Clear all site data」全部清除（需二次确认）
- 紧凑顶栏（M14 / M17）：自绘最小化 / 关闭按钮；地址胶囊里收着手机/桌面 UA 切换和刷新/停止；前进按钮只在能前进时出现；加载进度细条、tab 数角标；tab 抽屉、查找条、下载抽屉都盖在页面上方，不挤压页面
- 始终置顶：能盖住 F11 全屏浏览器和视频播放器
- 单实例锁：已有实例时双击不会再开一个
- System / Dark / Light 三档 chrome 主题：Settings → Appearance 切换，System 跟随 OS 深色模式
- 所有设置项均有 reset-to-default 按钮
去 GitHub Releases 最新发布页 下载 sidebrowser-Setup-<version>.exe 直接运行。
首次安装 Windows SmartScreen 会弹"未知发布者"警告，这是正常的（没做代码签名）。点**"更多信息"→"仍要运行"**即可。
或者本地构建：
pnpm install
pnpm build:installer
# 产出 release/sidebrowser-Setup-<version>.exe，<version> 取自 package.json运行环境要求：Node.js ≥ 20，pnpm ≥ 9，Windows 10/11。
pnpm dev # electron-vite 开发服务器，支持热重载
pnpm build # 打包到 out/
pnpm build:installer # 构建安装包
pnpm test # 单元测试（Vitest）
pnpm test:e2e # E2E 测试（Playwright/Electron），需要先跑 pnpm build
pnpm typecheck # TypeScript 严格检查
pnpm lint # ESLintCI：每个 PR 和推到 main 的提交都会在 GitHub Actions（windows-latest）上跑类型检查、lint、单元测试、构建和 E2E。E2E 在本地跑时窗口是透明、鼠标穿透、不进任务栏的「静默模式」，不会打扰你干别的；想看着跑就加 SIDEBROWSER_E2E_VISIBLE=1。
发版：改 package.json 版本号 + CHANGELOG.md，合进 main 后推 v<version> tag。release.yml 会在干净的 runner 上构建安装包并挂到一个 draft release，补完发布说明后手动发布。
环境坑：如果你的 shell 里 ELECTRON_RUN_AS_NODE 被全局设置了（部分开发工具会这样），Electron 会进入 Node 兼容模式，导致应用启动失败。所有 pnpm 脚本都经过 scripts/run.mjs 包装，会自动剥离这个变量。如果你直接调用 electron-vite，记得先 unset ELECTRON_RUN_AS_NODE。
| 快捷键 | 功能 |
|---|---|
Ctrl+T |
新 tab |
Ctrl+O |
选择本地 PDF，在新 tab 打开 |
Ctrl+W |
关闭当前 tab |
Ctrl+L |
聚焦地址栏 |
Ctrl+R / F5 |
刷新 |
Alt+← / Alt+→ |
后退 / 前进 |
Ctrl+Tab / Ctrl+Shift+Tab |
切换到下一个 / 上一个 tab（切换时展开 tab 抽屉） |
Ctrl+, |
打开/关闭设置抽屉 |
Ctrl+Shift+T |
恢复刚关闭的 tab |
Ctrl+F |
页内查找（Enter / Shift+Enter 上下跳，Esc 关闭） |
Ctrl+= / Ctrl+- |
放大 / 缩小当前 tab（desktop 和手机模式都可用） |
Ctrl+滚轮 |
缩放当前 tab（desktop 模式） |
Ctrl+0 |
复位当前 tab 缩放至 100% |
F12 |
打开/关闭 DevTools |
- 极端反移动端检测的站可能仍识别为桌面。 M10 用 hybrid CDP 翻
userAgentData.mobile/(pointer:coarse)/(hover:none)/'ontouchstart' in window+ Sec-CH-UA-* 头，覆盖了大多数靠 UA + Client Hints + 媒体查询路由的站点（包括 X.com、B 站等）。但极端的 device fingerprinting（细到 GPU 型号 / 字体集 / 时钟偏移）仍可能被识别。 - 手机模式下 Ctrl+滚轮不能缩放（Chromium 的 device emulation 把它当成模拟双指捏合吃掉了）。用 Ctrl+= / Ctrl+- 或右键菜单的缩放项即可。
- 不支持 macOS。
- 关闭窗口即退出，没有系统托盘。
- 始终置顶对 DirectX exclusive fullscreen 无效（极少数老游戏 / 部分 DRM 视频），这是 OS 层限制。
- 无代码签名，首次安装 SmartScreen 会叫，点"仍要运行"。
- 无书签管理。常去的站在新标签页的 Frequent 里。
- 网站权限一律拒绝，没有逐站授权。需要摄像头 / 定位的站请用系统浏览器打开（右键 → Open page in system browser）。
Electron + React 19 + TypeScript + Vitest + Playwright + electron-vite + Tailwind CSS + Zustand + electron-store。不引入原生模块（Electron 本身除外）。
- 主设计 spec：
docs/superpowers/specs/2026-04-23-sidebrowser-design.md - Milestone 计划文档：
docs/superpowers/plans/ - M10 spec（mobile emulation 增强）：
docs/superpowers/specs/2026-04-27-mobile-emulation-clienthints-design.md - M11 spec（搜索引擎 + 网页缩放）：
docs/superpowers/specs/2026-04-27-M11-search-and-zoom-design.md - M12 spec（浏览历史 + NewTab + 网址栏自动补全）：
docs/superpowers/specs/2026-05-06-history-and-newtab-design.md - M13 spec（右键菜单 + Ctrl+Tab 循环 + 隐身级暗化）：
docs/superpowers/specs/2026-05-11-M13-context-menu-tab-ux-stealth-dim-design.md - M14 spec（macOS 风 UI）：
docs/superpowers/specs/2026-05-11-M14-macos-style-ui-design.md - M16 spec（权限 / 查找 / 下载 / 懒加载与卸载 / 存储清理等）：
docs/superpowers/specs/2026-10-08-M16-browser-essentials-design.md - M17 spec（顶栏与界面打磨）：
docs/superpowers/specs/2026-10-08-M17-chrome-polish-design.md
- Claude (Anthropic) — 代码实作、测试、文档全包
- superpowers 插件 — brainstorming / writing-plans / subagent-driven-development 工作流，早期 milestone 靠它让 AI 主导开发变得可行
- 人类 owner — 出需求、拍板、按按钮