klarkxy 的 DSH 插件

密钥管理器

@klarkxy/dsh-secret-manager
插件 工作方式 含 Web 界面

在对话之外安全收集与管理密钥,工具只拿到引用,权限按会话限定。

安装

 dsh plugin --profile web add @klarkxy/dsh-secret-manager

这个插件依赖 插件共享库,安装时会自动一起装上。

把 web 换成你在用的 profile。装完重启 profile,插件会出现在「设置 → 插件」里。

说明

以下内容来自 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,若请求指定了其他请求头或前缀也会一并展示供你确认)。
    • 若不勾选任何授权,则只保存密钥而不向当前会话开放使用权限。
  • 拒绝与重新打开:点击「拒绝请求」或直接关闭弹窗都会立即拒绝本次请求并清空输入框;若拒绝请求未能到达宿主,界面会保留错误提示与「重试」按钮,不会谎称已取消。等待确认期间,对话中的工具行显示「等待你确认密钥」,可通过「打开授权」按钮重新打开弹窗。

管理密钥与会话授权(设置 → 密钥管理器)

打开 设置 → 密钥管理器:

  • 密钥:输入小写字母、数字和连字符组成的名称(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 重定向),且响应体受大小上限约束。
  • 无自动重写与自动授权:其他工具参数中原本已经写死的明文密钥不会被自动替换;模型只能发起请求,保存、授权、替换与撤销均须由你显式确认。

许可证

SATA License 2.1