Vibebar

# 振动条:: [](https://bridgeware-dynamics-business.github.io/Vibebar/) [](https://github.com/Bridgeware-Dynamics-Business/Vibebar/releases/tag/1.1.0-pr) [](https://github.com/Bridgeware-Dynamics-Business/Vibebar/releases/tag/1.1.0-pr) 一款适用于 **编程辅助** 的浮动 Windows 伴侣，适用于 Cursor 等 AI 助手。它停靠在屏幕边缘，让您的项目上下文、提示、安全检查、终端工作流和 Cursor 代理连接一键即可访问 — 这样您就可以保持专注，而不是不断寻找上下文。 **当前版本：** [1.1.0 预发布版](https://github.com/Bridgeware-Dynamics-Business/Vibebar/releases/tag/1.1.0-pr) · 请参阅 [更新日志](CHANGELOG.md) 和 [版本控制](VERSIONING.md) 以了解发布策略。 ## 文档 **阅读文档：** [bridgeware-dynamics-business.github.io/Vibebar](https://bridgeware-dynamics-business.github.io/Vibebar/) | 如果您想… | 从这里开始 | |--------------|------------| | 安装 VibeBar | [安装和设置](https://bridgeware-dynamics-business.github.io/Vibebar/guide/getting-started) | | 学习工作流程 | [您的第一个会话](https://bridgeware-dynamics-business.github.io/Vibebar/guide/first-session) | | 查看所有工具 | [工具栏和工具](https://bridgeware-dynamics-business.github.io/Vibebar/features/) | | 连接 Cursor 代理 | [MCP 服务器](https://bridgeware-dynamics-business.github.io/Vibebar/features/mcp-server) | | 解决问题 | [故障排除](https://bridgeware-dynamics-business.github.io/Vibebar/help/troubleshooting) | 新用户：[什么是 VibeBar？](https://bridgeware-dynamics-business.github.io/Vibebar/guide/what-is-vibebar) ## 下载 从 **[发布版本](https://github.com/Bridgeware-Dynamics-Business/Vibebar/releases/tag/1.1.0-pr)**（当前为 **1.1.0 预发布版**）获取最新的 Windows 安装程序。然后按照 [安装指南](https://bridgeware-dynamics-business.github.io/Vibebar/guide/getting-started) 进行操作。 ## 工具栏 VibeBar 是一个薄的、始终在顶部的条形，可以吸附在任何监视器的左侧、右侧或顶部边缘。每个工具都会在条形旁边打开一个内联的玻璃面板 — 任何面板都可以 **分离** 成自己的浮动窗口。按 `Ctrl+Shift+P` 即可打开命令调色板，通过键盘访问所有功能。 ## 功能 ### 上下文和切换 - **最近项目** — 从工具栏下拉菜单或命令调色板（`切换项目`）切换到您最近的 10 个项目文件夹。 - **提示库** — 具有保护措施和复制时秘密删除的项目感知模板。 - **上下文打包器** — 将选定的文件捆绑成一个可粘贴的 AI 提示；**打包更改** 获取具有令牌估计的 git 修改文件。 - **会话中心** — 提示、差异、审计发现和终端问题的时序记录。固定项目并复制一个结构化的切换提示（完整文本存储在复制时），按类型筛选，并查看工具栏上的固定计数徽章。**同步项目上下文** 读取 AGENTS.md / Cursor 规则。 - **Git 差异提示** — 将暂存 + 未暂存的更改复制为 AI 就绪提示（在您有更改时右键单击 GitHub 徽章）。 - **快照到 AI 上下文** — 将屏幕区域直接捕获到您的 AI 上下文文件夹中。 - **笔记** — 项目 Markdown 笔记，带有任务列表；**保存到笔记** 来自审计发现和终端问题。 ### 质量和验证 - **安全审计** — 只读静态扫描，带有修复提示，可选的 `npm audit` 供应链建议和 SARIF/Markdown 导出。 - **就绪检查** — 一个预提交的三态门控（看起来准备好了 / 需要审查 / 被阻止），它显示阻止因素和可复制的审查简报。 - **智能终端** — 运行命令，检测问题，重新运行，并关闭发现。 ### Cursor 代理集成 - **Cursor 代理菜单** — 一个专用的工具栏按钮（插件图标），用于所有 MCP 操作。启用本地服务器，查看实时连接状态，复制 `mcp.json` 代码段，并调整 Cursor 自动化切换 — 所有这些都在一个地方。当 Cursor 处于活动连接状态时，按钮会变成绿色。 - **MCP 服务器** — 一个可选的只读 [MCP 服务器](https://bridgeware-dynamics-business.github.io/Vibebar/features/mcp-server)，运行在 `127.0.0.1:17342`，允许 Cursor 代理读取 VibeBar 会话状态（意图，就绪检查，git 状态，审计摘要等）而无需复制粘贴。仅限本地主机 — 无 API 密钥，无云中继，无聊天界面。 - **准备 Cursor** — 复制一个代理启动程序（意图，验证配方，就绪检查简报，MCP 使用提示）并在您的项目上打开 Cursor。 ### 启动和同步 - **代码同步** — 连续同步到 AI 上下文文件夹。 - **快速启动** — 在活动项目上打开 Cursor（或其他编辑器）。 - **首次运行引导** — 一个可跳过的向导，用于项目选择，Cursor 设置，AI 上下文文件夹和会话中心介绍。 ## 编程辅助工作流程 1. 从工具栏文件夹按钮 **选择您的项目**。 2. *(可选，一次)* 打开 **Cursor 代理** 按钮 → 启用 MCP 服务器，将 `mcp.json` 代码段复制到 Cursor，然后重启 Cursor。现在，代理可以直接读取您的会话状态。 3. 像平常一样使用 Cursor（或其他编辑器）**编码**。 4. 当您需要 AI 帮助时： - 从库中复制一个 **提示**，或 - **打包上下文** / **复制 git 差异** 以获取更改的内容，或 - 运行 **安全审计** 并复制修复提示。 5. 粘贴到 Cursor 聊天 — 如果已连接 MCP，则可以完全跳过粘贴操作。使用 **打开 Cursor** 在复制的提示上快速跳转回来。 6. 在 **会话中心**（火花图标 — 徽章显示固定计数）中 **固定** 重要项目并 **复制切换** 以发送一个结构化的 Markdown 包。使用 **复制修复提示** 仅用于审计/终端修复。 7. 在提交前运行 **就绪检查**，然后在智能终端中 **验证**（`npm test` 等）— 重新运行最后一个命令并标记问题已解决。 会话数据存储在每个项目的 `.vibebar/session.json`（git 忽略）中。当存在 AGENTS.md 时，切换包括 AGENTS.md 的摘录。审计基准和规则切换存储在 `.vibebar-audit.json` 中。 ## Cursor 代理（MCP）概览 | | | |---|---| | **端点** | `http://127.0.0.1:17342/mcp`（仅限本地主机） | | **从** | **Cursor 代理** 工具栏按钮 → *为 Cursor 启用 MCP 服务器* | | **配置路径** | `%USERPROFILE%\.cursor\mcp.json`（或项目级的 `.cursor/mcp.json`） | | **公开** | 只读资源（会话固定，意图，就绪检查，git 状态，审计摘要，...）以及工具（`pack_changed`，`ready_check`，`get_intent`，...） | | **写入** | 仅会话元数据（`set_intent`，`record_outcome`）— 绝不写入您的源文件 | 请参阅完整的 [MCP 服务器指南](https://bridgeware-dynamics-business.github.io/Vibebar/features/mcp-server)，了解设置、资源/工具目录和安全说明。 ## 性能说明 - **审计扫描** 使用增量逐文件缓存；自动扫描合并飞行中的运行，并静默镜像到打开的终端。 - **上下文打包器** 延迟加载目录，并带有 debounce 展开和加载指示器。 - **会话中心** 将可见的时间线限制在 100 个条目（带有“显示较旧的”）；页脚显示本地“接下来是什么？”启发式。 - **命令调色板** memoizes 操作并 debounce 模糊搜索（150ms）。 - **分离的面板和智能终端** 恢复保存的窗口边界；移动/调整大小时，位置/大小持续存在。 ## 全局热键（默认启用） | 快捷键 | 操作 | |----------|--------| | `Ctrl+Shift+P` | 命令调色板 | | `Ctrl+Shift+H` | 显示/隐藏工具栏 | | `Ctrl+Shift+T` | 切换智能终端 | 在 **设置 → 行为** 中切换热键。 ## 本地运行 从存储库根目录： ```bash npm install npm run dev ``` 运行测试： ```bash npm test ``` 类型检查： ```bash npm run typecheck ``` 构建 Electron 应用程序： ```bash npm run build npm run dist ``` 在本地编辑文档站点：`npm run docs:dev` ## 要求 - Windows 10+ - Node.js 20+ - Git（用于 git 状态，差异和更改跟踪） - [Cursor](https://cursor.com) 或其他编辑器（可选，用于快速启动和 MCP） ## 贡献 请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 和文档站点上的 [贡献指南](https://bridgeware-dynamics-business.github.io/Vibebar/contribute/contributing)。 ## 许可证 请参阅 [LICENSE](LICENSE)。