安装与首次设置
验证发行包，完成本机安装、配对和恢复密钥保存。
概览
先核对平台对应的发行包和 SHA-256；0.3.1 需要全新的空白数据目录，不可覆盖旧数据库。解压完整原生包后运行 verify-package，再执行 install。程序、Web 资源、许可和清单应保持在同一个包中。
边界与检查
管理页仅在本机回环地址开放。你亲自接受协议、设置 PIN 或较长口令，并离线保存只展示一次的恢复密钥。代理不会把这些内容交给 MCP 客户端。
先检查已有安装
更换 AI 客户端或开启新对话通常不需要重新安装。先查看现有 MCP 配置中的程序路径、PATH 和默认安装记录，再用当前活动程序运行 status。如果显示后台未运行，运行 start 即可。若此前使用自定义数据目录但路径不明，应先找到原位置，避免新建第二份数据。
推荐的安装流程
- 在安装说明复制请求，交给能够在这台电脑执行命令的 AI 助手；它应先确认现有安装，适配时优先使用产品发行页的包。
- 核对系统与架构，下载完整包及相应 SHA-256 文件。对照发行页核验归档，再解压并运行
verify-package。详见包校验。 - 在安装或修改 AI 客户端配置前，检查目标目录、命令和最小改动。包内程序的
install 包目录会复制整包到当前用户的安装目录并启动后台；不要只复制可执行文件。 - 若安装结果显示浏览器未自动打开，在运行代理的本机交互桌面执行活动程序的
open。首次配对由程序打开一次性本机链接；本人接受协议、设置 PIN 或较长口令，安全保存只显示一次的恢复密钥。 - 使用活动程序生成客户端配置，重载 AI 客户端，调用只读
secretbridge_terminal_capabilities验证 MCP 连通。随后用一次性测试资源走完申请、审批和受限结果流程。
后台控制与生命周期
| 命令 | 用途 |
|---|---|
status |
查看后台、版本与安装路径 |
open |
打开本机管理页；首次未设置 PIN 时生成新的一次性配对链接 |
start --no-open / stop |
启动或停止后台；停止会中断活动终端与任务 |
client-config CLIENT |
打印当前安装对应的 MCP 配置，不修改客户端文件 |
安装后由用户决定是否启用登录自启动；它不是系统级常驻或崩溃自动重启。升级和回退会结束活动终端，且旧程序不能直接打开新 schema 数据库。当前 0.3.1 不支持覆盖早期安装；评估时使用全新空白数据目录和测试凭据，保留旧目录及独立备份。