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。