说明
以下内容来自 README.md(0.1.3)。
在对话之外安全收集与管理密钥。智能体需要 API Key 或令牌时,通过专用弹窗向你请求:输入值直接发送到本机宿主保存而不进入对话,模型与工具只拿到 secret://<slot> 引用,使用权限按当前会话分别限定为 shell 环境变量或精确的 HTTPS 来源。
安装
本插件通过宿主凭据存储保存密钥;智能体需要密钥时会向你弹出请求窗口,由你确认后才写入。
dsh plugin --profile web add @klarkxy/dsh-secret-manager
把 web 换成你的 profile 名,安装后按提示重启 profile,并在插件列表中确认启用「密钥管理器」。
使用
模型工具
| 工具 | 用途 | 返回内容 |
|---|---|---|
request_secret |
弹出专用请求窗口收集或复用密钥,并申请本会话使用授权 | 仅返回状态、secret://<slot> 引用、DSH_SECRET_* 变量名与授权标记 |
secret_status |
查询哪些 secret://<slot> 引用已保存 |
仅返回已配置引用与对应环境变量名,不读取也不返回明文 |
secret_http |
向当前会话已获授权的精确 https:// 来源发起请求并附带认证头 |
返回响应状态与正文(不回显请求认证头与响应头,并脱敏正文中的密钥) |
回应请求(request_secret 弹窗)
模型调用 request_secret 时,对话中会自动打开专用授权弹窗,展示目标名称(slot)、secret://<slot> 引用、DSH_SECRET_* 环境变量名、用途说明与过期时间:
- 输入或复用:在掩码输入框中键入密钥值;若该名称已保存旧值且你想继续复用,可留空直接提交。
- 选择本会话权限:shell 与 HTTP 权限彼此独立,且只作用于当前会话:
- Shell 环境变量(
DSH_SECRET_*):若请求包含 shell 权限,勾选后允许本会话的非持久 shell 调用读取对应的DSH_SECRET_*变量(例如github-token对应DSH_SECRET_GITHUB_TOKEN)。 - 精确 HTTPS 来源:若请求包含 HTTP 权限,勾选后允许本会话通过
secret_http向弹窗中显示的精确https://来源发送认证头(默认为Authorization: Bearer,若请求指定了其他请求头或前缀也会一并展示供你确认)。 - 若不勾选任何授权,则只保存密钥而不向当前会话开放使用权限。
- Shell 环境变量(
- 拒绝与重新打开:点击「拒绝请求」或直接关闭弹窗都会立即拒绝本次请求并清空输入框;若拒绝请求未能到达宿主,界面会保留错误提示与「重试」按钮,不会谎称已取消。等待确认期间,对话中的工具行显示「等待你确认密钥」,可通过「打开授权」按钮重新打开弹窗。
管理密钥与会话授权(设置 → 密钥管理器)
打开 设置 → 密钥管理器:
- 密钥:输入小写字母、数字和连字符组成的名称(slot)与密钥值即可新增(同名覆盖),也可对已有条目执行「替换」或「删除」(均需二次确认)。输入框始终掩码,已保存的值永不回显,也不显示尾号或长度。
- 本会话授权:查看当前打开会话持有的 shell / HTTP 授权状态以及各密钥的已授权会话数,可点击「撤销本会话授权」或「撤销全部会话授权」立即收回访问权而不删除密钥本身。
主要限制
- 本机明文存储:密钥通过宿主凭据存储保存在本地,以明文形式落盘——本插件是引用管理器,而非加密保险箱;任何能够读取 DSH 数据目录的程序或用户都可以读取这些值。
- 录入隔离与脱敏边界:弹窗输入直达宿主并在提交、拒绝或关闭时立即清空,不写入对话记录、浏览器持久存储或插件日志;
tools/post-execute脱敏只覆盖工具正常返回的结果,不覆盖命令运行时的实时流式输出、溢出文件、经编码或变形改写后的输出(如 Base64/Hex)以及外部程序日志。获授 shell 权限的会话可直接读取对应的DSH_SECRET_*变量,请谨慎授权。 - 按会话与时间严格限定:授权仅对批准它的当前顶层会话有效,不继承给子代理,约 1 小时后自动过期,插件卸载或宿主重启即全部清除;替换或删除密钥值会立即撤销所有会话对该密钥的授权。未处理的
request_secret请求约 5 分钟后自动过期。 - Shell 与 HTTP 使用边界:shell 注入仅支持原生非持久 shell,不支持持久 shell;
secret_http仅支持精确匹配的https://来源(不支持整域通配、明文 HTTP、URL 内嵌凭据或 HTTP 重定向),且响应体受大小上限约束。 - 无自动重写与自动授权:其他工具参数中原本已经写死的明文密钥不会被自动替换;模型只能发起请求,保存、授权、替换与撤销均须由你显式确认。