DeepSeek Harness 插件开发进阶:从 Host 工具到 Client UI

DeepSeek Harness 插件开发进阶:从 Host 工具到 Client UI 一、先理解 DSH 的插件模型 DSH 的插件运行时基于 Cordis。一个插件本质上是一个模块,它导出几样东西: export const name = 'my-plugin' // 插件名 export const inject = ['tools'] // 依赖哪些服务 export const Config = Schema.object({})// 配置 schema(可选) export function apply(ctx, config) {} // 插件主体 inject 声明依赖的服务;Cordis 会在这些服务可用时调用 apply,并在插件卸载或依赖消失时释放它注册的资源。Config 用于校验 profile 配置行里的 config。 1.1 Profile、Bundle 与 Patch DSH 的运行时组合是分层的: DSH 进程 └─ profile(desktop / web / headless / ...) ├─ package.json │ └─ dsh.profile.bundles: [bundle A, bundle B, ...] ├─ cordis.patch.yml # 用户自己的覆盖层 └─ node_modules/ ├─ @deepseek-ai/dsh-base # 基础 bundle ├─ @deepseek-ai/dsh-web-app # Web 形态 bundle └─ my-plugin # 你的插件 ├─ cordis.patch.yml # 插件要插入的配置行 ├─ lib/index.js # Host 侧入口 └─ lib/client.js # Client 侧入口(可选) Bundle:一组配置行的集合,通常是一个 npm 包,通过 dsh.bundle.patch 指向自己的 cordis.patch.yml。 Patch:按 id 定位配置行,可以覆盖、禁用或插入。注意,patch 会替换目标行的整个 config,不是深合并;想保留的字段要重写。 Profile:把若干 bundle 按顺序叠加,再叠加用户自己的 cordis.patch.yml 和 --patch 覆盖层。 加载顺序大致是:bundle 的 patch → profile 的 cordis.patch.yml → home 级 patch → --patch。后写的层覆盖先写的层。 ...

2026-10-25 · 7 分钟 · 1348 字 · Jones

DeepSeek Harness(DSH)使用指南:功能、自定义模型与插件

DeepSeek Harness(DSH)使用指南:功能、自定义模型与插件 一、DSH 是什么 DeepSeek Harness(简称 DSH)是一个运行在本地的 Agent Harness。它不直接训练模型,也不把工作流锁死在某个云端产品里,而是把下面几件事组合成一个可扩展的工作台: DSH = 模型路由 + 工具运行时 + 持久会话 + 权限与沙箱 + 插件系统 和普通聊天客户端相比,DSH 的关键差别是「能动手」: 它可以读取和修改工作区文件,执行 PowerShell / Bash 命令。 它可以调用网页搜索、网页抓取、后台任务、子 Agent、工作流、定时任务等工具。 它会持久化会话,支持恢复、压缩、标题和会话列表。 它把不同模型统一成「提供方 + 模型」的路由,可以在设置里接入官方 API、兼容网关或本地模型。 它的一切能力几乎都由插件组合而成,插件可以增加工具、命令、页面、设置卡片,甚至新的模型提供方。 DSH 目前主要有三种使用形态: 形态 启动方式 适合场景 桌面应用 安装 DeepSeek Harness 桌面端 日常交互、文件预览、插件管理 Web GUI dsh web 或 dsh --profile web 浏览器访问、局域网使用、与桌面端共用同一套能力 无头 / 程序化 dsh --profile headless "任务"、dsh --profile sdk、dsh --profile acp 脚本、CI、SDK 集成、自动化客户端 官方入口:https://www.deepseek.com/harness/ 二、安装与第一次启动 2.1 桌面端 从官方入口下载并安装 DeepSeek Harness。首次打开时选择一个项目目录作为工作区,然后就可以在对话框里描述任务。 ...

2026-10-25 · 5 分钟 · 977 字 · Jones