AI 简明手册
DeepSeek Harness 源码解读 · 持久化与基建凭据、设置、存储与遥测怎样分层

专题篇章 · 持久化与基建源码解读

凭据、设置、存储与遥测怎样分层

先看全局

凭据配置保存环境变量引用，key 每次现取，轮换免重启。设置写盘在锁内合并后原子提交，一个懒创建 UUID 服务三方遥测身份。

沿地图找代码

配置文件无 key 值

配置文件无 key 值。凭据从环境、.credentials.yaml、项目与用户 .env 四层解析，请求开始冻成一份快照，中途轮换本次用旧 key，下次生效。空值视为未配。

[repo]

写盘前重读并合并外部改动

写盘前重读并合并外部改动，在跨进程文件锁内原子提交。SQLite 用 user_version 记 schema，当前为 1，不匹配拒绝打开。匿名 UUID 懒创建，三方共用，无凭据不产生身份。

[repo]

建议阅读顺序

  • 保存新 key 后请求仍用旧 key，原因： 进程环境优先级最高，环境里的旧值压过配置文件。

  • 为何不靠事件广播实现热更新： 靠读取时机而非通知，无需订阅和失效追踪。

这张地图没覆盖什么

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31