dsh-sensitive-guard
Verified@r0cky20/dsh-sensitive-guard · v0.2.1 · Apache-2.0
Sensitive-data guard for DeepSeek Harness: blocks credential reads/outbound secrets and redacts secrets, tokens, and PII before they reach the model, session log, or spill files.
Install
dsh plugin add @r0cky20/dsh-sensitive-guard Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-sensitive-guard
🇨🇳 简体中文 · 🇬🇧 English
面向 DeepSeek Harness 的 host-only 安全插件:拦截凭据读取与外发密钥,并在密钥、令牌与 PII 进入模型、会话日志或 spill 文件前替换为占位符。
状态:0.2.1。拦截、脱敏与可选出站守卫三层均已实现并有测试;剩余工作统一由 GitHub Issues 跟踪(见路线图),尚未实现的能力请勿当作可用功能。
覆盖范围
| # | 泄露路径 | 覆盖 |
|---|---|---|
| 1 | 用户粘贴 → 模型请求 | ✅ agent/pre-step(提交的 user/message 也是脱敏版) |
| 2 | 工具读取 → 模型 | ✅ tools/pre-execute 路径/argv/URL 拦截 + tools/post-execute 结果脱敏 |
| 3 | 工具结果 → spill 文件 | ✅ 命中时 post-execute 短路,下游 spill 看不到原文 |
| 4 | PTC 子调用日志副本 | ✅ tools/ptc-dispatch-log |
| 5 | system prompt / runtime context | ✅ system-prompt/assemble |
| 6 | 会话 inbox 原文 | ⚠️ 部分:agent/inbox/spliced 仍保留用户原文 |
| 7 | assistant 复述 | ❌ 无公开改写钩子 |
| 8 | 图片 / 截图 | ❌ 无 OCR |
| 9 | 第三方插件 / MCP 内部 | ❌ 不在 DSH 工具管线内 |
| 10 | 模型 provider 留存 | ❌ 合同/选型问题 |
内容层只能约束经过 DSH 工具管线与消息管线的内容。可选出站守卫(egress.enabled)为遵守 HTTPS_PROXY 的子进程增加目的地址级控制:它约束连接能去哪里,而不是内容本身,且明确不做 TLS 中间人。
功能
- 两层能力:fail-closed 的 allow/deny/ask 拦截层 + 脱敏层。
- 五个钩子:pre-step、pre-execute、post-execute、PTC dispatch log、system-prompt assemble。
- 规则:用户 YAML 规则 + 生成的路径策略 + vendor 的高危基线(破坏性命令、RCE、凭据路径)。
- 检测:分层密钥规则(PEM、各厂商 key、JWT、URL 凭据、赋值)与 PII(邮箱、手机、身份证、Luhn 银行卡、SSN),附高熵 fallback。
- 稳定占位符:密钥
[SECRET:<category>:<id>](不可逆);PII[[PII_<TYPE>_<hash8>]](跨会话稳定)。 - 审计:JSONL,只含规则 id、计数与 hash,不含原文、密钥或完整路径。
- 先观察:
mode: monitor只审计不拦截。 - 可选提示:
redact.notify在被脱敏的 step 追加一条仅含计数的消息。
路线图
所有计划中的工作都通过 GitHub Issues 管理。入口是 roadmap 标签, issue 列表是唯一来源。
要求
- Node.js
^22.19.0 || >=24.0.0 - DeepSeek Harness
0.2.1-rc.2(peer 范围>=0.2.1-rc.2 <0.3.0-0) - 启用了
tools服务的 profile(base bundle)
安装
从 npm 安装
从 v0.2.0 起发布到 npmjs(匿名、无需 token):
dsh plugin --profile web add @r0cky20/dsh-sensitive-guard
从 GitHub Release 安装
需要固定版本或校验产物时:先用同一 release 的 SHA256SUMS 校验下载文件,然后:
dsh plugin --profile web add \
https://github.com/gythialy/dsh-sensitive-guard/releases/latest/download/dsh-sensitive-guard.tgz
两个渠道都是公开的。不要从 GitHub Packages 安装 @gythialy/dsh-sensitive-guard
镜像,那个 registry 需要 GitHub 认证,不是面向用户的路径。
交给 agent 安装
把 docs/agent-install.md 交给 coding agent,或直接给它这段提示:
Install dsh-sensitive-guard into my DSH web profile by following https://github.com/gythialy/dsh-sensitive-guard/blob/main/docs/agent-install.md
指南包含一条安装命令、挂载验证、重启、可选的 enforce 配置与回滚。
从源码安装(开发期)
pnpm install
pnpm verify
# 链接到某个 profile;会写 ~/.dsh,需要批准
dsh plugin --profile web add link:"$PWD"
包内 cordis.patch.yml 通过 dsh.bundle.patch 自动挂载。profile 可用行 id sensitive-guard 覆盖配置:
# ~/.dsh/profiles/web/cordis.patch.yml
- id: sensitive-guard
name: '@r0cky20/dsh-sensitive-guard'
config:
mode: monitor
安装后重启 dsh web;不要在会话内自行重启当前 GUI。
配置
完整配置见 docs/configuration.md。关键项:
mode: monitor # monitor 只审计;enforce 生效
defaultDecision: allow
failClosed: true
levels:
input: aggressive
output: balanced
policy:
rulesFile: .dsh/rules.yaml
builtin: true
paths:
deny: ['**/.env', '**/.ssh/**', '**/*.pem']
allow: ['**/.env.example', '**/.env.sample', '**/.env.template']
egress: # 可选的目的地址级出站守卫,默认关闭
enabled: false
port: 41999
failClosed: true
unknown: allow
allow: []
deny: ['169.254.169.254:80', 'metadata.google.internal']
upstream: ''
canary: true
audit:
path: ~/.dsh/audit/sensitive-guard.jsonl
defaultDecision注意:schema 默认是ask(与设计文档一致)。因此mode: enforce下,没有命中任何规则的调用也会询问批准。请先跑monitor看审计,再改成allow或补显式 allow 规则。monitor下该值不影响行为。
项目规则文件位于 <project>/.dsh/rules.yaml,格式见 docs/rules-format.md。敏感凭据路径在 enforce 下默认 deny;.env.example / .env.sample / .env.template 默认放行。
PII key 文件为 32 字节随机值,权限 0600(父目录 0700)。不可用时退化为进程内随机 key:仍能脱敏,但跨重启占位符不稳定。
/guard 命令
/guard status:模式、等级、规则数、审计与 PII/restore 状态;不含明文或匹配值。/guard on//guard off:仅对当前进程切换enforce/monitor,不持久化。/guard restore <placeholder> <file>:需pii.restore: true;把原始 PII 写入新的0600文件,拒绝覆盖,绝不回显原值。映射只在内存中,只有开启 restore 后在本进程内生成的占位符可恢复;密钥仍不可逆。/guard egress [status|canary|report]:可选出站守卫的状态:监听、https_proxy是否指向本进程、规则数、隧道/拦截/字节计数、最近目标、回环探针,以及report(从审计日志汇总目标,支持--since 7d与--yaml)。
出站守卫(可选,默认关闭)
v2 在 DSH 已有的 HTTPS_PROXY 缝隙上做目的地址级 CONNECT 守卫:只看
host/port,不做 TLS 中间人、不装 CA。必须在启动环境里接线才生效:
# $DSH_HOME/.env(或在启动前 export),然后重启 DSH
https_proxy=http://127.0.0.1:41999
egress:
enabled: true
port: 41999
unknown: allow # 先放行+审计;要白名单就改 deny
deny: ['169.254.169.254:80', 'upload.example.com:443']
覆盖范围如实说明:DSH 对 loopback 强制直连,telemetry 与 PTC/workflow worker
不走代理,JVM、rustls、静态 Go、容器、SSH、HTTP/3 也会忽略或绕过代理变量。
被拒的隧道返回 403 与 X-Guard-Reason。完整契约见
docs/configuration.md。
审批提示会说明工具、简短风险类别(如 高风险命令、敏感路径)以及脱敏后的具体操作;密钥会替换为占位符,URL 凭据会打码。拒绝原因会说明拦截理由并给出一条安全的下一步。/guard status 输出带标签的键值块,而不是 key=value 行。守卫提示跟随 DSH 语言设置(en / zh);未设置时依次回退到进程 locale 和英文。
扫描
包内附带独立扫描器,复用同一套规则,只输出类别、相对路径、计数和行号:
pnpm build
node bin/scan.mjs --staged # 当前仓库已 staged 的文件
node bin/scan.mjs src test # 指定路径
node bin/scan.mjs --json --no-exit-code .
退出码:0 干净、1 有命中、2 用法/IO 错误。超过 --max-bytes
(默认 8 MiB)和二进制文件会跳过;绝不打印匹配到的原值。
审计
目录 0700、文件 0600,超过 rotateBytes 轮转,保留 5 份。写失败只 warn 一次,不影响工具调用。记录示例见英文 README。
已知边界
- 无法改写 DSH 的
agent/inbox/spliced原文与 assistant 输出。 - 安装前的历史会话不会自动重写。
- 工具参数中的密钥只能阻止执行,无法改写参数(host 在 pre-execute 前已记录)。
- 出站守卫是可选的目的地址级控制:只覆盖遵守
https_proxy的客户端,HTTPS 只能看到host:port。loopback、telemetry、PTC/workflow worker、JVM、rustls、静态 Go、容器、SSH 与原始套接字都会绕过;不做 CA、不做 TLS 中间人。详见 docs/configuration.md 与 设计文档 §19;不做 OCR/图片脱敏。 - 脱敏隐私优先:误报可能去掉正常文本;先
monitor再收敛规则。
开发
pnpm format:check
pnpm lint
pnpm typecheck
pnpm test
pnpm test:coverage
pnpm test:e2e # 临时 headless profile + 本地 mock provider
pnpm build
pnpm pack:check
src 为 TypeScript,1:1 转译到 lib(不打包),发布产物可逐文件审计。
许可证
Apache-2.0。规则基线派生自 dsh-permission-rules(Apache-2.0, Copyright 2026 PerryLink);密钥规则表派生自 dsh-secret-scrub(MIT, Copyright (c) 2026 jkt-check)。详见 THIRD_PARTY_NOTICES.md 与设计文档 docs/sensitive-guard-integration.md。
安全问题报告:SECURITY.md。