DeepSeek Harness (DSH) 的插件化架构允许开发者灵活扩展智能体的能力。在处理敏感数据与合规审计时,手动检查既繁琐又容易遗漏。enterprise-compliance 插件通过自动化 SOC2/GDPR 检查、敏感信息拦截与操作日志审计,解决 DSH 生态中的合规痛点。
插件概述¶
这是 DeepSeek Harness 的企业级合规插件,由 xiaoliang2 维护,采用 MIT 许可证。它提供 SOC2/GDPR 自动化检查、敏感信息脱敏及审计追溯能力,支持 Web 与 Desktop Profile 安装。
核心功能¶
1. SOC2 / GDPR 自动化合规自检¶
通过 compliance_report 模型工具读取运行时事实,按 CC6.1 / CC6.2 / CC7.2 / CC6.6 与 GDPR Art.5 / Art.25 逐项判定 PASS / WARN / FAIL 并打分。支持 summary / json / markdown 三种格式导出,并记录评分历史趋势。
2. 敏感信息拦截与脱敏¶
compliance_redact 模型工具集成 9 类正则规则(邮箱、手机号、身份证、银行卡、API Key、JWT、Bearer、私钥、IP)。已挂载到 session-telemetry/record 瀑布流,在遥测导出前自动脱敏,符合 GDPR 数据最小化原则。
3. 操作审计追溯¶
compliance_audit 模型工具监听 tools/result,记录每次工具调用的时间、工具名、成功/失败、会话 ID、脱敏后的参数。审计数据持久化到 settings.yaml,重启后不丢失证据,支持按工具/会话/时间过滤导出。
4. 敏感数据文件扫描¶
compliance_scan 模型工具扫描工作区文件或目录中的明文敏感信息,返回逐文件命中统计与脱敏样例。默认遵守 .gitignore,并跳过 .git / node_modules 目录。默认限工作区,可通过 allowOutside 开关开启外部扫描。
5. GDPR 数据主体权利¶
提供数据导出与擦除能力:
* compliance_data_export:依据 GDPR Art.20 导出采集的数据。
* compliance_data_erase:依据 GDPR Art.17 一键擦除审计/历史/报警状态(需确认)。
6. 阈值报警与策略管理¶
- 策略读写:
compliance_policy模型工具可读取/修改报警阈值、审计持久化条数、检查项开关、脱敏规则开关、告警 Webhook。 - 阈值报警:评分跌破
alertThreshold时发出enterprise-compliance/alert事件。 - 告警 Webhook:配置
alertWebhook后,评分跌破/恢复时 POST JSON 到指定 URL(5s 超时)。
安装与启用¶
使用 npm 安装:
dsh plugin add @xiaobanli/dsh-enterprise-compliance
安装后,本包会被加入 profile 的 dsh.profile.bundles,cordis.patch.yml 会在下次启动时自动应用。插件支持 Web 与 Desktop Profile。
典型用法¶
生成合规报告¶
# 读取运行时事实,输出 JSON 格式报告
compliance_report --format json
敏感信息脱敏¶
# 对输入文本进行脱敏,返回脱敏后的结果与命中统计
compliance_redact "请拨打 13800138000 或访问 user@example.com"
查看审计日志¶
# 导出审计日志,支持按工具或会话过滤
compliance_audit --export csv
扫描敏感文件¶
# 扫描当前工作区,跳过二进制文件与超过 1MB 的文本文件
compliance_scan
擦除数据¶
# 确认后擦除本插件采集的审计/历史/报警状态
compliance_data_erase --confirm true
已知限制¶
- 审计持久化不含参数:
args仅在内存环中存在,落盘的是时间/工具/结果/会话/错误,重启后参数不再可查。 - 持久化条数限制:默认持久化条数为 100(可通过
policy.auditPersist调整),内存环上限为 500。 - 文件扫描限制:
compliance_scan默认跳过二进制文件与超过 1MB 的文本文件。 - 数据擦除范围:
compliance_data_erase仅擦除本插件自身采集的数据,不涉及 DSH 其他数据。 - 运行时依赖:部分检查项结果取决于运行时服务是否挂载(如审批、凭证、持久化、遥测)。
- 页面依赖:合规中心页面依赖
settings服务存在;缺失时仅影响页面展示,不影响模型工具。
生态与目录¶
该插件已发布到 npm,源码托管在 GitHub。社区目录收录了该插件的详细索引:https://www.skillhub.cn/plugins/xiaoliang2/enterprise-compliance。