DeepSeek Harness 模型密钥为什么保存后看不见:只写、脱敏预览与凭据引用怎么读
DeepSeek Harness 保存模型密钥后看不见明文,不是界面藏起来了,而是这条链路从设计上就是只写的:页面拿到的是脱敏描述符,明文只落在 $DSH_HOME/.credentials.yaml,settings 只保留一个凭据引用。 理解这一点,才能正确解读输入框里的点、前后几位字符,以及删除后为什么可能还能用。
DeepSeek Harness 只写契约:页面拿到的是描述符
只写的意思是「写进去可以,读出来不行」,不是「保存后暂时隐藏、点一下就能看」。 官方说明得很直接:密钥是只写的,保存后页面只会收到脱敏描述符,永远不会收到明文(来源)。
这条契约有两个直接后果。第一,设置页不可能提供「显示已保存密钥」的功能,因为浏览器端根本没有明文可显示。第二,任何需要用到密钥的请求都由宿主侧解析凭据引用,而不是由页面把明文再传一遍。
它也不是「前端把明文藏起来」那种隐藏。隐藏只是视觉上的,打开开发者工具还能找到值;只写是数据流上的:保存之后,服务端返回给页面的就只有描述符,页面没有可还原明文的材料。这也是为什么「查看网页源码」「抓接口响应」这类办法在这里没有用。
所以你在输入框里看到的那串字符,目的不是让你核对完整密钥,而是让你确认「当前生效的是哪一把」。只要标识和前几位能对上,就说明保存的是你想的那把。
DeepSeek Harness 密钥实际落在哪:.credentials.yaml 与凭据引用
明文落在 $DSH_HOME/.credentials.yaml,settings 里只留引用,这是「看不见」的根因。 官方文档明确写了这两个位置的分工:密钥存储在 $DSH_HOME/.credentials.yaml 中,settings 只保留它的凭据引用(来源)。
这个分工解释了三件事:
- 为什么设置页看不到明文 — 设置页读的是 settings,不是凭据文件;
- 为什么换 home 后密钥没了 — 凭据跟着 home 走,不跟着界面走;
- 为什么多个提供商可以共用一把密钥 — 它们可以指向同一条凭据引用。
迁移或备份时,不能只拷 cordis.patch.yml。凭据文件与 home 是成对的;只迁移配置、不迁移凭据,表现就是「配置看起来都在,请求却报没有凭据」。完整的密钥生命周期见《DeepSeek Harness 的 API Key 全生命周期》。
迁移前按这四条核对:
- 确认旧 home — 旧机器上的
DSH_HOME指向哪个目录; - 备份凭据文件 — 连同
.credentials.yaml一起备份,不要只备份 profile; - 确认引用名 — 新 home 的 settings 里引用的凭据名要与旧的一致;
- 发一次请求 — 迁移后用最小任务验证,不要等到正式任务才发现凭据没过去。
如果新环境本来就用环境变量提供密钥,可以不迁移凭据文件,但要确保变量名与路由声明的一致,否则删除存储覆盖后仍然没有认证。
DeepSeek Harness 脱敏预览怎么显示:前五后四与至少隐藏八个字符
脱敏预览有一套明确规则,不是简单地把中间替换成星号。 官方描述是:预览保留第一个连字符或下划线之前的标识,以及密钥的前五、后四个字符,但中间必须至少隐藏八个字符;否则整串和标识全部显示为点,计数使用 Unicode 码点(来源)。
这套规则带来两个容易误读的现象:
- 短密钥可能全是点 — 当前五位加后四位已经覆盖大部分内容时,规则不允许再露出任何字符,于是整串显示为点。这不是保存失败,而是脱敏规则在保护短密钥。
- 标识不一定等于密钥前缀 — 预览先保留第一个连字符或下划线之前的标识,再取密钥前后几位。看到标识对,只能说明这条凭据的归类对,不代表你记住了密钥内容。
把三种情况放在一起看:
| 情况 | 预览表现 | 说明 |
|---|---|---|
| 长密钥 | 标识 + 前五 + 点 + 后四 | 中间至少隐藏八个字符 |
| 短密钥 | 整串和标识全是点 | 无法在不暴露内容的前提下露出字符 |
| 带标识 | 标识被保留 | 标识取自第一个连字符或下划线之前 |
已保存密钥在输入框下方通常会显示「使用已保存密钥」的提示。这个提示是状态说明,不是可点击的「查看」入口。
DeepSeek Harness 替换、删除与取消:输入框里的四种动作
已保存密钥不能局部编辑,所有修改都是整项级的。 官方列出的操作边界很具体(来源):
- 替换 — 直接键入或粘贴会整项替换已保存密钥;输入框里出现的是替换草稿,保存后才生效。
- 暂存删除 — 按 Backspace 或 Delete 会暂存整项删除,界面提示保存后将使用环境认证;点保存才真正移除存储覆盖。
- 取消 — 保存前点取消会保留原密钥,草稿和暂存删除都放弃。
- 清空草稿 — 清空替换草稿也会暂存删除已保存密钥,效果与按 Backspace 相同。
这里最容易踩的坑是「以为删了但没保存」。按 Backspace 只是暂存,必须点保存才会写入。反过来说,如果你只是想把输入框清空看看,点取消就能恢复原状。
还有两个边界值得记住:删除被拒绝时,设置保持不变;密钥已删除但设置保存失败时,界面会警告这次删除无法撤销,你可以重试保存完成配置更新,或关闭并保留部分提交结果。遇到这种半提交状态,先重试保存,不要连续重复删除。
DeepSeek Harness 清空之后:环境变量回退与共享引用的影响
清空存储覆盖不等于「没有密钥」,它可能只是回退到环境认证。 官方说明:按 Backspace 或 Delete 再保存,即可移除存储覆盖并使用环境认证;环境后备会用「留空使用环境认证」的占位文字提示,输入留空时显示一条检测提示(来源)。
所以删除后要分三种情况看:
- 环境里有对应变量 — 请求可能继续成功,只是认证来源从存储覆盖变成了环境变量;
- 环境里没有对应变量 — 提供商没有认证,下一次请求就会失败;
- 这条凭据被多个功能共享 — 清除共享凭据会影响使用同一引用的全部功能,不只当前这个模型页。
因此,删除前先问一句:这把密钥是不是只给当前提供商用的?如果不是,清空它可能同时打断搜索、其他模型或插件。要换密钥时,优先「先加后删」:先保存新密钥,确认请求成功,再清理旧凭据,而不是先清空再补。
DeepSeek Harness 三步验证与常见误读
验证密钥是否生效,不要盯着输入框,要发一次请求。 推荐三步(来源):
- 看状态 — 输入框显示脱敏预览、下方提示使用已保存密钥,说明存储覆盖存在;
- 发请求 — 用当前模型发一条最短任务,确认能返回;
- 看回退 — 如果要切换到环境认证,先确认环境变量存在,再删除存储覆盖并再发一次请求。
三个常见误读也一并列在这里:
- 「看不见就是没保存」 — 只写设计下看不见才是正常的,判断依据是脱敏预览和请求结果;
- 「复制不出来就是坏了」 — 已保存密钥本来就不提供复制,替换草稿才有眼睛按钮;
- 「删掉就安全了」 — 删除只移除存储覆盖,环境变量、共享引用和其他 home 里的副本仍可能存在。
把这三步和三误读记住,模型页的密钥行为就不会再像黑箱。模型列表怎么加载、换模型后旧会话为什么不变,见同批的模型列表与会话作用域两篇。
常见问题
因为 DeepSeek Harness 的密钥是只写的:保存后页面只收到脱敏描述符,不会收到明文。输入框显示的是脱敏预览,用于确认保存的是哪一把密钥,不是让你读回密钥。
DeepSeek Harness 把密钥存储在 $DSH_HOME/.credentials.yaml 中,settings 只保留它的凭据引用。因此设置页里看不到明文,换机器或换 home 时也要连同凭据一起迁移。
DeepSeek Harness 对已保存密钥保持只写,不提供显示、复制、剪切和局部编辑。需要换密钥时只能整项替换;输入框里的眼睛按钮只对未保存的替换草稿生效。
DeepSeek Harness 里不一定,具体取决于配置。DeepSeek Harness 删除存储覆盖后会回退到环境认证;如果环境里没有对应变量,提供商就没有认证,请求才会失败。清空共享凭据还会影响使用同一引用的全部功能。
相关术语
- 只写密钥
- 只写密钥是 DeepSeek Harness 的凭据保存方式:用户可以把密钥写入设置,但页面之后只能收到脱敏描述符,永远不能读回明文。— DeepSeek Harness 官方文档 - 配置模型
- 脱敏预览
- 脱敏预览是设置页对已保存密钥的展示形式,保留标识与前五、后四位字符,中间至少隐藏八个字符,用于确认密钥身份而不暴露内容。— DeepSeek Harness 官方文档 - 配置模型
- 凭据引用
- 凭据引用是 settings 中指向某条已保存凭据的标识;多个提供商或功能可以引用同一条凭据,因此清除它会影响所有使用该引用的位置。— DeepSeek Harness 官方文档 - 配置模型
- 环境认证回退
- 环境认证回退是 DeepSeek Harness 在没有已保存密钥覆盖时,按路由声明的环境变量名去环境中查找凭据的行为。— DeepSeek Harness 官方文档 - API key 提供方参考
来源
- DeepSeek Harness 官方文档 - 配置模型· deepseek-harness
- DeepSeek Harness 官方文档 - API key 提供方参考· deepseek-ai