安全连续终端

概览

代理持有真实 Shell，普通非秘密命令可通过输入租约写入。需要凭据的精确命令应创建请求并交给用户审批，不能把凭据写进终端输入、脚本或聊天。

边界与检查

输出通过游标读取。遇到截断应说明缺失范围；断线后从保存的游标继续，不应仅为恢复输出重复执行业务命令。结束聊天时可分离附件，只有确定不再需要时才关闭终端。

普通输入与凭据命令

本机代理持有真实 Shell，关闭浏览器或 MCP 对话不会立即结束终端。普通、非秘密输入可由取得输入权的连接通过 secretbridge_terminal_write 发送；含凭据的程序调用使用 secretbridge_request_command 创建精确审批草案，不能把密码写进普通输入、脚本、命令历史或聊天。用户批准后，代理在该终端临时注入秘密并先脱敏再保存与返回输出。

连接、读取与释放

1. 先调用 secretbridge_terminal_capabilities 确认可用 Shell，再创建终端并保存返回的 terminal.id。
2. 附加终端时检查 input_granted。同一终端同时只有一个输入持有者；其他连接可读取但不能写入、调整尺寸或中断。
3. 读取时保存 next_cursor 并用于下一次 terminal_read。单次最多读 16 KiB，代理保留最近 64 KiB；truncated:true 表示旧片段已不在窗口。
4. 交还输入权时 detach，需要结束进程时才 close。Web 历史与 MCP 运行输出可在终端关闭后查看已保留的脱敏记录。

服务重启会结束进程内终端和输入租约，未完成任务标记中断，不会自动重放。普通写入也不是幂等操作；连接中断时先读状态与输出，不要盲目重发。受控命令的恢复见固定程序和审批。

使用边界

终端仍以当前系统用户权限执行，不是恶意代码沙箱。脱敏只覆盖代理实际绑定的秘密及已支持的表示形式；未绑定业务数据、任意编码或程序主动外传可能不被识别。只使用可信程序与最小权限账号。