前言¶

在 DeepSeek Harness 里跑 agent，对话和工具调用往往会带上 API Key、邮箱电话、身份证、公司名等明文。这些内容会随请求发往云端大模型，也会写入本地会话日志。若只靠「别在 prompt 里写密钥」这类习惯，很难在流式输出、工具回传和落盘环节保持一致。下面介绍社区插件 dsh-privmask：在请求离开本机前做本地遮罩，模型侧与日志侧只见占位符，本地再把占位符还原给 agent 和展示层使用。

这是什么¶

dsh-privmask 是 DeepSeek Harness 的本地脱敏插件，维护者为 JunyuZhan，在 DSH 插件目录中归类为 admin-security。它将密钥、PII 与常见中文实体替换为 [REDACTED_类别_N] 形式的占位符，云端请求与落盘日志均使用脱敏内容；模型输出与工具参数中的占位符在本地还原，再次出站时会重新脱敏。插件以 MIT 许可证发布，npm 包名与安装标识均为 dsh-privmask。

核心功能¶

出站脱敏¶

请求发往云端前，对 PEM/JWT/API Key、邮箱与电话、身份证、统一社会信用代码、银行卡、车牌、地址、公司名、机关名等做替换。README 说明：法院/案号、出生日期、涉案金额等类别默认保留，便于办案类场景仍能看到相关真值。脱敏异常或未知字段在严格模式下默认拒绝请求，非文本内容默认剥离，避免静默放行明文。

入站还原与展示¶

模型输出和工具调用参数里的占位符在本地映射回原值；同一会话内相同原文对应相同编号。流式场景下占位符被切分到多个 delta 时仍可跨分片还原。展示层在服务可见时，可将用户消息还原为原文显示。

落盘遮罩¶

用户输入、工具结果以及 run_code 子派发在写入会话日志前替换为占位符，与出站策略对齐，减少日志中的明文残留。

离境审计与本地文件工具¶

每笔发往云端的请求可在本地记一行 JSONL，配合文档中的 audit-summary 做汇总巡检。另提供 docx/纯文本脱敏、PDF 预检与覆写式脱敏等本地文件能力；图片本地 OCR 默认关闭。宿主版本方面，README 写明对 0.1.1-rc.2 至 0.2.2-alpha.2 等范围做过兼容核对，并对事件/服务做软探测与自动降级。

安装与启用¶

绝大多数用户可在 DSH Desktop 侧栏打开「插件」→「添加插件」，输入 dsh-privmask 后安装并立即启用，按提示重启 Desktop；「设置 → 插件」中应出现「隐私保护」页签。

无界面或 web profile 部署时，使用 README 给出的命令行方式：

dsh plugin --profile web add dsh-privmask

装完需重启宿主生效。也可在插件市场启用「自定义插件市场」，添加索引源 https://cdn.jsdelivr.net/gh/JunyuZhan/dsh-privmask@main/market/index.json 后搜索安装。镜像源、升级与排查见仓库 docs/install.md。

典型用法¶

默认配置偏向「隐私优先」：凭据、地址、姓名、公司与单位名及常见 PII 会脱敏，案号、出生日期、金额等按默认策略保留。需要覆盖时，可在 profile 的 cordis.patch.yml 中调整，或在客户端「隐私保护」卡片上修改（live 生效）。示例片段如下：

# $DSH_HOME/profiles/<profile>/cordis.patch.yml
- id: privmask
  config:
    enabled: true
    redactNames: true
    redactCompanies: true
    redactOrgs: true
    customTerms: [张三, 某某公司]

全部配置键与默认值见 docs/configuration.md。脱敏流水线、安全边界与已知限制分别见 how-it-works.md、security-model.md 与 limitations.md。

适用场景与注意¶

适合在 DSH 中处理含密钥、客户信息或中文实体的 agent 工作流，又希望云端与日志侧默认不见明文的团队。README 明确：脱敏基于启发式规则，不保证零漏检、零误伤；高合规场景应自行抽样验证并保留可信原文副本。

插件与 DSH 宿主同一进程权限运行，安装前建议阅读源码与 MIT 许可证，确认策略是否符合你的数据分级要求。发现隐私泄漏或绕过脱敏的问题，应通过仓库 SECURITY.md 私下报告，勿在公开 Issue 中粘贴真实敏感数据。

结尾¶

dsh-privmask 把「出站遮罩、日志遮罩、入站还原」串成一条本地流水线，是 DSH 生态里面向 admin-security 的隐私插件之一。社区目录页：https://www.skillhub.cn/plugins/JunyuZhan/dsh-privmask；源码与文档：https://github.com/JunyuZhan/dsh-privmask。