官方内置组合包是干什么的？

组合包（bundle）是附带配置层的 npm 包：dsh-base 是每个 profile 最先应用的共享核心，dsh-web-app 提供浏览器界面与运行时插件，dsh-headless 提供无界面的单次任务模式。web 和 headless 两个内置 profile 首次使用自动初始化。

官方 LLM 插件有哪些？

llm 目录下有 dsh-llm-deepseek（直连 DeepSeek 的适配器）与 dsh-llm-pi-ai（多提供商 pi-ai 适配器），配合 dsh-llm（服务定义）、dsh-token-meter（用量计量）、dsh-llm-retry（重试策略）组成完整的模型接入家族。

官方插件和社区插件怎么区分？

官方插件由 deepseek-ai 团队维护、随 dsh 安装自带或在官方仓库 packages 目录发布，npm 包名带 @deepseek-ai 前缀；社区插件由个人或组织发布，来源在插件中心有标注。两者安装方式相同，都是 dsh plugin add 或插件中心一键安装。

从哪些官方渠道获取 DSH 插件？

官方渠道四个：官网 deepseek.com/harness、GitHub 仓库 deepseek-ai/deepseek-harness、npm 包 @deepseek-ai/dsh、官方文档 deepseek-harness.github.io。社区插件集中在 dsh-plugin.org 插件中心与 [DSH Plugin Hub](/zh/plugins/dshplugin/dsh-plugin-hub) 内置市场。

DeepSeek Harness 官方插件有哪些？dsh 官方内置插件包、组合包与官方渠道说明

Q: DeepSeek Harness 官方插件有哪些？

分两层：内置组合包 @deepseek-ai/dsh-base（共享核心）、@deepseek-ai/dsh-web-app（浏览器界面）、@deepseek-ai/dsh-headless（一次性任务模式），构成 profile 的运行骨架；LLM 适配器 @deepseek-ai/dsh-llm-deepseek、dsh-llm-pi-ai 负责模型接入。

DeepSeek Harness 的官方插件分两层：内置组合包（bundle）与官方插件包。组合包 @deepseek-ai/dsh-base、dsh-web-app、dsh-headless 构成每个 profile 的运行骨架，web / headless 两个内置 profile 首次使用自动初始化；LLM 适配器 dsh-llm-deepseek、dsh-llm-pi-ai 负责模型接入。本文按「组合包 → LLM 插件 → 官方渠道 → 官方与社区区别」四步讲清官方插件全貌。

概览：官方插件的两层结构

官方插件按职责分两层：组合包定义「跑什么形态」，LLM 插件定义「接什么模型」。 DeepSeek Harness 的官方仓库把官方能力组织成两类包：packages/bundle 下的组合包负责 profile 的形态（网页 / 无界面任务），packages/llm 下的插件负责模型接入（来源）。理解这两层，就能看懂 dsh 启动时到底加载了哪些官方能力，也方便和社区插件区分。下面先讲组合包。

一、官方内置组合包：profile 的运行骨架

内置组合包是随 dsh 安装自带的配置层：dsh-base 是共享核心、dsh-web-app 是网页形态、dsh-headless 是无界面任务形态，每个 profile 都由它们叠加而成。 组合包（bundle）是声明了 dsh.bundle 的 npm 包，附带一份配置层 patch（来源）。三个官方内置包（来源）：

组合包	职责	说明
`@deepseek-ai/dsh-base`	共享核心	每个 profile 最先应用的底层，只提供 patch 层
`@deepseek-ai/dsh-web-app`	浏览器界面	web patch 层 + 运行时 glue 插件，即 Web UI 形态
`@deepseek-ai/dsh-headless`	一次性任务模式	基于 base、无 Host/Web 层，挂载 headless-runner，跑完即退出

它们的关系：dsh --profile web 启动的就是 base + web-app 组合出来的网页版；dsh --profile headless "任务" 启动的是 base + headless，跑一次任务、打印结果、退出（来源）。想亲眼验证这两个内置 profile，直接启动即可：

bash

# 启动内置 web profile（base + web-app 组合出的网页版）
dsh --profile web

# 用内置 headless profile 跑一次性任务（跑完打印结果退出）
dsh --profile headless "总结这个仓库"

web 和 headless 两个内置 profile 首次使用会自动从官方模板初始化，其余 profile 通过 dsh plugin 创建。内置组合包始终从 dsh 安装目录解析，社区插件则装进 profile 自己的 node_modules。

二、官方插件包：LLM 适配器

官方 LLM 插件负责模型接入：dsh-llm-deepseek 直连 DeepSeek，dsh-llm-pi-ai 走多提供商适配，配合服务定义、用量计量与重试策略组成完整家族。 packages/llm 目录下的官方包（来源）：

@deepseek-ai/dsh-llm-deepseek：直连 DeepSeek 的适配器，在 ctx.llm 上注册提供商路由，就是 Web UI 默认接 DeepSeek API 的通道。
@deepseek-ai/dsh-llm-pi-ai：多提供商 pi-ai 适配器，同样注册在 ctx.llm，用于接入 pi-ai 覆盖的模型服务。
@deepseek-ai/dsh-llm：LLM 服务定义与共享流式词汇，是上面两个适配器的底座。
@deepseek-ai/dsh-token-meter：按会话计量的 Token 用量统计，监听请求事件。
@deepseek-ai/dsh-llm-retry：按提供商范围的重试策略，请求出错时自动重试。

也就是说，「接什么模型」由 LLM 适配器决定，想换提供商就换适配器插件，不用动 dsh 本体——这正是一切皆插件架构的体现。

三、官方渠道：官方插件从哪获取

官方插件的获取渠道有四个：官网、GitHub、npm、官方文档；官方包名一律带 @deepseek-ai 前缀。 需要官方组件时认准这些渠道（来源）：

官网 deepseek.com/harness：产品介绍与下载入口；
GitHub deepseek-ai/deepseek-harness：源码、Releases、更新日志，官方插件包都在仓库 packages 目录；
npm @deepseek-ai/dsh：安装与升级本体，官方包都以 @deepseek-ai/dsh-* 命名；
官方文档 deepseek-harness.github.io：插件开发、打包、安装教程。

社区插件则集中在 dsh-plugin.org 插件中心与 DSH Plugin Hub 内置市场（4,800+ 收录），和官方渠道互补。

四、官方 vs 社区：怎么区分与选择

判断是否官方插件看三点：维护方是否 deepseek-ai、是否随 dsh 安装自带、npm 包名是否带 @deepseek-ai 前缀。 实际使用时：

看来源：插件中心每个插件都标注来源与维护方，官方包显示 deepseek-ai；
看验证状态：verified 表示已人工核实兼容性，官方包天然可靠，社区包优先选 verified；
按需求选：模型接入、核心形态选官方；界面增强、记忆、工具等扩展能力社区生态更丰富，先在 DSH Plugin Hub「设置 → 插件中心」按分类浏览再装。

官方插件的注意事项

一句话：官方插件管「形态与模型」，社区插件管「能力扩展」，装之前先看来源与验证状态。 三点提醒：

内置包不用手动装：dsh-base / web-app / headless 随安装自带、由 profile 自动引用，不要在插件中心重复安装。
适配器不要叠加：LLM 适配器一次用一个主提供商，混装多个适配器可能路由冲突；换模型按官方文档切换配置。
社区包认准来源：GitHub 分发可能缺构建产物，优先装 npm 版或在 DSH Plugin Hub 看来源标注再装。

来源：deepseek-ai/deepseek-harness - packages/bundle、packages/llm、DeepSeek Harness 官方文档 - 打包与安装插件