bridge

<div align="center"> # 桥接 **Claude Code 的操作系统。** 一个用于管理 MCP、技能、代理、插件、斜杠命令和钩子的可视化仪表盘。 [](LICENSE) [](https://github.com/noahtekle/bridge/releases) [](https://bridge-stack.pages.dev) </div>  --- ## 什么是桥接？ Claude Code 的强大用户界面分散在 `~/.claude.json`、`~/.claude/settings.json` 和用于技能、代理、斜杠命令和钩子的文件夹中。没有任何原生界面。您需要手动编辑配置来管理您的栈。 桥接是缺失的图形用户界面层。 - 在一个仪表盘上查看所有 MCP、技能、代理、插件、斜杠命令和钩子 - 开关、编辑描述、删除并保留备份 - 直接从 GitHub URL 导入技能、代理和插件 — 桥接检测类型并在安装前预览 - 发现选项卡，包含精选、验证 URL 的插件和技能 — 通过相同的流程一键安装 - 受 Linear/Raycast/Arc 启发的界面，默认黑暗模式，系统主题同步 - 仅限本地 — 您的配置从未离开您的机器 ## 截图 ### 命令调色板  ### 发现选项卡  ### 卡片详情  ### GitHub 导入  ### 设置  ## 下载 **v0.1.0 仅支持 Windows。** Mac 支持将在 v0.1.1 中实现，并进行适当的代码签名 — 未签名的 Mac 二进制文件会触发 Gatekeeper 过度激进的保护。 | 平台 | 下载 | |---|---| | Windows (x64) | [最新版本](https://github.com/noahtekle/bridge/releases/latest) | **v0.1 版桥接未签名。** Windows 首次启动时会出现 SmartScreen 警告 — 请参见下面的[绕过说明](#为什么未签名)。 或者从源代码构建： ```bash git clone https://github.com/noahtekle/bridge.git cd bridge pnpm install pnpm dev ``` ## 为什么未签名？ 桥接是开源的。每次写入都会先备份。除了您明确触发 GitHub 导入外，没有任何网络调用。您可以在运行前阅读源代码。 签名在现有基础上添加了一层操作系统级别的信任。对于未来的版本，我们将实现签名。 ### Mac 支持 Mac 支持即将到来，版本为 v0.1.1。v0.1.0 未签名的 `.dmg` 文件会在首次启动时产生过多的 Gatekeeper 错误 — 这不是此应用程序应该提供的体验。 与其发布变通方法，v0.1.1 将实现适当的代码签名和验证。 如果您今天想在 Mac 上使用桥接，可以从源代码构建 — `pnpm install && pnpm build:mac` 会生成一个未签名的 `.dmg` 文件，您可以右键单击并选择“打开”。 ### Windows — 首次启动绕过 Windows SmartScreen 在首次启动时会出现警告，因为桥接未签名。以下是绕过方法： **步骤 1：** 当您看到此对话框时，单击 **“更多信息”**：  **步骤 2：** 出现新的“仍然运行”按钮。单击它：  **步骤 3：** Windows 会记住您的选择。未来的启动将正常进行。 ## 隐私 **桥接在本地读取您的 Claude Code 配置，从不联网。** 无遥测。无分析。无崩溃报告。无帐户。无云。除了您明确触发 GitHub 导入外，无任何网络调用。这是合同 — 任何违反此合同的行为都是一个错误。 在进行任何修改之前，您的配置备份将写入 `~/.claude/backups/<timestamp>/`，并自动轮换（最近 50 个或最近 30 天，以较宽松为准）。原子 JSON 写入（`.tmp` + `fsync` + `rename`），因此在写入过程中进程崩溃不会损坏原始文件。 设置存储在 Bridge 自己的目录中，即 `<userData>/bridge-settings.json` — 绝不会污染您的 `~/.claude/`。 ## 功能（v0.1） - ✅ 六大类：MCP、技能、代理、插件、斜杠命令、钩子 - ✅ 读取管道扫描 `~/.claude.json` + `~/.claude/`，也检测插件捆绑的项目 - ✅ 文件监视器（chokidar）— 外部编辑在 ~1 秒内更新仪表盘 - ✅ 开关、编辑描述、删除 — 每次修改都先备份，原子操作 - ✅ 需要重启的横幅，当 MCP/插件更改需要重启 Claude Code 时 - ✅ GitHub 导入：粘贴 URL → 克隆 → 检测 → 预览 → 安装（支持 monorepo 子路径） - ✅ 发现选项卡：16 个精选的插件和技能，通过导入流程一键安装 - ✅ Cmd-K 命令调色板：搜索栈 + 操作 + 快速开关 + 快速删除 - ✅ 设置：主题（系统/浅色/深色）、备份保留、聚焦时扫描 - ✅ 隐私模态：首次运行 + 从设置链接 - ✅ “未检测到 Claude Code” 首次运行时的备用方案，如果 `~/.claude/` 丢失 - ✅ 热键：Cmd-K 调色板、Cmd-, 设置、Cmd-N 新建（导入）、Cmd-R 重新扫描、Cmd-F 搜索、Esc 关闭 - ✅ Windows（x64）已在 v0.1.0 中发布 — Mac（Apple Silicon + Intel）将在 v0.1.1 中发布，并具有适当的代码签名 ## 路线图 从 v0.1 推迟，按可能实现顺序排列： - **MCP 安装路径** — 读取 MCP 服务器 README，生成 `mcpServers` JSON，追加到 `~/.claude.json`（解锁 ~10 个额外的发现条目） - **代码签名和验证** — Mac 和 Windows - **通过桥接安装插件** — 目前路由到 Claude Code 的 CLI 提示；原生安装支持 - **卡片右键上下文菜单** - **拖放文件夹导入** - **备份差异查看器**，一键恢复 - **市场 + 链接分享** — 社区贡献的设置 - **云同步**（付费层）— 跨机器同步您的栈 ## 架构 - **栈：** Electron 32 + Vite + electron-vite + electron-builder，React 18 + TypeScript，Tailwind + shadcn-style 组件，Lucide，Framer Motion，Zustand - **仓库布局：** pnpm 工作区 — `apps/desktop`（Electron 应用程序），`apps/web`（marketing site 在 `bridge-stack.pages.dev`），`packages/core`（共享类型 + IPC 合同），`packages/ui`（设计令牌） - **安全性从 commit 1 开始：** `contextIsolation: true`，`nodeIntegration: false`，`sandbox: true`。渲染器 ↔ 主进程仅通过 `packages/core/src/ipc.ts` 中的类型化 IPC 合同进行通信。文件系统访问存在于主进程中；渲染器从不触摸磁盘。 - **测试：** 58 个 vitest 测试，涵盖 ConfigWriter（切换/删除/编辑每类别，队列序列化），备份快照 + 轮换，钩子扫描器 + 编写器，GitHub 导入检测，monorepo 子路径遍历安全性。实际的 `~/.claude/` 从未被触摸 — 测试在 `BRIDGE_CLAUDE_HOME` 临时目录中运行。 在 [`CHANGELOG.md`](CHANGELOG.md) 中查看每週构建日志。 ## 贡献 欢迎 PR。目前最有用的贡献是添加一个到发现列表的条目 — 请参见 [`apps/desktop/src/main/discover/README.md`](apps/desktop/src/main/discover/README.md)。五个代码行的 PR。 随时提出问题和功能请求 — 请参见 [`.github/ISSUE_TEMPLATE/`](.github/ISSUE_TEMPLATE/)。 ## 许可证 MIT — 请参见 [LICENSE](LICENSE)。由 [@noahtekle](https://github.com/noahtekle) 构建。