钥匙串凭据 nengong-ai/dsh-keychain-credentials

dsh-keychain-credentials

用于 DeepSeek Harness（dsh）的 macOS Keychain 凭据提供程序。

默认提供程序（dsh-credentials-local）将密钥存储在 $DSH_HOME/.credentials.yaml 中，权限为 0600。正如其自己的 README 所述：该文件对其他操作系统用户是受保护的，但对模型不是——工具进程（bash、文件系统工具）以同一用户身份运行，可以像读取任何其他文件一样读取它。

此提供程序将密钥移入 macOS 登录钥匙串。一个不存在的文件无法被 cat；不会有任何内容落入备份、同步文件夹或 git 中。

这为你带来了什么

- 已修复： 密钥不再是一个文件。默认文件可被模型拥有的每一种读取原语访问——read、cat、grep、tar、node -e …，无论进程内还是子进程。使用此提供程序后，值存放在登录钥匙串中。
- 未修复（诚实地说）： 当登录钥匙串处于解锁状态时（登录后的默认状态），任何同一用户的进程都可以通过调用 /usr/bin/security 读取该项——该 CLI 受 ACL 信任，不会出现提示。一个拥有不受限 shell 且知道去询问钥匙串的代理仍然可以窃取。与限制工具子进程的沙箱配合可以缩小这一范围；硬边界需要操作系统级别的隔离（一个带有私有访问组的已签名代理，例如 keyringseam，或一个单独的操作系统用户）。

净效果：门槛从“任何读取原语”提高到“必须以同一用户身份执行 /usr/bin/security”——这是真正的改进，而非完整的边界。

为什么选这个，而不是其他

- 完整的接缝覆盖： 实现了 ctx.credentials 的两半——refs（API 密钥）和 records（结构化凭据，如 client-connection/browser-session 授权）。其他几个提供程序只实现了 refs 这一半，这意味着 DSH 自身的会话记录会回退到明文文件。
- 零构建步骤： 纯 JavaScript，无需 Swift，无需代码签名证书，无需 Xcode。安装即用。
- 无认证提示： 读取和写入从不要求用户进行 Touch ID / 密码验证。（这是一个有意的取舍：keyringseam 提供设备所有者认证，代价是每次操作都要弹出提示。）

要求

- macOS（/usr/bin/security）
- DeepSeek Harness ≥ 0.1.0-rc.6

安装

dsh plugin --profile web add dsh-keychain-credentials
or from source:
dsh plugin --profile web add github:/dsh-keychain-credentials

然后该 bundle 的 cordis.patch.yml 会禁用默认提供程序并挂载此提供程序。如果你更愿意手动接线，请添加到你的补丁层（~/.dsh/cordis.patch.yml 或 --patch ）：

- id: credentials
disabled: true
- insert:
- id: credentials-keychain
name: dsh-keychain-credentials
config:
servicePrefix: dsh-credentials # keychain service prefix
account: dsh # keychain account name

用法存储一个密钥（account = 凭据引用名称）：

security add-generic-password -U -s dsh-credentials -a DEEPSEEK_API_KEY -w 'sk-…'

LLM 适配器按请求解析该引用——轮换后无需重启。

遵循接缝契约的语义：

- 进程环境会遮蔽钥匙串（每次运行的运维意图优先）。
- 存储的值为空视为不存在。
- 当只读来源（环境）遮蔽该引用时，set/unset 会被拒绝。
- describe 检查是否存在而不读取值——状态查询绝不会将明文拉入 agent 进程。
- 来自 security CLI 的错误经过净化：仅保留退出码和 stderr，绝不包含命令行（在 set 失败时命令行会携带密钥）。
- 密钥始终通过 stdin 而非 argv 传给 security，因此绝不会出现在 ps 中。
- 超过 128 字节的值通过 security -i 写入，而非 stdin 密码提示：该提示最多存储 128 字节，并会静默截断更长的内容。交互模式没有此限制，但不会报告失败退出码，因此这些写入会通过回读该值来确认。（DSH 作为 records 条目存储的账户令牌就是这样一个值。）

测试

npm test

需要真实的 DSH node_modules（peer 依赖）——从已安装 @deepseek-ai/dsh-credentials 的 profile 中运行，或符号链接一个。

许可证

MIT