SecretBridge
EN快速开始
首页 / SecretBridge

SECRETBRIDGE · 快速开始

让 AI 帮你安装 SecretBridge

复制推荐内容到可在本机执行命令的 AI 会话，由助手检查已有安装、验证发行包、部署本机代理并接入 MCP。

SecretBridge 在你的电脑上运行。请把下面的内容发给可在本机执行命令、能展示变更并请求确认的 AI 助手；首次设置中的 PIN 与恢复密钥由你在本机页面亲自处理。

  1. 01复制推荐内容无需预先下载仓库
  2. 02粘贴到 AI 会话使用能操作当前电脑的客户端
  3. 03由 AI 检查并部署你审阅需要修改的内容
  4. 04完成本机设置亲自设置 PIN 与恢复密钥

推荐方式

交给你正在使用的 AI 助手

复制后直接粘贴到会话。助手会先检查已有安装，再核对发行包、安装本机代理、接入 MCP，并把需要你处理的本机设置交还给你。

请在当前电脑安装或复用 SecretBridge，并接入我正在使用的 MCP AI 客户端。产品仓库：https://github.com/qq940500529/secretbridge。请实际完成可执行的部署与只读连接验证，不要只给出安装步骤；可以从任意目录开始，不要假设仓库已下载。

1. 先检查当前客户端已有的 SecretBridge MCP 配置、PATH 和产品文档列出的默认安装记录。找到候选程序就运行 status；健康且版本适用时直接复用，后台已停止时使用该活动程序启动。不要因为换了对话或客户端就重复安装；若发现自定义安装但无法定位，先问我，不要另装一份。
2. 需要新装时，先阅读仓库 AGENTS.md、SECURITY.md，以及 docs/getting-started/AI辅助部署.md、自动化部署运行手册.md、安装与服务管理.md。核对本机系统与架构，优先选择最新适用的 GitHub Release 原生包，下载同名 .sha256，核对摘要并运行 verify-package；仅在没有适用发行包时，才在新目录从最新 main 构建并完成文档要求的检查。
3. 在修改安装目录、系统配置或客户端 MCP 配置前，展示目标、将执行的命令与必要备份，并等待我确认。0.3.1 不支持直接覆盖旧版数据；评估新版本时保留旧安装和独立备份，使用单独的空白数据目录。任一下载、校验、构建或安装步骤失败时停止排查，不跳过检查、不覆盖旧数据、不降低本机安全设置。
4. 启动或复用后台，确认 status 正常且管理端仅监听本机回环地址。使用 install 或 status 返回的活动程序路径运行 client-config CLIENT，按当前客户端格式只合并 SecretBridge 项并重载；确认工具可见，再调用只读的 secretbridge_terminal_capabilities 验证 MCP 连接。无法安全修改客户端配置时，给我准确的可粘贴片段和重载步骤。
5. 新装后检查 install 返回的 management_page：若为 opened，不要再次调用 open；若为 manual_open_required，且当前电脑有交互桌面，才用活动程序的 open 打开本机管理页。协议确认、PIN/口令设置、恢复密钥保存和可选身份验证器绑定由我在本机页面亲自完成。不要读取、代填、截图或转发这些值及一次性配对链接。
6. 最后重新检查服务和 MCP 只读能力，并报告复用或新装、版本、验证结果与剩余人工步骤。不要访问既有凭据库条目，也不要在对话、命令、环境变量、日志或共享报告中暴露秘密值、个人路径、私人主机信息或配对材料。

依据产品仓库的 部署说明 编写。AI 无法在本机运行命令时，请使用下方备用资料。

当前 0.3.1 与旧版数据不兼容。AI 应复用健康的现有安装；若要评估新版，须保留旧安装与独立备份，使用单独的空白数据目录。

查看备用的手动安装与发行包资料
01

已有安装？先复用

先查看当前 AI 客户端的 SecretBridge MCP 配置、PATH 中的程序，以及文档列出的当前系统默认安装记录。只检查这些明确位置，不扫描整个用户目录。

找到候选程序后运行 status。若版本适用且运行正常，直接使用；若 running 为 false，用该安装的活动程序执行 start。更换客户端或开启新对话都不需要重复安装。

查看默认安装位置和复用规则

SecretBridge 0.3.1 · 2026-10-10 · 源码提交 a82cd12 · 数据结构 25 / 配置包格式 2

02

没有可用安装时，选择平台

选择与你的系统和架构匹配的公开发行包。只从产品仓库的 GitHub Release 获取；没有适用包时，请阅读上游源码构建文档。

Windows x86_64

secretbridge-0.3.1-windows-x86_64.zip

18.1 MiB · 完整原生包 · 发行说明

从 GitHub 下载 SHA-256
SHA-256
a6194d1f342d889b64b89592cfc378cfde9d1014cf028eaf11d728da07569f84

核对摘要、验证包，再安装

先将系统计算的摘要与上方值及同名 .sha256 文件逐字核对。仅在一致时继续解压；verify-package 必须成功后才运行 install。命令以新下载目录为例，不要覆盖旧版数据目录。

& {
  $ErrorActionPreference = 'Stop'
  $expected = 'a6194d1f342d889b64b89592cfc378cfde9d1014cf028eaf11d728da07569f84'
  $actual = (Get-FileHash .\secretbridge-0.3.1-windows-x86_64.zip -Algorithm SHA256).Hash
  if ($actual -ne $expected) { throw 'SHA-256 mismatch; stop.' }
  Expand-Archive .\secretbridge-0.3.1-windows-x86_64.zip -DestinationPath .\secretbridge-package
  Set-Location .\secretbridge-package
  .\bin\secretbridge.exe verify-package (Get-Location).Path
  if ($LASTEXITCODE -ne 0) { throw 'Package verification failed; stop.' }
  .\bin\secretbridge.exe install (Get-Location).Path
  if ($LASTEXITCODE -ne 0) { throw 'Installation failed.' }
}

验证材料与历史版本

原生包包含文件清单、CycloneDX 1.6 SBOM、第三方许可和对应源码。核对 GitHub 发行来源、摘要与包清单后再安装。

包验证指南 · 历史版本 · 查看对应源码 · 产品安装原文

发行元数据核对于 2026-10-12 UTC · 页面使用随网站构建保留的已核验记录。