前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时,工具的执行结果往往包含敏感信息,如 API Key、Token 或数据库密码。如果这些凭据直接进入模型的上下文窗口,存在泄露风险。dsh-cloak 旨在解决这一问题,它作为一个上下文防火墙,在数据进入模型前拦截并处理这些凭据。
插件定位¶
dsh-cloak 是 DeepSeek Harness 的一个插件,核心功能是检测工具结果中的凭据,并用不透明占位符进行替换,确保机密信息不会进入上下文。
该插件由用户 zhangmiao03 维护。目前项目已迁移至 zhangmiao03/cloakpack 单仓库,与 cloakpack CLI 共享底层引擎。
核心功能¶
该插件主要提供以下能力:
- 凭据检测:识别工具返回结果中的敏感信息。
- 占位符替换:将检测到的凭据替换为不可读的占位符,保持上下文流的可读性。
- 上下文隔离:确保机密数据不会在模型处理过程中被实际读取或泄露。
安装与启用¶
安装前请确保已安装 DeepSeek Harness 及其 Web 服务器组件。
- 执行以下命令安装插件:
dsh plugin --profile web add dsh-cloak
- 插件将作为 DSH 进程的一部分运行,利用
@deepseek-ai/cordis及相关依赖(如dsh-llm、dsh-tools等)进行拦截处理。
使用示例¶
根据插件维护者的描述,该插件的设计理念可以概括为:“One product, one vault, two gates”(一个产品,一个金库,两道门)。这里的“两道门”指的是:
* Git 出机门:在代码仓库层面控制机密流出。
* DSH 入模门:在模型上下文层面控制机密流入。
插件代码位于 zhangmiao03/cloakpack 仓库的 packages/dsh-cloak 目录下。
注意事项¶
- 权限依赖:插件以 DSH 进程的权限运行,安装和使用前请检查源码和许可证(MIT)。
- 生态关系:DSH 的社区目录与 DeepSeek 或幻方官方无从属关系,请通过提供的 GitHub 链接获取最新信息。
结语¶
dsh-cloak 为 DSH 开发者提供了一种轻量级的上下文安全保护手段。通过在模型处理前进行脱敏,可以降低智能体在处理敏感任务时的风险。