DeepSeek Harness Server

把原版 DeepSeek Harness 作为受管智能体 模块接入既有业务系统的树外扩展。不修改 Harness 源码，用 OAuth 委托身份、每用户独立 Runtime 和业务 API 对象级授权实现多用户共用。

一句话概括：用户在自己的业务系统里使用 Agent，Agent 用用户自己的身份和权限访问业务 数据。

本项目由 aiworkskills 维护，是 DeepSeek Harness 的 第三方扩展，与 DeepSeek 官方无关，也未获得其背书。

六个包

包	加载平面	作用
@dshserver/dsh-integration	DSH Runtime	OAuth 委托的业务工具与执行前授权守卫
@dshserver/runtime-gateway	宿主应用	每用户独立 Runtime 生命周期与 DSH 管理接口锁定
@dshserver/gateway-server	宿主应用	把上面那层跑成服务:路径匹配、认证与策略顺序、RPC 拒绝、流量代理
@dshserver/dsh-preferences	浏览器	个人偏好、连接器设置卡片、业务页面话术送入
@dshserver/dsh-deliverables	Runtime + 浏览器	托管部署里,对话中的产物点开就在右侧面板里看
@dshserver/dsh-embed-chrome	Runtime + 浏览器	DSH 嵌在自己页面里时,由那个页面决定品牌、大标题与工作区切换

外加 config/：部署方维护的企业 Profile 与三套 Agent Preset（员工、管理者、 审计员）。

60 秒看到它在做什么

只需要 Node.js >=22.19 和 pnpm 11，不需要 Harness 源码、模型凭据或任何网络出口：

pnpm install --frozen-lockfile && pnpm example

这条命令会在本机拉起一个假的 Token Broker 和一个假的业务 API，写入一份真实格式的 Runtime 租约，然后用真插件跑五个场景：授权读取、缺少 Scope 被守卫拒绝、租户写开关关闭、 写入携带幂等键、租约过期后失败关闭。输出是逐条的 PASS/FAIL。

它证明的是本仓库负责的那段边界；完整产品形态（登录、嵌入 UI、业务系统）见 https://dshserver.cn。

它解决什么问题

在业务系统里嵌一个智能体，难的从来不是接模型，而是让智能体的权限恰好等于当前用户的 权限，而且这件事要在用户看不见的地方被强制执行。本仓库的做法：

• 模型参数永远不含 userId、tenantId、角色或 Access Token。身份来自 Runtime Manager 写入的 0600 租约文件。
• 每次工具调用用租约换一张有效期 120 秒的降权业务 Token（RFC 8693 Token Exchange）。
• 申请的 Scope 恒等于守卫检查过的 Scope——两者从同一张策略表派生，不可能不一致。
• 最终的对象级授权由业务 Resource Server 执行，插件不直接连业务数据库。
• 平台管理员可以在不改 OAuth 的前提下一键停掉所有写操作。

文档

我想…	文档
接入自己的业务系统	集成指南
理解 OAuth 委托、Runtime 隔离与 Token Exchange	核心概念
查配置项与默认值	配置参考
查工具、接口与错误码	工具与 API 参考
了解模块划分与扩展检查表	插件架构
做安全评审	安全模型
确认支持的 DSH 版本	兼容性

安装

DSH 目前只发布预发布版本，请精确锁定版本——npm 的 latest 标签落后于 next，两者 都不满足本仓库的 peer 区间。详情与原因见兼容性。

pnpm add @dshserver/dsh-integration
pnpm add -D @deepseek-ai/dsh-tools@0.1.1-rc.2 @deepseek-ai/dsh-settings@0.1.1-rc.2 @deepseek-ai/cordis@4.0.1 @deepseek-ai/schemastery@3.18.1

在 Agent Preset 中加载：

- id: dshserver-business
  name: '@dshserver/dsh-integration'
  config:
    brokerUrl: https://broker.internal.example.com
    businessApiUrl: https://api.internal.example.com
    runtimeLeaseFile: /run/secrets/runtime-lease.jwt
    scopes: [assistant:use, customers:read:team, customers:write:team]
    exposedTools: [business_list_customers, business_update_customer]
    readScope: customers:read:team

内置的四个 CRM 工具是示例，用来演示接入方式。换成自己的业务接口见 集成指南 · 步骤 6。

本地开发

pnpm install --frozen-lockfile
pnpm check      # typecheck + test + build
pnpm example    # 端到端契约检查

贡献流程见 CONTRIBUTING.md，漏洞报告见 SECURITY.md。

License

MIT。