dsh-encrypt

DSH 凭证加密插件（bundle 形态）：未设密码时 $DSH_HOME/.credentials.yaml 是与官方 dsh-credentials-local 完全一致的明文 YAML；在「设置 → 加密安全」设置密码后，凭证以 AES-256-GCM 密文（Argon2id 派生密钥 + SHA3-256 完整性指纹）写入插件自己的 $DSH_HOME/.credentials.encrypt.yaml，原凭证文件只留一行指向说明（普通 dsh 也能正常启动，只是读不到密文凭证）。浏览器只提交密码的 SHA3-256 摘要（前后端分离校验），模型请求按需临时解密，明文从不缓存；另提供「N 天免密登录」滑块（仅 localhost 生效），并内置解锁爆破锁定、凭证泄露检测与输出脱敏、发行代码完整性自校验。

项目	值
形态	bundle（`dsh.bundle.patch` → `cordis.patch.yml`，随 profile 启动，`dsh plugin add` 原生安装）
版本	`0.1.0-rc.9`
依赖线	npm rc.1（`@deepseek-ai/cordis@^4.0.1` 等 scoped 包 + `@node-rs/argon2` 原生绑定）
环境	Node.js ≥ 18（官方教程建议 22+）；DSH `@deepseek-ai/dsh@0.0.1-rc.1`+
License	MIT

解决的问题

DSH 默认的凭证存储把密钥以明文 YAML 写在 $DSH_HOME/.credentials.yaml。dsh-encrypt 提供可选的加密形态：设置密码前零改动、完全兼容；设置密码后凭证被加密存进插件自己的 .credentials.encrypt.yaml（密钥状态与密文都不再占用官方凭证文件），凭证只在模型调用发生时临时解密。

特性

双文件双形态：明文 YAML 留在官方 .credentials.yaml；设密码后密文 JSON 存进插件自己的 .credentials.encrypt.yaml，官方文件变为注释指引——官方 provider 始终只接触它自己的文件
WebUI 全生命周期：设置密码 / 解锁 / 修改密码，全部在「设置 → 加密安全」完成（永远密文策略下没有「移除密码」）
AES-256-GCM：每条凭证独立随机 nonce，凭证引用名绑定为 GCM AAD（换位即认证失败）
SHA3-256 双重完整性：条目级指纹 + 覆盖文档头部的文档级指纹，损坏文件在启动时即被拒绝（绝不当作“空库”）
Argon2id 密码派生（@node-rs/argon2，m=64 MiB, t=3, p=1，OWASP 对齐）：密码不落盘，仅存盐与 AEAD 验证器；旧版 scrypt（v2）密文仍可解锁并在解锁时自动升级到 Argon2id
摘要校验（前后端分离）：WebUI 用纯 JS Keccak-f[1600] 计算密码的 SHA3-256，只 POST { digest } 到后端；后端用 Argon2id 拉伸摘要并与 AEAD 验证器匹配，原始密码不离开浏览器
解锁爆破锁定：连续密码解锁失败计数持久化到状态文件（重启不清零），达到阈值（默认 5 次）后指数退避锁定（30 s 起，2 倍递增，上限 15 min），WebUI 显示剩余锁定时间，HTTP 返回 429 + Retry-After
凭证泄露检测与输出脱敏（Leak Guard）：模型实际解析过的凭证值会被登记为掩码模式——WebUI 的 HTTP 响应体与 WebSocket 事件帧在离开主机前扫描并替换为 [REDACTED:dsh-encrypt]，提示词注入诱导模型回显密钥时也会被脱敏
发行代码完整性自校验：打包时生成 lib/integrity-manifest.json（所有发行文件的 SHA3-256），启动时逐文件校验、不一致即拒绝加载（fail-closed），覆盖 provider 行与浏览器面板包
免密登录滑块：设置「多少天免密」（0 = 每次都输密码 / 1–30 天 / 永远，刻度仅保留头尾），解锁成功后签发 256 位票据（HttpOnly Cookie + 响应体回传，浏览器同时存 localStorage 并随 x-dsh-encrypt-remember 请求头回传，不再依赖 Cookie 存取可靠性）；打开 WebUI 即自动尝试免密解锁（localhost 专属），磁盘只存被 AEAD 包裹的密钥副本；到期或票据不匹配即失效
仅 localhost 免密与改密：非本机访问强制每次都输密码，且不能设置/修改密码（后端强制，返回 LOCAL_ONLY）
永远密文（ciphertext-only）：一旦设置密码，文件永不回退明文——「移除密码」功能已移除；外部把文件改回明文时，解锁态下自动重新加密写回，锁定态下拒绝采用并保留最后密文快照；重启后若文件被替换成明文，凭证解析被拒绝（plaintextForbidden）直到重新设置密码
阅后即焚：密文只在被使用的那一刻解密；解密中间 Buffer 立即清零，新增 withUnlockedBuffer 擦除式接口（回调结束后在 finally 中焚毁明文副本），改密时的明文集合用后即清空，密钥在锁定/卸载时清零
按请求解密：明文只存活于单次操作，不缓存、不进日志；密钥在锁定/卸载时清零
热重载：外部编辑明文即时生效；外部加密即时转锁定；损坏的中间状态保留最后一个好快照
原子写 + 文件锁：写入经 dsh-atomic-write，POSIX 上强制 0600 权限（启动即校验）
自动化解锁：DSH_CREDENTIAL_PASSWORD 环境变量在启动时解锁（适合 headless）

形态与架构

本插件是 bundle 形态（package.json + dsh.bundle.patch → cordis.patch.yml），且是 Fabric-required 行——默认 disabled，由 fabric-dsh 启动时用 overlay 启用；普通 dsh 完全跳过本插件（官方明文凭证照常工作）。组合里只有一行 + 一个客户端声明：

组合行	入口	职责
`dsh-encrypt`	`dsh-encrypt`（`lib/index.js`）	`encryptVault` 服务：vault 状态机、密码/锁定操作、leak guard，以及五条 Fabric transform 的 handler；存在 `webServer` 时自动挂载浏览器密码路由（headless 自动跳过）
`dsh-encrypt/client`	`package.json` 的 `dsh.client` 声明	「设置 → 加密安全」面板（web 组合自动挂载）

替换方式改用 Fabric 层改写：不修改、不禁用任何核心 row——官方 credentials 行（dsh-credentials-local）继续持有 ctx.credentials 接缝与凭证文件，fabric 在加载时把凭证文件的解析/渲染接上插件自己的密文文件（.credentials.encrypt.yaml）：

patch	目标	操作	作用
`dsh-encrypt/credentials-parse`	`parseCredentialsDocument`	around	凭证文件为 shadow marker（注释指引）时直接把密文文件解密为映射返回（校验已在加密时由官方解析器完成）；锁定态解析为空店（启动照常，解锁后重载）；真实明文撞密文策略时掩码并在解析时拒绝
`dsh-encrypt/credentials-render`	`renderDocument`	after	解锁态下渲染出的变更加密写进密文文件，官方文件只落 shadow marker；锁定态写入以 `VAULT_LOCKED` 拒绝
`dsh-encrypt/credentials-resolve`	`resolve`	after	把实际解析出的明文喂给 leak guard；明文回退时拒绝解析
`dsh-encrypt/webserver-http-register`	`register`	before	每个注册的 HTTP 路由 handler 包上响应脱敏
`dsh-encrypt/webserver-upgrade-register`	`registerUpgrade`	before	每个 upgrade 路由包上 WS 帧脱敏

LLM 适配器、Models 页、web-search 等所有既有消费者无需任何改动。凭证两条 patch 标 required: true：fabric-dsh 下 transform 未绑定则拒启，普通 dsh 下显式启用本行同样拒启（cordis-fabric-dsh 门禁）。

安装

1. Profile Bundle（推荐）

先打包，再装进 profile（dsh plugin add 会把声明了 dsh.bundle.patch 的依赖自动 reconcile 进 bundles 列表）：

# 打包（files 字段仅含 lib 与 cordis.patch.yml，test/ 不入包；
# prepack 会自动重新生成 lib/integrity-manifest.json）
pnpm pack
# → dsh-encrypt-0.1.0-rc.9.tgz

# web profile（设置页「加密安全」）
dsh plugin --profile web add ./dsh-encrypt-0.1.0-rc.9.tgz

# headless profile（一次性任务 / 自动化解锁；web 与 headless 是不同 profile，需分别安装）
dsh plugin --profile headless add ./dsh-encrypt-0.1.0-rc.9.tgz

@node-rs/argon2 是带预编译二进制（napi-rs）的原生依赖，dsh plugin add 安装依赖时会拉取对应平台的 optionalDependencies；Node.js ≥ 18（建议 22+）。若安装后出现原生模块缺失（极少数平台组合），重新执行一次 npm rebuild @node-rs/argon2 即可。

本地源码目录同样可以直接安装（路径用 Windows 正斜杠形式）：

dsh plugin --profile web add "D:/path/to/DSH-Encrypt"

2. 启动走 fabric-dsh

本插件是 Fabric-required 行：普通 dsh 跳过它，启动必须走 fabric-dsh（hooks 先注入、行被 overlay 启用）：

$DSH_HOME/profiles/web/node_modules/.bin/fabric-dsh --harness <deepseek-harness-checkout> web --port 8000

浏览器密码路由在 web 组合里随服务自动挂载（存在 webServer 即启用），无需再手工插入行。

3. 验证安装

dsh --profile web --dump-config | grep dsh-encrypt
# 期望：出现 dsh-encrypt 行（disabled 由 fabric-dsh 的 overlay 在启动时置 false），基础 credentials 行保持启用

4. 运行验证

# web：启动后打开「设置 → 加密安全」，应能看到加密面板
dsh web

# headless：环境变量自动解锁后，任何任务都应正常启动、凭证解析无 VAULT_LOCKED
DSH_CREDENTIAL_PASSWORD='<密码>' dsh run "运行一次最小任务验证凭证可用"

仓库另附两阶段真实重启 e2e（见开发与测试），覆盖明文→设密→损坏/恢复→重启锁定→解锁→改密→移除密码全生命周期。

5. 手动安装与旧版本兼容（仅调试场景）

手动 patch 只作为旧快照兼容或调试方案，不是默认安装流程。完整手动层：

# $DSH_HOME/profiles/web/cordis.patch.yml
- id: dsh-encrypt
  disabled: false

（显式启用行却不用 fabric-dsh 启动会在 boot 时被门禁拒绝。）

使用

全部操作在「设置 → 加密安全」完成（面板 id encryption）：

操作	前置状态	效果
设置加密密码（输入两次，至少 8 个字符）	明文	凭证加密写入 `.credentials.encrypt.yaml`，官方文件变为注释指引，进程保持解锁
解锁	加密+锁定（重启后）	校验密码摘要并派生密钥，立即恢复模型调用
修改密码	加密+解锁	全部条目在新密钥下重加密
免密登录时长（滑块）	任意	0 = 每次都输密码；1–30 = N 天内免密；31 = 永远免密（均仅本机）

滑块即改即存（松开即提交到 /api/credentials.config，只接受 localhost；刻度只显示「每次」与「永远」两头）。解锁成功后按当前滑块时长签发免密票据；改动滑块会作废旧票据，若当前已解锁则立即按新时长重新签发。打开 WebUI 时自动尝试免密解锁（localhost 专属），免密期间无需输密码；到期后回到密码解锁。非 localhost 访问始终需要输入密码，且不显示改密入口（后端同样强制）。

永远密文：设置密码后没有「移除密码」路径——文件永为密文。若凭证文件被人替换成明文，解锁状态下会被立即重新加密写回；若发生在锁定/重启期间，凭证解析暂停（面板显示警告），重新设置密码即恢复（原有凭证内容保留）。

解锁锁定：连续输错密码达到阈值（默认 5 次）后，解锁接口进入指数退避锁定——第 1 次锁定 30 秒，之后每次失败翻倍，上限 15 分钟；计数与截止时间持久化在状态文件里，重启进程不能清零。锁定期间面板显示剩余秒数并禁用解锁按钮，接口返回 429 + Retry-After；成功解锁即清零。

状态机：

             set-password                    (restart)            unlock
  plain ──────────────────► encrypted+unlocked ──────► encrypted+locked ──► unlocked
    ▲                            │  ▲                                        │
    └──（永远密文：没有返回明文的路径）┘  └──────────── change-password ───────────┘

锁定期间：web 服务照常运行；继承环境中的凭证仍可解析，文件内凭证解析为空（锁定 = 不可见）——设置页即是解锁入口
免密窗口：票据在签发时写入 issuedAt 与 days；days: -1 永不失效。滑块改动会立即作废旧票据
忘记密码：设计上不可恢复（密码不落盘）；恢复手段 = 删除 .credentials.encrypt.yaml 与 .credentials.yaml 重新配置

凭证解析顺序

优先级	来源	说明
1	继承环境（launching environment）	只读、高于受管文件；对被其遮蔽的引用写入会被拒绝
2	受管文件 `.credentials.yaml`	明文形态，可写；设密码后为注释指引（shadow marker），密文在 `.credentials.encrypt.yaml`
3	`.env` 回退（project-env / user-env）	低于受管文件，仅在文件无此引用时兜底

allowEnvFallback: false 可关闭第 1、3 层（严格仅文件策略）。

磁盘格式

明文形态（未设密码，与 dsh-credentials-local 完全一致）：

OPENCODE_GO_API_KEY: sk-…

密文形态（设密码后，写入插件自己的 .credentials.encrypt.yaml）：

{
  "format": "dsh-encrypt-credentials",
  "version": 3,
  "algorithm": "aes-256-gcm+sha3-256",
  "kdf": "argon2id",
  "kdfInput": "sha3-256-password",
  "m": 65536, "t": 3, "p": 1,
  "salt": "<base64url>",
  "verifier": { "data": "<base64url>", "sha3": "<hex>" },
  "remember": {
    "salt": "<base64url>", "issuedAt": 1755000000000, "days": 7,
    "cipher": { "data": "<base64url>", "sha3": "<hex>" }
  },
  "entries": {
    "OPENCODE_GO_API_KEY": { "data": "<base64url>", "sha3": "<hex>" }
  },
  "sha3": "<document fingerprint>"
}

kdf: "argon2id"：主密钥 = Argon2id(密码的 SHA3-256 摘要, salt, m/t/p)，m 单位 KiB；原始密码不进后端
旧版兼容：v2 文档（kdf: "scrypt"，字段 n/r/p）仍可解析与解锁，用自身存储的 scrypt 参数派生；下一次密码解锁成功时自动原地升级为 v3 Argon2id 格式（免密票据随旧密钥一起作废）
verifier 是固定明文的 AEAD 密文，用于在不接触任何真实凭证的前提下校验摘要
remember 仅在签发过免密票据时存在：cipher 是在票据密钥（SHA3-256(域名‖salt‖票据)）下 AEAD 包裹的主密钥；票据本身只存在于浏览器 HttpOnly Cookie，永不落盘；days: -1 表示永远
文档级指纹覆盖 sha3 以外的全部字段（含 salt、成本参数与 remember 块）；条目级指纹覆盖各自的密文 blob
密码与票据从不落盘

HTTP 路由（web 行）

仅 POST application/json（与官方 /api 相同的跨站写护栏）；响应 { ok: true, value } 或 { ok: false, code, message }，错误消息不含密码或任何密钥材料：

路径	请求体	作用
`/api/credentials.status`	`{}`	返回 `{ format, unlocked, plaintextForbidden, local, remember, ticketRejected, lockout, leakGuard }`；localhost 且携带免密票据（`x-dsh-encrypt-remember` 请求头或 Cookie）时先尝试票据解锁
`/api/credentials.unlock`	`{ digest }`	密码摘要解锁（64 位小写 hex SHA3-256）；localhost 成功后再按滑块签发免密票据（票据随响应体 `ticket` 字段回传）；失败次数过多时返回 429 + `Retry-After`（`TOO_MANY_ATTEMPTS`）
`/api/credentials.set-password`	`{ digest }`	明文 → 密文（仅 localhost），并写入密文策略标记
`/api/credentials.change-password`	`{ digest }`	重加密（需已解锁，仅 localhost，作废旧票据并签发新票据）
`/api/credentials.config`	`{ action: "get" }` / `{ action: "set", rememberDays }`	读取状态或设置免密天数（-1 = 永远，0 = 每次，1–30；set 仅 localhost，签发新票据时随响应回传）

所有路由只接受 POST application/json。密码本身永不出现在任何请求体里——浏览器只提交 digest（可用 node -p "require('crypto').createHash('sha3-256').update('密码').digest('hex')" 计算）。

headless 组合不挂载 web 行，因此没有 HTTP 面。

配置项

config:
  path: ''            # 凭证文件绝对路径；未设置时取 $DSH_HOME/.credentials.yaml（密文文件自动派生为同名 .encrypt.yaml）
  dshHome: ''         # Harness home（通常由运行时注入，无需手动设置）
  allowEnvFallback: true          # 允许继承环境与 .env 回退层
  passwordEnv: DSH_CREDENTIAL_PASSWORD  # 启动自动解锁的环境变量名
  watch: true         # 监听文件变化热重载
  debounceMs: 100     # 热重载防抖（毫秒）
  leakGuard: true     # 凭证泄露检测与输出脱敏
  leakMinMaskLength: 8     # 短于该长度的值不脱敏（避免误伤普通文本）
  leakMaxMaskLength: 256   # 长于该长度的值不脱敏（流式回看窗口）
  maxUnlockAttempts: 5     # 连续解锁失败触发锁定的阈值
  lockoutBaseMs: 30000     # 首次锁定窗口（毫秒，之后指数翻倍）
  lockoutMaxMs: 900000     # 锁定窗口上限（毫秒）

字段	类型	默认值	说明
`path`	string	`$DSH_HOME/.credentials.yaml`	凭证文件绝对路径（运行时注入 `dshHome` 计算默认值）；密文文件路径由其派生（`.yaml` → `.encrypt.yaml`）
`dshHome`	string	运行时注入	Harness home
`allowEnvFallback`	boolean	`true`	是否启用继承环境与 `.env` 回退层
`passwordEnv`	string	`DSH_CREDENTIAL_PASSWORD`	启动自动解锁密码的环境变量名
`watch`	boolean	`true`	是否监听文件热重载
`debounceMs`	number	`100`	热重载防抖毫秒数（≥ 0）
`rememberDays`	number	`0`	免密登录天数：`0` = 每次都输密码，`1..30` 天，`-1` = 永远（补丁配置的初始值；滑块运行时值写入 `$DSH_HOME/.dsh-encrypt.json` 并优先生效）
`leakGuard`	boolean	`true`	泄露检测与输出脱敏总开关（关闭后 HTTP/WS 输出不再扫描）
`leakMinMaskLength`	number	`8`	参与脱敏的最小值长度（4–64；更短的值视为普通文本）
`leakMaxMaskLength`	number	`256`	参与脱敏的最大值长度（16–1024；同时是流式脱敏的跨块回看窗口）
`maxUnlockAttempts`	number	`5`	连续解锁失败多少次后进入锁定（≥ 1）
`lockoutBaseMs`	number	`30000`	首次锁定窗口毫秒数（≥ 1000；之后每次失败 ×2）
`lockoutMaxMs`	number	`900000`	锁定窗口上限毫秒数（≥ 1000）

安全模型

保证：

静态存储只含密文；内存快照在密文形态下只保存密文记录
每条目随机 12 字节 nonce；引用名作为 GCM AAD，记录换位会认证失败
双层 SHA3-256 指纹 + GCM 认证标签：篡改且重算指纹的攻击仍会以 VAULT_KEY_MISMATCH 失败（与错误主密钥不可区分——这是 AEAD 的诚实答案）
密码经 Argon2id（m=65536 KiB, t=3, p=1，@node-rs/argon2）派生，只存盐与 AEAD 验证器；文档中成本参数有上限（m ≤ 256 MiB、t ≤ 64、p ≤ 32），恶意构造的参数无法耗尽内存/CPU
阅后即焚：密文只在被使用的一刻解密；解密中间 Buffer 立即清零；withUnlockedBuffer 在回调结束后焚毁明文副本；改密的明文集合用后即清空；密钥（KEK）在锁定/卸载时清零（zeroizeBuffer）
永远密文：设密后文件不可能回退明文；外部明文替换在解锁态被立即重加密，锁定/启动态被拒绝（plaintextForbidden）
POSIX 上凭证文件与密文文件都必须是 owner-only（0600，插件写入时即按此创建），否则启动直接拒绝（chmod 600 修复）；Windows 无 mode 可查，保护由创建 API 与 OS ACL 表达
防爆破：连续解锁失败计数 + 指数退避锁定，计数持久化（重启不清零）；接口返回 429 + Retry-After，面板显示剩余时间
防注入回显（Leak Guard）：模型解析过的凭证值成为掩码模式；WebUI 的 HTTP 响应体与 WebSocket 文本帧在离开主机前被替换为 [REDACTED:dsh-encrypt]（分块边界安全的流式脱敏，绝不先漏出前缀）
防篡改/防逆向侧：启动时对发行代码做 SHA3-256 完整性自校验，任何字节不一致即拒绝加载（fail-closed）；覆盖 provider 行、web 行与浏览器面板包

诚实边界：

JavaScript 字符串不可变：解密出的明文无法在内存中清零。给出的保证是不持久化、不缓存、不进日志，以及操作结束即丢弃引用
解锁期间主密钥必须驻留内存（否则无法解密任何条目），请以操作系统账户与 0600 文件保护
忘记密码无法找回（设计如此）；唯一恢复手段是清除凭证文件后重新配置
完整性清单不是信任根：能改写插件目录的攻击者也能重新生成清单；该校验拦住的是未重算清单的篡改（运行时打补丁、截断、供应链替换）。真正的信任根是用户密码
锁定计数存在状态文件：同一 OS 用户可编辑 .dsh-encrypt.json 重置计数——锁定防的是「在线猜密码」，不是同账户内的自我解锁
脱敏只覆盖本插件已知的值：仅模型实际解析过的凭证会被掩码；模型把密钥通过工具调用（bash/web_search/网络请求）外传不属于输出脱敏的覆盖范围，那属于 permission/tools 层职责；二进制 WS 帧与静态资源不做扫描；把密钥拆分/转码后再输出可绕过子串匹配
脱敏掩码集在解锁期间驻留内存（仅已解析值，锁定/改密/卸载即清空）——这是"掩码输出"与"不缓存明文"之间的有意识取舍
锁定态下未注册任何掩码（无明文可知），但也没有任何凭证会被解析出去，泄露面为零

错误码

VaultError 携带稳定的机器可读 code，消息永不含明文/密文/密钥材料：

code	含义
`PASSWORD_WRONG`	摘要与验证器不匹配（错误密码在触碰任何条目之前即被拒绝）
`PASSWORD_INVALID`	摘要不是 64 位小写 hex 的 SHA3-256
`LOCAL_ONLY`	该操作（改密/移除密码/免密设置）仅允许 localhost
`REMEMBER_EXPIRED`	免密票据已超过其窗口，需重新输入密码
`REMEMBER_INVALID`	免密票据与本凭证库不匹配（或库中无票据）
`VAULT_LOCKED`	凭证库已锁定；在「设置 → 加密安全」解锁（或导出 `DSH_CREDENTIAL_PASSWORD`）
`VAULT_NOT_ENCRYPTED`	尚未设置密码，无锁可解/无密可改/可除
`VAULT_ALREADY_ENCRYPTED`	已设密码；修改密码请用 `change-password`
`VAULT_CORRUPTED`	SHA3-256 完整性校验失败，错误中指名出问题的引用
`VAULT_INVALID`	文档结构非法（版本、算法、字段形状）
`VAULT_KEY_MISMATCH`	GCM 认证失败：主密钥不匹配，或密文被替换
`PASSWORD_INVALID` / `MASTER_KEY_INVALID`	参数或密钥材料非法
`TOO_MANY_ATTEMPTS`	解锁失败次数过多，已进入锁定窗口（HTTP 429 + `Retry-After`，错误携带 `retryAfterMs`）
`INTEGRITY_FAILED`	发行代码完整性校验失败（插件拒绝加载；合法重建后运行 `npm run integrity`）

兼容性与升级

v0.1.0-rc.6 → rc.7：文档版本升级为 v2（KDF 输入从密码改为密码的 SHA3-256 摘要）。v1 密文文档无法被 rc.7 读取——升级前请先在旧版「移除密码」恢复明文，或删除 .credentials.yaml 重新配置；明文形态不受影响
v0.1.0-rc.7 → rc.8：移除「移除密码」并启用永远密文策略（外部明文替换会被重新加密/拒绝）；免密票据增加 localStorage + 请求头通道并在打开 WebUI 时自动触发；新增阅后即焚（decryptEntryBuffer / withUnlockedBuffer）
v0.1.0-rc.8 → rc.9：KDF 从 scrypt 切换为 Argon2id（文档升级 v3，字段 m/t/p）；v2 scrypt 密文仍可解锁，成功解锁时原地自动升级，无需手工迁移。新增解锁爆破锁定（429 + 指数退避）、凭证泄露检测与输出脱敏（HTTP/WS）、发行代码完整性自校验（fail-closed）。注意新增原生依赖 @node-rs/argon2
与官方 credentials 接缝 drop-in：官方 provider 行原地工作，Fabric transform 透明加解密，LLM 适配器、Models 页、web-search 等消费者零改动
旧版原地密文自动迁移：旧版本把密文写在 .credentials.yaml 里；fabric-dsh 首次启动时会把该密文搬进 .credentials.encrypt.yaml，官方文件改写为注释指引，无需手工操作
官方凭证 RPC（如 credentials.set）在两种形态下照常工作；锁定状态下写入会以 VAULT_LOCKED 拒绝
设密后官方文件只是注释指引，普通 dsh 启动照常（解析为空店，读不到密文凭证）；要用这些凭证请通过 fabric-dsh 启动
对外导出：dsh-encrypt（encryptVault 服务）、dsh-encrypt/vault（零依赖密码学核心）、dsh-encrypt/web（路由与脱敏包装）、dsh-encrypt/client（浏览器包）

卸载与回滚

密文策略下没有「移除密码」路径，密文永远留在 .credentials.encrypt.yaml；基础 credentials 行读不懂它，因此卸载前先备份并删除两个凭证文件（或接受重新录入）：

备份/删除 $DSH_HOME/.credentials.yaml、.credentials.encrypt.yaml 与 .dsh-encrypt.json
移除 bundle：

dsh plugin --profile web remove dsh-encrypt
dsh plugin --profile headless remove dsh-encrypt

官方 credentials 行从未被禁用，之后在 DSH 设置中重新录入凭证。

开发与测试

npm install        # devDependencies 自包含（scoped rc.1 依赖线 + @node-rs/argon2）
npm test           # node --test：43 个单元测试（vault / web / client / security；pretest 自动重建完整性清单）
npm run integrity  # 手工重建 lib/integrity-manifest.json（修改任何 lib/ 文件后必须执行，否则启动自校验会拒绝加载）
npm pack           # prepack 自动重建清单后打包

安全测试覆盖：锁定期望（阈值/指数退避/上限/不复位）、泄露检测（正则元字符转义、长度窗口、去重）、流式脱敏的分块边界不泄漏性质、WebSocket 帧过滤（拆分帧/长度类重建/控制帧直通/二进制直通）、完整性清单（篡改/缺失 fail-closed）、429 响应与路由包装（注册前后均被包裹）、101 握手缓冲后过滤帧。

额外验证脚本：

node test/client-smoke.mjs     # 浏览器包 ModuleLoader/SSR 冒烟
# 两阶段真实重启 e2e（目标实例与 home 均显式传入，不硬编码回环地址）：
node test/e2e-webui.mjs --base http://localhost:3199 --home <dsh-home> --phase 1
node test/e2e-webui.mjs --base http://localhost:3199 --home <dsh-home> --phase 2

测试套件仅本地回归用，不随 npm 包分发（files 仅含 lib 与 cordis.patch.yml）。

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
lib		lib
scripts		scripts
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
cordis.patch.yml		cordis.patch.yml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml

Navigation Menu

Uh oh!

Repository files navigation

dsh-encrypt

解决的问题

特性

形态与架构

安装

1. Profile Bundle（推荐）

2. 启动走 fabric-dsh

3. 验证安装

4. 运行验证

5. 手动安装与旧版本兼容（仅调试场景）

使用

凭证解析顺序

磁盘格式

HTTP 路由（web 行）

配置项

安全模型

错误码

兼容性与升级

卸载与回滚

开发与测试

许可证

About

Releases

Packages

Contributors

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

dsh-encrypt

解决的问题

特性

形态与架构

安装

1. Profile Bundle（推荐）

2. 启动走 fabric-dsh

3. 验证安装

4. 运行验证

5. 手动安装与旧版本兼容（仅调试场景）

使用

凭证解析顺序

磁盘格式

HTTP 路由（web 行）

配置项

安全模型

错误码

兼容性与升级

卸载与回滚

开发与测试

许可证

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages