为 DSH Desktop 提供密钥库,集中保管 API 密钥并以 $DSH_* 变量注入助手的 shell 中。
安装
# npm 包(预构建)
dsh plugin --profile web add @moruteaven/dsh-key-panel
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:MoruTeaven/dsh-key-panel
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
npm 上的 @moruteaven/dsh-key-panel · English · 简体中文 · 日本語
给 DSH Desktop 用的密钥管家。把 API 密钥集中放在一处,
以 $DSH_* 环境变量的形式注入助手的 shell,然后由你在设置页的面板里决定——
助手到底能拿它们做什么。
它解决什么问题:助手要调 Cloudflare、OpenAI,或者你的数据库,就得有凭据。 直接粘进对话,就永久留在了对话记录里;存成文件,最后又散落到某个你早已忘记的 目录。这个插件把它收进一个文件、暴露成一个环境变量,而值本身从不进入对话。
助手要部署 Worker
→ 执行:wrangler deploy --api-token $DSH_CLOUDFLARE_TOKEN
→ shell 里有,模型的上下文里没有
功能
- 设置页面板。增删改查、显隐、复制,都在你管理其它设置的地方,不用改配置文件。
$DSH_*注入。每个密钥都是助手 shell 里的一个变量,改动下一条命令即生效,无需重启。- 三档权限,由你设定并持久保存:
只读(默认)·可写·可编辑。 - 平台与账号。多数服务商要两个值(账号 id + 令牌),而一个服务商常配多个账号。按平台和账号归组后,每个槽位就是
DSH_<平台>_<账号>_ID和DSH_<平台>_<账号>_KEY。归组只是存储的组织方式——变量名仍是扁平的,读它的东西也都不用变。 - 来源标记。密钥记录是你建的还是助手建的,且写入无法互相"洗白"。
- 最近活动。记录每条 shell 命令实际拿到了哪些变量,以及助手主动申报的目的。两者并排展示,从不配对。只记名字和时间戳——任何值都不会写进去。
- 名称作用域(暂未开放)。宿主支持把助手限定在
DSH_AGENT_*之类的名字下,存储里已设置的作用域也照常生效,但本版本面板上的入口是隐藏的。 - 两段式删除。删除需要第二次带令牌的确认调用——单次误调用删不掉东西。
- 只读清单接口。助手可以直接查到每个密钥的名称与用途,不用再靠读取环境变量去猜。该接口只返回名称与用途,永不返回密钥值,且三种权限档位下都可用。宿主未启用 MCP 资源功能时,此接口自动不存在,不影响其它功能。
- 值永不进模型。任何模式下,没有任何工具会把密钥值返回给模型。
- 幂等、可热重载。面板每次调用都重新读取当前权限。
界面示例
设置 → 密钥 的实际样子:


安装
设置 → 插件 → 搜索 "dsh-key-panel" → 安装 → 重启 DSH Desktop
之后面板出现在 设置 → 密钥。
其它渠道:
- npm ——
npm i @moruteaven/dsh-key-panel,然后在你的 profile 的package.json里把裸包名@moruteaven/dsh-key-panel加进dsh.profile.bundles。这个列表只接受裸包名,file:或路径会被拒绝(file:放在dependencies里是合法的)。 - 从源码 —— 见 CONTRIBUTING.md。
使用
添加密钥
设置 → 密钥 → 添加密钥。
| 字段 | 说明 |
|---|---|
| 名称 | 必须匹配 DSH_[A-Z][A-Z0-9_]*,例如 DSH_CLOUDFLARE_TOKEN |
| 用途 | 可选。会作为该变量的说明展示给助手 |
| 值 | 密钥本体。明文存储,保存后只以掩码显示 |
然后直接告诉助手用它:
部署这个 worker,token 在
$DSH_CLOUDFLARE_TOKEN里。
平台与账号
当一个服务商需要两个值(比如账号 id 和令牌),而你在它下面有不止一个账号时,平铺的列表会变得难读。用 添加平台 和 添加账号 把这些密钥归成一类,变量名由插件替你拼:
| 你填 | 得到 |
|---|---|
平台 CF、账号 WORK |
DSH_CF_WORK_ID 与 DSH_CF_WORK_KEY |
提交前面板会先把两个名字显示出来,你能看到最终会落进 shell 的是什么。标识符只允许大写字母、数字和下划线;小写会被拒绝而不是悄悄转成大写——你没要求过的名字,比需要重打一次更糟。
密钥就在账号行里填。 账号建好之后,它的两个变量名已经定下来了——名字是从标识符拼出来的,不是你选的。所以账号那一行有一枚「填入密钥」按钮,点开是个弹出面板,一次收两个值,直接挂到这个账号下。弹出面板里会先把两个名字列出来,但不需要你敲——这才是重点:让你把一个插件算好的名字抄到顶部的「添加密钥」卡片、一个字段抄一次,那是誊写,不是输入。
账号那一行自己就写完了一个账号该有的全部信息:显示名和标识符在上,两个变量名在下,各自带着填充状态——已填的只点一个小圆点,没填的才写「未填」。状态词只留给需要你动手的那一个,整行扫过去就知道哪里还空着。平台那一行则只放显示名、账号数量和几个图标按钮;变量名不在那里重复,它们属于账号这一层。
每个槽位都可以先空着以后补。未分组的密钥仍然用「添加密钥」——它们没有账号可以填。
平台和账号都另有一个显示名,面板上显示的是它。它和标识符刻意分开:标识符会拼进变量名、之后不能改;显示名随时可改。如果你想让面板上写着「Cloudflare」而变量名保持 DSH_CF_*,这两个字段就是干这个的。
如果某个账号会生成的名字已经被占用——比如你在建账号之前就手工加过 DSH_CF_WORK_KEY——面板会先提示并列出涉及的密钥,等你确认。继续保存会覆盖它们原有的值,所以不会静默发生。
两点值得知道:
- 归组是组织方式,不是安全边界。 变量仍是普通的扁平
DSH_*名字——这正是关键,因为 shell 没有嵌套。归组给你的是一个好读的面板,顺带还带来一个正好对齐到单个账号的作用域(见下)。 - 删平台或账号不会带走你的密钥。 只要还有密钥挂在它下面,删除就会被拒绝,你得先清空或改挂。如果你选择强行继续,那些密钥会被退回未分组,值一概不动。
从没归过组的密钥保持原样。这个功能不要求你重组任何东西才有用,已有的存储也照常可用、无需迁移。
最近活动
面板会保留两条记录,并把它们并排放在一起:
| 记录 | 谁写的 | 内容 |
|---|---|---|
| 助手申报 | 助手调用 key_panel_intent |
它自己说的时间戳、目的,以及打算用的名字 |
| 注入命令 | 插件自己,每次 shell 命令解析环境时 | 时间戳,以及那次命令实际拿到的名字 |
两者是并排展示,不是配对。列表里上下相邻的一条申报和一次注入,可能属于同一个任务,但数据本身没有任何东西这么说——把它们连起来就是把猜测当成事实呈现。
「注入命令」不意味着什么。 宿主在每条 shell 命令执行前解析整个 $DSH_* 环境,看不到命令拿它做了什么。所以一行只说明这些名字在那一刻在作用域里——不表示命令读了它们,更不表示用它们做了什么。把这份记录当作「哪些流程依赖了哪些密钥」的信号,不要当作审计凭证。
由此有两点实际影响:
- 助手可能什么都不申报。
key_panel_intent是可选的,跳过它没有任何代价,所以会有未申报的活动——这是预期内的。插件只在便宜的地方询问意图,但从不强制:每条命令前面加一道必填步骤,很快会变成肌肉记忆,也就不再携带信息。 - 开销不在命令路径上。 记录先在内存里缓冲、再批量落盘,所以记账不会拖慢任何命令。文件有上限(超出后丢弃最旧的),写失败被吞掉——这份文件丢了尾部,损失的是趋势,不是密钥。
记录与密钥库放在一起,文件名 usage.jsonl,只保存名字和时间戳。任何值都不会写进去。
权限档位
| 档位 | 助手可以 | 助手不可以 |
|---|---|---|
只读(默认) |
使用密钥 | 改任何东西——写入类工具一个都没注册 |
可写 |
新增;覆盖自己建的 | 删除任何东西;改你建的密钥 |
可编辑 |
增、改、删 | ——(删除仍需二次确认) |
在面板里切换,下一次工具调用即生效,不用重启。
从「只读」开始。 只有当你确实想让助手自己添加凭据时,再往上放——后两档就是 为这一个场景存在的。
按名称限定
本版本面板上暂未开放。 作用域功能本身是完好的——校验、持久化、每次模型调用时的判定都在,存储里已设置的作用域也继续生效。隐藏的只是设置它的那个输入框(
lib/client.js里的SHOW_SCOPE_UI)。需要时可以直接在存储文件里设置;把该标志打开即可恢复入口。
在选档位之前,有个安全后果值得先知道:没有设置作用域时,限制助手能触到哪些密钥的只剩权限档位本身。 作用域未设置就等于没有限制。想要更窄的边界,就自己去设一个——目前只能写存储文件。
作用域用于收窄助手能碰的名字:
| 取值 | 效果 |
|---|---|
| (留空) | 不限制 |
DSH_AGENT_* |
只允许该前缀 |
DSH_CF_* |
只允许该平台的密钥 |
DSH_CF_WORK_* |
只允许某一个账号的凭据 |
只支持 * 这一个通配符,表达不了路径,也表达不了正则。
配置项
| 设置 | 位置 | 默认 |
|---|---|---|
| 权限档位 | 面板 | readonly |
| 名称作用域 | 仅存储(面板已隐藏) | 不限制 |
| 存储位置 | $DSH_HOME/key-panel/keys.json |
~/.dsh/key-panel/keys.json |
| 活动日志 | $DSH_HOME/key-panel/usage.jsonl |
~/.dsh/key-panel/usage.jsonl |
存储格式
{
"version": 2,
"policy": { "accessMode": "readonly", "scopePattern": null },
"platforms": {
"CF": { "label": "Cloudflare", "createdAt": 1758428400000 }
},
"accounts": {
"CF/WORK": { "platform": "CF", "identifier": "WORK", "label": "工作", "createdAt": 1758428400000 }
},
"keys": {
"DSH_CF_WORK_TOKEN": {
"value": "…",
"description": "Cloudflare Workers 部署令牌",
"origin": "operator", // "operator" | "model"
"platform": "CF", // 可选的归组字段
"account": "WORK",
"field": "key", // "id" | "key"
"createdAt": 1758428400000,
"updatedAt": 1758428400000
}
}
}
写入走 临时文件 → fsync → rename。少了 fsync,崩溃可能留下一个已改名却
内容为空的文件——读回来就是「所有密钥都没了」。
version 1 的文件能原样加载:归组字段全是可选的,平台概念出现之前写入的密钥读回来 就是「未分组」。不需要迁移步骤。
usage.jsonl
活动记录放在另一个文件里,每行一个 JSON 对象:
{"t":1758428400000,"kind":"intent","names":["DSH_CF_WORK_TOKEN"],"note":"deploy staging"}
{"t":1758428450000,"kind":"use","names":["DSH_CF_WORK_TOKEN"]}
| 字段 | 含义 |
|---|---|
t |
epoch 毫秒 |
kind |
intent(助手申报)或 use(注入命令) |
names |
涉及的名字,已去重。永远不是值。 |
note |
仅 intent——目的,截断到 500 字符 |
批量追加,并保留最近 1000 条,所以不会无限增长。与 keys.json 不同,它不是原子写入,也不逐行 fsync:进程被强杀可能截断最后一行,读取时跳过即可。这个取舍在这里是对的——这份文件是信号,不是密钥,为了持久性拖慢每条命令不值得。
两种记录由不同的一方在不同时刻写入,因此分开存储,展示时按时间对齐。插件从不把它们合并。
安全
密钥以明文存储。 这是刻意的取舍,完整说明(信任模型、不变量、非目标)见 SECURITY.md。
简要版:
- 任何以你的 OS 用户身份运行的程序都能读到存储文件。请当成
.env对待。 - 任何模式下,助手都无法把密钥值读进对话记录。
- 助手永远改不了权限档位和作用域——那是操作者专属的。
- 「只读」档下写入工具不存在,而不是拒绝调用。
- 「只读」限制的是能改什么,不是能看到什么:密钥要在 shell 里可用,名字就必须存在,助手因此本就能列出名字。只读清单接口还会给出用途与分组。名称和用途按设计不算机密,只有值是。
开发
npm test # 两套一起跑 —— 486 条断言
npm run test:host # 宿主侧:权限、存储、工具、网关、MCP 资源(335)
npm run test:client # 客户端 bundle:契约、插槽、RPC、字典(151)
客户端测试按真实前端的加载方式跑 lib/client.js:伪造
window.__ModuleLoader__、require 只允许种子模块,然后断言 bundle 求值时
不产生副作用、只引用种子模块,以及面板调用的每个 RPC 端点都与宿主网关对得上。
没有构建步骤。 宿主侧是纯 ESM,浏览器侧是一个 CJS factory 字符串。
lib/
policy.js 权限档位、作用域 glob、决策函数
store.js 持久化、来源标记、原子写入
tools.js 面向模型的工具、删除确认台账
index.js 宿主侧 —— Typert 网关、shellEnv 注册
client.js 浏览器 bundle —— 设置面板
本仓库要求遵守的约定、以及怎么跑测试,见 CONTRIBUTING.md。
兼容性
- DSH Desktop 2.0.11+(dsh
0.1.5-rc.1) - Node 20+
- 客户端部分仅支持 web 平台
许可
Apache License 2.0 · 署名信息见 NOTICE
选 Apache-2.0 而不是 MIT/BSD,是因为它对处理凭据的工具多了两条有意义的条款:
- 专利授权(第 3 条)。MIT 和 BSD 完全没有这一条,而它同时要求贡献者做同样承诺。
- 商标限制(第 6 条)。别人不能拿作者的名义为衍生分支背书——这正是 BSD-3-Clause 背书条款提供的同一层保护。
其余照旧宽松:可商用、可修改、可闭源分发。
链接
同类插件
kenryu42/cc-safety-net★ 2075
执行前守卫,在工具调用运行前拦截破坏性 Git 与文件系统命令,以及对 SSH 密钥、.env 等机密文件的访问。
ADWMC/helm-d#helmd★ 1379
DeepSeek Harness 的安全分析插件:33 个工具覆盖六大安全域、证据/报告与工具集,并提供案件生命周期、路由和工具账本;按会话绑定的案件工作区支持证据链、E 编号校验与可复现结论(repro_cmd);内置 362 篇按需参考、三档可热切换人设,以及带案件状态恢复的破甲 / Case / 拦截 / 关于四页工作台。
toby-bridges/api-relay-audit★ 920
从 DeepSeek Harness 对 AI API 中转站和 LLM 代理运行本地安全审计,生成 Markdown 报告,覆盖提示词注入、模型替换信号、工具调用改写、错误泄漏、流完整性和按 profile 启用的 Web3 风险。
SeaOf0/dsh-redteam-model★ 899
面向授权安全研究的 DSH 合集:九个工作模式(redteam 总控、渗透测试、代码审计、二进制分析、攻防评估、免杀对抗、应急溯源、云安全攻防、CTF 解题)与十五个运行时插件,设置页管理台支持一键部署、安装、更新与卸载。
howmp/dsh-pentest★ 622
面向 DeepSeek Harness 的授权渗透模式:以探索链路记录目标、线索、资产与漏洞,并在 Web 中可视化展示。
PerryLink/dsh-auto-review★ 254
审批链上的第二模型自动审查:只读审查子代理返回带理由的 allow/deny 结构化裁决,默认 fail-closed。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。