固定程序与参数

配置程序、逐项参数与凭据插槽。

SecretBridge 0.3.1更新于 2026-10-12
本页目录

概览

优先使用可表达意图的原生连接器。确需本机程序时,在任务中指定绝对可执行路径和逐项参数,声明普通参数范围及凭据插槽。秘密可经标准输入、临时环境、独立参数或受管临时文件注入;每种方式都有不同可见性风险。

边界与检查

审批界面展示实际操作快照。输出过滤已绑定秘密的原文和部分编码形式,但不是万能识别或沙箱;拥有同账号任意代码执行权限的程序可能绕开应用层边界。

动态草案与可复用模板

一次性命令无需先建模板:AI 读取非秘密资源目录、选定现有安全终端,然后提交绝对程序路径、逐项参数、工作目录及 {{secret:槽位}}。草案只能申请一次审批,完成、拒绝、过期或撤销后停用。稳定重复的操作可以由用户显式保存为模板;保存后重新申请,不沿用旧授权。

模板还可声明普通文本、整数或布尔参数,使用占据完整参数项的 {{param:名称}}。普通参数值和默认值会进入 SQLite 与审批快照,不能存放秘密。代理不会通过 Shell 再解释或递归展开这些参数;若选择 Shell 或脚本解释器,解释行为属于所选程序本身,应逐项审阅。

选择秘密注入方式

方式 注意事项
标准输入 通常优先;每次命令只能有一个 stdin 凭据槽
子进程环境 仅当前调用期间存在,但同用户调试工具可能观察
独立参数 可能被进程查看工具观察,不得与普通文本拼接
受管临时文件 程序接收私有路径,代理在结束、失败或取消后尝试清理

需要较长的非秘密标准输入时可提交 stdin_content,最多 32 KiB UTF-8,不能和 stdin 秘密插槽同时使用。审批页展示完整内容供核对。执行结果有状态、退出码、已过滤输出和截断标志;退出码为零仍不证明业务目标达成。若清理、超时或连接状态不确定,先查记录和目标系统,不自动重复。

下一步:安全终端 · 参数与授权。

对应产品文档来源 · 反馈文档问题