前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在企业落地过程中，往往最先遇到三个问题：谁能调用高危工具、出事如何追溯、成本花在哪里。dsh-gov 是为此设计的插件，提供了基于策略的工具门禁、结构化审计日志以及按 Agent 的 Token 配额控制能力。
这是什么¶
这是一个面向 DeepSeek Harness 的 Agent 治理套件，旨在提供策略门禁、结构化审计和成本管理。它由用户 863683348 维护，状态持久化在 $DSH_HOME/gov/ 目录下。
核心功能¶
- 策略门禁：支持按工具名称、Agent 或工作区设置规则，动作包括允许、拒绝或询问。支持通配符和优先级。默认策略为放行，平局时遵循 fail-closed 逻辑（拒绝 > 询问 > 允许）。
- 结构化审计日志：生成纯追加的 JSONL 文件，记录工具名、Agent、工作区、决策、理由和结果（不记录工具参数）。
- Token 配额管理：基于宿主的
tokenMeter，按 Agent ID 累计 Token 用量。支持按天/周/月/总量设定配额，超限时会向模型上下文注入警告。 - 工具拦截与观察：在工具执行前进行门禁检查，并在工具调用后记录结果。
安装与启用¶
通过官方插件目录安装：
dsh plugin --profile <profile> add dsh-gov
安装后，插件会接管 DSH 的工具调用流程，并自动在 $DSH_HOME/gov/ 下创建策略、配额和审计数据。
典型用法¶
插件提供了一个 gov 工具，包含以下常用命令：
- 查看治理总览：
gov status
- 添加策略（示例：对 PowerShell 开头的工具要求审批）：
gov policy_add tool="pwsh*" policyAction=ask reason="shell commands require approval" priority=10
- 设置配额（示例：为 Agent alice 设置每天 100,000 tokens 的限制）：
gov quota_set id=alice quotaLimit=100000 period=day
- 查询审计日志（示例：查询最近的拒绝记录）：
gov audit_query decision=deny limit=20
适用场景与注意¶
该插件适合需要严格权限控制、合规审计或成本管理的团队。注意，插件以当前 DSH 进程的权限运行，调用工具和访问文件系统，请务必在安装前检查源码与许可证。
结尾¶
dsh-gov 提供了策略门禁、审计追踪和配额管理的基础能力，帮助企业更安全地使用 DeepSeek Harness。更多细节请参考社区目录或GitHub 仓库。
