电脑版：把组件钉在桌面上，专注计时放进菜单栏

组件世界电脑版支持 Windows、macOS 和 Linux。它是一个轻量的原生 App（不是 Electron，安装包只有几 MB）：左边是侧栏，右边打开你的起始页、我的组件、专注空间和我的数据；你的任何一个组件都能钉在电脑桌面上；专注倒计时显示在菜单栏 / 托盘里。

下载和安装

在电脑上打开下载页，会自动推荐你的系统。

macOS（通用版，Apple 芯片和 Intel 都能用，需要 macOS 10.15+）

1. 打开 .dmg，把 WidgetStore 拖进「应用程序」。
2. 推荐：打开「终端」（⌘空格 搜「终端」），粘贴运行 xattr -dr com.apple.quarantine "/Applications/WidgetStore.app"，然后正常双击打开。这一行只去掉这个 App 的「从网上下载」隔离标记（com.apple.quarantine），不会改别的 App，也不会关掉系统的安全设置。
3. 不用终端：先双击打开一次（被拦下时点「完成」），再到「系统设置 → 隐私与安全性」，滚到底部点「仍要打开」，输入密码确认。macOS 15（Sequoia）起「右键 → 打开」已经不能绕过门禁，只能用这里。

打不开时

• 提示「无法验证开发者」/「Apple 无法检查其是否包含恶意软件」/「未打开」：按上面第 2 或第 3 步做。
• 提示「已损坏，无法打开，你应该将它移到废纸篓」：运行第 2 步的命令后再打开（这是下载隔离标记和没有公证的组合，不是文件真的坏了；可以先在下载页核对 SHA-256）。
• 「隐私与安全性」里没有「仍要打开」：那个按钮只在你刚刚尝试打开之后约 1 小时内出现，先双击一次再去看。

Windows（Windows 10 / 11，64 位）

1. 运行安装程序（.exe，装在你自己的账户里，不需要管理员权限）。企业批量部署可以用 .msi。
2. 出现「Windows 已保护你的电脑」（SmartScreen）：点「更多信息」→「仍要运行」。
3. Windows 10 没有 WebView2 时，安装程序会自动下载。

Linux（64 位，需要 WebKitGTK 4.1：Ubuntu 22.04+、Debian 12+、Fedora 37+）

• .deb：sudo apt install ./WidgetStore_*.deb；.rpm：sudo dnf install ./WidgetStore-*.rpm。
• AppImage：允许作为程序执行（chmod +x）后双击。
• 托盘图标需要桌面支持 AppIndicator（GNOME 装扩展「AppIndicator and KStatusNotifierItem Support」）。

登录

• 用浏览器登录（推荐）：会打开你的默认浏览器，用 Google、Notion、微信或邮箱登录后点「连接并回到桌面版」，自动回到 App。
• 在 App 里用邮箱登录：欢迎页点「在这里用邮箱登录」。
• 登录态只保存在这台电脑上（只有你的系统账户能读），「设置 → 退出登录」会删除它。

桌面小组件

1. 侧栏点「我的组件」，在想要的组件上点「放到桌面」。
2. 鼠标移到小组件顶部会出现工具条：拖动标题移动，右下角拖动调整大小；位置和大小会记住，停下时自动对齐网格（设置里可以改网格大小或关掉）。
3. 工具条上的按钮：
   • 层级：贴在桌面（默认，在其它窗口后面）/ 普通窗口 / 总在最前；
   • 状态：可拖动 → 已锁定（不能拖动，但可以点组件里的内容）→ 点击穿透（鼠标直接点到后面的窗口）；
   • 刷新、从桌面移除（点两次确认，组件本身不会删除）。
4. 想再调整锁定或点击穿透的小组件：托盘 / 菜单栏 →「编辑桌面小组件」，或侧栏「桌面小组件」旁边的「编辑位置」。侧栏里点小组件名字可以显示 / 隐藏它。

专注计时和快速面板

• 在专注空间里开始专注，倒计时会显示在 macOS 菜单栏（Linux 显示在托盘图标旁，Windows 在托盘提示里），到点有系统通知。
• 托盘菜单里可以直接「开始专注 25 分钟」，到点或提前结束都会记进「专注记录」（满 1 分钟才记）。
• 快速面板：按 Ctrl+Shift+空格（Mac 上 ⌘⇧空格）随时呼出，开始专注、记一条待办、勾掉待办。待办和网页、手机 App、浏览器扩展是同一份。

启动器：一个快捷键搜一切

按 Alt+空格（Mac 上 ⌥空格）在任何地方呼出启动器，输入几个字就能：

• 打开这台电脑上的应用（显示应用自己的图标，名字、英文名、关键字都能搜）；
• 打开起始页里的网站（带网站图标）、我的组件（↵ 直接钉到桌面）、AI 搭的空间；
• 执行命令：开始 / 结束专注、加待办（输入内容后选「加待办：…」）、让 AI 搭一个空间、打开起始页 / 专注空间 / 我的数据、添加或编辑桌面小组件；
• 算数和换单位：12*(3+4)、10 km to mi、100 f in c、5 斤 to kg，↵ 复制结果；
• 都没有时用搜索引擎搜（按内容地区：中国大陆百度、韩国 Naver、其它 Google）。

键盘：↑↓ 选择、↵ 打开、Ctrl+K（Mac 上 ⌘K）或 Tab 打开更多操作（显示所在位置、复制链接、在编辑器里打开）、Ctrl+1–9 直接打开第几个、Esc 关闭。常用的会自动排到前面；打开时还没输入，会显示你钉在桌面上的组件、快捷操作和最近用过的。

快捷键在 托盘 / 菜单栏 →「设置…」→「启动器设置」里改（也可以选 Ctrl+空格 或关掉）。本机应用的列表、图标和使用记录只存在这台电脑上，不会上传。

「应用」：比启动台更好用

按 Shift+Alt+空格（Mac 上 ⇧⌥空格）或点侧栏最上面的「应用」，打开全屏的应用网格：这台电脑上的应用、起始页里的网站和你的组件（实时显示）都在一起。

• 加组件：点「编辑」，左上角会出现「+」，挑一个你的组件、选小 / 中 / 大，它会落进网格（和应用图标对齐）；也可以在空白处右键 →「添加组件」，或点右上角「…」。组件右键可以换尺寸；点「−」移除后几秒内可以「撤销」。
• 单独的「应用」图标：「设置」→「启动器、应用和 AI 用量」→「应用」→「『应用』图标」。它有自己的图标（网格 + 组件），点它直接打开「应用」，不会打开组件世界的主窗口。Mac 上一键放进 Dock，像启动台一样用；Windows 会放进开始菜单（在那里右键 →「固定到任务栏」）；Linux 会出现在应用列表里。
• 整理：拖动图标排顺序；把一个图标拖到另一个上面停一下就建文件夹（文件夹名字可以改，拖出框外就拿出来）；点「编辑」后用「−」把不想看到的藏起来。新装的应用会自动加在最后。
• 找：直接打字就搜（应用名、英文名、网站名、组件名），↵ 打开第一个；方向键选择；触控板左右滑或滚轮翻页；Esc 关闭。
• 想让它代替系统的：添加上面的「应用」图标并放进 Dock / 任务栏；快捷键可选 F4（Mac 要在「键盘」设置里打开「将 F1、F2 等键用作标准功能键」）或 Win+Alt+A；也可以设「鼠标移到屏幕角落时打开」。再打开「登录时启动」，随时一个快捷键就到。
• 做不到的：系统自己的启动台 / 开始按钮 / Win 键 / 触控板手势没法替换（需要私有接口或常驻监听键盘，我们不做）。macOS 26 的「App」不能建文件夹、不能自己排顺序，这里都可以。

排列只存在这台电脑上，不会上传。

侧栏最上面现在是搜索框（点一下打开启动器），左下角显示你的头像、昵称和 Pro 标记，点开可以进账号中心或退出登录。

AI 用量：看看编程 AI 用了多少

如果你用 Claude Code、Codex CLI、Gemini CLI、opencode 或 GitHub Copilot CLI 写代码，电脑版可以读它们自己在这台电脑上留下的用量日志，算出每天用了多少 token、按各家 API 价格大概花了多少钱（估算；Claude Max、ChatGPT Plus 这类订阅不按 token 收费，这里是同样用量按 API 算的价格）。

• 默认关。打开：「设置」→「启动器、应用和 AI 用量」→「AI 用量」→「统计 AI 用量」，每个工具都可以单独关。
• 只读数字：只取 token 数、工具名和模型名，从不读取对话内容、文件路径或项目名；这台电脑上只记日志文件路径的哈希和读到哪了。
• 能看到：今天 / 近 7 天 / 近 30 天的 token 和估算费用、按工具、30 天的格子、模型分布。可以随时「暂停统计」「清空本机统计」。
• 同步到「我的数据」（默认关）：打开后每天的合计存进系统表「AI 用量」（默认只有你能看）。打开前先看「我们上传什么」——就是将要上传的那几列的真实几行：日期、工具、模型、输入 / 输出 / 缓存读 / 缓存写 token、请求数、会话数。
• 同步之后可以：在起始页加「数据」格子、在个人主页加「连接的数据」卡片（选「AI 用量」来源，你选了哪个数字才公开哪个），也能让你的 AI 通过 MCP 读取（get_my_series）。组件和公开页面能看到多少，由「组件和公开页面上显示多少」决定：只合计（默认）/ 加按工具 / 再加按模型。
• 「删除已上传的数据」会删掉「我的数据」里的 AI 用量表并关闭同步，本机统计不受影响。
• 暂不支持：Cursor（用量在 Cursor 服务端）、Aider（本机只有对话全文）、编辑器里的 GitHub Copilot（本机没有用量记录）。

阅读：在电脑上订阅和阅读 RSS

侧栏「阅读」是一个本机的 RSS 阅读器：订阅很多网站、博客、视频频道，在一个地方读完。抓取、保存和搜索都在你的电脑上完成，不经过我们的服务器；订阅列表、文章、已读和星标只保存在这台电脑上（换电脑用「导出 OPML」带走订阅）。

• 添加订阅：点「订阅」旁的 +，粘贴网址或订阅地址（网站自己声明的 RSS / Atom / JSON Feed 会自动找到），或者从「常用来源」里选：GitHub 版本发布、YouTube 频道、Reddit、Mastodon、Bluesky、Medium、Substack 这些是网站官方的订阅，最稳定。也可以导入其他阅读器导出的 OPML。
• RSSHub：没有 RSS 的网站（哔哩哔哩、微博、知乎、小红书、X……）可以通过 RSSHub 变成订阅。在「阅读设置」里填一个实例（例如你自己用 Docker 跑的 http://127.0.0.1:1200，点「检测本机」能自动找到）。公共的 rsshub.app 只供测试、经常限流；标着「要自建并配置 Cookie」「容易失效」的来源在公共实例上基本用不了。
• 阅读：三栏——订阅 / 文章列表 / 正文；「今天」「未读」「星标」三个智能视图；搜索标题和正文（全在本机）。只有摘要的订阅点「抓取全文」，在本机提取正文；某个订阅总是这样就右键选「总是抓取全文」。
• 键盘：j / k 下一篇 / 上一篇，s 星标，m 已读 / 未读，o 打开原文，f 抓取全文，/ 搜索，r 刷新。
• 刷新：App 在托盘 / 菜单栏里运行时也会按间隔刷新（默认 30 分钟；同时最多 4 个网站、同一个网站一个接一个；失败了自动拉长间隔）。托盘菜单显示未读数；启动器里也能搜到文章。
• 安全和隐私：文章内容经过严格清洗（去掉脚本、内嵌框架、表单），在隔离的视图里显示；跟踪像素一律拦截，图片不带来源网址，也可以在设置里关掉图片；不能订阅本机或内网地址（你自己填的 RSSHub 实例除外）。
• 存到别处（都只在你点了之后、只发这一篇）：「存到 Notion」（选一个分享给组件世界的 Notion 页面，存标题、链接和正文文字；先在「账号 → 连接」里关联 Notion）、「稍后阅读」（存进起始页的稍后阅读）、「AI 总结」和「AI 摘要未读」（按火花计费，发送前会提示发什么）。
• 桌面小组件：在文章的「存到…」菜单里选「放到桌面」，桌面上会出现「阅读」小组件，显示最新的未读（数据只在本机）。
• 翻译：文章右上角的「翻译」——「翻译（快速，免费）」每天有免费额度，「高质量翻译」按火花计费；可以选「原文 + 译文」逐段对照或「只看译文」。设置里可以打开「自动翻译外文标题」，某个订阅右键「总是翻译这个订阅」。只发送这一篇的文字（不含图片和链接地址），译文存在这台电脑上，再打开不再花费。
• 组件世界更新日志：第一次打开阅读时会默认订阅更新日志的 RSS（你的界面语言），不想要可以右键删掉；「常用来源」里也能再加回来。

屏幕使用时间

电脑版 1.6 起，侧栏「屏幕使用时间」可以看到这台电脑上今天 / 近 7 天按应用和分类（写代码、设计、浏览器、聊天……）用了多久，以及专注时都在用什么（例如「专注时 85% 在写代码」）。

• 默认关，打开后才开始记。只记最前面的应用名字和时长，从不记窗口标题、网址、文件名，不截屏、不记按键；一段时间没有键盘鼠标操作（默认 5 分钟）算离开，不计时。macOS 不需要「辅助功能」或「屏幕录制」权限。
• 数据存在这台电脑上；可以随时「暂停 1 小时」、排除某些应用、清空记录。
• 同步到我的数据（另外打开）：每小时一次，只上传每天每个分类的分钟数，存在「我的数据」的「电脑使用时间」表里，默认私人；还可以选择带上每个分类最常用的应用名。随时可以删除已上传的。
• 朋友能看到什么（默认关）：关 / 只有「正在专注」/ 加上应用分类（「写代码中」）/ 加上应用名（「在 VS Code 里」）。只有互相加了的朋友（「消息」里的联系人、同一个自习室的人）看得到；页面上一直显示朋友现在看到的内容，侧栏也有提示，一键暂停。
• Linux 需要 X11（安装了 xprop）；只有 Wayland 的桌面拿不到前台应用，暂时用不了。

小伙伴常驻桌面

「设置」→「小伙伴」→「常驻桌面」（默认关），或托盘菜单「小伙伴常驻桌面」。你的小伙伴会在屏幕底部（Dock / 任务栏上面）溜达：开始专注、专注结束、Agent 任务开始和完成、阅读来了新文章时会有反应，没人理它就睡觉。可以戳它、左右拖它；除了它身上，鼠标点击都会穿过去，不挡桌面。可以选大小、关掉「自己溜达」。

笔记、每日 SOP 和音乐

• 笔记：在笔记的「更多」里可以「打开本机文件」「存到本机」，像 Typora 一样直接编辑电脑上的 .md（自动存回文件，不上传）；双击 .md 文件也能用电脑版打开。Alt+Ctrl+N（Mac ⌥⌘N）随时新建一篇笔记，启动器里能搜到笔记标题。
• 每日 SOP：今天的提醒到点会发系统通知；运行一套 SOP 时，菜单栏 / 托盘显示进度（例如「巡检 3/6 · 下一步」）。
• 音乐：关掉主窗口（留在托盘）后音乐继续播放，键盘的媒体键可以控制；托盘菜单显示正在播放的歌，可以播放 / 暂停、下一首。

离线

没网时，快速面板的专注计时和待办照常用，联网后自动同步；桌面小组件显示上次的内容（时钟类照常走）。起始页这类网页内容需要联网，断网时显示离线页，联网后自动回来。

设置和更新

托盘 / 菜单栏 →「设置…」：语言、开机时启动（只在后台启动托盘和桌面小组件）、关窗后继续在托盘运行、全局快捷键、吸附网格、每个桌面小组件的层级和状态。

新版本会在后台下载好，侧栏出现「重启以更新」，点一下就完成；更新包带数字签名，签名不对不会安装。也可以在设置里「检查更新」。