863683348/dsh-gov

Agent governance suite for DeepSeek Harness: policy-based tool gating (allow/deny/ask), structured JSONL audit trail, per-agent token quotas — enterprise companion

Bundle 已验证 MIT JavaScript 未知
Bundle 已验证

已收录

0

Security

Bundle 已验证

★ 0 在 GitHub 查看
版本未知
语言JavaScript
许可证MIT
在 GitHub 查看

预览

第 1 个预览，共 2 个：863683348/dsh-gov
第 2 个预览，共 2 个：863683348/dsh-gov

功能介绍

Agent 治理套件：基于策略的工具门禁（allow/deny/ask，支持通配符与优先级）、结构化 JSONL 审计日志、基于宿主 token 计量的按 agent 配额，状态存于 $DSH_HOME/gov。

适合

  • 需要基于策略对 agent 工具调用执行允许、拒绝或审批控制的团队。
  • 需要跨工作区审计工具调用并跟踪各 agent token 用量的组织。

不适合

  • 不适合要求严格强制配额的场景，因为超额仅注入上下文警告，计量或持久化失败也不会阻断 agent。
  • 不适合需要工具参数或载荷内容的取证，因为审计日志不记录这些内容。

README

dsh-gov — Agent Governance Suite (enterprise companion)

权限、审计、成本 —— DSH 进企业前必须有的东西，做成一个插件。策略门禁（allow/deny/ask）、结构化审计日志、按 agent 的 token 配额，状态持久化在 $DSH_HOME/gov/。

为什么需要它

企业引入 DSH 时第一波问题永远是：

  • 谁能让 agent 跑高危工具？ 策略门禁：按工具/agent/工作区规则，allow / deny / ask，通配符 + 优先级，默认放行、命中即裁决、平局 fail-closed（deny > ask > allow）。
  • 出事了怎么追溯？ 每次工具调用（决定 + 结果）都写入结构化 JSONL 审计日志（audit.jsonl），可查询、可导出、可汇总。
  • 钱花哪去了？ 接宿主 tokenMeter，按 agent 累计 token 用量，周期配额（day/week/month/total），超限注入上下文警告，可一键重置。

安装

dsh plugin --profile <profile> add dsh-gov

用法（模型侧）

工具 gov，action 一览：

action 说明
status 治理总览：规则数、审计事件汇总（allow/deny/ask/error/ok）、配额用量
policy_list / policy_add / policy_remove 规则管理（tool 支持 * 通配；priority 高者胜；平局 fail-closed）
audit_query / audit_export 查询审计（limit/agent/tool/since 过滤）；导出日志路径
quota_get / quota_set / quota_reset 按 agent id（或 global）的 token 预算

示例：

gov policy_add tool="pwsh*" policyAction=ask reason="shell commands require approval" priority=10
gov quota_set id=alice quotaLimit=100000 period=day
gov audit_query decision=deny limit=20

配置

key 默认 说明
root $DSH_HOME/gov 治理数据目录（gov.json + audit.jsonl）
defaultPeriod day 新配额默认周期
defaultLimit 0 默认配额（0 = 不限；>0 时启用 step 计量）
prestepWarn true 超限时向模型上下文注入警告
sectionOrder 5 提示词段落顺序

设计

  • 纯逻辑分层：lib/policy.js（规则引擎）、lib/audit.js（审计模型）、lib/quota.js（配额计算）零依赖可单测；lib/index.js 负责接线（tools/pre-execute 门禁、tools/result 观察、agent/pre-step 计量）。
  • 全局而非会话：状态和日志在 DSH home，跨工作区一致。
  • fail-safe：计量失败、持久化失败都不阻塞 agent；策略引擎平局默认 fail-closed。
  • 审计日志是纯追加 JSONL，可被任何合规管道消费（二期：导出 SOC2 素材、多租户隔离）。

测试

node test/policy.test.mjs && node test/audit.test.mjs && node test/quota.test.mjs

FAQ

  • 默认放行还是默认拒绝？ 默认 allow（与 DSH 一致）；需要收紧就加规则，平局时 fail-closed（deny > ask > allow）。
  • 审计日志会记录工具参数吗？ 不会。只记工具名、agent、工作区、决定、理由、结果（成功/失败）——不含参数内容。
  • 配额按什么计？ 宿主 tokenMeter 的 totalTokens（当前请求+响应压力），按 agent id 累计到周期。
  • 计量失败会卡住 agent 吗？ 不会，fail-safe：计量/持久化异常时跳过该步。

License

MIT

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:863683348/dsh-gov。命令会解析公开 package 元数据，并保持插件与本页展示的目录身份一致。

PerryLink/dsh-auto-review★ 30

审批链上的第二模型自动审查：只读审查子代理返回带理由的 allow/deny 结构化裁决，默认 fail-closed。

Apache-2.0
omdsh-dev/dsh-security-audit★ 12

本机安全审计：配置/插件来源/会话/网络暴露面，只读脱敏风险报告。

MIT
slywalker2006/dsh-passwords★ 11

让 DeepSeek Harness 变成服务器级多租户平台：远程访问 + 自动 HTTPS、子用户权限与配额、沙盒强制、加密认证与审计日志。

BSD-3-Clause
PerryLink/dsh-permission-rules★ 8

Claude Code 风格的声明式权限规则：按序 allow/deny/ask 的 YAML 规则，在 tools/pre-execute 瀑布上匹配工具名、参数、工作区路径与 agent 身份，带完整会话日志审计、干跑模式与热重载。

Apache-2.0