mickymultani/deepseek-harness-enterprise-suite

DeepSeek Harness 企业套件

面向 DeepSeek Harness 的开源企业集成、治理控制与插件模板。

该套件为希望让智能体访问内部系统、又不愿将连接器凭据、授权策略和审计逻辑放入单个提示词或智能体循环中的组织，提供了一个安全的起点。

包含的插件

| 插件 | 能力 | 状态 |
|---|---|---|
| Atlassian | Confluence 搜索；Jira 读取、创建以及确定性问题审查 | 可用；支持模拟和实时模式 |
| 企业策略 | 项目和空间允许列表、可配置的 DLP 检查、需审批的 Jira 写入 | 可用 |
| 企业审计 | 基于最终工具结果的、经脱敏的仅所有者可访问的 JSONL 记录 | 可用 |

该仓库还包含插件生成器、可复用的连接器工具、机器可读的企业插件目录、部署指南、威胁模型，以及用于新连接器和策略插件的起始模板。

安装

DeepSeek Harness 目前处于开发者预览阶段。请将 Harness 和本套件都固定到经过审查的版本或提交。

在 DeepSeek Harness 源码检出目录中执行：

export DSH_HOME=/absolute/path/to/an/evaluation-home
pnpm dsh plugin --profile web add github:mickymultani/deepseek-harness-enterprise-suite#v0.1.0
pnpm dsh --profile web --dump-config
pnpm dsh web --no-open

用于本地开发：

git clone https://github.com/mickymultani/deepseek-harness-enterprise-suite.git
cd deepseek-harness-enterprise-suite
pnpm install
pnpm test

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/deepseek-harness-enterprise-suite
pnpm dsh web --no-open

该捆绑包以模拟 Atlassian 模式启动。在操作员明确将配置文件改为 mode: live 并提供凭据引用之前，它无法修改真实租户。

配置实时 Atlassian 访问

在 $DSH_HOME/profiles/web/cordis.patch.yml 创建覆盖配置。Harness 补丁行会替换完整配置，因此请包含每个字段：

- id: enterprise-atlassian
config:
mode: live
baseUrl: https://your-company.atlassian.net
authMode: basic
tokenRef: ATLASSIAN_API_TOKEN
emailRef: ATLASSIAN_EMAIL
requestTimeoutMs: 30000
allowInsecureHttp: false

- id: enterprise-policy
config:
mode: enforce
allowedJiraProjects: [ENG, SEC]
allowedConfluenceSpaces: [ENG, SEC]
protectedToolPrefixes: [jira_, confluence_]
requireApprovalForWrites: true

配置中包含的是引用，而绝不是凭据值。请通过 Harness 凭据提供程序、注入的进程环境，或由企业保管库支持的自定义提供程序来解析这些引用。

创建插件

生成一个独立的连接器插件：

npx dsh-enterprise-suite create-dsh-enterprise-plugin knowledge-search
生成的项目包含可安装的捆绑包清单、类型化的规范工具输出、配置验证、支持取消的 HTTP、测试和文档提示。参见创建插件和连接器契约。

设计原则

- 将读取、提议、批准、执行和验证操作分离。
- 为每个外部操作解析凭据，并且绝不记录其值。
- 将检索到的企业内容视为不可信数据，而不是指令。
- 将确定性授权放在策略插件中，而不是模型判断中。
- 使写入操作具备幂等性、审批门控、支持取消，并经过外部验证。
- 生成结构化的规范值；将叙述性文本保留在渲染器中。
- 通过脱敏和保留控制记录权威的最终结果。
- 对每个插件发布进行固定、审查、扫描、签名和金丝雀发布。

文档

- 架构
- 企业插件目录
- 路线图
- 部署指南
- 威胁模型
- 策略模型
- 安全策略
- 贡献指南

项目状态

共享插件基础以及随附插件适合用于评估。生产部署仍必须验证其自身的租户 API、字段映射、身份传播、审批体验、保留规则、监管控制、可用性目标和事件处理流程。能力状态在插件目录中明确跟踪。

许可证

MIT。这是一个独立的社区项目；参见声明。