TapPass governance：DeepSeek Harness 的业务规则权威层

前言¶

DeepSeek Harness 的核心理念是「一切皆插件」。现有的安全分类器通常关注输出本身是否有害，这是一种模型层面的属性。而 TapPass 插件关注的是一个不同的问题：在当前的规则下，这个智能体是否被允许执行这个动作？这是一个属于组织的业务属性，模型权重无法回答这个问题。

该插件在 Harness 的 tools/pre-execute 钩子处拦截每一个工具调用，将其发送到 TapPass 的策略决策点，并根据返回结果允许、拒绝或升级为人工审批。

插件定位¶

这是一个为 DeepSeek Harness 设计的插件，旨在为代理式 AI 提供业务规则层面的权威控制。它由 tappass 维护，采用 MIT 许可证。

它解决的核心问题是：如何在 Harness 中实施组织内部的业务逻辑（如退款额度、PII 数据出境限制、CRM 只读策略），而不仅仅是依赖模型的安全分类器。

核心功能¶

• 拦截工具调用：在工具执行前的 tools/pre-execute 阶段介入。
• 基于业务规则：将策略编写为业务语言（如“超过 500 的退款需人工审批”），而非提示词。
• 观察与强制执行模式：默认以观察模式运行，记录所有调用而不阻断；确认无误后可切换至强制执行模式。
• 跨模型/框架通用：同一套规则可应用于 Harness、Claude Code、Codex 或 LiteLLM 后端。
• 审计日志：记录所有决策过程，支持 EU 托管，满足 EU AI Act 要求。

安装与启用¶

安装前请确保已安装 DeepSeek Harness 并配置了默认 Profile。

1. 安装插件：
   执行以下命令将插件添加到默认配置文件：

    dsh plugin --profile default add @tappass/dsh-governance

2. 配置环境变量：
   设置 TapPass 开发者密钥，该密钥绑定到特定的 agent 和 org：

    export TAPPASS_API_KEY="tp_dev_..."

3. 验证配置：
   不启动 Harness，直接检查配置是否正确加载：

    dsh --profile default --dump-config

典型用法¶

插件安装后，需通过 YAML 补丁配置其运行模式。默认为 observe（仅记录），配置为 enforce 后生效。

创建或编辑配置文件（例如 $DSH_HOME/profiles/default/cordis.patch.yml）：

- tappass-governance:
    config:
      mode: enforce

决策流程¶

插件会将 TapPass 返回的 outcome 映射为 Harness 的决策：

在 observe 模式下，所有调用默认返回 next()，但拦截到的 block 或 needs_approval 请求仍会在服务端记录日志，供你在切换到 enforce 模式前评估流量。

适用场景与注意¶

适用场景¶

• 需要对智能体工具调用进行细粒度权限控制（如只读 CRM、禁止修改敏感配置）。
• 需要符合欧盟数据本地化及 AI Act 合规要求的组织。
• 希望先观察再执行，逐步收紧策略的团队。

注意事项¶

1. 不支持参数重写：DeepSeek Harness 在 tools/pre-execute 阶段将工具参数设为只读（用于日志和展示），因此 TapPass 的 modify 意图无法直接应用。该插件在强制模式下遇到此类请求会直接拒绝（Fail Closed），并返回原因。
2. 批准需开放回合：needs_approval 意图映射到 Harness 的 ask 决策，需要配置审批器。如果未配置审批器，该请求会安全地回退为拒绝。
3. 开发者预览阶段：DeepSeek Harness 及其插件 API 目前处于开发者预览阶段，可能存在变更。
4. EU 托管：TapPass 服务托管于 EU，API 端点为 https://app.tappass.ai/v1/govern。

结语¶

TapPass governance 提供了将组织业务规则落地到 AI Agent 执行层面的能力。通过观察模式与强制模式的切换，它允许团队在控制风险的同时，保留智能体的自主性。所有决策均记录在案，确保了审计的透明度。

• 插件目录：https://www.skillhub.cn/plugins/tappass/dsh-governance
• 源码地址：https://github.com/tappass/dsh-governance