插件目录 / Automation / dsh-governance
dsh-governance
未验证 tappass
功能简介
dsh-governance — DSH 插件(编排)
未验证 — 尚未实测
dsh-governance — DSH 插件(编排) 尚未验证——请自行安装测试。
「未验证」表示我们的自动化 CI 尚未安装过该插件。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
TapPass governance for DeepSeek Harness
The authority layer for agentic AI, as a DeepSeek Harness plugin.
Everything in DeepSeek Harness is a plugin. This is the one that decides what
your agents are allowed to do.
Guardrails and safety classifiers ask "is this output harmful?" That is a
property of the model. TapPass asks a different question: "is this agent
allowed to do this, under our rules, right now?" That is a property of
your business, and no model level tool can answer it, because the answer lives
in your organisation, not in the weights.
This plugin intercepts every tool call at the harness's tools/pre-execute
seam, sends it to the TapPass policy decision point (POST /v1/govern), and
allows, denies, or escalates it for human approval.
Why it is different
- Business rules, not model safety. Write the rule once, in your language:
"refunds over 500 need a human", "no customer PII leaves the EU region", "this
agent may read the CRM, never write it". It is enforced on every tool call, on
every harness, under every model. A prompt is a suggestion. A policy is a fact. - Authority is earned. The plugin ships in observe mode: from the first
minute it watches and records every call, and blocks nothing. You see what
your agents do before you enforce a single deny. Then you turn on enforcement
for what matters. Autonomy is a track record, not a checkbox. - Harness and model agnostic. The same rules that govern an agent here
govern it in Claude Code, in Codex, behind LiteLLM. The harness is
interchangeable. The authority is not. - EU hosted, EU AI Act ready.
Install
# create a profile if you do not have one, then add the plugin
dsh plugin --profile default add @tappass/dsh-governance
# point it at your TapPass workspace
export TAPPASS_API_KEY="tp_dev_..." # a TapPass developer key
# verify the layer without booting, then run
dsh --profile default --dump-config
dsh --profile default
Get a developer key from your TapPass dashboard (Settings, Developer keys) orPOST /api/agents/{agent}/developer-keys. The key is bound to one agent and one
org; TapPass records the audit trail against it.
Configure
Every tool call is governed once it is installed. Configuration is optional; the
defaults are safe.
| Key | Default | Meaning |
|---|---|---|
baseURL |
https://app.tappass.ai |
TapPass API base. The plugin POSTs to ${baseURL}/v1/govern. |
apiKeyEnv |
TAPPASS_API_KEY |
Env var holding your tp_dev_ key. A reference, not the secret. |
mode |
observe |
observe: send and record every call, block nothing. enforce: honor verdicts. |
onError |
deny |
In enforce, when TapPass is unreachable: deny (fail closed) or allow (fail open). |
timeoutMs |
4000 |
Hard timeout per verdict call. A slow PDP never wedges the agent loop. |
agentId |
harness agent id | Override the agent id sent to TapPass. |
orgId |
from the key | Override the org id; normally stamped from the developer key. |
Set them in your profile's patch, for example to enforce:
# $DSH_HOME/profiles/default/cordis.patch.yml
- tappass-governance:
config:
mode: enforce
How a verdict becomes a decision
TapPass outcome |
dsh PreToolDecision |
Effect |
|---|---|---|
allow |
next() |
the tool runs |
block |
{ kind: 'deny', reason } |
the model gets an error result with the reason |
needs_approval |
{ kind: 'ask', reason } |
routed to the harness approval flow for a human |
In observe mode every call returns next(), but a would-be block or approval
is still recorded server side and logged locally, so you can size your policy
against real traffic before enforcing.
The plugin sends its mode with each call (enforcement.mode), so the audit
trail can show an observe-mode block distinctly from an enforced one.
Honest limitations
- No argument rewriting. DeepSeek Harness makes tool arguments read only at
tools/pre-executeby design (they are already logged and shown to the
model), so a TapPassmodifyverdict cannot be applied in place. This plugin
fails such a call closed inenforcemode with a clear reason rather than
silently running the unmodified request. Redaction obligations are surfaced,
not applied. - Approval needs an open turn. A
needs_approvalverdict maps to the
harnessaskdecision, which routes to whatever approval answerer your
profile mounts. With no approver configured,askfails closed to a denial,
which is the safe default. - Developer preview. DeepSeek Harness and its plugin API are pre-release and
may change. This plugin is deliberately thin: it is a bridge to/v1/govern,
so if the harness API shifts the fix is a small shim, not a rewrite.
Develop
npm install --legacy-peer-deps # dsh rc packages have skewed peer ranges
npm run build
node --test
The verdict mapping and the /v1/govern client are covered bytest/plugin.test.mjs and run against a local mock server, no TapPass instance
required.
Links
- TapPass: https://tappass.ai
- The authority layer for agentic AI. Authority is earned. Even by AI.
License
MIT © Cogniqor BV (TapPass)
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 dsh-governance」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:tappass/dsh-governance Headless(CLI)profile:
dsh plugin --profile headless add github:tappass/dsh-governance 实测报告
尚未 L3 验证——若已跑过,见下方失败备注。
备注:验证: install-fail (0.1.0-rc.6) 浏览全部待验证失败 →
使用场景
自动化一项重复工作——调度、串联任务或响应事件——不用你亲手启动。
适合谁
有周期性工作、想 cron 式无人值守而非手动触发的人。
二次开发建议
触发器和任务模板是缝——加事件驱动或文件监听触发,以及更丰富的流程编排。