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
認證certification3.1.6
DSHIO 依据标准对某插件作出符合性判定,并公开该判定的行为。
当前未启用。 DSHIO/T 32 认证规则仍为草案。在它转为「现行」之前,不存在「DSHIO 认证」这一状态,任何声称获得认证的表述均为虚假。
构成
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、acpdesktop 是保留名,由 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。插件作者要知道自己的配置在哪一层生效 —— 被后面层覆盖是「装了没生效」的常见原因。
测试
掛載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 失败)判定只覆盖到失败的那个阶段,后续阶段不执行。
測試條件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(读取凭证或执行动态代码)符合性
參照實現reference implementation3.6.5
第一个按某标准完整实现并通过全部条款的实例。
判别条件:标准发布前必须有参照实现;无参照实现的不得从「草案」转为「现行」
用途:证明标准可执行。DSHIO/T 10 的参照实现是
@liangjiehappy/dsh-deepseekbase。實施獨立性implementation independence11.2
标准不要求使用任何特定的开发工具、编程语言、构建流程或辅助库。凡满足全部技术要求者即为符合,不论其如何实现。
判别条件:判定以可观测的运行时行为为准,不以源码结构为准
具体含义: 不强制
@deepseek-ai/dsh-tools(defineTool() 只是便捷方式)、不强制 TypeScript、不强制 pnpm、不读源码判定。这也是「不用官方开发套件也能按标准开发」的依据。