DeepSeek Harness 插件术语表
本站与插件生态里使用的词汇。当某个条目提到接缝、profile 或 target，而你不想靠猜的时候，从这里查准确含义。每条不只给定义，也提示你在条目页上该核对什么——定义加审阅习惯，而不是空字典行。
- DSH
- DeepSeek Harness 的通用缩写，DeepSeek AI 开源的智能体框架。在本站语境下，它也指建立在 Cordis 运行时上的插件生态——不 fork 核心、通过运行时扩展 harness 的社区包。条目写「DSH 插件」时，意思是能经该运行时加载的包，不是泛指 MCP 服务，也不是浏览器扩展。
- DSH 插件（dsh plugin）
- 通过 Cordis 运行时扩展 DeepSeek Harness 的包：新工具、界面表面、模型适配器，或其他插件可消费的能力。多数社区插件面向 web profile，并经 apply(ctx) 注册。插件不等于技能——技能改变模型被指示知道什么，插件改变运行时能做什么。
- Cordis
- DeepSeek Harness 底层的轻量插件运行时。插件导出 apply(ctx) 函数，通过上下文对象注册能力。由于 harness 仍在开发者预览，深入内部实现的插件比只走公开接缝的更容易在升级时坏掉。优先选择声明了 harness 目标、并使用注册 API 的包，而不是 monkey-patch 私有模块的包。
- apply(ctx)
- 插件的入口函数。harness 在加载阶段调用它，并传入用于注册、事件处理和资源释放的上下文。若 apply 抛错或什么都没注册，插件可能「加载成功」却贡献不了工具。审阅条目时先读 apply 再信 README：权限请求与钩子挂载都写在这里。
- dshTarget
- 插件声明自己测试过的 harness 版本范围，本站逐字记录，例如 >=0.1.0-rc.6 <0.2.0。在 DSH 处于开发者预览阶段时，用户和目录站用它判断兼容性。插件没有声明时该字段留空——生态里大多数都留空；留空表示作者从未承诺范围，不表示插件坏了。
- Profile（配置档）
- 插件的安装范围。Web 界面使用 web 这个 profile，所以安装命令写作 dsh plugin --profile web add。装在你根本不用的 profile 下，插件会「消失」。实验性条目请放进隔离 profile，避免一次坏安装拖垮你真正干活的 profile。
- 插件接缝（plugin seam）
- 官方文档中允许提供或替换能力的接入点，例如 memory 接缝、subagent 接缝。使用接缝的插件能在破坏内部实现依赖的版本变更中存活。条目若声称「钩住了记忆」，要问清是走接缝还是 monkey-patch 私有模块；只有前者对升级宽容。
- 能力（capability）
- 插件提供给其他插件消费的东西，区别于面向用户的功能。能力提供方通常较早注册，方便消费方找到它。目录里写的「agent 工具」往往是在列能力而不是 UI。若两个插件注册同名能力，后装的可能静默覆盖先装的——每次多插件安装后请核对工具列表。
- 技能（skill）
- 智能体可以按需加载的指令与配套文件。分发方式与插件类似，但改变的是模型知道什么，而不是运行时能做什么。只有斜杠命令、没有停止条件的技能包不是智能体框架。优先选择写明预算、审批门，并在宣称自主前交出可审查产物的技能。
- 子智能体（subagent）
- 由主智能体启动、拥有独立上下文来处理限定任务的子进程式智能体，用于委派、并行与长任务。没有预算时，子智能体可能在你看不见的情况下烧掉步数或墙钟时间。会 spawn 子进程的编排插件应暴露可打断、持久日志，以及清晰的「完成」条件。
- MCP
- Model Context Protocol，向智能体暴露工具和数据的通用协议。MCP 桥接让插件或 harness 能消费标准 MCP 服务。仅仅包装 MCP 客户端的 DSH 插件很方便，但多了一层信任边界：桥、服务，以及服务还能碰到什么。优先选择写明权限提示与网络出口的桥。
- 上下文窗口（context window）
- 模型当前能看到的一切：对话、工具输出与注入内容。上下文类插件负责度量和管理它；记忆类插件决定窗口清空后什么能留下来。会话「忘了」时，先分清是压缩丢掉了事实，还是从未写入比窗口活得更久的存储。
- 压缩（compaction）
- 运行时为了不超出窗口而概括或丢弃较早的上下文。上下文插件会记录它何时发生，因为它会悄悄改变模型记得什么。若工作流依赖会话早期的精确工具输出，请把该输出钉到文件里，或接受压缩只会给你改写后的摘要。
- 验证等级
- L1 到 L5 的标签，记录条目安装链路被验证到哪一步，从「仓库存在」到「插件能加载并运行」。等级衡量验证走多远，不衡量插件有多安全。本目录今日诚实区间是 L1–L3；L4–L5 意味着沙箱加载或运行测试，目前没有条目声称达到。
- Web UI
- 由 npx @deepseek-ai/dsh web 在 127.0.0.1:3080 提供的浏览器界面，也是多数社区插件面向的目标。桌面外壳与 TUI 是同一运行时上的不同表面。条目若写「web GUI」，除非另写宿主，否则默认挂进这个界面。
- 安全扫描（本站标签）
- 在本目录，「已扫描」表示在不运行代码的前提下对仓库做自动审查：声明的依赖、请求的权限、明显的密钥处理错误，以及供应链信号。它不是沙箱执行，也不是保证。「未验证」表示扫描尚未发生——不表示插件安全或不安全。
- 安装命令
- 可复制粘贴的安装行，通常是 dsh plugin --profile web add … 加包名或 github:owner/repo#sha。预览运行时变动频繁时优先钉提交。若命令在已发布的包注册表上解析不了，在条目修好之前应把该条目当作过期。
怎么用这份术语表审条目
按这个顺序扫插件页：安装命令（能否解析？）、验证等级（安装链路查到哪一步？）、dshTarget（是否声明 harness 区间？）、权限表面（能碰到什么？），最后是健康度与最近核查日期。若这五项缺失或过期，页面上的散文不如源码仓库重要。在安装任何关键路径依赖之前，请对照验证说明与安全扫描状态交叉核对同一批术语。
初次接触这个生态？先读 DeepSeek Harness 是什么， 再看Cordis 生命周期教程。