StepBar 是一个更智能的 Toolbar：在你唤醒它的那一刻，就猜到你接下来想干什么，把「下一步的入口」直接送到眼前。
灵感来自两个好设计：
- 飞书的工具栏：一键唤醒，搜人、搜文档、搜各种信息——唤起即所得，不用先想好要去哪；
- Mac 的聚焦搜索：一个快捷键唤出面板，搜应用、搜文件——但它只匹配名字，不够 AI，不理解你此刻想干什么。
把两者合起来，再往前推一步：如果唤醒的那一刻，工具能猜到我接下来想干什么呢？ 不是等我组织好语言去搜，而是把下一步的入口直接送到眼前。这就是 StepBar。
名字就是宣言：不叫 Chrome Search——产品的核心不是服务 Mac、也不是服务 Chrome，而是一个更智能的 Toolbar，一下为你服务所有事情。
演示均为真实内容。
如果视频无法播放，可直接下载：stepbar-promo.mp4
有时，你知道想找什么，却记不起它叫什么。
浏览器开了几十个页面，标签越来越窄。你记得之前看过一篇讲强化学习的博客，解释得很好，却忘了标题、网站和打开的时间。
不必逐个翻标签，也不必猜关键词。唤起 StepBar，说一句：
“之前看的那篇讲 RL 的博客，里面解释了奖励模型。”
StepBar 要做的，不只是匹配标题，而是理解页面讲了什么、对你有什么用，让你用记忆里的描述找回它。你记住的是内容和意义，不应该被迫记住网址。
更进一步，你可能连下一步要打开什么，都不必重新寻找。办公不是一组孤立的搜索，而是一条跨应用的工作路径：看到消息、了解问题、查找资料、打开工具、继续处理。在未来的跨应用场景中，团队消息出现一条服务告警，授权应用通过 MCP 提供必要上下文，StepBar 结合过去的处理习惯，把相关指标页、日志查询和排查文档整理成建议。按 ⌘M，即可选择对应入口，继续工作。
从“帮我找到之前看过的东西”，到“帮我接上现在要做的事情”——这就是 StepBar 想走的路。
选浏览器作为第一个落地场景，因为它同时满足三个条件：
- 使用最频繁：监控告警、查问题、查反馈，大量工作入口都发生在浏览器里；
- 痛点最密：标签开多了挤在一起，不知道谁是谁，想找找不到；
- 边界最清晰：历史数据库与扩展提供了干净的上下文来源，便于先验证“理解 → 记忆 → 推荐”是否真正减少操作。
Chrome 是第一站，不是边界。 StepBar 的架构从第一天就按「智能 Toolbar + 连接器」设计，浏览器只是第一个连接器。
受 Hackathon 时间与技术条件限制，当前 v0.1.8 仅支持 macOS 13+、Apple Silicon 和 Google Chrome：按 ⌘M，输入几个词或使用已配置的语音，结合标签页、浏览历史、页面用途、剪贴板和过去的选择，找到或生成目标网页入口。默认使用阶跃星辰 Step Plan，也支持自定义服务。
这一版验证的是愿景里的基础闭环：获取上下文 → 理解用途 → 学习路径 → 推荐入口 → 从选择中继续学习。目前不读取其他应用或本地文件，不截图、不读屏幕；跨应用 MCP、工作路径组合和跨应用下一步预测均属于后续规划，不是当前已交付能力。
我们希望未来的办公工具能通过 MCP（Model Context Protocol）或适配器 与 StepBar 连接，按权限共享必要信息与操作能力。这个愿景不是持续监视设备：接入范围、共享信息、记忆和执行权限必须由用户控制。当前未实现跨平台或跨应用接入。
以下为先前在真实 Chrome 中录制的演示，未修改结果内容；不是本轮未发布 Top5／新提示词的复测证据，也不保证当前联网结果相同。
输入 kimicode github，从联网摘要中找到官方地址，直接打开 github.com/MoonshotAI/kimi-code，而不是一篇转载文章。
小红书 国庆去哪里玩：即使没在这个站点搜过，也能构造站内搜索地址。目标站点可能要求登录。
大模型会不会让程序员失业 知乎：去掉站名，只把问题带进知乎搜索。
阶跃 api 是啥：标题里没有这些词，靠后台为页面写好的用途和关键词，找回看过的「基本概念」文档。
只输入 deeps，上次选过的 DeepSeek GitHub 搜索页直接出现。熟悉的路径，不必每次重新寻找。
每次唤起，结果分三层逐步给出：
- 历史匹配（本机）：仅按原始标题和网址匹配 Chrome 标签页与历史；明确的回忆时间条件先过滤。查询入口、站内搜索和命令走独立通道。
- 语义匹配（本机）：Step 5 已整理的实体、别名、用途、关键词和常见问法，通过混合分词、IDF、覆盖率与缓存索引匹配，不是向量检索。
- ✦ Step（停止输入 150 ms 后）：本地与及时返回的联网结果先统一去重、融合排序，最多 5 个候选交给
step-3.7-flash。联网软等待 1.2 秒，晚结果只缓存；不发送当前页或剪贴板。模型挑选或提出模板动作，本机校验后展示。
后台模型理解页面用途并归纳网址结构。v0.1.5 首次立即准备、每 15 分钟或新增满 10 条增量分析，不再要求空闲接电或因唤起面板取消后台请求。支持的历史路径先在本地生成，不必等模型。
愿景、阶段边界和演进路径见 产品设计；当前实现及未来 MCP 连接设计见 技术实现。
当前下载包仍为 v0.1.8。工作区新版实现了原始标题／网址匹配、Step 5 结构化数据的本地索引，以及本地与联网结果统一 URL 去重、排名融合后最多 5 个候选交给 3.7。模型不再接收当前页或剪贴板；空输入只提供本地建议，不自动调用模型。生成入口由本机验证模板和取值，找不到时只在隐私和搜索设置允许下提供搜索兜底。完整规则、提示词位置与验收边界见 三层检索。
源码还支持明确 github owner/repo 的确定性直达、前台旧请求取消、5 分钟搜索缓存和模型失败反馈。合成测试通过不代表真实历史准确率或网络延迟；v0.1.8 下载包仍使用旧候选流程，未通过这些源码改动自动升级。
需要 macOS 13+、Apple Silicon（M 系列芯片）和 Google Chrome。目前没有发布 Intel 安装包。
- 下载最新版本与查看版本说明（在 Assets 中选择
StepBar-版本号-arm64.zip）
源码与 Releases 公开，无需 GitHub 登录或 Token。不要从不明来源下载。
- 下载 ZIP 并解压，得到
StepBar.app。 - 建议将应用移到
/Applications，或自己的~/Applications文件夹，再双击打开。直接从下载目录打开也可能被 macOS 隔离运行，更新时需要选择真正的应用文件。 - 首次启动若被系统拦截，按照下节步骤放行。
- 启动后在 屏幕顶部菜单栏 找到 StepBar 图标。它没有普通应用的主窗口，不出现 Dock 图标属于正常行为。
- 打开菜单栏 →「设置」，填写官方 Step Plan Key，或配置自定义后台／前台服务，保存后点击「测试已保存的 AI 配置」。安装包不含 Key，也不会自动读取源码旁的
config.local.json。 - 按下文安装 Chrome 扩展并验证连接，最后按 ⌘M 开始搜索。不配置模型也能先用本地检索。
当前使用本机固定签名，没有 Developer ID 签名与 Apple 公证。提示“Apple 无法验证 StepBar 是否包含恶意软件”表示系统无法验证开发者与公证状态，不等于已检测到恶意软件；也不能据此保证应用安全。只在确认安装包来源可信后放行。
- 尝试打开一次 StepBar，让系统显示拦截提示。
- 前往 系统设置 → 隐私与安全性。
- 向下滚动到「安全性」，找到“已阻止 StepBar 以保护 Mac”的提示，点击 仍要打开。
- 输入系统密码或使用 Touch ID，再确认打开。
如果没有“仍要打开”：重新尝试打开一次应用，然后回到该页面检查。受组织管理的 Mac 可能禁止放行，需要联系管理员。若提示明确指出“会损坏电脑”、检测到恶意软件或应用已损坏，不应按此方法绕过；停止运行并核对安装包。
不需要关闭 Gatekeeper、修改全局安全设置、开启完全磁盘访问或辅助功能权限。 麦克风权限仅在启用并使用语音时按需申请。未来正式分发需要 Developer ID 签名、Hardened Runtime 和 Apple 公证；本版尚未完成。
设置 →「版本与更新」，默认启动时和每 6 小时自动检查公开 GitHub Releases，无需 Token。可关闭自动检查；发现新版本后确认下载、验证并安装重启，不静默安装。
GitHub Releases 保存 ZIP 和 update-arm64.json（版本、文件名、架构、SHA-256）。匿名请求固定 GitHub API，只接受允许的 GitHub HTTPS 资源重定向。校验包摘要、版本、Bundle ID 和与当前应用相同的签名身份，不通过则不安装。以后版本必须使用同一签名证书；网络故障或匿名 API 限流时可手动下载。更新后 Chrome 扩展需重新加载。
v0.1.6 起，隔离运行时会让你选择应用程序或下载目录中真正的 StepBar.app，校验后等待当前进程退出，再替换并重启。不会清除隔离属性或关闭 Gatekeeper。v0.1.5 及以前没有此流程；若因隔离运行无法更新，请先手动安装一次 v0.1.6。失败会明确提示，安装阶段详情记录在本机 ~/Library/Application Support/StepBar/update.log。真实隔离环境的完整升级仍需现场验收。
额外需要 Swift 工具链（Xcode 或 Command Line Tools）。配置也可以直接在应用设置中填写；使用本机配置文件的开发者可按以下流程配置。
下面克隆的是公开仓库代码；本轮优化仅本地提交、尚未 push，重新克隆不会获得这些新实现。
git clone https://github.com/liuedcson/hackathon-StepBar.git
cd hackathon-StepBar
# 1. 配置 Key：复制模板，在两处 apiKey 填入 Step Plan Key
cp config.example.json config.local.json
chmod 600 config.local.json
# 2. 可选，只需一次：创建本机固定签名，保持后续构建签名身份一致
./scripts/setup-signing.sh
# 3. 构建并启动
./scripts/build.sh
open build/StepBar.appconfig.local.json 已被 .gitignore 忽略。其中 summary 是后台模型（step-5-preview），quick 是唤起时的模型（step-3.7-flash），两者都使用 https://api.stepfun.com/step_plan/v1。
菜单栏 →「设置」→「模型配置」：
- 官方 · StepFun Step Plan：地址固定为官方 Step Plan；后台记忆和前台检索的 Model ID 分别填写，共用一个 Step Plan Key。
- 自定义 · OpenAI 兼容协议：后台记忆、前台检索分别填写 Base URL、Model ID 和 API Key，可使用不同服务。Base URL 通常以
/v1结尾，也可填写完整/chat/completions地址；本机服务支持 HTTP，其他地址要求 HTTPS。 - API Key 使用单行密码框；已有授权时静默读取，无授权留空、不弹后台授权窗口。未编辑保存不删除旧 Key，主动编辑并清空后保存才删除。保存后立即生效，点击「测试已保存的 AI 配置」分别以
max_tokens=1检查后台和前台连通性，不生成业务内容、不发送浏览历史；不代表搜索、语音或 JSON 输出均已验证。 - 官方模式的搜索和语音使用 Step Plan；自定义模式完全不调用 Step Plan。自定义搜索默认关闭，可选择 Bing 等搜索引擎入口（仅点击后打开，不提供模型上下文），或配置独立的搜索 JSON API（完整 URL、独立 Key，POST
{query,n}，返回{results:[{title,url,snippet,time?}]}）。 - 自定义语音默认关闭。需要时配置 OpenAI 兼容音频转写接口的完整 URL（如
https://asr.example/v1/audio/transcriptions）、Model ID 和独立 Key。发送 multipart WAV，返回{text}。未启用或未配置完整时不录音、不请求麦克风权限；不支持此协议的服务请保持关闭。
自定义模式不发送 Step 专用推理参数；支持 JSON 输出的服务可开启「请求 JSON 输出模式」。官方和自定义配置分别保留，切换模式不会覆盖另一套 Key。
扩展就在 Git 仓库里：browser-extension/。 文件包括 manifest.json、background.js、连接状态页和图标。pairing.json 是每台机器生成的私有配对配置，故意不提交到 Git，不能共用或上传。
方式一：使用安装包（推荐，不需要下载源码）
- 先启动 StepBar，保持菜单栏应用运行。
- 点击菜单栏 → 设置 → Chrome 扩展 → 安装 Chrome 扩展。应用会准备扩展资源，在 Finder 中选中文件夹，并尝试打开 Chrome 扩展页。
- 在 Chrome 地址栏输入
chrome://extensions，打开右上角 开发者模式。 - 点击 加载已解压的扩展程序，选择 Finder 中的
StepBar-browser-extension文件夹。不是选择 ZIP、.app或某个 JS 文件。 - 如果找不到文件夹：在选择窗口按 ⌘⇧G，粘贴
~/Downloads/StepBar-browser-extension，再选中它。 - 扩展会读取该目录里的本机配对码自动连接。这个目录需长期保留；不要加载后删除或移动。
v0.1.1 会将可加载的扩展准备到下载目录；再次点击可刷新文件，再在 Chrome 中点「重新加载」。旧版 v0.1.0 仍使用 ~/Library/Application Support/StepBar/browser-extension，从旧版升级请移除旧扩展并加载新目录。
方式二：从 Git 仓库加载扩展
- 克隆仓库或在 GitHub 选择 Code → Download ZIP 并解压。
- 在
chrome://extensions开启开发者模式，加载源码中的browser-extension/文件夹。 - 开发运行的 StepBar 会在可定位到的源码扩展目录自动写入本机配对文件；确认应用桥接已启用且未暂停。
- 在 StepBar 设置中点「测试连接」，或点 Chrome 工具栏扩展图标查看状态。若不能自动连接，使用应用「安装 Chrome 扩展」导出的目录再加载，不手动填写配对码。
如何确认安装成功
- Chrome 扩展列表里能看到 StepBar for Chrome，且启用开关已打开。
- 扩展连接页显示「已连接」；StepBar 设置里的「测试连接」收到真实无副作用 probe／ack 确认，端口监听或旧心跳不能替代测试。
- 打开两个公开网页，按 ⌘M 搜索其中一个的标题。选中已经打开的标签页后，应切回原标签页。
连接失败时，检查 StepBar 是否运行、桥接是否启用且未暂停；重新点击「安装 Chrome 扩展」刷新导出文件，再在 Chrome 重新加载并测试。升级应用后也先刷新导出文件；从头重装时移除旧扩展再加载新目录。不要移动或删除 Chrome 正在加载的目录。
扩展上报标签页、读取停留页面的正文摘录，并执行切换／关闭标签页；不读取无痕窗口。不装扩展也能搜索 Chrome 历史，但没有扩展提供的标签页上下文、切换／关闭和页面正文能力。
完整重装、验收与故障排查见 安装与使用指南。
应用首次启动后，会在本机记忆目录准备卸载工具。无需 Python、无需下载源码，在 macOS「终端」执行一行：
/bin/zsh "$HOME/Library/Application Support/StepBar/uninstall.sh"输入 YES 确认后，工具会退出 StepBar，删除应用、本机记忆、设置、缓存、专用钥匙串密钥和应用导出的扩展目录。删除不可撤销。
最后打开 chrome://extensions → StepBar for Chrome → 移除。Chrome 历史、用户资料和其他扩展不受影响。
源码和 config.local.json 会保留；后者可能包含自行配置的 Key，不再需要时请自行删除。只把 .app 移到废纸篓不会清除记忆与密钥。
此卸载工具从 v0.1.2 起提供；使用更早版本时，请先更新并启动一次应用。
唤起与输入
- ⌘M — 唤起或关闭面板。
- 输入 — 本机结果实时出现，停顿后 ✦ Step 结果置顶。
- 长按 ⌥M — 先唤起 StepBar，在面板内长按才录音，松开结束；官方默认由
stepaudio-2.5-asr转写。不会后台采集。
历史准备与用量
设置中的「首次使用与历史准备」展示近 90 天历史载入数量、本地标识符路径和 AI 待处理数量，可重新准备。首先在本地扫描全部可读取、未排除的 Chrome 历史；有两个不同实例支持的 ID 地址模板可直接复用，不需要先等待 AI。首次配置完成立即分批准备，随后每 15 分钟或新增满 10 条增量分析，不要求空闲、接电或小时额度。每批最多理解 10 个页面，输出上限 4096 tokens；失败退避重试，用户暂停时停止。移除离开历史范围的页面理解和网站模式，正文按保留周期清理，不回访历史网页。没有历史证据时不会凭空生成 traceid 等查询入口。
「Token 用量」展示本次运行、今日、累计及输入／输出 tokens，来自模型返回的 usage，包括前台、后台和连接测试；未返回用量单独计数，不冒充零消耗。搜索和语音费用不包括在内，Token 不是金额。设置中的 Chrome 扩展状态显示 Ready、最近心跳；超过 60 秒无心跳显示连接过期，桥接端口监听成功不代表扩展已连接。
选择与打开
- ↑ ↓ / ↩ — 选择并打开；已打开的页面切换到原标签页。
- ⌘1–9 — 直接打开第 N 项。
- Tab — 让 Step 再生成一次动作。
退出与整理
- ⌘⌫ — 关闭选中的标签页。
- Esc — 先清空输入，再按一次关闭面板。
不输入直接 ⌘M 时，显示和剪贴板相关的建议以及最近的页面。
设置 →「记忆」，可以查看历史准备、后台页面理解、网址模式、学到的查询入口和选择，也可以逐条删除。菜单栏只保留设置、暂停／恢复和退出。
- 记住选择：源码优化版只给已相关结果加权；同输入选过至少两次的相关原始页面可走免模型快路径，不注入无关页面。
- 学会站内搜索：在某个网站搜过之后，下次「站名 + 关键词」直接在那里搜；GitHub、知乎、小红书、B 站等常见网站内置了搜索入口。
- 学会查询入口：复制一个 ID 后两分钟内打开了含这个 ID 的网址，下次复制新 ID 唤起，就能直达从没访问过的对应页面。
- 理解页面：后台定时定量整理真正新增页面，消耗 Token 和电量；理解可改善换说法检索，不保证准确率随使用单调提高。
- 所有记忆保存在本机
~/Library/Application Support/StepBar/，可在诊断窗口查看和删除。 - 联网搜索只发送你输入的词，不发送剪贴板、页面内容或历史。回忆类输入（「上周看的…」）、链接，以及含订单号、长 ID 或疑似密钥的输入不会联网。
- 发给模型前统一脱敏：手机号、邮箱、证件号会被替换，疑似密钥的剪贴板内容整段丢弃，带 token、session 等敏感参数的网址整条不发送。
- 不截图，不读取屏幕，不读取无痕窗口。可在设置里排除域名、关闭后台理解或联网搜索。
- 源码优化版前台只发送主动 query、最多 5 个融合候选和相关模板，不发送 current／clipboard；公开 v0.1.8 仍是旧流程。
- 浏览器桥接仅监听本机回环地址，默认端口 17373，占用时尝试 17374–17393；每个请求均须本机配对凭据，自动同步实际端口。
下面诊断可能读取配置、浏览历史并调用模型；仅在明确授权后运行，输出不要直接公开。本轮验证使用合成／隔离数据，未运行真实历史基准。完整验收清单见 产品验收，发布门禁见 发布与升级。
./scripts/test.sh # 单元测试与桥接测试
./scripts/build.sh # 构建 build/StepBar.app
# 命令行诊断（需要 config.local.json）
.build/release/StepBar --search-check "阶跃 api 是啥" # 逐层打印候选、联网结果、模型输出和耗时
.build/release/StepBar --model-bench "q1" "q2" # 多个查询的端到端耗时
.build/release/StepBar --understand 1 # 跑一轮后台页面理解与网址模式归纳
.build/release/StepBar --eval-search # 用本机搜索日志计算命中率本项目为 Hackathon 作品，暂未附带开源许可证。