DSHIO 术语表

30 个术语的标准定义,依据 DSHIO/T 00—2026。每个术语给出判别条件、常见误解与相关术语。也提供 API:/api/dshio/term?q=插件

主体

DSHDSH3.1.2
DeepSeek Harness,本体系所规范的宿主程序。以下各版本均指 @deepseek-ai/dsh 这个 npm 包。
DSH 名称含 DeepSeek,但其架构与模型解耦 —— 模型接入是独立插件(dsh-llm-*)。
DSHIODSHIO3.1.1
DeepSeek Harness Input/Output。本标准体系的发布机构代号。
不是官方机构,不是认证机构,是标准的编写与维护方。DSHIO 不拥有 DeepSeek Harness,不对其行为负责。
相关:dsh
作者author3.1.4
开发并发布 DSH 插件的自然人或组织。
相关:plugin
認證certification3.1.6
DSHIO 依据标准对某插件作出符合性判定,并公开该判定的行为。
当前未启用。 DSHIO/T 32 认证规则仍为草案。在它转为「现行」之前,不存在「DSHIO 认证」这一状态,任何声称获得认证的表述均为虚假。

构成

插件plugin3.2.1
向 DSH 提供一项或多项能力的软件单元。以 npm 包形式分发,通过 cordis.patch.yml 声明在配置树中的位置。
判别条件:三条全满足才是插件:① package.json 含 dsh.bundle.patch 字段 ② 该字段指向的 patch 文件存在 ③ 该 patch 文件的 insert 列表至少含一个 entry
只有 dsh.client 字段不算插件。能 npm install 也不等于能被 DSH 挂载。
套件bundle3.2.2
一组插件的集合。以 dsh.profile.bundles 列表成员的形式出现。
与插件的区别:套件本身不提供能力,它只是把多个插件和它们的配置打包。例:@deepseek-ai/dsh-web-app 是套件,包含 web 界面、会话管理、工具执行器等一组插件。
相关:pluginprofile
工具tool3.2.3
插件向模型暴露的可调用函数。
判别条件:在 ctx.tools.register() 中注册,且有 name、description、parameters、execute 四个字段
工具是给模型调用的,不是给人敲的命令。一个插件可以注册多个工具。
相关:pluginservice
服務service3.2.4
插件向其他插件提供的可注入能力。以 inject 声明依赖。
例:dsh-fs 提供文件读写服务,dsh-llm 提供模型调用服务。只声明真正用到的服务 —— 声明未使用的会拖慢启动。
相关:plugintool
entryentry3.2.5
配置树中的一个条目。cordis.patch.yml 的 insert 列表中的一项。
判别条件:含 id(唯一标识)、name(模块 specifier)、config(可选)
id 在配置树内必须唯一。与已有 entry 撞 id 会导致覆盖而非新增 —— 这是「装了没生效」的常见原因。
patchpatch3.2.6
描述对配置树的插入、覆盖或禁用操作的 YAML 文件。
判别条件:DSH 插件的入口补丁文件名约定为 cordis.patch.yml;顶层必须是数组
最常见的致命错误:@ 开头的值没加引号。YAML 里 @ 是保留指示符,写成 name: @scope/pkg 会解析失败。

运行环境

profileprofile3.3.1
DSH 启动时载入的一组插件及其配置的集合。对应 $DSH_HOME/profiles/<name>/ 目录。
判别条件:出厂 profile:web、headless、sdk、sdk-minimal、acp
desktop 是保留名,由 Electron 宿主拥有,CLI 不接受 boot 和 config-dump 请求。
配置樹composed config tree3.3.2
profile 的所有 patch 层按优先序合成后得到的 entry 列表。
判别条件:用 dsh --profile <name> --dump-config 查看
層優先序layer precedence3.3.3
配置合成的顺序。后者覆盖前者。
判别条件:① 各 bundle 的 patch,按 dsh.profile.bundles 顺序 ② profile 的 cordis.patch.yml ③ home 级 $DSH_HOME/cordis.patch.yml ④ --patch 覆盖层
来源:官方 README。插件作者要知道自己的配置在哪一层生效 —— 被后面层覆盖是「装了没生效」的常见原因。
沙箱sandbox3.3.4
隔离的容器运行环境,用于在不影响宿主的情况下安装与运行插件。
判别条件:必须满足:与宿主隔离、可限制 CPU/内存/网络、每次测试后销毁
相关:verdict

测试

掛載mount3.5.1 备注
entry 出现在合成后的配置树中。
判别条件:dsh --profile <name> --dump-config 的输出里有你的 entry id
装上了 ≠ 挂载了 ≠ 生效了。这三步是分开的。
判定verdict3.5.3
对一次测试的结论。
判别条件:五值:pass(全部阶段通过)、install_failed(T1 失败)、config_failed(T3 失败)、installs_but_not_registered(T3 通过但 entry 未进配置树)、boot_failed(T4 失败)
判定只覆盖到失败的那个阶段,后续阶段不执行。
裝了沒註冊installs but not registered3.5.3
判定之一:插件能安装、能列装,但 entry 没有进入合成后的配置树。
判别条件:install_ok=true 但 registered=false
最隐蔽的失败模式。 用户看到的是「安装成功、列表里有」,但功能就是不生效。原因:patch 被后续层覆盖、id 与已有 entry 冲突、或 patch 没有 insert 项。
測試條件test condition3.5.2
影响测试结果的外部因素集合。包括 DSH 版本、容器镜像、资源限制、网络状态、超时设置。
判别条件:完整清单见 DSHIO/T 21
没有固定条件的测试结果,只是一个人某天某台机器上的印象。
可複現性reproducibility3.5.4
在相同测试条件下重复执行,得到相同判定的性质。
判别条件:任何对外发布的判定,必须至少执行两次且结果一致;不一致记「不稳定」,不得用于认证
首次錯誤first error3.5.5
判定失败时,测试输出中第一条能定位失败原因的非空行。
判别条件:排除:纯 JSON 行、框线装饰行、进度行
用途是给作者修复线索,不用于判定本身。
相关:verdict

模型

模型無關性model agnosticism3.4.1
DSH 的核心能力(安装、挂载、启动、工具注册)不依赖具体模型的性質。
判别条件:依据:模型接入由独立插件提供(dsh-llm-deepseek、dsh-llm-pi-ai 等),不在 harness 核心内
意涵:一个插件在 DeepSeek 模型下能装上,换成其他模型也能装上。安装性与模型无关。 只有工具调用可靠性这类「模型相关要求」才依赖具体模型。
模型接入插件model adapter3.4.3
把某个模型提供商接入 DSH 的插件。
判别条件:命名约定 dsh-llm-<provider>
例:dsh-llm-deepseek、dsh-llm-pi-ai。所以 DSH 叫 DeepSeek Harness,但能接近 40 家模型。

安全

權限聲明declared capability3.7.1
插件在 manifest 中声明的所需能力。
判别条件:能力标识:fs-read、fs-write、network、shell、credentials、dynamic-code、llm、env
高报权限会降低信任,低报会导致运行失败。
紅線red line3.7.2
单独出现即判定为高风险的权限组合。
判别条件:当前定义一种:network 与(shell 或 fs-write)同时出现
这两类权限同时存在,构成「读取本地资料并发送到外部」的完整路径,而使用者无法从声明看出实际流向。
風險等級risk level3.7.3
对插件权限组合的风险归类。
判别条件:三级:low(其他情形)、medium(shell + network)、high(读取凭证或执行动态代码)

符合性

符合conforming3.6.1
满足某标准全部强制性条款的状态。
判别条件:判定主体为认证机构(当前为 DSHIO 自身);判定依据为该标准的技术要求与试验方法
相关:certification
畸形插件malformed plugin3.6.3
满足「插件」的部分特征但无法完成安装的包。
判别条件:典型情形:有 dsh.bundle.patch 但文件不存在、patch 文件 YAML 语法错误、insert 列表为空
静态检查(T0)即可识别,不需要进入安装阶段。
相关:pluginpatch
例外exception3.6.4
标准要求与实际冲突时,经公开登记的偏离。
判别条件:必须包含:偏离哪一条、为什么、影响范围、有效期
未登记的偏离不是例外,是不符合。
相关:conforming
參照實現reference implementation3.6.5
第一个按某标准完整实现并通过全部条款的实例。
判别条件:标准发布前必须有参照实现;无参照实现的不得从「草案」转为「现行」
用途:证明标准可执行。DSHIO/T 10 的参照实现是 @liangjiehappy/dsh-deepseekbase。
實施獨立性implementation independence11.2
标准不要求使用任何特定的开发工具、编程语言、构建流程或辅助库。凡满足全部技术要求者即为符合,不论其如何实现。
判别条件:判定以可观测的运行时行为为准,不以源码结构为准
具体含义: 不强制 @deepseek-ai/dsh-tools(defineTool() 只是便捷方式)、不强制 TypeScript、不强制 pnpm、不读源码判定。这也是「不用官方开发套件也能按标准开发」的依据。