插件与包目录
316 个包，55 个包组，统计范围为仓库 packages/ 目录。Python、native 与 vendor 等目录不计入此数。可挂载插件、服务定义、提供者、消费者、纯库与发行配置分别说明；一个包可承担多种角色。
本目录列出仓库提供的能力；实际启用情况以运行配置为准。配置说明区分插件默认、必填项与发行组合提供的值，均对应固定资料版本。
箭头表示标注的调用或依赖关系；点击组件定位正文。完整关系见下方文字说明。
文字关系说明与章节链接
Cordis 装配树 →（挂载服务）→ dsh-tools；dsh-tool-fs →（注册工具）→ dsh-tools；dsh-tool-fs →（调用文件能力）→ 文件服务接口；dsh-fs-local →（实现服务）→ 文件服务接口。
Cordis 装配树 · dsh-tools · dsh-tool-fs · 文件服务接口 · dsh-fs-local
316 个包
没有匹配条目。请换一个能力词或使用包名搜索。
ACP 自动化会话桥@deepseek-ai/dsh-acp
通过标准 ACP 创建、恢复和独立关闭持久会话。允许选择模型与推理强度、提交或取消任务。
dsh-acp · 接口摘录，省略上下文 · session/prompt · packages/acp/acp/README.md// ACP 为已有会话提交提示，同一会话只允许一个在途请求。
session/prompt具体能力
- 通过标准 ACP 创建、恢复和独立关闭持久会话
- 允许选择模型与推理强度、提交或取消任务
- 接入 MCP 工具并向外部控制程序发送语义更新
配置与默认行为
- provider、model 可选，用于每个会话的 Agent 路由
- sessionListPageSize 默认 100，限制一次 session/list 返回的摘要数
限制与使用条件
- 不支持会话删除、分叉、转录重放及额外工作目录
- authenticate 立即成功；接口面向受信任程序自动化，不自行实施身份认证
账户登录远程控制@deepseek-ai/dsh-api-account-controller
向浏览器暴露经过认证的账户操作。通过快照流提供登录状态和断线后的状态恢复。
具体能力
- 向浏览器暴露经过认证的账户操作
- 通过快照流提供登录状态和断线后的状态恢复
- 将令牌和 PKCE 秘密留在宿主，不作为远程结果返回
限制与使用条件
- 宿主退出后不能恢复进行中的登录尝试
双端远程调用网关@deepseek-ai/dsh-api-gateway
在宿主提供 typertGateway、在客户端提供 remote。根据生成的 InvocationDescriptor 分发远程方法。
具体能力
- 在宿主提供 typertGateway、在客户端提供 remote
- 根据生成的 InvocationDescriptor 分发远程方法
- 在同一逻辑流中复用远程流和客户端上行消息
限制与使用条件
- 流重连不推断重放语义，恢复游标与基线校验由业务所有者负责
后台作业远程观察@deepseek-ai/dsh-api-job-controller
把会话可见作业投影为完整列表流。按绝对字节偏移跟随单个作业保留的输出。
具体能力
- 把会话可见作业投影为完整列表流
- 按绝对字节偏移跟随单个作业保留的输出
- 提供人工停止作业操作且不消费模型自己的读取游标
配置与默认行为
- observeFlushMs：默认 100
- observeMaxFrameBytes：默认 65,536
限制与使用条件
- 作业列表与输出环仅保存在进程内，宿主重启后丢失
客户端业务远程接口装配@deepseek-ai/dsh-api-remotes
显式挂载应用选择的远程能力。为客户端业务包提供统一远程接口门面。
具体能力
- 显式挂载应用选择的远程能力
- 为客户端业务包提供统一远程接口门面
- 在宿主选择转发事件并注册到 API Gateway
限制与使用条件
- 能力集合由构建时导入固定，不会运行时发现宿主全部服务
会话与历史远程控制@deepseek-ai/dsh-api-session-controller
提供会话生命周期、历史记录及宿主代际模型目录。暴露会话技能发现和 Agent 范围文件引用。
具体能力
- 提供会话生命周期、历史记录及宿主代际模型目录
- 暴露会话技能发现和 Agent 范围文件引用
- 支持人工停止后台作业、打开工作区路径和附件上传入口
配置与默认行为
- nativeOpen：默认 平台检测结果
限制与使用条件
- 原始浏览器上传不支持断点续传，失败重试从首字节开始
设置与凭据远程控制@deepseek-ai/dsh-api-settings-controller
返回脱敏设置和凭据元数据。接受设置与凭据写入但不返回秘密值。
具体能力
- 返回脱敏设置和凭据元数据
- 接受设置与凭据写入但不返回秘密值
- 在宿主桌面打开提供者持有的设置或 Agent 预设位置
限制与使用条件
- 批量引用上限固定为64，不能通过部署配置更改
会话侧栏终端控制@deepseek-ai/dsh-api-terminal-controller
在会话工作区打开执行环境默认 shell。浏览器重连后重新附着已有进程和有限屏幕缓存。
具体能力
- 在会话工作区打开执行环境默认 shell
- 浏览器重连后重新附着已有进程和有限屏幕缓存
- 关闭提供者持有的终端进程范围且不把输出加入 Agent 转录
配置与默认行为
- shell：未设置；具体省略行为见 README
- shellCandidates：默认 zsh, bash, fish, pwsh, powershell, cmd
- maxTerminals：默认 8
- maxCols, maxRows：默认 500, 200
- scrollback：默认 1000
- maxBufferedBytes：默认 2097152
- maxInputBytes：默认 65536
- disposeGraceMs：默认 1000
- unattendedTimeoutMs：默认 7200000
- activityPollIntervalMs：默认 30000
- cleanupRetryMs：默认 60000
限制与使用条件
- 终端不能跨宿主重启恢复，同一时刻只允许一个附着方写入或调整尺寸
工作区导航远程控制@deepseek-ai/dsh-api-workspace-controller
创建、重命名、删除和重排工作区。重排、归档和取消归档导航中的会话。
具体能力
- 创建、重命名、删除和重排工作区
- 重排、归档和取消归档导航中的会话
- 跟随完整工作区投影并提供目录选择远程接口
配置与默认行为
- documentsDirectory：默认 系统文档目录
- documentsLookupTimeoutMs：默认 10000
限制与使用条件
- 重连替换完整投影，不提供持久游标或增量补发协议
工作区文件只读预览@deepseek-ai/dsh-api-workspace-files
分页读取 UTF-8 文本、限定字节窗口或完整文件。查询文件元数据并从基准文件解析相关路径。
具体能力
- 分页读取 UTF-8 文本、限定字节窗口或完整文件
- 查询文件元数据并从基准文件解析相关路径
- 跟随文件变更和工作区目录的直接条目变更
配置与默认行为
- maxBytes：默认 2097152 (2 MiB)
- maxFileBytes：默认 33554432 (32 MiB)
- maxLines：默认 5000
- maxEntries：默认 2000
限制与使用条件
- 没有文件修改操作
- 不支持监听的后端只能手动刷新，不能自动轮询补偿
持久附件服务接口@deepseek-ai/dsh-attachment
在提示和命令中接纳图像与普通文件附件。图像在消息接纳前校验并规范化为模型可用内容。
// 校验并持久提交图像批次，返回不可变引用后才可记录事件。
async saveImages(inputs: readonly SaveImageAttachment[]): Promise<readonly ImageAttachmentRef[]>具体能力
- 在提示和命令中接纳图像与普通文件附件
- 图像在消息接纳前校验并规范化为模型可用内容
- 普通文件按原字节保存并用只读路径供模型按需读取
限制与使用条件
- 未发送草稿仅存于浏览器，已存附件不会自动删除
本机附件持久存储@deepseek-ai/dsh-attachment-local
在 DSH_HOME 下持久保存图像和普通文件。相同字节去重并在读取时校验长度与内容。
具体能力
- 在 DSH_HOME 下持久保存图像和普通文件
- 相同字节去重并在读取时校验长度与内容
- 按模型路由缓存规范化图像且保留已接纳对象的可读性
配置与默认行为
- dshHome：默认 按文档的解析优先级确定
- maxImageBytes：默认 20 MiB
- maxImagesPerMessage：默认 20
- maxMessageImageBytes：默认 200 MiB
- maxImagePixels：默认 64,000,000
- maxImageDimension：默认 8192
- normalizedImageMaxPixels：默认 2048 × 2048
- normalizedImageMaxDimension：默认 8192
- normalizedImageMaxBytes：默认 4 MiB
- imageCompressionConcurrency：默认 2
限制与使用条件
- 数据只在本机可用且不会自动回收
- GIF 规范化仅保留首帧
统一应用装配启动@deepseek-ai/dsh-app-boot
按层加载环境并组合 profile、bundle 与 patch。启动全部插件并报告失败插件和原因。
dsh-app-boot · 接口摘录，省略上下文 · dsh --profile <name> · packages/boot/app-boot/README.md · --dump-config · packages/boot/app-boot/README.md// 用户选择命名 profile，启动其 bundle 与 patch 组合的应用。
dsh --profile web
// 用户预览本次配置组合；输出含配置中的拒绝加载行，不代表运行实例已激活。
dsh --profile web --dump-config具体能力
- 按层加载环境并组合 profile、bundle 与 patch
- 启动全部插件并报告失败插件和原因
- 提供生效配置预览及终端退出前的恢复机会
限制与使用条件
- HMR 可热应用受支持的配置变更；修改 profile 符号链接目标需要重启，因为 Node 按真实路径缓存模块
应用命令行参数接入@deepseek-ai/dsh-cmdline
解析启动器保留下来的应用参数与帮助请求。允许解析后的参数覆盖配置表达式中的默认值。
具体能力
- 解析启动器保留下来的应用参数与帮助请求
- 允许解析后的参数覆盖配置表达式中的默认值
- 通过启动器的关停路径请求进程退出
限制与使用条件
- 启动器参数必须放在应用参数之前，首个非启动器参数决定分界
活动配置安全编辑@deepseek-ai/dsh-config-editor
把插件配置保存到活动 profile 的 patch。写盘前校验完整候选配置。
// 完整配置编辑器修改活动 profile 的覆盖项；实际生效仍受 Loader 与更高层 patch 影响。
ctx.configEditor.edit具体能力
- 把插件配置保存到活动 profile 的 patch
- 写盘前校验完整候选配置
- 与 profile 变化及 HMR 串行应用修改
限制与使用条件
- 仅可编辑根 Include 持有且能唯一寻址的条目，不能写 home patch 或命令行覆盖层
宿主插件热重载@deepseek-ai/dsh-hmr
在应用运行时替换插件模块。串行处理 Include 刷新和 profile 配置变化。
具体能力
- 在应用运行时替换插件模块
- 串行处理 Include 刷新和 profile 配置变化
- 通过 ctx.hmr 保留 Cordis HMR 配置及事件接口
配置与默认行为
- base：默认 Context 基础 URL
- root：默认 ["."]
- ignored：默认 ["**/node_modules", "**/.*", "cache", "data"]
- debounce：默认 100
限制与使用条件
- 已安装包版本替换仍需重启，HMR 自身不会重新启动进程
运行配置插件管理@deepseek-ai/dsh-plugin-manager
启停当前 profile 中的插件条目。选择已安装 bundle 并安装或移除外部 bundle。
具体能力
- 启停当前 profile 中的插件条目
- 选择已安装 bundle 并安装或移除外部 bundle
- 有 HMR 时即时应用配置变化，否则等待重启
配置与默认行为
- pnpmCommand：默认 pnpm
- inspectTimeoutMs：默认 20000
- githubConnectionTimeoutMs：默认 5000
- registry：默认 pnpm's own
- fallbackRegistries：默认 ['https://registry.npmmirror.com/']
- outputBytes：默认 16384
- lockWaitMs：默认 120000
- idleTimeoutMs：默认 600000
限制与使用条件
- 包版本替换需要重启，变更影响使用该 profile 的所有会话
浏览器提供者互斥注册@deepseek-ai/dsh-browser-use
在一个 Cordis 服务实例中登记浏览器能力提供者。第二个提供者注册时报告已有提供者并拒绝。
具体能力
- 在一个 Cordis 服务实例中登记浏览器能力提供者
- 第二个提供者注册时报告已有提供者并拒绝
- 把浏览器资源、会话隔离和具体工具交给实际提供者
限制与使用条件
- 本包不增加模型工具或浏览器操作，模型不能运行时切换后端
ACP 应用发行组合@deepseek-ai/dsh-acp-app
在 base 组合上挂载自动化 ACP 标准输入输出应用。配置编码 Agent 人设与默认模型路由。
具体能力
- 在 base 组合上挂载自动化 ACP 标准输入输出应用
- 配置编码 Agent 人设与默认模型路由
- 先接受应用命令行再启动 ACP，使帮助命令不占用协议流
限制与使用条件
- 配置变更需重启，用户加入的插件仍可能污染标准输出
通用 Agent 基础发行配置@deepseek-ai/dsh-base
为基于 base 的 profile 组合模型连接和完整工具集。装配持久会话历史和工作区安全默认策略。
具体能力
- 为基于 base 的 profile 组合模型连接和完整工具集
- 装配持久会话历史和工作区安全默认策略
- 允许后续 bundle 或 profile patch 替换默认配置
限制与使用条件
- patch 替换整块配置而非自动合并，须重述要保留的字段
单任务命令行发行组合@deepseek-ai/dsh-headless
运行一项命令行任务并打印最终回答后退出。通过 --json 输出 JSON 事件流。
具体能力
- 运行一项命令行任务并打印最终回答后退出
- 通过 --json 输出 JSON 事件流
- 通过 --session-id 恢复会话继续一次任务
配置与默认行为
- task：默认 stdin
- sessionId：默认 session-<uuid>
- json：默认 false
限制与使用条件
- 每次调用只处理一项任务，没有交互式追问
SDK 标准流发行组合@deepseek-ai/dsh-sdk-app
在 base 上装配 JSON-RPC SDK 服务。设置编码 Agent 人设并挂载应用命令行提供者。
具体能力
- 在 base 上装配 JSON-RPC SDK 服务
- 设置编码 Agent 人设并挂载应用命令行提供者
- 接受调用后才启动协议服务，帮助输出不占用协议流
限制与使用条件
- 配置变更需重启，自定义插件可能污染 JSON-RPC 标准输出
最小编码 SDK 发行组合@deepseek-ai/dsh-sdk-minimal
独立组合完整 Cordis 树而不继承 base。默认只向模型提供按平台选择的持久 shell。
具体能力
- 独立组合完整 Cordis 树而不继承 base
- 默认只向模型提供按平台选择的持久 shell
- 用未压缩 JSONL 保存会话并从 SDK 初始化请求选择模型
限制与使用条件
- 不包含压缩、文件工具、技能、作业、子代理及托管凭据
- 默认 shell 拥有进程可用路径的完整访问权
浏览器交互发行组合@deepseek-ai/dsh-web-app
启动带聊天、模型设置和会话历史的浏览器 GUI。打印带认证的访问地址并通常打开默认浏览器。
具体能力
- 启动带聊天、模型设置和会话历史的浏览器 GUI
- 打印带认证的访问地址并通常打开默认浏览器
- 支持端口和额外主机设置，SSH 或 --no-open 时保留手动打开方式
配置与默认行为
- openBrowser：默认 true
- printUrl：默认 true
- surfaceContext：默认 true
- trustedHosts：默认 []
限制与使用条件
- 源码目录必须先有前端构建产物，缺失时启动失败且无源码服务回退
浏览器连接与代际管理@deepseek-ai/dsh-client-connection
承载浏览器到宿主的远程调用和 Fetch 响应。发布当前连接代际、宿主事实和恢复状态。
具体能力
- 承载浏览器到宿主的远程调用和 Fetch 响应
- 发布当前连接代际、宿主事实和恢复状态
- 提供立即重连命令并由控制器实施重试策略
限制与使用条件
- 没有注销操作
- 默认回环 HTTP 的浏览器 cookie 不带 Secure 标志
浏览器流式附件上传@deepseek-ai/dsh-client-file-upload
为会话上传 Blob、字节数组或可读字节流。返回可供后续提示引用的不透明收据。
具体能力
- 为会话上传 Blob、字节数组或可读字节流
- 返回可供后续提示引用的不透明收据
- 观察已消费字节并取消上传，跨 Worker 转移流所有权
限制与使用条件
- 上传不支持续传，可读流只能消费一次，重试必须创建新流
客户端插件热同步@deepseek-ai/dsh-client-hmr
让打开的页面随宿主插件启停同步。在浏览器 bundle 重建后替换对应插件。
具体能力
- 让打开的页面随宿主插件启停同步
- 在浏览器 bundle 重建后替换对应插件
- 保留连接和会话数据层，同时创建新的插件组件状态
配置与默认行为
- pollIntervalMs：默认 500
限制与使用条件
- 重载丢失该插件 React 状态，替换失败不恢复旧 bundle
客户端语言目录与切换@deepseek-ai/dsh-client-locale
切换内置中英文及插件新增语言。向插件提供带类型的命名空间字典和翻译 API。
具体能力
- 切换内置中英文及插件新增语言
- 向插件提供带类型的命名空间字典和翻译 API
- 回环页面持久保存用户选择并让插槽文案即时更新
限制与使用条件
- 注册时捕获的文本须重新注册才会更新，复数与双向布局由语言包负责
浏览器插件模块装载@deepseek-ai/dsh-client-modules
从 dsh.client 声明生成可加载浏览器 bundle 图。通过 Web 或壳载体返回准确 bundle 响应。
// 返回当前客户端依赖启动图，供 Host 注入浏览器引导信息。
graph(): WebBootGraph具体能力
- 从 dsh.client 声明生成可加载浏览器 bundle 图
- 通过 Web 或壳载体返回准确 bundle 响应
- 按需物化模块，执行 bundle 仅登记工厂
限制与使用条件
- 模块版本以文件元数据区分，页面 bootstrap 的替换需要刷新
桌面交互遥测采集@deepseek-ai/dsh-client-product-analytics
在 Desktop 采集选定的产品交互事件。复用已有 OTel 产品导出器发送事件。
具体能力
- 在 Desktop 采集选定的产品交互事件
- 复用已有 OTel 产品导出器发送事件
- 缺少登录身份时省略身份信息，普通 Web 不上报这些事件
限制与使用条件
- 发送为尽力而为，没有持久发件箱或仓库确认
客户端地址资源订阅@deepseek-ai/dsh-client-resources
按 dsh-resource 地址查找业务包持有的数据。通过 useResource 提供当前值与后续流式更新。
具体能力
- 按 dsh-resource 地址查找业务包持有的数据
- 通过 useResource 提供当前值与后续流式更新
- 无支持协议或非资源地址时返回无资源
限制与使用条件
- 地址记录保留到页面结束，内存随读过的不同地址增长
设备快捷键注册与定制@deepseek-ai/dsh-client-shortcuts
按接收设备选择 Desktop 与 Web 默认快捷键。允许用户修改绑定并在同一设备重载后保留。
具体能力
- 按接收设备选择 Desktop 与 Web 默认快捷键
- 允许用户修改绑定并在同一设备重载后保留
- 插件卸载时移除命令并保留其用户覆盖供重装使用
限制与使用条件
- 操作系统未交给窗口的快捷键不能拦截，组合键首键不会延迟或吞掉原动作
客户端可观察状态原语@deepseek-ai/dsh-client-store
提供不依赖 React 的可观察对象和快照存储。支持同步及动画帧发布、Immer 更新和浅比较。
具体能力
- 提供不依赖 React 的可观察对象和快照存储
- 支持同步及动画帧发布、Immer 更新和浅比较
- 可选把状态以 JSON 持久保存到 localStorage
限制与使用条件
- 浏览器持久化不跨设备，非浏览器运行时关闭持久化
Agent 预设选择界面@deepseek-ai/dsh-client-ui-agent-preset
在 Web 选择 Agent 预设。设置新任务的默认预设。
具体能力
- 在 Web 选择 Agent 预设
- 设置新任务的默认预设
- 以只读方式查看模式说明及声明并引导到 Creator 创作
限制与使用条件
- Web 页面不能直接创建或编辑预设
人工批准请求界面@deepseek-ai/dsh-client-ui-approval
接收 Agent 范围远程瀑布事件中的待批准请求。临时接管会话输入框并可显示关联工具详情。
具体能力
- 接收 Agent 范围远程瀑布事件中的待批准请求
- 临时接管会话输入框并可显示关联工具详情
- 把用户一次允许或拒绝决定返回等待中的宿主操作
限制与使用条件
- 面板只提供临时决定，不管理持久权限策略
附件轨道与图像预览@deepseek-ai/dsh-client-ui-attachment
在输入框下显示有序附件草稿轨道和全屏拖放提示。在聊天、轨迹与工具结果中渲染持久图像。
具体能力
- 在输入框下显示有序附件草稿轨道和全屏拖放提示
- 在聊天、轨迹与工具结果中渲染持久图像
- 用灯箱按视口适配显示原始图像
限制与使用条件
- 灯箱不支持缩放或下载，Tab 焦点仍可能进入背后页面
官方品牌界面贡献@deepseek-ai/dsh-client-ui-brand-official
在 official 客户端构建的侧栏显示 DeepSeek Harness 标志和名称。其他构建保留壳的鱼形图标及本地构建标签。
具体能力
- 在 official 客户端构建的侧栏显示 DeepSeek Harness 标志和名称
- 其他构建保留壳的鱼形图标及本地构建标签
- 保持会话欢迎区使用动画鱼标志且不修改模型请求
限制与使用条件
- 浏览器标题由构建期 DSH_CLIENT_TITLE 独立决定，不受品牌插槽控制
会话聊天转录界面@deepseek-ai/dsh-client-ui-chat
从会话记录渲染聊天、历史图像及本地化操作。按工作详情模式展示推理预览和过程行并保留最终答案。
具体能力
- 从会话记录渲染聊天、历史图像及本地化操作
- 按工作详情模式展示推理预览和过程行并保留最终答案
- 立即显示本地提交，在权威记录到达时原子替换临时回显
限制与使用条件
- 聊天只反映已加载的历史窗口，更早记录需会话控制器翻页
斜杠命令输入界面@deepseek-ai/dsh-client-ui-commands
把斜杠命令解析为选择弹窗、客户端动作或宿主执行。允许业务包注册弹窗与动作并装饰现有宿主命令。
具体能力
- 把斜杠命令解析为选择弹窗、客户端动作或宿主执行
- 允许业务包注册弹窗与动作并装饰现有宿主命令
- 按会话命令目录在空格和回车时解析输入
限制与使用条件
- 触发会话销毁后，脱离执行的结果通知只落到控制台
会话显示目标装配@deepseek-ai/dsh-client-ui-conversation
消费会话事件并提供与显示目标无关的注册表和会话绑定。向 uiSession 提供 useConversation、useInput 与输入动作。
具体能力
- 消费会话事件并提供与显示目标无关的注册表和会话绑定
- 向 uiSession 提供 useConversation、useInput 与输入动作
- 按会话缓存附件图像 URL 并在绑定释放时撤销
限制与使用条件
- 只渲染已注册目标，content 工厂不能独立指定另一个会话
变更文件与交付卡片@deepseek-ai/dsh-client-ui-deliverables
展示回合修改文件及宿主统计的行数。点击变更文件进入该回合审阅标签。
具体能力
- 展示回合修改文件及宿主统计的行数
- 点击变更文件进入该回合审阅标签
- 为明确交付的文件生成卡片并把已核实路径关联到结束文案
限制与使用条件
- 内联本地图像要求 HTTP(S) 页面，Desktop 的 dsh-app 页面不支持该文件路由
应用内目录选择界面@deepseek-ai/dsh-client-ui-directory-picker-browse
在对话框中列出宿主目录。导航路径并创建新文件夹。
具体能力
- 在对话框中列出宿主目录
- 导航路径并创建新文件夹
- 填充工作区目录流程插槽以完成远程浏览器选目录
限制与使用条件
- 不提供搜索、多选、重命名或删除
系统目录选择界面@deepseek-ai/dsh-client-ui-directory-picker-native
由无可见组件的插槽占位触发系统目录选择器。向工作区流程报告选中路径、取消或失败。
具体能力
- 由无可见组件的插槽占位触发系统目录选择器
- 向工作区流程报告选中路径、取消或失败
- 在浏览器与宿主同机时接入本地选择体验
限制与使用条件
- 浏览器不能取消已经打开的系统选择器，不适用于远程浏览器
可拆分标签面板布局库@deepseek-ai/dsh-client-ui-dockkit
用分割树表示带标签的面板布局。提供可逆布局操作及规划函数。
具体能力
- 用分割树表示带标签的面板布局
- 提供可逆布局操作及规划函数
- 提供驱动拖放和布局展示的组件
限制与使用条件
- 导出属于内部引擎而非稳定 API，尺寸只有权重及最小值约束
长期目标状态界面@deepseek-ai/dsh-client-ui-goal
同时展示持久目标状态与当前进程的激活状态。允许编辑、暂停、恢复或清除目标并内联显示拒绝原因。
具体能力
- 同时展示持久目标状态与当前进程的激活状态
- 允许编辑、暂停、恢复或清除目标并内联显示拒绝原因
- 把持久化的 /goal 命令显示为重载后仍可见的命令气泡
限制与使用条件
- 不负责创建目标，切换到 minimal 不会删除宿主持有的目标
输入位置候选菜单@deepseek-ai/dsh-client-ui-input-trigger
在光标处输入 / 或 @ 时打开分组菜单。支持键盘、指针选择和逐级下钻。
具体能力
- 在光标处输入 / 或 @ 时打开分组菜单
- 支持键盘、指针选择和逐级下钻
- 选择后启动命令流程或插入供输入面消费的引用
限制与使用条件
- 只支持全局候选源注册，尚未启用会话范围覆盖
后台作业状态面板@deepseek-ai/dsh-client-ui-jobs
在会话页头汇总作业生命周期、耗时与进度。展开运行中或保留输出的作业查看输出。
具体能力
- 在会话页头汇总作业生命周期、耗时与进度
- 展开运行中或保留输出的作业查看输出
- 折叠时停止输出订阅并分组展示已结束作业
限制与使用条件
- stdout 与 stderr 合并显示，不呈现通道标签
三栏应用布局@deepseek-ai/dsh-client-ui-layout
提供三栏 AppFrame 和两侧宽度控制。空间不足时优先调整右栏，为中央内容保留空间。
具体能力
- 提供三栏 AppFrame 和两侧宽度控制
- 空间不足时优先调整右栏，为中央内容保留空间
- 支持右栏全屏展示并保留宽屏轨道
限制与使用条件
- 面板几何仅存于页面，刷新会恢复默认宽度和右栏隐藏状态
消息评价与反馈界面@deepseek-ai/dsh-client-ui-message-feedback
在最终助手消息上提供赞与踩入口。用同一会话反馈对话框收集分类和可选说明。
具体能力
- 在最终助手消息上提供赞与踩入口
- 用同一会话反馈对话框收集分类和可选说明
- 支持 /feedback 入口并显示提交成功或失败提示
限制与使用条件
- 说明长度由宿主限制，页面不预检，超限由宿主拒绝
模型与推理强度选择@deepseek-ai/dsh-client-ui-model-selection
通过 /model 或输入框控件选择现有会话模型。按提供者分组展示模型及其可用推理强度。
具体能力
- 通过 /model 或输入框控件选择现有会话模型
- 按提供者分组展示模型及其可用推理强度
- 完整选择从下一次请求生效，当前步骤保持原模型
限制与使用条件
- 不提供会话创建前模型选择或指定子代理的模型选择
外部应用打开控件@deepseek-ai/dsh-client-ui-open-in-app
在会话页头按已保存的应用选择打开工作区。列出宿主探测到的已安装应用。
具体能力
- 在会话页头按已保存的应用选择打开工作区
- 列出宿主探测到的已安装应用
- 在文档预览中提供默认应用打开和定位文件操作
限制与使用条件
- 路径没有匹配的宿主映射时拒绝启动原生应用
权限预设选择界面@deepseek-ai/dsh-client-ui-permission-presets
分别设置当前会话权限和未来会话默认权限。通过输入框或 /permission 切换当前会话策略。
具体能力
- 分别设置当前会话权限和未来会话默认权限
- 通过输入框或 /permission 切换当前会话策略
- 在宿主投影确认后显示变更，并对可见高权限选择收集风险确认
限制与使用条件
- 实验 Auto review 仅限当前会话选择，不作为未来默认值
计划提交与审阅界面@deepseek-ai/dsh-client-ui-plan
用 /plan 和输入框标记进入或退出计划模式。提交计划后自动打开右侧审阅文档。
具体能力
- 用 /plan 和输入框标记进入或退出计划模式
- 提交计划后自动打开右侧审阅文档
- 从回合交付区重新打开计划并从会话历史恢复文档
限制与使用条件
- 计划模式仅提供指导，不代替执行沙箱或只读权限策略
插件管理页面@deepseek-ai/dsh-client-ui-plugin-manager
在侧栏 Plugins 中启停 bundle 及其条目。展示安装说明和 pnpm 输出并允许停止安装。
具体能力
- 在侧栏 Plugins 中启停 bundle 及其条目
- 展示安装说明和 pnpm 输出并允许停止安装
- 为插件提供独立配置页并在卸载前确认
限制与使用条件
- 探测响应时间不代表下载吞吐，探测与 pnpm 可使用不同代理
共享控件与安全输出渲染@deepseek-ai/dsh-client-ui-primitives
提供标准控件、图标和定位覆盖层。渲染含 TeX 的 Markdown、终端、差异、搜索与 JSON。
具体能力
- 提供标准控件、图标和定位覆盖层
- 渲染含 TeX 的 Markdown、终端、差异、搜索与 JSON
- 丢弃原始 HTML、限制链接并解析 ANSI 来处理不可信输出
限制与使用条件
- 差异编辑距离超过上限时退化为粗粒度替换显示
文件和会话引用界面@deepseek-ai/dsh-client-ui-reference
在统一 @ 菜单中列出文件、目录和会话。插入具有稳定剪贴板形式的原子引用。
具体能力
- 在统一 @ 菜单中列出文件、目录和会话
- 插入具有稳定剪贴板形式的原子引用
- 允许目录下钻且一个候选域加载失败不阻断另一个
限制与使用条件
- 候选发现失败时静默无结果，会话引用准备失败会终止该 Agent 回合
React 应用挂载与插槽渲染@deepseek-ai/dsh-client-ui-renderer
在客户端插件清单稳定后挂载完整 React 应用。接管无框架启动页面并在下一次绘制前完成切换。
具体能力
- 在客户端插件清单稳定后挂载完整 React 应用
- 接管无框架启动页面并在下一次绘制前完成切换
- 在插槽出口把可观察源绑定成选择器 hooks
限制与使用条件
- 首个应用画面等待全部客户端条目就绪，不支持区域独立就绪
自动任务管理界面@deepseek-ai/dsh-client-ui-schedule
搜索筛选活动和非活动定时任务。修改名称、指令、执行时间并浏览记录或删除任务。
具体能力
- 搜索筛选活动和非活动定时任务
- 修改名称、指令、执行时间并浏览记录或删除任务
- 在会话页头、列表及工具卡片展示提醒入口
限制与使用条件
- 历史记录描述收件箱投递而非模型执行结果，未保存的旧记录无法恢复
会话界面绑定与状态@deepseek-ai/dsh-client-ui-session
通过标准插槽 hooks 提供会话目录和统一状态。允许 SessionProvider 继承或显式绑定会话引用。
具体能力
- 通过标准插槽 hooks 提供会话目录和统一状态
- 允许 SessionProvider 继承或显式绑定会话引用
- 管理进程内待交互和完成提醒策略
限制与使用条件
- 待交互投影不持久，浏览器重连依赖远程瀑布重新投递请求
客户端设置表单基础@deepseek-ai/dsh-client-ui-settings
提供按命名空间读写的设置表单。支持原子多字段更新、schema 校验及并发冲突保护。
具体能力
- 提供按命名空间读写的设置表单
- 支持原子多字段更新、schema 校验及并发冲突保护
- 定义设置页面、页头操作、插件标签和引导扩展点
限制与使用条件
- 非回环页面关闭宿主持久化，表单写入不发送到远程
账户设置与引导界面@deepseek-ai/dsh-client-ui-settings-account
显示 DeepSeek 登录状态并发起浏览器登录。提供登录取消和侧栏 Platform 退出登录。
具体能力
- 显示 DeepSeek 登录状态并发起浏览器登录
- 提供登录取消和侧栏 Platform 退出登录
- 为 Desktop 展示可恢复的账户额度与显示偏好引导
限制与使用条件
- 余额查询失败独立显示，不能把失败伪造为零余额
工具并行上限设置页@deepseek-ai/dsh-client-ui-settings-agent-loop
编辑单步骤可同时运行的并行安全工具数量。先暂存输入再保存设置。
具体能力
- 编辑单步骤可同时运行的并行安全工具数量
- 先暂存输入再保存设置
- 标记用户覆盖并允许重置部署默认值
限制与使用条件
- 只编辑并行上限，agents 装配数组不属于该设置页
通用设置与首次引导外壳@deepseek-ai/dsh-client-ui-settings-general
提供设置面板和由功能插件贡献的导航。显示连接恢复控件以立即重试连接。
具体能力
- 提供设置面板和由功能插件贡献的导航
- 显示连接恢复控件以立即重试连接
- 组织顺序首次引导并在可用时打开本地配置文件
限制与使用条件
- 除 Coding Tools 与当前版本外的通用设置行须由对应功能插件提供
模型提供者配置界面@deepseek-ai/dsh-client-ui-settings-models
以只写方式保存 API 密钥到凭据引用。编辑提供者模型列表和手动 pi-ai 路由。
具体能力
- 以只写方式保存 API 密钥到凭据引用
- 编辑提供者模型列表和手动 pi-ai 路由
- 合并提供者目录、设置及凭据描述为一致快照
限制与使用条件
- 卡片仅编辑 API 密钥及选定字段，不覆盖重试、超时等全部配置
只读插件清单界面@deepseek-ai/dsh-client-ui-settings-plugin-inventory
按 Agent 预设与全局清单显示插件实例。展示启用状态、来源、运行状态和发现失败。
具体能力
- 按 Agent 预设与全局清单显示插件实例
- 展示启用状态、来源、运行状态和发现失败
- 搜索名称及说明并指出其他预设中的匹配
限制与使用条件
- 每次打开设置或重试获取一次快照，不自动跟随 Loader 变化或重连
内置插件设置导航@deepseek-ai/dsh-client-ui-settings-plugins
注册内置插件设置导航入口。展示其他插件注册的标签页行。
具体能力
- 注册内置插件设置导航入口
- 展示其他插件注册的标签页行
- 为只读清单等插件提供共同设置区域
限制与使用条件
- 自身没有标签页，没有功能贡献时只显示空状态
官方日志上传设置行@deepseek-ai/dsh-client-ui-settings-session-log
在通用设置展示官方模型 API 的会话日志上传开关。立即保存用户切换。
具体能力
- 在通用设置展示官方模型 API 的会话日志上传开关
- 立即保存用户切换
- 呈现宿主已接受值并阻止只读客户端修改
限制与使用条件
- 宿主未提供 session-log-deepseek 命名空间时不可用
Shell 执行限制设置页@deepseek-ai/dsh-client-ui-settings-shell
编辑单命令允许的运行时长。编辑每个输出流的内存保留量。
具体能力
- 编辑单命令允许的运行时长
- 编辑每个输出流的内存保留量
- 暂存修改后统一保存并允许逐项恢复部署默认
限制与使用条件
- 页面只编辑这两个共同字段，PowerShell 路径等平台字段不在该编辑面
子代理规模与模型设置页@deepseek-ai/dsh-client-ui-settings-subagent
编辑委派深度和宽度限制。选择 Agent 可用于子代理的模型。
具体能力
- 编辑委派深度和宽度限制
- 选择 Agent 可用于子代理的模型
- 将 subagent 与 subagent-model-selection 两个命名空间纳入一次保存
限制与使用条件
- 模型目录只在适配器变化、文档提交、重连或手动重试时重新读取
网页搜索配置界面@deepseek-ai/dsh-client-ui-settings-web-search
编辑搜索提供者密钥和端点。编辑单请求搜索次数预算。
具体能力
- 编辑搜索提供者密钥和端点
- 编辑单请求搜索次数预算
- 通过凭据域写入密钥以避免响应返回明文
限制与使用条件
- 只编辑密钥、端点和搜索预算，模型、API 版本及 token 预算保持组合配置
快捷键查看与录制界面@deepseek-ai/dsh-client-ui-shortcuts
按动作、英文别名或按键搜索当前窗口命令。录制、清除或恢复应用按键绑定。
具体能力
- 按动作、英文别名或按键搜索当前窗口命令
- 录制、清除或恢复应用按键绑定
- 从通用设置或 Mod+/ 打开快捷键参考
限制与使用条件
- 固定输入动作只读，命令提供者加载或卸载会使录制草稿失效
主侧栏导航外壳@deepseek-ai/dsh-client-ui-sidebar
提供新会话、工作区浏览和设置入口。折叠为56像素窄轨并保留底部设置按钮。
具体能力
- 提供新会话、工作区浏览和设置入口
- 折叠为56像素窄轨并保留底部设置按钮
- 按显式工作区、当前会话和最近活动工作区依次选择新会话位置
限制与使用条件
- 分组、排序、搜索与会话状态点由 ui-workspace 而非本壳管理
侧栏网页浏览标签@deepseek-ai/dsh-client-ui-sidebar-browser
在独立侧栏标签中浏览 HTTP(S) 页面及回环服务。Web 使用 iframe 与应用管理历史。
具体能力
- 在独立侧栏标签中浏览 HTTP(S) 页面及回环服务
- Web 使用 iframe 与应用管理历史
- Desktop 使用 Electron webview 的原生历史并保留页面
限制与使用条件
- 网站可能拒绝 iframe，沙箱兼容性设置也不能绕过混合内容限制
多格式文档侧栏预览@deepseek-ai/dsh-client-ui-sidebar-documentpreview
分页读取 Markdown 与代码并支持折行和重载。预览 PDF、HTML、常见图像和电子表格。
具体能力
- 分页读取 Markdown 与代码并支持折行和重载
- 预览 PDF、HTML、常见图像和电子表格
- 把 Word 与 PowerPoint 本地转换为 PDF 并允许插件增补渲染器
配置与默认行为
- excel.maxBytes：默认 16777216 (16 MiB)
- excel.maxCells：默认 250000
- excel.timeoutMs：默认 15000
- office.maxCachedEntries：默认 8
- office.maxCachedBytes：默认 67108864 (64 MiB)
- office.maxPending / office.maxReaders：默认 8 / 32
限制与使用条件
- 只预览不编辑，不提供共享搜索
- 未知扩展名仍须满足文本 UTF-8 与 NUL 检查
会话工作区文件树@deepseek-ai/dsh-client-ui-sidebar-files
浏览会话工作目录下的文件树。打开文件到侧栏预览。
具体能力
- 浏览会话工作目录下的文件树
- 打开文件到侧栏预览
- 监听根目录及已展开目录直接条目并提供手动刷新
限制与使用条件
- 不能浏览根目录之上，不支持搜索、重命名或拖放
按会话组织的右侧面板@deepseek-ai/dsh-client-ui-sidebar-right
为每个会话持有独立停靠布局。提供标签类型注册表和导航控制器。
具体能力
- 为每个会话持有独立停靠布局
- 提供标签类型注册表和导航控制器
- 管理标签导航来源、生命周期及会话页头展开入口
限制与使用条件
- 布局仅保存在浏览器且不跨设备，没有会话时不显示右侧面板
人工交互终端界面@deepseek-ai/dsh-client-ui-sidebar-terminal
选择已安装 shell 并在会话工作区启动命令。重命名终端标签并在刷新后恢复保留进程。
具体能力
- 选择已安装 shell 并在会话工作区启动命令
- 重命名终端标签并在刷新后恢复保留进程
- 折叠面板保持运行，关闭标签请求终止进程
限制与使用条件
- 启动失败不自动换 shell，补全由 shell 配置提供
- 人工终端权限独立于 Agent 权限
技能命令与指令卡片@deepseek-ai/dsh-client-ui-skill
在斜杠建议中选择技能或直接输入技能名。与同名宿主命令冲突时保留宿主命令优先。
具体能力
- 在斜杠建议中选择技能或直接输入技能名
- 与同名宿主命令冲突时保留宿主命令优先
- 把调用渲染为可展开且内容稳定的 Instructions 卡片
限制与使用条件
- 历史窗口仅有结果而无对应调用时只能显示通用行
类型化界面插槽注册@deepseek-ai/dsh-client-ui-slots
为插件定义父级持有的界面扩展位置。以组件工厂组合调用方选定的局部组件。
具体能力
- 为插件定义父级持有的界面扩展位置
- 以组件工厂组合调用方选定的局部组件
- 从声明合并类型派生作用域、注入及语言属性并报告定义冲突
限制与使用条件
- isLive 对所有记录线性扫描，适合数十级 UI 插件注册规模
子代理会话导航界面@deepseek-ai/dsh-client-ui-subagent
浏览父会话下的所有子代理及后代。展示运行状态、token 用量和活动回合耗时。
具体能力
- 浏览父会话下的所有子代理及后代
- 展示运行状态、token 用量和活动回合耗时
- 对可继续会话提交有序追问并提供独立停止操作
限制与使用条件
- 非正常完成的非活动结果合并展示，不细分失败、取消、拒绝或耗尽
主题与内容字号管理@deepseek-ai/dsh-client-ui-theme
选择浅色、深色或跟随系统主题。设置12至17像素的会话内容字号。
具体能力
- 选择浅色、深色或跟随系统主题
- 设置12至17像素的会话内容字号
- 提前注入启动样式并允许第三方覆盖主题别名 token
配置与默认行为
- 内容字体大小可设为12–17px
限制与使用条件
- 第三方主题覆盖不校验完整性，颜色仍以 token 样式表为权威
工具调用与子调用渲染@deepseek-ai/dsh-client-ui-tool
按工具名分派原子调用到对应工具视图。渲染根调用及 PTC 子调用。
具体能力
- 按工具名分派原子调用到对应工具视图
- 渲染根调用及 PTC 子调用
- 未知工具使用通用卡片并消费运行时给出的配对和生命周期
限制与使用条件
- 生产 PTC 绑定排除 run_code，因此生产事件只有一层分派，递归能力不代表实际嵌套工具可用
Agent 轨迹与时间概览@deepseek-ai/dsh-client-ui-trajectory
按回合和步骤展示用户、助手、工具、子工具及压缩记录。查看 token、耗时、输入输出、图像和附件摘要。
具体能力
- 按回合和步骤展示用户、助手、工具、子工具及压缩记录
- 查看 token、耗时、输入输出、图像和附件摘要
- 长历史从尾部按需翻页并只渲染可见行
限制与使用条件
- 未结束记录只显示开始标记，不虚构已完成耗时
结构化用户问答界面@deepseek-ai/dsh-client-ui-user-questions
用问答面替换聊天输入框。支持单选、多选、自定义回答、跳过及批量提交。
具体能力
- 用问答面替换聊天输入框
- 支持单选、多选、自定义回答、跳过及批量提交
- 对计划审阅意图显示专用批准与修改请求操作
限制与使用条件
- 未提交草稿仅在页面与会话范围内保存，刷新或新请求身份会清空
工作流运行层级卡片@deepseek-ai/dsh-client-ui-workflow-run
把持久顶层工作流显示为独立聊天节点。逐层展开阶段和成员的身份与状态。
具体能力
- 把持久顶层工作流显示为独立聊天节点
- 逐层展开阶段和成员的身份与状态
- 对当前会话仍可用的运行成员打开子会话
限制与使用条件
- 只展示 tool-workflow 的顶层调用记录，不展示脚本、输出、日志或控制项
工作区与会话导航管理@deepseek-ai/dsh-client-ui-workspace
按分组或平铺方式浏览、搜索和排序会话。创建、重命名、删除工作区并分叉或归档会话。
具体能力
- 按分组或平铺方式浏览、搜索和排序会话
- 创建、重命名、删除工作区并分叉或归档会话
- 显示待交互警示和活动定时任务入口
限制与使用条件
- 不支持会话删除，内容搜索非模糊匹配且结果只定位会话
浏览器应用启动内核@deepseek-ai/dsh-client-web
读取宿主提供的启动图并加载客户端模块系统。在挂载界面前激活全部客户端插件。
具体能力
- 读取宿主提供的启动图并加载客户端模块系统
- 在挂载界面前激活全部客户端插件
- 用无框架启动页报告条目状态并提供共享外部模块表
限制与使用条件
- 任一条目失败都会保留启动报告，不支持部分界面可用
手动上下文压缩命令@deepseek-ai/dsh-command-compact
注册不消耗模型回合的 /compact 命令。调用已组合的压缩后端并报告项目数和估算节省量。
// 用户无参数发起立即压缩；Agent 忙碌、压缩已运行或无可压缩历史时报告明确结果。
/compact具体能力
- 注册不消耗模型回合的 /compact 命令
- 调用已组合的压缩后端并报告项目数和估算节省量
- 压缩期间把新提示排队，完成后再执行
限制与使用条件
- 只在空闲且无优先待唤醒提示时可执行，命令自身不排队且不接受参数
会话压缩服务接口@deepseek-ai/dsh-compaction
定义旧历史替换为单条摘要的接口。保留最近对话并让被遮蔽内容继续留在日志。
dsh-compaction · 接口摘录，省略上下文 · compactIfNeeded · packages/compaction/compaction/README.md · compactNow · packages/compaction/compaction/README.md// 自动策略入口按当前请求路由与预算决定是否压缩；服务接口需装配后端实现。
compactIfNeeded
// 手动调用在 Agent 空闲时预留接纳权，即使低于自动压力阈值也尝试压缩安全旧片段。
compactNow具体能力
- 定义旧历史替换为单条摘要的接口
- 保留最近对话并让被遮蔽内容继续留在日志
- 让重放确定性还原相同的压缩对话
限制与使用条件
- 本包不执行压缩，须组合实际后端
- 不注册模型可见压缩工具
摘要式自动上下文压缩@deepseek-ai/dsh-compaction-basic
按 token 压力把最旧历史压成摘要并保留近期消息。上下文溢出后压缩并重试请求。
具体能力
- 按 token 压力把最旧历史压成摘要并保留近期消息
- 上下文溢出后压缩并重试请求
- 可先裁剪过大工具结果，再用一次额外模型请求生成摘要并仅保留摘要文本
配置与默认行为
- thresholdRatio：默认 0.8
- headroomTokens：默认 65536
- retainRatio：默认 0.16
- retainTokens：未设置；具体省略行为见 README
- summarizationProvider：默认 ''
- summarizationModel：默认 ''
- maxTokens：默认 headroomTokens (65536)
- compactionRetries：默认 1
- maxOverflowRetries：默认 1
- modelPolicies：默认 []
- auto：默认 true
- auto 默认 true；阈值为 floor(min(W×thresholdRatio, W−O−headroomTokens))，小窗口应调整 headroomTokens 以容纳输出和保留预算
限制与使用条件
- 无法缩小系统提示、工具定义或会话前缀，也不能拆开单个不可分割的大单元
- /compact 入口由 command-compact 注册，不由本包注册
- 需满足 W−O−headroomTokens>0 且保留预算低于阈值；headroomTokens=0 时 maxTokens 必须为正
历史图像卸载与重试@deepseek-ai/dsh-compaction-image-offload
图像预算被模型路由拒绝后把旧图像替换为附件与只读路径说明。不消耗提供者重试预算地重新请求。
具体能力
- 图像预算被模型路由拒绝后把旧图像替换为附件与只读路径说明
- 不消耗提供者重试预算地重新请求
- 记录卸载选择以跨路由切换、恢复和重放保持一致
限制与使用条件
- 卸载图像不会因预算变大自动恢复，每次卸载先经历一次失败请求
大工具结果头尾裁剪@deepseek-ai/dsh-compaction-tool-result-pruner
压缩触发条件满足时裁剪超预算工具文本。保留有限开头与结尾并在中间插入裁剪标记。
具体能力
- 压缩触发条件满足时裁剪超预算工具文本
- 保留有限开头与结尾并在中间插入裁剪标记
- 保留日志中的完整原结果，无需模型调用即可释放上下文
配置与默认行为
- thresholdChars：默认 8192
- headChars：默认 4096
- tailChars：默认 1024
限制与使用条件
- 字符预算不是 token 预算，头尾保留不判断内容语义重要性
桌面控制提供者注册@deepseek-ai/dsh-computer-use
为一个服务实例注册单个桌面操作提供者。第二次注册时报告当前提供者并拒绝。
具体能力
- 为一个服务实例注册单个桌面操作提供者
- 第二次注册时报告当前提供者并拒绝
- 把模型工具与桌面动作交给具体驱动
限制与使用条件
- 不协调并发会话或不同进程对同一桌面的操作
分层工作区指令加载@deepseek-ai/dsh-agent-instructions
首次请求加载用户全局与项目 AGENTS.md 指令链。成功文件操作发现嵌套指令并刷新修改或删除。
dsh-agent-instructions · 接口摘录，省略上下文 · agent/pre-step · packages/context/agent-instructions/README.md// 指令插件在会话首次合格步骤前组合基线，将规则作为可重放输入纳入进入批次。
'agent/pre-step'具体能力
- 首次请求加载用户全局与项目 AGENTS.md 指令链
- 成功文件操作发现嵌套指令并刷新修改或删除
- 恢复时校准基线并按字节预算先舍弃较宽层文件再截断最具体文件
配置与默认行为
- maxBytes 必填，无插件默认值；65536 是 dsh-base 组合设置
- maxSourceBytes 默认 1048576
- projectRootMarkers 默认 [".git"]
限制与使用条件
- 不持续监听外部修改，shell 内切换目录不会触发嵌套指令发现
- 指令符号链接可以读取树外文件，本包不是文件访问隔离机制
文件提及候选接口@deepseek-ai/dsh-file-reference
为指定 Agent 提供 @file 路径候选发现。把选中候选插入为普通提示文本。
dsh-file-reference · 接口摘录，省略上下文 · ctx.fileReferences.list · packages/context/file-reference/README.md// 输入补全消费者查询确定性排序的文件与目录路径候选，不读取文件正文。
const candidates = await ctx.fileReferences.list(agent, query, signal)具体能力
- 为指定 Agent 提供 @file 路径候选发现
- 把选中候选插入为普通提示文本
- 允许本地或远程提供者承担排序、缓存和失效处理
限制与使用条件
- 候选只是提示，不证明后续文件工具可访问同一命名空间
- 选中不读取文件内容
本机文件提及候选@deepseek-ai/dsh-file-reference-local
从 Agent 本机工作区有界扫描并排序候选路径。工具活动后后台刷新结果而不阻塞补全。
具体能力
- 从 Agent 本机工作区有界扫描并排序候选路径
- 工具活动后后台刷新结果而不阻塞补全
- 在 read 可用时向模型说明如何解释引用路径
配置与默认行为
- maxResults：默认 20
- maxEntries：默认 50000
- excludedDirectories：默认 ['.git', 'node_modules', 'dist', 'build', 'out', 'coverage', 'target', '.next', '.nuxt', '.turbo', '.venv', '__pycache__', '.pytest_cache', '.mypy_cache', '.gradle']
限制与使用条件
- 不跟随目录符号链接，远程或虚拟文件工具须使用匹配的候选提供者
跨会话只读背景引用@deepseek-ai/dsh-session-reference
按工作目录亲近度和最新标题发现其他会话。把引用转换为标准 URI 并捕获有界只读快照。
具体能力
- 按工作目录亲近度和最新标题发现其他会话
- 把引用转换为标准 URI 并捕获有界只读快照
- 把快照作为持久不可信背景附带禁止执行其中指令的警告
配置与默认行为
- maxReferences：默认 3
- candidateLimit：默认 50
- maxReferenceBytes：默认 automatic
- referenceContextFraction：默认 0.2
限制与使用条件
- 候选查询不搜索消息正文，捕获的快照不会随来源会话变化
模型时间与浏览器时区上下文@deepseek-ai/dsh-time-context
在合格步骤记录当前时间和前一模型可见消息后的间隔。携带当前请求的浏览器时区。
具体能力
- 在合格步骤记录当前时间和前一模型可见消息后的间隔
- 携带当前请求的浏览器时区
- 缺少或混合时区时指导模型询问用户
配置与默认行为
- timeZone：默认 进程时区
- refreshIntervalMs：默认 600000 (10 minutes)
- refreshIntervalMs 默认 600000（10分钟）；0 表示每个合格步骤注入
限制与使用条件
- 仅提供提示指导，不自动填写其他工具要求的时区参数
tmux 进程位置上下文@deepseek-ai/dsh-tmux-context
检测 Agent 所在 tmux 会话、窗口、窗格及布局。仅在回合首步且位置改变时追加持久上下文。
具体能力
- 检测 Agent 所在 tmux 会话、窗口、窗格及布局
- 仅在回合首步且位置改变时追加持久上下文
- 查询失败或只是继承环境而非位于该窗格时不注入
配置与默认行为
- refreshIntervalMs：默认 0 (every changed turn)
限制与使用条件
- 回合中移动或调整窗格要到下一回合才反映
活动 Agent 生命周期接口@deepseek-ai/dsh-agent
创建或恢复活动 Agent 并提交追问和转向输入。注入模型上下文、取消工作并等待空闲。
dsh-agent · 接口摘录，省略上下文 · AgentHandle.dispose() · packages/core/agent/README.md · ctx.agents.create · packages/core/agent/README.md// 仅拥有 AgentHandle 的组件销毁 Agent，等待循环停止、注销并展开作用域清理。
await handle.dispose()
// 应用通过已注册工厂创建 Agent 与 Session，返回负责销毁的 AgentHandle。
const handle = await ctx.agents.create({
sessionId,
agentOptions: { provider: 'deepseek', model: 'deepseek-chat' },
})具体能力
- 创建或恢复活动 Agent 并提交追问和转向输入
- 注入模型上下文、取消工作并等待空闲
- 按 Agent 范围观察拦截活动与安装能力
限制与使用条件
- 本包不发模型请求，调用发起者归属只在当前进程有效
新 Agent 默认模型服务@deepseek-ai/dsh-agent-default-model
为未指定选择的会话提供默认提供者和模型。以实时配置提供推理强度。
具体能力
- 为未指定选择的会话提供默认提供者和模型
- 以实时配置提供推理强度
- 把保存的选择写入活动 profile patch 并作用于后续读取
配置与默认行为
- provider：必填，无插件默认值
- model：必填，无插件默认值
限制与使用条件
- 全进程只有一份默认值，单会话选择仍归入口负责
标准模型工具执行循环@deepseek-ai/dsh-agent-loop
驱动创建或恢复后的回合执行模型请求、流式响应与工具。持久记录会话历史并支持声明式启动 Agent。
具体能力
- 驱动创建或恢复后的回合执行模型请求、流式响应与工具
- 持久记录会话历史并支持声明式启动 Agent
- 限制并行安全工具数量，顺序执行独占调用并在取消时保留已交付文本
配置与默认行为
- maxParallelToolCalls：默认 10
- agents[].id：必填，无插件默认值
- agents[].provider / agents[].model：未设置；具体省略行为见 README
- agents[].reasoningEffort：未设置；具体省略行为见 README
- agents[].maxTokens：未设置；具体省略行为见 README
- agents[].cwd：未设置；具体省略行为见 README
- agents[].sessionId：未设置；具体省略行为见 README
- agents[].resumeSessionId：未设置；具体省略行为见 README
限制与使用条件
- 并行安全判定针对单个调用，需要比较兄弟调用或资源的工具必须保持独占
Agent 工具呈现方式配置@deepseek-ai/dsh-agent-tool-presentation
在预设中选择原生工具、PTC SDK 或两者。允许同进程不同预设拥有不同模型工具目录。
具体能力
- 在预设中选择原生工具、PTC SDK 或两者
- 允许同进程不同预设拥有不同模型工具目录
- 挂载时验证 ptc 或 both 所需运行时是否存在
配置与默认行为
- mode 必填，可选 native、ptc、both，无插件默认值；未挂载时继承 tools 的呈现默认
限制与使用条件
- PTC 运行时由宿主组合提供，本包不为每个预设单独提供运行时
继承式作用域原语@deepseek-ai/dsh-scope
为 Agent 或分组建立独立贡献集合和共享生命周期。子范围继承祖先贡献且最近定义优先。
dsh-scope · 接口摘录，省略上下文 · createScope(ctx, key) · packages/core/scope/README.md · scope.dispose() · packages/core/scope/README.md// 组合方为 Agent 等拥有者建立作用域，关联注册的可见范围与存活时间。
const scope = createScope(ctx, agent)
// 作用域拥有者等待清理其中的注册；作用域本身不构成文件或进程沙箱。
await scope.dispose()具体能力
- 为 Agent 或分组建立独立贡献集合和共享生命周期
- 子范围继承祖先贡献且最近定义优先
- 允许祖先观察后代事件并在释放范围时移除其全部贡献
限制与使用条件
- 只有使用作用域感知注册和事件分派 API 的状态才会隔离
可重建会话事件记录@deepseek-ai/dsh-session
以追加日志保存每个模型可见事实。从记录重建历史，支持检查、回放、分支及 flush 耐久检查点。
具体能力
- 以追加日志保存每个模型可见事实
- 从记录重建历史，支持检查、回放、分支及 flush 耐久检查点
- 压缩隐藏旧内容但保留原始事件
限制与使用条件
- 未配置持久化后端时会话只在内存；flush 等待所组合后端完成写出，作为耐久检查点
系统提示与工具目录装配@deepseek-ai/dsh-system-prompt
为每个模型步骤组织有序系统提示和工具 schema。注册提示章节、运行事实及可复用变量。
具体能力
- 为每个模型步骤组织有序系统提示和工具 schema
- 注册提示章节、运行事实及可复用变量
- 允许 Agent 范围覆盖同名全局贡献并拒绝未解析变量或冲突组合
配置与默认行为
- includeHarnessIdentity：默认 true
- includeRuntimeContext：默认 true
- personaPrefix：默认 ''
- personaSuffix：默认 ''
- toolOrder：未设置；具体省略行为见 README
限制与使用条件
- 部署人设文本通过配置与组合提供，本包不替代 Agent 的运行控制
类型化工具注册与执行@deepseek-ai/dsh-tools
以 defineTool 声明参数、结果、timeoutMs 预算、并行安全与展示。校验模型调用并执行 allow、deny、ask 策略。
dsh-tools · 接口摘录，省略上下文 · ctx.tools.register · packages/core/tools/README.md · ctx.tools.guard · packages/core/tools/README.md// 工具插件登记定义，返回可撤销注册；模型可见描述由注册表参与组装。
const dispose = ctx.tools.register(definition)
// 策略插件注册同步单向拒绝检查；后续监听器不能把已拒绝调用改成允许。
const dispose = ctx.tools.guard(guard)具体能力
- 以 defineTool 声明参数、结果、timeoutMs 预算、并行安全与展示
- 校验模型调用并执行 allow、deny、ask 策略
- 将普通工具失败作为最终结果返回，支持原生或 PTC 呈现
配置与默认行为
- mode：默认 native
- maxParallelSubCalls：默认 10
限制与使用条件
- 并行策略直接读取工具定义，不能用普通事件监听器改写判定
- timeoutMs 只是工具预算，实际协作超时由 tool-call-timeout-policy 执行
人工授权流程接口@deepseek-ai/dsh-authorization
发起需要浏览器登录、代码输入或问答的凭据流程。只向发起表面发送提示和通知。
具体能力
- 发起需要浏览器登录、代码输入或问答的凭据流程
- 只向发起表面发送提示和通知
- 凭据成功写入所组合的存储后才报告授权成功，并区分取消与失败
限制与使用条件
- 授权尝试不能恢复，浏览器刷新会放弃当前流程
- 本包不内置提供者专用授权方法，需要组合存储及集成方法注册
凭据引用与记录接口@deepseek-ai/dsh-credentials
用命名引用把秘密值移出配置文档。存储插件授权记录和提供者环境值。
// 每次操作重新解析凭据，返回当前值与来源，跨操作不可缓存。
abstract resolve(ref: CredentialRef): Promise<ResolvedCredential | undefined>具体能力
- 用命名引用把秘密值移出配置文档
- 存储插件授权记录和提供者环境值
- 允许界面查询来源、可写性及是否设置而不返回秘密
限制与使用条件
- 不提供引用枚举，配置界面须从自己的设置 schema 获知引用
本机私有凭据存储@deepseek-ai/dsh-credentials-local
在 Harness home 私有文件持久保存密钥。默认监听凭据文件变化并重新加载文件值。
具体能力
- 在 Harness home 私有文件持久保存密钥
- 默认监听凭据文件变化并重新加载文件值
- 按启动环境、凭据文件、项目 .env、home .env 的来源优先级解析
配置与默认行为
- path：默认 <harness home>/.credentials.yaml
- dshHome：默认 $DSH_HOME or ~/.dsh
- watch：默认 true
- debounceMs：默认 100
限制与使用条件
- 同一引用并发写入最后写入者生效，同用户 Agent 进程仍能读取秘密
- 环境快照在启动时冻结并优先于文件，环境来源凭据轮换需要重启
账户身份与授权服务@deepseek-ai/dsh-deepseek-account
读取登录状态并发起或取消浏览器登录。退出登录并为指定推理来源解析账户凭据。
具体能力
- 读取登录状态并发起或取消浏览器登录
- 退出登录并为指定推理来源解析账户凭据
- 读取已有设备、账户标识和登录 OS 版本而不创建设备或返回凭据
限制与使用条件
- 账户令牌没有过期与刷新流程，远程退出失败不会恢复本地登录
平台浏览器登录提供者@deepseek-ai/dsh-deepseek-account-platform
通过系统浏览器登录并存入已有凭据库。本地取消后阻止迟到回调或换票响应重新登录。
具体能力
- 通过系统浏览器登录并存入已有凭据库
- 本地取消后阻止迟到回调或换票响应重新登录
- 校验现有设备记录并仅暴露非秘密身份信息
限制与使用条件
- 仅支持带明确端口的本机 HTTP 回环或 SSH 本地转发，不支持非回环反向代理
最终文件交付声明@deepseek-ai/dsh-tool-present
用 present 声明会话文件系统中已有最终文件。记录路径及可选说明而不复制内容。
// 声明已存在且可访问的普通文件，卡片读取源路径当前内容。
{ "files": [{ "path": "report.md", "description": "检查报告" }] }具体能力
- 用 present 声明会话文件系统中已有最终文件
- 记录路径及可选说明而不复制内容
- 允许用户在默认应用打开当前源文件
配置与默认行为
- maxFiles：默认 8
限制与使用条件
- 源文件移动或删除后声明不能打开，Session ZIP 只含声明不含文件内容
回合文件变更对照@deepseek-ai/dsh-workspace-changes
为有工作目录且无 subagent origin 的根会话比较回合开始与结束的 Git 工作树快照。仅对不超过 maxFileBytes 的文件捕获首次文件工具修改前及回合结束后的完整副本。
// 读取活动会话某次变更摘要中指定文件的回合前后比较。
diff(sessionId: SessionId, seq: number, index: number, signal: AbortSignal): Promise<WorkspaceFileDiff | undefined>具体能力
- 为有工作目录且无 subagent origin 的根会话比较回合开始与结束的 Git 工作树快照
- 仅对不超过 maxFileBytes 的文件捕获首次文件工具修改前及回合结束后的完整副本
- 对可比较文件提供行数与前后对照，并记录 workspace/changes 事件
配置与默认行为
- timeoutMs：默认 30000
- outputMaxBytes：默认 8388608
- maxFiles：默认 500
- maxFileBytes 默认2097152（2 MiB），限制完整副本捕获及从快照读取对照内容的单文件字节数
- diffTimeoutMs：默认 100
限制与使用条件
- 摘要和对照仅保留至当前宿主中的会话释放时
- 无 Git 时仅覆盖文件工具修改；不记录子代理会话
- 超过 maxFileBytes 不提供对照；文件工具捕获项不保存超大副本，并以 oversized 列出而无计数
Office 文档转 PDF@deepseek-ai/dsh-office-to-pdf
在宿主转换 DOC、DOCX、XLS、XLSX、PPT 与 PPTX。已声明原生引擎的平台使用原生 LibreOffice，其余用 Node WASM。
具体能力
- 在宿主转换 DOC、DOCX、XLS、XLSX、PPT 与 PPTX
- 已声明原生引擎的平台使用原生 LibreOffice，其余用 Node WASM
- OOXML 结果返回缺失字体名称
配置与默认行为
- maxConcurrentConversions：默认 2
- timeoutMs：默认 60000
- maxInputBytes：默认 52428800
- maxOutputBytes：默认 104857600
- maxImageResolution：默认 192
- fontFallbacks：默认 转换工具包默认值
限制与使用条件
- 不搜索系统 LibreOffice 或运行时下载引擎，排队时间不计入 timeoutMs
持久 Agent 团队协作@deepseek-ai/dsh-experimental-agent-team
把主会话设为 Lead 并创建具名队友。持久交换消息并维护共享任务板。
具体能力
- 把主会话设为 Lead 并创建具名队友
- 持久交换消息并维护共享任务板
- 队友恢复后接收离线期间排队消息
配置与默认行为
- maxMembers：默认 16
- maxTasks：默认 256
- maxPendingMessagesPerMember：默认 64
- maxMessageBytes：默认 65,536
- disposalTimeoutMs：默认 5,000
限制与使用条件
- 需要持久会话存储，自身不注册工具
- 成员或任务变更广播完整视图
Agent 团队实验组合@deepseek-ai/dsh-experimental-agent-team-profile
一次装配团队服务、模型工具和 Web 界面。支持查看成员、共享任务与队友会话。
具体能力
- 一次装配团队服务、模型工具和 Web 界面
- 支持查看成员、共享任务与队友会话
- 关闭普通子代理及重叠全局控制，保留 Workflow 新建子代理能力
限制与使用条件
- 属于显式选用的实验组合，没有稳定性承诺
录音识别远程接口@deepseek-ai/dsh-experimental-api-speech-to-text
通过 speech Remote 连接浏览器和语音识别服务。发现可用语音提供者及其限制。
具体能力
- 通过 speech Remote 连接浏览器和语音识别服务
- 发现可用语音提供者及其限制
- 提交完整录音并返回转写结果
限制与使用条件
- 不提供文件上传、持久转写历史或流式识别协议
模型辅助工具审批@deepseek-ai/dsh-experimental-auto-review
在当前会话权限选择器增加 Auto review。调用当前 Agent 模型评估原生和 PTC 内层工具。
具体能力
- 在当前会话权限选择器增加 Auto review
- 调用当前 Agent 模型评估原生和 PTC 内层工具
- 允许时完整访问执行，拒绝时转向人工批准
限制与使用条件
- 没有文件沙箱，外层 run_code 和直接 Node 效果不经过内层工具审查
- 分类可能出错并消耗额外 token
Chrome DevTools 浏览器接入@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp
通过上游 MCP 工具检查和操作 Chromium。会话创建或恢复完成前建立连接并跨回合保留。
具体能力
- 通过上游 MCP 工具检查和操作 Chromium
- 会话创建或恢复完成前建立连接并跨回合保留
- 启动独立浏览器或单会话附着到保留登录状态的浏览器
配置与默认行为
- mode：必填，无插件默认值
- headless：默认 true
- executablePath：默认 上游自动发现
- endpoint：attach 模式必填
- toolCallTimeoutMs：默认 MCP 客户端默认值
限制与使用条件
- 只支持 Chromium，连接断开不自动重试
Playwright 浏览器接入@deepseek-ai/dsh-experimental-browser-use-playwright-mcp
通过 Playwright MCP 检查和操作 Chromium。在会话接纳前发现工具并保持连接跨回合使用。
具体能力
- 通过 Playwright MCP 检查和操作 Chromium
- 在会话接纳前发现工具并保持连接跨回合使用
- 支持独立浏览器或独占附着现有浏览器标签
配置与默认行为
- mode：必填，无插件默认值
- headless：默认 true
- executablePath：默认 上游自动发现
- endpoint：attach 模式必填
- toolCallTimeoutMs：默认 MCP 客户端默认值
限制与使用条件
- 只支持 Chromium，启动失败或取消会拒绝会话创建或恢复
浏览器会话资源复用库@deepseek-ai/dsh-experimental-browser-use-runtime
按会话复用浏览器并在运行时释放时关闭资源。串行执行同会话操作且允许隔离会话并行。
具体能力
- 按会话复用浏览器并在运行时释放时关闭资源
- 串行执行同会话操作且允许隔离会话并行
- 独占保留附着浏览器并在首个模型请求前发现 MCP 工具
限制与使用条件
- 提供者不接管已有活动 Agent，同次激活不会重试繁忙附着
Stagehand 原生浏览器操作@deepseek-ai/dsh-experimental-browser-use-stagehand-native
浏览标签、导航并捕获截图。用单独配置的原生模型执行动作、发现动作和提取数据。
具体能力
- 浏览标签、导航并捕获截图
- 用单独配置的原生模型执行动作、发现动作和提取数据
- 为活动会话创建浏览器或独占附着指定实例
配置与默认行为
- mode：默认 launch
- cdpEndpoint：attach 模式必填
- extensionId：默认 加载随包扩展
- executablePath：默认 已安装的稳定版 Chrome
- headless：默认 true
- operationTimeoutMs：默认 30000
- model.modelName：必填，无插件默认值
- model.apiKey：必填，无插件默认值
- model.headers：默认 None
- shutdownGraceMs：默认 5000
限制与使用条件
- 只支持 Chromium，重放会话记录不恢复活动浏览器状态
团队成员与任务界面@deepseek-ai/dsh-experimental-client-ui-agent-team
在会话页头增加团队入口。从 Lead 会话投影实时显示成员和任务板。
具体能力
- 在会话页头增加团队入口
- 从 Lead 会话投影实时显示成员和任务板
- 沿稳定子会话路径进入队友对话
限制与使用条件
- 不显示邮箱消息时间线，已有页面后启用插件需刷新接收投影
浏览器语音输入界面@deepseek-ai/dsh-experimental-client-ui-voice-input
在输入框提供麦克风与实时音量录音工具栏。停止录音后将识别文字写入草稿。
具体能力
- 在输入框提供麦克风与实时音量录音工具栏
- 停止录音后将识别文字写入草稿
- 在插件设置管理识别偏好、语言与模型准备
限制与使用条件
- 不会自动发送，不提供常开麦克风、唤醒词、流式字幕或语音合成
Cua Driver MCP 桌面接入@deepseek-ai/dsh-experimental-computer-use-cua-driver-mcp
连接已经安装的 Cua Driver。通过 MCP 暴露驱动自己的工具描述、参数与结果。
具体能力
- 连接已经安装的 Cua Driver
- 通过 MCP 暴露驱动自己的工具描述、参数与结果
- 在连接与工具完成关闭前保持桌面提供者占用
配置与默认行为
- command：默认 cua-driver
- args：默认 [mcp]
- toolCallTimeoutMs：默认 MCP 客户端默认值
- reconnect：默认 MCP 客户端策略
限制与使用条件
- 安装和桌面权限由外部驱动负责，并发会话工作流需调用者协调
Cua Driver 原生桌面接入@deepseek-ai/dsh-experimental-computer-use-cua-driver-native
在宿主进程中使用原生 npm 驱动操作桌面窗口。暴露上游驱动工具而无需单独 CLI。
具体能力
- 在宿主进程中使用原生 npm 驱动操作桌面窗口
- 暴露上游驱动工具而无需单独 CLI
- 用持久附件把截图送给支持图像的模型
限制与使用条件
- npm 安装不授予桌面权限，也不会创建图形会话
宿主与客户端调试检查器@deepseek-ai/dsh-experimental-inspector
在 Chrome DevTools 查看宿主与客户端 Console。调试宿主 Sources 并捕获宿主 fetch 请求。
具体能力
- 在 Chrome DevTools 查看宿主与客户端 Console
- 调试宿主 Sources 并捕获宿主 fetch 请求
- 通过 Worker 传输验证后的 Cordis 树快照
配置与默认行为
- host：默认 127.0.0.1
- port：默认 9230
- clientOrigins：默认 []
- captureFetch：默认 true
- maxRequestBodyBytes：默认 8 MiB
- maxResponseBodyBytes：默认 32 MiB
- maxBodyChunkBytes：默认 48 KiB
- maxJournalBytes：默认 256 MiB
- maxRetainedRequests：默认 2000
- maxSourceFrameBytes：默认 128 KiB
- maxSourceRecordsPerFrame：默认 128
- maxQueuedRecords：默认 2048
- maxQueuedBytes：默认 16 MiB
- startupTimeoutMs：默认 10 seconds
- stopTimeoutMs：默认 5 seconds
- clientReconnectBaseMs：默认 250 ms
- clientReconnectMaxMs：默认 5 seconds
- clientRuntimeTimeoutMs：默认 30 seconds
- queryTimeoutMs：默认 10 seconds
- maxClientRuntimeObjects：默认 10000
- maxClientRuntimeProperties：默认 2000
- maxClientSourceBytes：默认 8 MiB
- maxCordisNodes：默认 2048
- maxDisconnectedCordisTrees：默认 8
限制与使用条件
- 不支持客户端脚本主动调试，客户端仅提供控制台、求值和只读 Sources 等能力
实验 Python 程序工具运行时@deepseek-ai/dsh-experimental-ptc-runtime-python
每次请求创建全新 CPython 3.10+ 子进程。执行顶层 await 与 return 并调用配置的工具绑定。
具体能力
- 每次请求创建全新 CPython 3.10+ 子进程
- 执行顶层 await 与 return 并调用配置的工具绑定
- 保留标准输出错误并用预算和进程组清理限制失控任务
限制与使用条件
- 子进程不是安全沙箱，直接 Python 操作不受文件隔离且运行间不保留状态
定时跟进实验组合@deepseek-ai/dsh-experimental-schedule-bundle
组合 time-context 为模型提供当前时间。挂载 schedule 服务管理自动任务。
具体能力
- 组合 time-context 为模型提供当前时间
- 挂载 schedule 服务管理自动任务
- 挂载 ui-schedule 提供浏览器任务界面
限制与使用条件
- 三行需要配合工作，关掉服务会使任务界面失去后端
语音识别服务接口@deepseek-ai/dsh-experimental-speech-to-text
按名称选择独立注册的识别提供者。让消费者在执行前解析请求。
具体能力
- 按名称选择独立注册的识别提供者
- 让消费者在执行前解析请求
- 统一完整录音的转写调用
限制与使用条件
- 仅支持完整录音，不定义流式识别或语音合成方法
本机 CPU 语音识别@deepseek-ai/dsh-experimental-speech-to-text-sensevoice
用 SenseVoiceSmall ONNX 识别录音。用 Silero VAD 检测语音并通过 sherpa-onnx 运行。
具体能力
- 用 SenseVoiceSmall ONNX 识别录音
- 用 Silero VAD 检测语音并通过 sherpa-onnx 运行
- 激活时仅检查缓存资源，不加载模型或下载资产
限制与使用条件
- 仅 CPU，Windows ARM64 和 Linux musl 不是已验证部署目标
团队消息与任务工具@deepseek-ai/dsh-experimental-tool-agent-team
让模型创建具名队友、发消息和查看可用状态。等待进展或中断卡住的队友。
具体能力
- 让模型创建具名队友、发消息和查看可用状态
- 等待进展或中断卡住的队友
- 用共享任务板协调工作并向成员提供九个工具
配置与默认行为
- freshProvider：默认 spawn
- forkProvider：默认 fork
限制与使用条件
- 与传统子代理控制复用工具名，组合时必须关闭旧定义
本地语音输入实验组合@deepseek-ai/dsh-experimental-voice-input-bundle
装配语音服务定义和本地 SenseVoice 提供者。加入经过认证的录音 Remote。
具体能力
- 装配语音服务定义和本地 SenseVoice 提供者
- 加入经过认证的录音 Remote
- 挂载浏览器麦克风控件
限制与使用条件
- 初始组合仅提供一个本地识别器，云识别须另装提供者及凭据
浏览器运行镜像打包@deepseek-ai/dsh-experimental-webworker-packer
把已组合 profile 打成 gzip 基础 tar 文件系统镜像。把不透明数据树打成有序覆盖层 tar。
具体能力
- 把已组合 profile 打成 gzip 基础 tar 文件系统镜像
- 把不透明数据树打成有序覆盖层 tar
- 封装仓库真实构建产物以使预览与部署产物一致
限制与使用条件
- 不会从源码编译，新资产类别需明确加入打包规则表
浏览器 Worker 宿主@deepseek-ai/dsh-experimental-webworker-runtime
在单个 Web Worker 中运行整棵 Harness 插件树。解压 VFS 镜像到内存并通过 CommonJS 包装加载模块。
具体能力
- 在单个 Web Worker 中运行整棵 Harness 插件树
- 解压 VFS 镜像到内存并通过 CommonJS 包装加载模块
- 经 postMessage 隧道提供普通 HTTP 页面服务
限制与使用条件
- 不含 Zstandard 编解码器，会话日志使用未压缩 JSONL
动态定义客户端运行器@deepseek-ai/dsh-cordis-client-runner
在批准或显式用户操作后加载动态定义的浏览器部分。供程序调用者和已有浏览器控件操作。
具体能力
- 在批准或显式用户操作后加载动态定义的浏览器部分
- 供程序调用者和已有浏览器控件操作
- 宿主撤回运行时移除定义
限制与使用条件
- 页面刷新不恢复动态定义，过期成功回执被拒绝后不自动重试
动态定义宿主运行器@deepseek-ai/dsh-cordis-host-runner
在 node:vm 域运行进程内定义的宿主部分。向工具提供运行时 API 检查注册表。
具体能力
- 在 node:vm 域运行进程内定义的宿主部分
- 向工具提供运行时 API 检查注册表
- 把浏览器部分交给客户端运行器和批准界面
配置与默认行为
- vmTimeoutMs：默认 5000
限制与使用条件
- 定义在重启后消失，加载成功回执不代表 React 已成功渲染
运行时 API 只读检查工具@deepseek-ai/dsh-tool-cordis
检查宿主可用服务与 API。向连接的浏览器查询客户端 API。
具体能力
- 检查宿主可用服务与 API
- 向连接的浏览器查询客户端 API
- 在 Creator 编写插件前发现 Loader 配置
限制与使用条件
- 不能调用服务方法、配置插件或执行生成代码，客户端查询等待可响应页面
历史动态插件与运行控制界面@deepseek-ai/dsh-client-ui-cordis
渲染历史生成插件卡片。为程序提供的进程内定义显示操作面板。
具体能力
- 渲染历史生成插件卡片
- 为程序提供的进程内定义显示操作面板
- 重启后仍显示持久卡片而不重建定义
限制与使用条件
- 没有发布注册表变化事件的操作不会立即刷新已打开面板
会话意见记录命令@deepseek-ai/dsh-command-feedback
用 /feedback 记录用户对会话的意见。接受 Web 分类和可选说明并返回会话及匿名用户标识。
具体能力
- 用 /feedback 记录用户对会话的意见
- 接受 Web 分类和可选说明并返回会话及匿名用户标识
- 拥有固定反馈分类且不触发或打断模型工作
限制与使用条件
- 没有反馈检索或管理界面，headless、ACP 与 JSON-RPC 无斜杠命令入口
助手消息评价服务@deepseek-ai/dsh-message-feedback
为已完成助手消息记录赞踩、分类及原文备注。通过 list、put、delete 获取修改当前评价。
具体能力
- 为已完成助手消息记录赞踩、分类及原文备注
- 通过 list、put、delete 获取修改当前评价
- 把创建、修改和删除写入规范会话日志且不进入模型历史
配置与默认行为
- maxNoteBytes：必填，无插件默认值
限制与使用条件
- 不读取或迁移旧 sidecar 评价，删除当前值仍保留历史事件
统一文件系统服务接口@deepseek-ai/dsh-fs
解析稳定文件身份并按后端能力映射共享宿主文件。提供有界文本与字节读取、目录列表和监听。
具体能力
- 解析稳定文件身份并按后端能力映射共享宿主文件
- 提供有界文本与字节读取、目录列表和监听
- 定义原子文本写入、字面替换及可选版本守卫
限制与使用条件
- 写入与编辑仅支持文本，文本读取和修改拒绝二进制内容
本机文件系统提供者@deepseek-ai/dsh-fs-local
解析本机路径与符号链接到统一身份。读取列举监听文件并执行原子文本写入和替换。
具体能力
- 解析本机路径与符号链接到统一身份
- 读取列举监听文件并执行原子文本写入和替换
- 保留权限并用可选版本守卫拒绝陈旧覆盖
配置与默认行为
- cwd：默认 process.cwd()
- diffBasisMaxBytes：默认 10 MiB
限制与使用条件
- cwd 只是相对路径默认基准，绝对路径与父目录访问不受其隔离
先读后写与版本保护@deepseek-ai/dsh-fs-observation-policy
要求通过 read 工具观察现有文件版本后才能覆盖或编辑。文件在读取后变化时拒绝修改并要求重读。
具体能力
- 要求通过 read 工具观察现有文件版本后才能覆盖或编辑
- 文件在读取后变化时拒绝修改并要求重读
- 允许读取不存在路径后进行受并发创建保护的新建
限制与使用条件
- 窗口读取也能授权整文件写入，只核对版本而不保证已读全文
- 直接 ctx.fs 读取不登记 observed，read 工具才登记
- 观察记录不持久，恢复会话后需要重新读取目标
文件修改策略隔离@deepseek-ai/dsh-fs-sandbox
read-only 拒绝所有文件修改。workspace-write 只允许工作区和平台临时目录修改。
具体能力
- read-only 拒绝所有文件修改
- workspace-write 只允许工作区和平台临时目录修改
- danger-full-access 不限制修改并对拒绝返回稳定错误与当前模式
限制与使用条件
- 这是可信代码中的策略检查，不是内核安全隔离
- 读取仍遵循本地后端行为
文本图像读取与文件编辑工具@deepseek-ai/dsh-tool-fs
读取带行号的 UTF-8 文本及支持格式的图像。创建或原子替换文件并执行定向字面编辑。
dsh-tool-fs · 接口摘录，省略上下文 · read · packages/fs/tool-fs/README.md// 模型以文件路径和可选行范围请求正文；tool-fs 解释参数并调用文件服务。
{"file_path":"README.md","offset":1,"limit":40}具体能力
- 读取带行号的 UTF-8 文本及支持格式的图像
- 创建或原子替换文件并执行定向字面编辑
- 限制返回大小并为错误提供稳定代码和恢复说明
限制与使用条件
- 没有模型可见目录列表工具，图像读取需要持久附件与支持图像的模型路由
本地路径与内容搜索工具@deepseek-ai/dsh-tool-fs-search
提供 glob 文件发现与 grep 内容搜索。无需宿主 rg 安装并包含隐藏及忽略文件而排除版本控制元数据。
具体能力
- 提供 glob 文件发现与 grep 内容搜索
- 无需宿主 rg 安装并包含隐藏及忽略文件而排除版本控制元数据
- 以配置限制行内结果并可把完整结果写入 spill
限制与使用条件
- 搜索命名空间与文件提供者不自动保证一致，部署须自行对齐
单入口文本编辑工具@deepseek-ai/dsh-tool-str-replace-editor
view 显示编号文本或浅层目录。create 创建文件、str_replace 执行唯一字面替换。
具体能力
- view 显示编号文本或浅层目录
- create 创建文件、str_replace 执行唯一字面替换
- insert 在指定行边界插入内容并服从已挂载读取观察与沙箱策略
限制与使用条件
- 仅支持 UTF-8 文本，不支持二进制文件
长期目标交互命令@deepseek-ai/dsh-command-goal
用 /goal 创建、编辑、暂停、恢复、清除或检查目标。命令与直接结果仅留在界面而不进入模型请求。
具体能力
- 用 /goal 创建、编辑、暂停、恢复、清除或检查目标
- 命令与直接结果仅留在界面而不进入模型请求
- 创建或编辑的附件可作为普通用户消息供后续目标回合读取
限制与使用条件
- 需要交互命令适配器，headless 等未提供该适配器的入口不适用
持久长期目标服务@deepseek-ai/dsh-goal
每个会话保存一个跨回合与重启的完成目标。以比较交换拒绝陈旧修改并支持暂停、恢复、完成和阻塞。
dsh-goal · 接口摘录，省略上下文 · ctx.goals.create · docs/subsystems/goal.md · ctx.goals.resume · docs/subsystems/goal.md// 在会话日志中创建目标，并激活当前进程的自动续轮授权。
create(agent: Agent, request: CreateGoalRequest): GoalView
// 按精确目标版本恢复并激活续轮，恢复会话后需明确人类授权。
resume(agent: Agent, ref: GoalRef): GoalView具体能力
- 每个会话保存一个跨回合与重启的完成目标
- 以比较交换拒绝陈旧修改并支持暂停、恢复、完成和阻塞
- 保存轮数上限、修订号及阻塞策略原因
配置与默认行为
- defaultMaxGoalRounds：默认 256
- defaultMaxGoalRounds 默认 256，为正安全整数；显式创建参数可覆盖
限制与使用条件
- 只存储和提供目标，不调度执行
- 自动继续授权只在进程内有效
长期目标自动续行@deepseek-ai/dsh-goal-round-driver
在目标已激活且轮数未耗尽时追加后续提示。在 Agent 完成与目标状态间驱动自动继续。
具体能力
- 在目标已激活且轮数未耗尽时追加后续提示
- 在 Agent 完成与目标状态间驱动自动继续
- 让直接用户消息优先并记录目标回合来源
限制与使用条件
- 恢复或分叉后的目标不会凭持久 active 状态自行重新授权续行
长期目标模型工具@deepseek-ai/dsh-tool-goal
向模型提供 create_goal、get_goal 和 update_goal。根据直接用户请求创建或恢复长期目标。
具体能力
- 向模型提供 create_goal、get_goal 和 update_goal
- 根据直接用户请求创建或恢复长期目标
- 使用目标标识与修订号更新状态以避免陈旧覆盖
限制与使用条件
- 编辑、暂停和恢复要求直接用户请求，不能以任意自动续行代替授权
重复工具调用提醒@deepseek-ai/dsh-repeat-tool-reminder
监测同一工具与相同参数的连续调用。达到阈值后把用户形式提醒加入模型上下文。
具体能力
- 监测同一工具与相同参数的连续调用
- 达到阈值后把用户形式提醒加入模型上下文
- 让 Agent 调整策略而不直接终止工具执行
配置与默认行为
- thresholds：默认 [3, 5, 8]
- include：默认 []
- exclude：默认 []
- argumentsPreviewChars：默认 500
限制与使用条件
- 只比较调用签名，不判断不同参数操作在语义上是否重复
工具协作超时执行策略@deepseek-ai/dsh-tool-call-timeout-policy
读取各工具定义的 timeoutMs 预算。超时时中止为该调用派生的取消信号。
具体能力
- 读取各工具定义的 timeoutMs 预算
- 超时时中止为该调用派生的取消信号
- 等待下游执行收敛后返回 TOOL_TIMEOUT
配置与默认行为
- 无插件配置或全局超时默认，各工具自行声明 timeoutMs
限制与使用条件
- 无后台转换或硬终止；下游忽略取消时仍继续等待
外部命令钩子执行协议@deepseek-ai/dsh-hook-protocol
用稳定 JSON 输入输出协议运行外部钩子。提供超时、输出限制和错误解析。
具体能力
- 用稳定 JSON 输入输出协议运行外部钩子
- 提供超时、输出限制和错误解析
- 供 Claude Code 与 Codex 桥接复用命令执行基础
限制与使用条件
- 只承载协议与执行机制，不决定各宿主支持哪些钩子事件
Claude Code 命令钩子桥@deepseek-ai/dsh-hooks-claude-code
读取现有 Claude Code 配置中的受支持命令钩子。在提示和工具执行等阶段运行命令。
// 兼容钩子在工具执行前运行命令，可阻止工具或要求审批。
PreToolUse具体能力
- 读取现有 Claude Code 配置中的受支持命令钩子
- 在提示和工具执行等阶段运行命令
- 将阻止原因或附加上下文记录为模型可见事实
配置与默认行为
- configPath：必填，无插件默认值
- pluginRoot：未设置；具体省略行为见 README
- projectDir：默认 会话工作区
- defaultTimeoutMs：默认 600,000
- stderrSummaryMaxChars：默认 500
限制与使用条件
- 只支持当前30种 Claude Code 事件中的7种，不是完整兼容实现
Codex 命令钩子桥@deepseek-ai/dsh-hooks-codex
加载现有 hooks.json 的命令钩子。支持会话开始、提示提交、工具前后与停止五个阶段。
具体能力
- 加载现有 hooks.json 的命令钩子
- 支持会话开始、提示提交、工具前后与停止五个阶段
- 允许阻止提示或工具、追加上下文或要求继续一步
配置与默认行为
- configPath：必填，无插件默认值
- model：默认 ''
- defaultTimeoutMs：默认 600,000
- stderrSummaryMaxChars：默认 500
限制与使用条件
- 当前10种 Codex 事件仅支持5种，其他行为应使用原生插件
宿主目录选择接口@deepseek-ai/dsh-host-directory-picker
为 GUI 提供原生选择器与应用内浏览两种交互。向消费者返回当前交互类型以选择界面。
具体能力
- 为 GUI 提供原生选择器与应用内浏览两种交互
- 向消费者返回当前交互类型以选择界面
- 定义一次目录树浏览和选择结果
限制与使用条件
- 不支持多根目录浏览，不影响 Agent 执行循环
目录选择器自动装配@deepseek-ai/dsh-host-directory-picker-auto
启动时采样宿主环境选择 native 或 browse。把匹配后端及浏览器部分挂为真实 Loader 条目。
具体能力
- 启动时采样宿主环境选择 native 或 browse
- 把匹配后端及浏览器部分挂为真实 Loader 条目
- 仅在回环绑定、非 SSH 且存在显示会话时选择 native
限制与使用条件
- 只在启动时判断且无法证明操作者实际位置，生命周期内不自动切换
宿主目录浏览提供者@deepseek-ai/dsh-host-directory-picker-browse
通过 Node 提供单层按名称排序的目录列表。跟随指向目录的符号链接并标识隐藏项。
具体能力
- 通过 Node 提供单层按名称排序的目录列表
- 跟随指向目录的符号链接并标识隐藏项
- 校验单路径片段后非递归创建子目录
配置与默认行为
- maxEntries：默认 1,000
限制与使用条件
- Windows 隐藏属性不读取，隐藏标识仅按名称规则判断
本机系统目录选择提供者@deepseek-ai/dsh-host-directory-picker-native
每次选择启动一个平台原生目录选择器。返回选中绝对路径或取消的 null。
具体能力
- 每次选择启动一个平台原生目录选择器
- 返回选中绝对路径或取消的 null
- 在 macOS 用 osascript、Linux 用 Zenity/KDialog、Windows 用子进程 IFileOpenDialog
限制与使用条件
- Linux 未安装 Zenity 或 KDialog 时调用失败，需要操作者可访问宿主显示器
构建前端静态服务@deepseek-ai/dsh-host-frontend-static
从配置发行目录提供构建后的 Web shell。为入口注入启动信息并要求进程令牌或浏览器会话。
具体能力
- 从配置发行目录提供构建后的 Web shell
- 为入口注入启动信息并要求进程令牌或浏览器会话
- 直接提供资源并对缺失、路径穿越和不支持方法返回对应错误
限制与使用条件
- 没有源码服务回退，必须存在前端构建产物
宿主外部应用启动@deepseek-ai/dsh-host-open-in-app
发现宿主可用的编辑器与文件应用。按应用打开工作区或文件。
具体能力
- 发现宿主可用的编辑器与文件应用
- 按应用打开工作区或文件
- 将文件系统身份映射到宿主路径再调用平台打开能力
配置与默认行为
- probeTimeoutMs：必填，无插件默认值
- iconTimeoutMs：必填，无插件默认值
- launchWatchMs：必填，无插件默认值
限制与使用条件
- 没有宿主路径映射的远程文件不能直接启动本机应用
运行插件清单查询@deepseek-ai/dsh-host-plugin-inventory
读取 Loader 活动树中的插件实例。投影配置来源、运行状态、启用条件及发现失败。
具体能力
- 读取 Loader 活动树中的插件实例
- 投影配置来源、运行状态、启用条件及发现失败
- 为 Agent 预设与全局插件提供只读清单
限制与使用条件
- 这是查询快照而非自动订阅，也不修改插件配置
产品交互遥测导出@deepseek-ai/dsh-host-product-telemetry-otel
接收客户端产品交互事件。通过已有 OTel 管道导出产品数据。
具体能力
- 接收客户端产品交互事件
- 通过已有 OTel 管道导出产品数据
- 按可用登录身份补充非秘密标识
配置与默认行为
- endpoint：默认 https://dsh-otel-collector.deepseeksvc.com/v1/logs
- serviceName, serviceVersion：必填，无插件默认值
- channel：默认 dsh_otel_report
- compression：默认 SDK 环境值
- maxExportBatchSize, maxQueueSize：默认 512, 2048
- scheduledDelayMillis：默认 30000
- timeoutMillis：默认 15000
- exportTimeoutMillis：默认 20000
- shutdownTimeoutMillis：默认 21000
限制与使用条件
- 导出为尽力而为，不提供持久发件箱或仓库确认
宿主 HTTP 路由与升级入口@deepseek-ai/dsh-host-webserver
提供 HTTP 路由、WebSocket upgrade、index 与 fallback 扩展点。以默认回环监听承载宿主网络入口。
// 注册具名 HTTP 路由并返回撤销函数，由功能插件拥有响应处理。
register(route: WebRoute): () => void具体能力
- 提供 HTTP 路由、WebSocket upgrade、index 与 fallback 扩展点
- 以默认回环监听承载宿主网络入口
- 将具体请求处理交给所注册的上层插件
配置与默认行为
- 监听默认 127.0.0.1；可配置 0.0.0.0，但远程暴露的安全由上层与部署负责
限制与使用条件
- 不提供 TLS、认证或 Origin 检查；上层插件与部署负责访问安全
匿名用户持久标识@deepseek-ai/dsh-anonymous-user-id
为 Harness 安装提供稳定匿名用户标识。通过存储保持跨重启一致。
具体能力
- 为 Harness 安装提供稳定匿名用户标识
- 通过存储保持跨重启一致
- 供反馈和遥测关联同一安装而不要求账户登录
限制与使用条件
- 匿名标识不是认证凭据，不能证明操作者身份
交互命令注册服务@deepseek-ai/dsh-commands
注册面向人的斜杠命令及参数目录。把命令调用路由到相应处理器。
具体能力
- 注册面向人的斜杠命令及参数目录
- 把命令调用路由到相应处理器
- 让宿主入口执行命令而无需模型先决定调用
限制与使用条件
- 需要具体宿主命令适配器，不自动给所有协议入口添加命令
会话权限预设组合@deepseek-ai/dsh-permission-presets
把沙箱模式与批准策略组合为可选权限预设。允许切换当前会话并设置未来会话默认。
具体能力
- 把沙箱模式与批准策略组合为可选权限预设
- 允许切换当前会话并设置未来会话默认
- 通过持久事件向模型与界面说明当前策略
配置与默认行为
- presets：默认 workspace-write, danger-full-access
- defaultPreset：默认 inferred
限制与使用条件
- 预设只组合沙箱与批准已有机制，不能替代实际隔离后端
- 默认仅影响未来会话，不修改已恢复 seed；Auto 不能作为未来默认
- 恢复 Auto 要求实时注册和 admission 通过，否则失败而不降级为 Full access
模型结构化问答工具@deepseek-ai/dsh-tool-ask-user
用 ask_user_question 提交一个或多个选择或确认问题。等待人类接受回答并返回紧凑 JSON。
具体能力
- 用 ask_user_question 提交一个或多个选择或确认问题
- 等待人类接受回答并返回紧凑 JSON
- 回合取消时终止等待，没有回答器时返回错误
限制与使用条件
- 其他 Agent 拥有的活动子代理不能调用，待问答会阻塞该工具调用
一次性敏感操作批准@deepseek-ai/dsh-user-approval
在 ask 策略下请求人工或机器一次批准。never 策略直接拒绝，回答器缺失或失败时关闭操作。
// 请求一次动作审批并记录审计，只有 allowed-once 授权执行。
async request(req: ApprovalRequest): Promise<ApprovalOutcome>具体能力
- 在 ask 策略下请求人工或机器一次批准
- never 策略直接拒绝，回答器缺失或失败时关闭操作
- 把请求与结果写入所属会话审计日志
配置与默认行为
- policy：默认 ask
限制与使用条件
- 请求只可发生在打开回合内，批准不能复用到另一请求
结构化用户问题接口@deepseek-ai/dsh-user-questions
让工具或权限插件挂起操作等待人类决定。统一问题、选项和返回答案的结构。
具体能力
- 让工具或权限插件挂起操作等待人类决定
- 统一问题、选项和返回答案的结构
- 通过可接受请求的瀑布回答器接入不同界面
限制与使用条件
- Web 回答要求活动 Agent 作用域，无 Agent 调用需本地无作用域监听器
后台作业服务接口@deepseek-ai/dsh-jobs
给长任务稳定的 kind-N 标识。按所属 Agent 限制输出读取、等待和取消。
dsh-jobs · 接口摘录，省略上下文 · ctx.jobs.start · docs/subsystems/jobs.md · ctx.jobs.read · docs/subsystems/jobs.md// 先预检权限与控制器，再原子注册生产者启动的后台作业。
abstract start(spec: JobSpec): JobId
// 按所有者读取输出并推进模型游标，终态结果仅首次读取携带。
abstract read(id: JobId, caller?: SessionId): JobRead具体能力
- 给长任务稳定的 kind-N 标识
- 按所属 Agent 限制输出读取、等待和取消
- 让用户观察保留输出而不消费模型未读游标
限制与使用条件
- 接口依赖进程内回调和活动 Agent，不提供跨重启作业保证
进程内后台作业执行@deepseek-ai/dsh-jobs-local
在 Agent 继续工作时执行后台任务。限制并发及输出保留并支持增量输出追加。
具体能力
- 在 Agent 继续工作时执行后台任务
- 限制并发及输出保留并支持增量输出追加
- 支持所属 Agent 读取、等待、列出与取消
配置与默认行为
- maxConcurrentJobsPerOwner：默认 10
- retainBytes：默认 262144
- settledRetainBytes：默认 16384
- pumpPollMs：默认 150
限制与使用条件
- 作业记录不跨重启恢复
- dispose 请求取消并等待；忽略取消会阻塞清理且继续占用容量
- cancel 抛错时记录 force-fail，但底层工作仍可能孤留
后台作业读取与控制工具@deepseek-ai/dsh-tool-jobs
用 job_output、job_list 和 job_kill 观察控制任务。读取可在限定时间内等待输出或结束。
具体能力
- 用 job_output、job_list 和 job_kill 观察控制任务
- 读取可在限定时间内等待输出或结束
- 完成时向忙碌 Agent 下一步或空闲 Agent 后续回合投递通知
配置与默认行为
- waitTimeoutMs：默认 30,000
- maxWaitTimeoutMs：默认 600,000
- completionDelivery：默认 wakeup
- maxConsecutiveWakes：未设置；具体省略行为见 README
限制与使用条件
- 流输出由单读取者消费，拥有者释放后待通知不保留
官方请求扩展字段注册@deepseek-ai/dsh-deepseek-llm-api-extensions
让贡献插件声明合并官方请求的顶层字段。在基础请求序列化后准备当前扩展贡献。
具体能力
- 让贡献插件声明合并官方请求的顶层字段
- 在基础请求序列化后准备当前扩展贡献
- 验证提供者专用字段而无需修改基础适配器
限制与使用条件
- 只扩展官方 DeepSeek 请求，不是跨提供者通用输入机制
流式模型与路由服务@deepseek-ai/dsh-llm
通过配置适配器流式调用模型。发现模型并解析能力与调用默认值。
dsh-llm · 接口摘录，省略上下文 · ctx.llm.stream · packages/llm/llm/README.md · ctx.llm.listProviders() · packages/llm/llm/README.md// AgentLoop 或摘要器发起单次提供者尝试，消费流片段并收到一个终止 finish。
for await (const chunk of ctx.llm.stream({
provider: 'deepseek-official',
model: 'deepseek-v4-flash',
messages: [{ role: 'user', content: [{ type: 'text', text: '解释启动方式。' }] }],
})) { /* 处理片段 */ }
// 模型选择器读取已注册路由，结果按注册顺序排列。
const providers = ctx.llm.listProviders()具体能力
- 通过配置适配器流式调用模型
- 发现模型并解析能力与调用默认值
- 每条流以成功、失败或取消终态结束，循环构造请求深冻结
限制与使用条件
- 一次 stream 只发起一次提供者尝试，重试由独立插件负责
DeepSeek Messages 共享传输@deepseek-ai/dsh-llm-deepseek
提供 Messages 请求传输、请求配置与模型能力。为 API key 或账户插件复用认证头和文件上传。
具体能力
- 提供 Messages 请求传输、请求配置与模型能力
- 为 API key 或账户插件复用认证头和文件上传
- 设置更新只影响后续调用，上传复用按端点和认证头哈希隔离
配置与默认行为
- baseURL：默认 https://api.deepseek.com/anthropic
- thinking：默认 enabled
- reasoningEffort：默认 high
- maxTokens：默认 256,000
- defaultContextWindow：默认 1,000,000
- models：默认 V41 Flash 与 V4 Pro 目录
- streamIdleTimeoutMs：默认 300,000
- maxRequestFilesBytes：默认 128 MiB
- maxInlineRequestImageBytes：默认 20 MiB
- maxImagesPerRequest：默认 600
- imageOffloadByteQuantum：默认 64 MiB
- inlineImageOffloadByteQuantum：默认 10 MiB
- imageOffloadCountQuantum：默认 20
- filesApiTimeoutMs：默认 60,000
- fileExpiresAfterSeconds：默认 604,800
- fileRefreshMarginSeconds：默认 3,600
- fileQuotaCleanupBatch：默认 100
- retryPolicy：默认 normal 策略，5次重试
限制与使用条件
- 自身不完成身份选择和提供者注册，须配合账户或 API key 插件
DeepSeek 账户模型路由@deepseek-ai/dsh-llm-deepseek-account
注册 deepseek-account 的认证和模型发现。为请求解析 x-dsh-auth-token。
具体能力
- 注册 deepseek-account 的认证和模型发现
- 为请求解析 x-dsh-auth-token
- 绑定同一令牌处理401并避免旧请求清除新登录
限制与使用条件
- 依赖共享 Messages 传输及已登录账户，账户可用性决定目录可用性
DeepSeek API 密钥模型路由@deepseek-ai/dsh-llm-deepseek-api-key
注册 deepseek-official 认证与模型发现。解析并校验凭据引用的 API key。
具体能力
- 注册 deepseek-official 认证与模型发现
- 解析并校验凭据引用的 API key
- 为 Messages 和 Files 请求统一提供 x-api-key
限制与使用条件
- 依赖共享传输，未配置有效密钥时不能执行需要认证的请求
多提供者与兼容网关模型接入@deepseek-ai/dsh-llm-pi-ai
路由到 pi-ai 提供者、OpenAI 兼容网关或自托管服务。用现有目录默认值或显式自定义协议端点与模型。
具体能力
- 路由到 pi-ai 提供者、OpenAI 兼容网关或自托管服务
- 用现有目录默认值或显式自定义协议端点与模型
- 每请求解析设置凭据，并为支持的 OAuth 使用跨进程刷新锁
配置与默认行为
- apiKeyEnv：未设置；具体省略行为见 README
- displayName：默认 提供者名称
- api：默认 目录中的协议
- baseURL：默认 目录中的端点
- models：默认 已安装目录
- modelOverrides：未设置；具体省略行为见 README
- compat：默认 目录检测结果
- defaultContextWindow：默认 262,144
- defaultMaxTokens：默认 32,768
- requestImagePixelBudget：默认 4,194,304
- requestImageMaxBytes：默认 1 MiB
- maxRequestImageBytes：默认 20 MiB
- retryPolicy：默认 normal 策略，5次重试
限制与使用条件
- 可空路由启动但没有配置路由就没有可调用的该类模型
持久步骤边界模型重试@deepseek-ai/dsh-llm-retry
按提供者策略选择有限普通重试或无限 always 重试。在退避前记录计划重试并在同一回合重跑失败步骤。
dsh-llm-retry · 接口摘录，省略上下文 · agent/request-error · packages/llm/llm-retry/README.md · llm/retry-started · packages/llm/llm-retry/README.md// 重试插件按最终适配器策略处理步骤失败，在同一未结束回合中请求重跑。
'agent/request-error'
// 重试插件在真正开始重试前记录事件，使已安排等待与实际再次尝试可区分。
'llm/retry-started'具体能力
- 按提供者策略选择有限普通重试或无限 always 重试
- 在退避前记录计划重试并在同一回合重跑失败步骤
- 取消时保留一致历史
限制与使用条件
- 仅重试 Agent 回合，直接 llm.stream 调用仍只有一次
- 每次重试另行计费
官方请求活动包清单@deepseek-ai/dsh-plugin-package-inventory-deepseek
读取 Loader 和活动 Agent 的包身份。向官方请求扩展 dsh_plugin_packages。
具体能力
- 读取 Loader 和活动 Agent 的包身份
- 向官方请求扩展 dsh_plugin_packages
- 在请求时提供已挂载包名与版本用于诊断
限制与使用条件
- 程序化子 fiber、内存动态插件和无包身份的散模块不在清单内
确定性上下文用量估算@deepseek-ai/dsh-token-meter
从持久会话日志计算请求压力与单消息代价。提供 tokenUsage、contextPressure 和 contextBreakdown 投影。
具体能力
- 从持久会话日志计算请求压力与单消息代价
- 提供 tokenUsage、contextPressure 和 contextBreakdown 投影
- 仅完全相同请求包络复用提供者用量并按声明规则计价图像
限制与使用条件
- 文本固定启发式并非精确分词，不发模型请求也不决定循环行为
只读代码导航服务@deepseek-ai/dsh-lsp
按文件扩展名选择语言服务提供者。统一定义、引用、实现与悬停文档结果。
具体能力
- 按文件扩展名选择语言服务提供者
- 统一定义、引用、实现与悬停文档结果
- 将后端失败规范化而不改变导航请求
限制与使用条件
- 不包含通用 JSON-RPC、重命名、格式化、诊断或符号列表
本地语言服务器提供者@deepseek-ai/dsh-lsp-stdio
为工作区按需启动显式配置的语言服务器。每次查询重新读取文件而不保留文档状态。
具体能力
- 为工作区按需启动显式配置的语言服务器
- 每次查询重新读取文件而不保留文档状态
- 同服务器工作区串行查询，不同工作区可并行
配置与默认行为
- command：必填，无插件默认值
- extensionToLanguage：必填，无插件默认值
- args：默认 []
- env：默认 {}
- initializationOptions：默认 null
- configuration：默认 null
- maxMessageBytes：默认 16000000
- maxStderrBytes：默认 1000000
- maxDocumentBytes：默认 4000000
- shutdownTimeoutMs：默认 5000
- killGraceMs：默认 2000
限制与使用条件
- 不安装服务器也不提供沙箱，部署需提供命令、映射与隔离
模型语言导航工具@deepseek-ai/dsh-tool-lsp
用 lsp 工具查询定义、引用、实现及悬停。采用从1起计的 UTF-16 行列坐标。
具体能力
- 用 lsp 工具查询定义、引用、实现及悬停
- 采用从1起计的 UTF-16 行列坐标
- 按文件分组并限制结果，标注遗漏或截断
限制与使用条件
- 非 BMP 字符附近的 UTF-16 列需要准确计数，必须有提供者和会话根目录
外部 MCP 服务接入@deepseek-ai/dsh-mcp-client
为配置的 MCP 服务器注册命名空间工具。提供资源访问并把服务器指令记录到系统提示。
具体能力
- 为配置的 MCP 服务器注册命名空间工具
- 提供资源访问并把服务器指令记录到系统提示
- 按调用者作用域发现已配置服务
配置与默认行为
- transport：必填，无插件默认值
- serverName：必填，无插件默认值
- command / args / env / cwd：未设置；具体省略行为见 README
- url / headers：未设置；具体省略行为见 README
- toolCallTimeoutMs：默认 60,000
- maxInstructionBytes：默认 32,768
- failOnStartupError：默认 false
- reconnect.enabled：默认 true
- reconnect.initialDelayMs：默认 500
- reconnect.maxDelayMs：默认 30,000
- reconnect.maxAttempts：默认 10
限制与使用条件
- 不支持 MCP 提示模板，未配置服务不会增加工具或提示
- 慢或崩溃服务器可影响启动和调用
共享 MCP 资源发现工具@deepseek-ai/dsh-mcp-resources
列出指定服务器的资源。列出参数化资源模板。
dsh-mcp-resources · 接口摘录，省略上下文 · ctx.mcpResources.register · docs/subsystems/mcp.md · read_mcp_resource · packages/mcp/mcp-resources/README.md// 按作用域注册服务资源提供者，生命周期内启用共享资源工具。
register(server: string, provider: McpResourceProvider): () => void
// 使用明确服务名和列举或展开得到的 URI，按需读取外部资源。
{ server, uri }具体能力
- 列出指定服务器的资源
- 列出参数化资源模板
- 按明确服务器和 URI 读取资源文本到会话历史
限制与使用条件
- 二进制只向模型显示说明，完整载荷留给程序调用者
持久计划审阅模式@deepseek-ai/dsh-plan-mode
用 /plan 进入探索设计状态并接收附件。把完成计划交给人类批准或反馈后继续。
dsh-plan-mode · 接口摘录，省略上下文 · ctx.planMode.set · docs/subsystems/plan.md// 设置计划模式，运行中的变更可排队等待下一次接纳安全点。
set(agent: Agent, active: boolean): 'committed' | 'queued' | 'cancelled' | 'noop'具体能力
- 用 /plan 进入探索设计状态并接收附件
- 把完成计划交给人类批准或反馈后继续
- 恢复与分叉保持活动计划状态
配置与默认行为
- section：必填，无插件默认值
限制与使用条件
- 只是文本指导，全部工具仍可用，执行限制需沙箱与批准策略
声明式 Agent 子插件定义@deepseek-ai/dsh-agent-preset
用普通 Cordis YAML 声明 Agent 子插件。同时声明多个预设供会话选择。
具体能力
- 用普通 Cordis YAML 声明 Agent 子插件
- 同时声明多个预设供会话选择
- 提前加载定义并让编辑作用于后续新 Agent
配置与默认行为
- id：必填，无插件默认值
- plugins：必填，无插件默认值
- name：未设置；具体省略行为见 README
- description：未设置；具体省略行为见 README
- order：未设置；具体省略行为见 README
限制与使用条件
- 重复预设 ID 导致加载失败，不提供目录复制或删除操作
Agent 预设注册与版本@deepseek-ai/dsh-agent-preset-registry
以预设选择 Agent 工具、提示与技能。在同一进程运行不同组合。
具体能力
- 以预设选择 Agent 工具、提示与技能
- 在同一进程运行不同组合
- 保留失败定义可见性并让已有 Agent 维持原组合
配置与默认行为
- default：必填，无插件默认值
限制与使用条件
- 预设不是安全沙箱，用户覆盖替换完整子列表而不自动合并内置更新
Agent 范围人设覆盖@deepseek-ai/dsh-persona
在预设中注册人设前缀和后缀。覆盖会话的全局人设而不影响其他 Agent。
具体能力
- 在预设中注册人设前缀和后缀
- 覆盖会话的全局人设而不影响其他 Agent
- 可把前缀作为完整系统提示并关闭动态运行上下文
配置与默认行为
- prefix：必填，无插件默认值
- suffix：默认 ''
- complete：默认 false
- includeRuntimeContext：默认 true
限制与使用条件
- 不能全局挂载，否则与提示注册表的人设位置冲突
一次性程序工具执行接口@deepseek-ai/dsh-ptc-runtime
运行模型程序并暴露宿主异步绑定函数。返回无损 JSON 值、分通道有序日志或结构化错误。
dsh-ptc-runtime · 接口摘录，省略上下文 · ctx.ptcRuntime.resolve / ctx.ptcRuntime.run · packages/ptc-runtime/ptc-runtime/README.md// 编排消费者解析程序和宿主 bindings 后运行；返回 value、logs 或 error。
const spec = ctx.ptcRuntime.resolve({
program: 'return await tools.add({ a: 1, b: 2 })',
bindings: [{ global: 'tools', functions: { add: async (args) => args.a + args.b } }],
})
const result = await ctx.ptcRuntime.run(spec)具体能力
- 运行模型程序并暴露宿主异步绑定函数
- 返回无损 JSON 值、分通道有序日志或结构化错误
- 将程序失败放在结果内并区分调用者误用
限制与使用条件
- 一次运行只在完成后返回日志，不提供流日志或会话持久状态
- 隔离描述不等于安全承诺
受策略约束的 Node 程序执行@deepseek-ai/dsh-ptc-runtime-node
为每次 TypeScript 程序创建全新 Node 子进程。在与 Bash 相同平台沙箱策略下暴露异步宿主函数。
具体能力
- 为每次 TypeScript 程序创建全新 Node 子进程
- 在与 Bash 相同平台沙箱策略下暴露异步宿主函数
- 限制时长、输出与 V8 堆并在完成取消时终止进程范围
配置与默认行为
- timeoutMs：默认 120,000
- maxTimeoutMs：默认 600,000
- maxOutputBytes：默认 67,108,864
- maxOldGenerationSizeMb：默认 512
- maxMessageBytes：默认 134,217,728
- maxPendingCalls：默认 128
- graceMs：默认 3,000
- nodeExecutable：默认 当前 Node 可执行文件
- bootstrapPath：默认 随包引导入口
限制与使用条件
- 隔离强度继承后端限制，受限模式后端不可用时直接失败
包级运行不变量检查@deepseek-ai/dsh-invariants
发现并执行包持有的 invariant 伴生检查。比较权威事件流与可变快照之间关系。
// 为准确包名注册运行检查，子 fiber 生命周期绑定注册与插件。
register(packageName: string, installer: InvariantInstaller): () => void具体能力
- 发现并执行包持有的 invariant 伴生检查
- 比较权威事件流与可变快照之间关系
- 失败时抛出归属具体包的 InvariantError
配置与默认行为
- enabled：默认 true
- package_allowlist：默认 []
- package_blocklist：默认 []
限制与使用条件
- 服务单独加载不安装检查，允许名单和启用过滤在生命周期内固定
子进程文件访问隔离接口@deepseek-ai/dsh-sandbox
按次执行只读、工作区写入或完整访问的子进程及后代。要求后端无法实施受限模式时关闭失败。
dsh-sandbox · 接口摘录，省略上下文 · ctx.sandbox.confine · docs/subsystems/sandbox.md// 将原始 argv 包装为受约束执行参数，同时报告后端约束完整度。
abstract confine(argv: readonly string[], policy: SandboxPolicy, signal?: AbortSignal): Promise<ConfinedArgv>具体能力
- 按次执行只读、工作区写入或完整访问的子进程及后代
- 要求后端无法实施受限模式时关闭失败
- 拒绝后允许申请一次更宽模式人工批准
限制与使用条件
- 只描述文件效果，不限制网络和进程可见性
- 仍共享宿主内核与文件系统
本机跨平台沙箱提供者@deepseek-ai/dsh-sandbox-local
未指定自定义 runnerCommand 时，为 Linux、macOS、Windows 选择并探测内建执行器。报告 full 或 partial 实施强度；自定义 runner 的 full 来自操作者断言。
具体能力
- 未指定自定义 runnerCommand 时，为 Linux、macOS、Windows 选择并探测内建执行器
- 报告 full 或 partial 实施强度；自定义 runner 的 full 来自操作者断言
- 区分策略拒绝、执行器故障与无法实施而不静默无约束执行
配置与默认行为
- runnerCommand 默认 []；指定自定义 argv 后追加 bwrap 兼容策略参数，并跳过内建选择与探测
- runnerFailureSignatures 默认 []；配置 runnerCommand 时必须同时提供，用于识别 runner 自身故障的 stderr 特征
- probeTimeoutMs 默认5000，限制每个内建候选执行器的功能探测耗时
限制与使用条件
- Windows ACL 实施是 partial，硬链接可指向同一文件对象
- runnerCommand 跳过内建选择与功能探测，假定其按要求实现 bwrap 兼容策略
会话统一文件权限策略@deepseek-ai/dsh-sandbox-policy
为受限 Shell、文件与终端调用解析相同模式和工作区。允许部署默认与会话独立切换。
// 按本次批准覆盖、会话日志与部署默认解析文件执行策略。
resolve(request: SandboxPolicyRequest = {}): SandboxExecutionPolicy具体能力
- 为受限 Shell、文件与终端调用解析相同模式和工作区
- 允许部署默认与会话独立切换
- 持久保存会话选择并在模型请求前记录有效策略
配置与默认行为
- mode：默认 read-only
- workspaceRoot：默认 process.cwd()
限制与使用条件
- 每个会话只有一个主工作区，不在该策略中表达额外可写根目录
Windows ACL 受限进程@deepseek-ai/dsh-sandbox-windows-acl
用受限令牌把写入删除限制在工作区与私有临时目录。结合能力 SID、拒绝父目录删除权及低完整性标签隔离授权根。
具体能力
- 用受限令牌把写入删除限制在工作区与私有临时目录
- 结合能力 SID、拒绝父目录删除权及低完整性标签隔离授权根
- 任何必要 Win32 操作失败都阻止无约束启动
限制与使用条件
- 保证仍是 partial，硬链接共享对象且其他 AppContainer ACL 文件可能不可读
持久自动提醒与会话跟进@deepseek-ai/dsh-schedule
创建一次性、固定间隔、每日、每周及 cron 提醒。宿主重启后恢复任务并只补投周期任务最近一次漏发。
dsh-schedule · 接口摘录，省略上下文 · ctx.schedule.create · docs/subsystems/schedule.md// 持久保存绑定原会话的提醒，创建时不激活该会话。
async create(sessionId: SessionId, request: ScheduleCreateRequest, signal?: AbortSignal): Promise<ScheduleRecord>具体能力
- 创建一次性、固定间隔、每日、每周及 cron 提醒
- 宿主重启后恢复任务并只补投周期任务最近一次漏发
- 到期恢复冷会话并投递后续消息，删除任务及其已保存投递记录
配置与默认行为
- deliveryHistoryDays 默认30，限制投递历史保留天数
- deliveryHistoryRecords 默认200，限制投递历史记录数
- 随仓库提供的 Web 组合默认不挂载；通过 Plugins 页或 profile 的 dsh.profile.bundles 启用 @deepseek-ai/dsh-experimental-schedule-bundle
限制与使用条件
- 到期投递需要宿主运行，崩溃后可能重复投递
- 依赖 Host Web Session controller 与会话持久化后端，不能单独用于 headless 或 SDK-only 组合
- 删除不撤回原会话中已排队的消息
TypeScript 会话自动化客户端@deepseek-ai/dsh-sdk-client
通过 stdio JSON-RPC 启动并驱动完整 Harness 运行时。打开会话、发送文本图片提示并消费事件通知流。
dsh-client · 接口摘录，省略上下文 · DeepSeekHarness.run · packages/sdk/client/README.md// 启动命名 profile 的运行时并收集提示接纳至整体空闲的结果。
import { DeepSeekHarness } from '@deepseek-ai/dsh-sdk-client'
await using harness = new DeepSeekHarness({ profile: 'sdk' })
const result = await harness.run('say hi')具体能力
- 通过 stdio JSON-RPC 启动并驱动完整 Harness 运行时
- 打开会话、发送文本图片提示并消费事件通知流
- 运行时空闲后返回最后已提交回答，close 或 await using 清理拥有的子进程
配置与默认行为
- 可指定 dshBin，否则解析同版本 @deepseek-ai/dsh 可执行文件
限制与使用条件
- 调用者必须能选择运行时 profile 与启动设置，客户端不是现有 GUI 的控制器
自动化 JSON-RPC 协议类型@deepseek-ai/dsh-sdk-protocol
通过按行分帧字节流传输 JSON-RPC 2.0。共享请求、结果、通知名称与负载类型。
具体能力
- 通过按行分帧字节流传输 JSON-RPC 2.0
- 共享请求、结果、通知名称与负载类型
- 提供传输类及错误语义供 TypeScript 客户端与服务端使用
限制与使用条件
- 纯库，不注册插件或提供运行时配置；Python SDK 镜像协议而不导入本包
JSON-RPC 自动化服务端@deepseek-ai/dsh-sdk-jsonrpc-server
在 stdio 上按 sessionId 打开会话并排队用户提示。流式发送每个会话事件与 Agent 状态转换。
具体能力
- 在 stdio 上按 sessionId 打开会话并排队用户提示
- 流式发送每个会话事件与 Agent 状态转换
- 收到 shutdown 后释放根运行时并退出0
配置与默认行为
- maxTokensAsSuccess：默认 false
限制与使用条件
- stdout 只能携带 JSON-RPC 帧，不能组合 stdout 日志器
- Agent、模型、持久化和工具由周围组合提供，EOF 与信号退出由应用入口负责
工具派发耐久检查点@deepseek-ai/dsh-session-checkpoint-policy
在模型请求前、顶层工具产生外部效果前及下一步开始前执行耐久检查点。写出失败时不调用模型适配器或顶层工具体。
具体能力
- 在模型请求前、顶层工具产生外部效果前及下一步开始前执行耐久检查点
- 写出失败时不调用模型适配器或顶层工具体
- 让已存请求、调用、回应与结果在崩溃后恢复
配置与默认行为
- 无插件配置，需组合会话持久化后端
限制与使用条件
- 未完成助手流仍是瞬态；中断工具恢复为结果未知而不自动重试
相邻会话格式迁移基础@deepseek-ai/dsh-session-format
直接恢复当前格式或组合唯一相邻迁移链。逐物理行传递调用者拥有的已解析值。
具体能力
- 直接恢复当前格式或组合唯一相邻迁移链
- 逐物理行传递调用者拥有的已解析值
- 用有状态转换减少中间制品复制
限制与使用条件
- 最终事件数组与必要序号映射仍占线性内存
- 不负责压缩、发布和生命周期
会话格式静态目录@deepseek-ai/dsh-session-format-catalog
静态装配最早支持版本到当前版本的 codec 和迁移边。模块初始化验证完整无缺口链。
具体能力
- 静态装配最早支持版本到当前版本的 codec 和迁移边
- 模块初始化验证完整无缺口链
- 提供物理分派、头部分类、单遍恢复与当前记录编码
限制与使用条件
- 仅包含第一方构建清单，运行时插件不能补缺失的历史迁移边
会话 V0 到 V1 迁移@deepseek-ai/dsh-session-format-v0-to-v1
逐行解码已发布 V0 JSONL。保留已验证头部事件并应用有限遗留规范化。
具体能力
- 逐行解码已发布 V0 JSONL
- 保留已验证头部事件并应用有限遗留规范化
- 输出共享布局 V1，拒绝损坏或不支持记录且保留源数据
限制与使用条件
- 仅接受冻结的第一方事件，未知外部插件事件拒绝迁移
会话 V1 到 V2 迁移@deepseek-ai/dsh-session-format-v1-to-v2
把顶层 assistant/chunk 的精确带时序流嵌入对应消息。无表面消息的已结束尝试转为 assistant/attempt。
具体能力
- 把顶层 assistant/chunk 的精确带时序流嵌入对应消息
- 无表面消息的已结束尝试转为 assistant/attempt
- 稠密重排保留事件及同会话序号引用并从种子标记推导继承截点
限制与使用条件
- 未知 V1 事件即使标记可忽略也拒绝，序号重映射占线性内存
会话 V2 到 V3 迁移@deepseek-ai/dsh-session-format-v2-to-v3
在不改变历史请求含义前提下提升系统提示为消息。重映射本地事件引用。
具体能力
- 在不改变历史请求含义前提下提升系统提示为消息
- 重映射本地事件引用
- 转换 PTC 与预设名称并规范化事件包络
限制与使用条件
- 历史 code 预设无法区分同名自定义预设，不读取发布文件或迁移设置
会话 V3 到 V4 迁移@deepseek-ai/dsh-session-format-v3-to-v4
提升工具结果并重命名消息来源。关闭有证据的中断回合。
具体能力
- 提升工具结果并重命名消息来源
- 关闭有证据的中断回合
- 追加缺失父级目录事实并验证目标格式规则
限制与使用条件
- 不支持的历史形式可拒绝转换而保留原世代，文件读取与新世代发布由持久化负责
官方请求增量会话日志@deepseek-ai/dsh-session-log-deepseek
向官方模型请求附加规范会话日志后缀。持有 dsh_session_log 扩展字段。
具体能力
- 向官方模型请求附加规范会话日志后缀
- 持有 dsh_session_log 扩展字段
- 用持久接受事件推导上传水位以减少重复传输
限制与使用条件
- 服务成功后水位持久化前崩溃可能重传
- 无活动会话的直接调用不附加字段
会话日志持久化接口@deepseek-ai/dsh-session-persistence
创建、打开、检查、列出并追加会话日志。提供读取、flush 和关闭句柄。
dsh-session-persistence · 接口摘录，省略上下文 · ctx.sessionPersistence.create · packages/session/session-persistence/README.md · ctx.sessionPersistence.open · packages/session/session-persistence/README.md// 准备新会话的组件保存头信息并取得写句柄；空会话需 flush 才保证持久可列出。
const handle = await ctx.sessionPersistence.create(header)
// 恢复方以 write 申请单写者所有权，查询方以 read 打开观察；重复写拥有者会被拒绝。
const handle = await ctx.sessionPersistence.open(id, 'write')具体能力
- 创建、打开、检查、列出并追加会话日志
- 提供读取、flush 和关闭句柄
- 保持连续追加历史并以成功 flush 作为耐久屏障
限制与使用条件
- 只保证同一后端实例单写者，跨进程排他由提供者决定
JSONL 会话日志存储@deepseek-ai/dsh-session-persistence-jsonl
以默认校验 Zstandard 帧或可选原始 JSONL 保存会话。保留不可变历史格式世代并发布当前格式。
具体能力
- 以默认校验 Zstandard 帧或可选原始 JSONL 保存会话
- 保留不可变历史格式世代并发布当前格式
- 封装迁移、延迟实体化与崩溃撕裂尾恢复
配置与默认行为
- root：必填，无插件默认值
- compression：默认 'zstd'
限制与使用条件
- 仅支持静态目录中的迁移链，迁移保持所配置编码
会话状态同步投影@deepseek-ai/dsh-session-projection
从已提交事件同步归约待办、目标等状态。向客户端返回完整且经 schema 验证的 JSON 值和变更。
dsh-session-projection · 接口摘录，省略上下文 · ctx.sessionProjections.snapshot · packages/session/session-projection/README.md// 查询消费者同步取得同一日志切面的 asOfSeq 与 values，避免把派生视图当成另一份事实。
const snapshot = ctx.sessionProjections.snapshot(session)具体能力
- 从已提交事件同步归约待办、目标等状态
- 向客户端返回完整且经 schema 验证的 JSON 值和变更
- 给快照标明已反映事件截点并支持私有宿主投影
限制与使用条件
- 每个尾页携带全部客户端可见键，没有按键延迟加载
持久会话投影检查点@deepseek-ai/dsh-session-projection-cache
保存可用于冷查询的每会话投影快照。冷归约从检查点前缀之后恢复以减少读日志。
具体能力
- 保存可用于冷查询的每会话投影快照
- 冷归约从检查点前缀之后恢复以减少读日志
- 忽略或备份不兼容记录并确保快照不领先已提交日志
配置与默认行为
- writeEveryEvents：必填，无插件默认值
- writeIntervalMs：必填，无插件默认值
限制与使用条件
- 没有淘汰与保留设置，记录随会话积累需外部维护
完整会话执行统计@deepseek-ai/dsh-session-stats
从完整持久日志计算回合与步骤数。提供模型、工具、首 token 与解码耗时。
具体能力
- 从完整持久日志计算回合与步骤数
- 提供模型、工具、首 token 与解码耗时
- 让分页、压缩及刷新后统计保持一致
限制与使用条件
- 步骤统计执行尝试，失败而没有可见输出的步骤也计入
会话遥测复制与脱敏@deepseek-ai/dsh-session-telemetry
按序把会话活动副本交给选定后端。允许发送前对每份副本脱敏。
dsh-session-telemetry · 接口摘录，省略上下文 · session-telemetry/record · docs/subsystems/session-telemetry.md · ctx.sessionTelemetry.emit · docs/subsystems/session-telemetry.md// 外发记录的同步脱敏瀑布，仅改导出副本，异常时扣留该记录。
'session-telemetry/record'(record: SessionTelemetryRecord, next: () => SessionTelemetryRecord): SessionTelemetryRecord
// 向报告后端交接脱敏记录；调用完成不表示远端已经收到。
abstract emit(record: SessionTelemetryRecord): void具体能力
- 按序把会话活动副本交给选定后端
- 允许发送前对每份副本脱敏
- 以非阻塞交接避免遥测延迟会话处理
限制与使用条件
- 尽力而为且崩溃可丢队列，未配置脱敏时原数据离开进程
反馈授权的会话 OTel 导出@deepseek-ai/dsh-session-telemetry-otel
在新明确反馈后经 OTel SDK 导出规范日志前缀。FEEDBACK_ONLY 只放行截至反馈的前缀，后续记录等待新反馈。
具体能力
- 在新明确反馈后经 OTel SDK 导出规范日志前缀
- FEEDBACK_ONLY 只放行截至反馈的前缀，后续记录等待新反馈
- DISABLED 不创建传输，已授权批次可定时完成
配置与默认行为
- mode：默认 FEEDBACK_ONLY
- exporter.url：上传模式必填
- exporter, processor：未设置；具体省略行为见 README
- shutdownTimeoutMillis：默认 3,000
- maxRequestBytes：默认 4,000,000
限制与使用条件
- 依赖上游实验 sdk-logs API，部署自行负责脱敏规则
持久会话标题服务@deepseek-ai/dsh-session-title
从首个合格人类消息生成回退标题。接收异步生成器或明确用户重命名。
具体能力
- 从首个合格人类消息生成回退标题
- 接收异步生成器或明确用户重命名
- 持久标题跨恢复分页保留且新请求替代旧生成任务
配置与默认行为
- fallbackMaxWords：必填，无插件默认值
- fallbackMaxBytes：必填，无插件默认值
- maxTitleBytes：必填，无插件默认值
限制与使用条件
- 不提供标题删除、搜索或列表索引，标题不进入模型输入
全提示更新式标题生成@deepseek-ai/dsh-session-title-all-prompts-llm
汇总所有合格人类消息生成标题。每条新提示开始新修订并覆盖过期任务。
具体能力
- 汇总所有合格人类消息生成标题
- 每条新提示开始新修订并覆盖过期任务
- 复用共享模型路由、预算和取消策略
限制与使用条件
- 输入溢出保留旧标题，不执行摘要的再摘要
首提示标题生成@deepseek-ai/dsh-session-title-first-prompt-llm
只摘要首个合格人类消息。在新建非分叉会话首次建立回退标题时自动运行。
具体能力
- 只摘要首个合格人类消息
- 在新建非分叉会话首次建立回退标题时自动运行
- 失败保留回退并通过显式 refresh 再试
限制与使用条件
- 首条消息可能不再代表长会话，自动失败不反复重试
共享模型标题生成策略@deepseek-ai/dsh-session-title-llm
对选定人类消息构建统一标题请求。使用成对显式提供者模型或当前会话记录路由。
具体能力
- 对选定人类消息构建统一标题请求
- 使用成对显式提供者模型或当前会话记录路由
- 限制输入、输出及端到端时间并拒绝空、迟到和非文本结果
限制与使用条件
- 只接受文本，工具调用和提供者专用结构化输出不能作为标题
完整回合导航提纲@deepseek-ai/dsh-session-turn-outline
投影所有已开始回合及有界提示预览。回合结束后加入回应预览。
具体能力
- 投影所有已开始回合及有界提示预览
- 回合结束后加入回应预览
- 给历史客户端准确序号以导航未加载回合
限制与使用条件
- 每次推送携带完整提纲而随会话增长，预览不含注入上下文或工具结果
会话树与附件 ZIP 导出@deepseek-ai/dsh-session-log-export
在会话菜单与 /export 提供完整日志下载。将会话、子会话和附件打包为 ZIP 流。
具体能力
- 在会话菜单与 /export 提供完整日志下载
- 将会话、子会话和附件打包为 ZIP 流
- 通过认证 Fetch 路由提供浏览器下载反馈
配置与默认行为
- compressionLevel：默认 6
限制与使用条件
- 下载目标由浏览器选择，不把 ZIP 写到任意宿主路径
会话历史读取与关系查询@deepseek-ai/dsh-session-query
列出筛选读取历史及有界事件上下文。追踪会话或事件关系。
具体能力
- 列出筛选读取历史及有界事件上下文
- 追踪会话或事件关系
- 优先活动会话并从同一观察返回分离克隆
配置与默认行为
- readWindowMax：默认 50
- persistedReadConcurrency：默认 4
- preparedSessionCacheSize：默认 5
限制与使用条件
- 这是可信全上下文设施，不执行调用者授权
- 排名全文搜索需另外后端
SQLite 会话全文搜索@deepseek-ai/dsh-session-query-sqlite
为活动和持久历史创建独立派生 FTS5 索引。支持跨会话及会话内排名搜索和游标分页。
具体能力
- 为活动和持久历史创建独立派生 FTS5 索引
- 支持跨会话及会话内排名搜索和游标分页
- 按 openAt 选择启动、首搜或不打开索引
配置与默认行为
- path：必填，无插件默认值
- openAt：默认 startup
- journalMode：默认 wal
- defaultLimit：默认 20
- maxLimit：默认 100
- snippetChars：默认 240
- readWindowMax：默认 50
- persistedReadConcurrency：默认 4
- preparedSessionCacheSize：默认 5
限制与使用条件
- 按 token 和短语匹配而非任意子串，每个索引路径只允许一个进程拥有
模型历史搜索与关系工具@deepseek-ai/dsh-tool-session-query
提供五个只读工具搜索、检查匹配、追踪关系和读取事件。仅允许跨会话读取 cwd 精确相同的目标。
具体能力
- 提供五个只读工具搜索、检查匹配、追踪关系和读取事件
- 仅允许跨会话读取 cwd 精确相同的目标
- 排除当前会话搜索并在命中上限时要求缩小查询
配置与默认行为
- maxSearchResults：默认 100
- searchTimeoutMs：默认 30000
限制与使用条件
- 结果上限不提供续页，无 cwd 的调用者只能检查自身
声明式可编辑插件设置@deepseek-ai/dsh-settings
只编辑插件标注 volatile 的字段。按 profile 条目 ID 读取有效设置并保护秘密。
具体能力
- 只编辑插件标注 volatile 的字段
- 按 profile 条目 ID 读取有效设置并保护秘密
- 拒绝陈旧写入并持久化到活动 profile patch
限制与使用条件
- 嵌套 Include 配置不可经该表单修改，重置只能恢复继承值
一次性本机 Bash 执行@deepseek-ai/dsh-bash-local
每次用无 rc 的非登录 bash -c 启动命令。执行工作目录、时间和输出预算。
具体能力
- 每次用无 rc 的非登录 bash -c 启动命令
- 执行工作目录、时间和输出预算
- 分类超时取消并在输出溢出时保留 spill 路径
配置与默认行为
- cwd：默认 process.cwd()
- timeoutMs：默认 120,000
- maxTimeoutMs：默认 600,000
- maxOutputBytes：默认 64,000
- maxSpillBytes：默认 67,108,864
- graceMs：默认 3,000
限制与使用条件
- 不隔离权限且跨调用不保留 cwd、变量或函数
受限 Bash 执行@deepseek-ai/dsh-bash-sandbox
通过沙箱能力实施每调用文件模式。在结果中报告模式、拒绝及实施强度。
具体能力
- 通过沙箱能力实施每调用文件模式
- 在结果中报告模式、拒绝及实施强度
- 无法实施受限模式时以 SANDBOX_UNAVAILABLE 关闭失败
限制与使用条件
- 只约束文件效果，不保证网络限制或统一进程可见性
一次性本机 PowerShell 执行@deepseek-ai/dsh-pwsh-local
每次使用无 profile 的非交互 pwsh -Command。解析可执行文件并固定 UTF-8 输出。
具体能力
- 每次使用无 profile 的非交互 pwsh -Command
- 解析可执行文件并固定 UTF-8 输出
- 应用与本地 Bash 一致的预算和结果语义
配置与默认行为
- cwd：默认 process.cwd()
- timeoutMs：默认 120,000
- maxTimeoutMs：默认 600,000
- maxOutputBytes：默认 64,000
- maxSpillBytes：默认 67,108,864
- graceMs：默认 3,000
- pwshPath：默认 按文档的解析优先级确定
限制与使用条件
- 不提供权限隔离，Shell 状态不跨调用保存
受限 PowerShell 执行@deepseek-ai/dsh-pwsh-sandbox
经沙箱能力执行新的 PowerShell 进程。返回选定模式、实施强度和拒绝事实。
具体能力
- 经沙箱能力执行新的 PowerShell 进程
- 返回选定模式、实施强度和拒绝事实
- 按 Windows ACL 或 POSIX 平台后端执行并在不可用时失败
限制与使用条件
- Windows ACL 约束写入而不限制读取，实施为部分隔离
Shell 执行与后台句柄接口@deepseek-ai/dsh-shell
用一个执行句柄同时支持前台结果和后台读取。解析工作目录、超时及输出限制后再执行。
// 命令调用方先解析目录和预算，再执行完整 Spec；进程非零退出仍通过结果返回。
const spec = ctx.shell.resolve({ command: 'ls -la' })
const execution = await ctx.shell.execute(spec)
const result = await execution.result()具体能力
- 用一个执行句柄同时支持前台结果和后台读取
- 解析工作目录、超时及输出限制后再执行
- 让调用者无需修改即可选择本地或沙箱 Bash/PowerShell
限制与使用条件
- stdin 仅启动时一次写入并关闭，不提供后续交互输入通道
模型 Shell 受管环境注册@deepseek-ai/dsh-shell-env
为 Bash 和 PowerShell 提供 DSH_HOME、会话与 profile 等可信事实。按执行收集插件声明的环境键。
具体能力
- 为 Bash 和 PowerShell 提供 DSH_HOME、会话与 profile 等可信事实
- 按执行收集插件声明的环境键
- 重复归属或未声明键立即失败且注册随插件释放
配置与默认行为
- dshHome：默认 $DSH_HOME, then ~/.dsh
限制与使用条件
- list 只枚举插件贡献键，不包含注册表持有的内置事实
一次性 Bash 模型工具@deepseek-ai/dsh-tool-bash
运行 Bash 并返回 stdout、stderr 和退出标记。配合作业服务从启动即拥有稳定作业 ID。
具体能力
- 运行 Bash 并返回 stdout、stderr 和退出标记
- 配合作业服务从启动即拥有稳定作业 ID
- 允许立即后台化或超时后返回同一 ID 供读取停止
配置与默认行为
- enableRunInBackground：默认 true
- promoteOnTimeout：默认 true
限制与使用条件
- 每次 Shell 独立，非零退出作为结果返回需 Agent 自行判断
持久 Bash 模型工具@deepseek-ai/dsh-tool-bash-persistent
按 Agent 独立保留 cwd、导出变量、函数和后台工作。同 Agent 命令顺序执行。
具体能力
- 按 Agent 独立保留 cwd、导出变量、函数和后台工作
- 同 Agent 命令顺序执行
- 退出、超时或取消时丢弃 Shell 并在下次重建
配置与默认行为
- backendType：默认 shell
- timeoutMs：默认 300,000
- maxOutputChars：默认 16,000
- description：默认描述提示 Shell 状态、当前目录及已导出环境变量在当前 Agent 调用之间保留
限制与使用条件
- 需要拥有者 Agent 和真实 PTY，等待 stdin 的命令可能一直运行到超时
一次性 PowerShell 模型工具@deepseek-ai/dsh-tool-pwsh
通过配置执行器运行原生 PowerShell 命令。传递受管 DSH 环境并使用 Windows 路径与环境变量语法。
具体能力
- 通过配置执行器运行原生 PowerShell 命令
- 传递受管 DSH 环境并使用 Windows 路径与环境变量语法
- 结合作业服务提供立即后台和前台超时续跑
配置与默认行为
- enableRunInBackground：默认 true
- promoteOnTimeout：默认 true
限制与使用条件
- Windows 受限沙箱有语言模式与命名管道约束，进程状态不跨调用保存
持久 PowerShell 模型工具@deepseek-ai/dsh-tool-pwsh-persistent
为每个 Agent 保留目录、环境变量、函数与后台作业。同 Agent 串行命令而不同 Agent 状态分离。
具体能力
- 为每个 Agent 保留目录、环境变量、函数与后台作业
- 同 Agent 串行命令而不同 Agent 状态分离
- 超时或显式 exit 后下次启动新 Shell
配置与默认行为
- backendType：默认 shell
- timeoutMs：默认 300,000
- maxOutputChars：默认 16,000
- description：默认描述提示 Shell 状态、当前目录及已导出环境变量在当前 Agent 调用之间保留
限制与使用条件
- 要求真实且支持 pwsh 方言的终端后端，交互 stdin 应使用终端工具
多来源技能目录服务@deepseek-ai/dsh-skill
合并本地、内嵌和远程来源的任务指令。校验条目并确定性处理重名。
// 技能提供者同步登记目录与正文加载能力，返回移除该提供者的 disposer。
ctx.skills.registerProvider具体能力
- 合并本地、内嵌和远程来源的任务指令
- 校验条目并确定性处理重名
- 部分来源失效仍保留可用结果并按需加载全文
配置与默认行为
- collectCacheMaxEntries：默认 128
限制与使用条件
- 没有 TTL，刷新失效由提供者驱动
- 本包不带技能内容
官方归属徽章技能@deepseek-ai/dsh-skill-badge
提供固定 dsh-badge 技能。指导向文档与 PR 添加 powered by dsh 标记。
具体能力
- 提供固定 dsh-badge 技能
- 指导向文档与 PR 添加 powered by dsh 标记
- 附带 Markdown 片段和可离线使用的 PNG
限制与使用条件
- 只有一个固定技能且不支持运行时定制
磁盘技能发现与监听@deepseek-ai/dsh-skill-filesystem
扫描项目、自定义及用户技能根目录。读取目录 SKILL.md 或平铺 Markdown 的 YAML 元数据。
具体能力
- 扫描项目、自定义及用户技能根目录
- 读取目录 SKILL.md 或平铺 Markdown 的 YAML 元数据
- 监听新增改名删除以免重启更新目录
配置与默认行为
- providerName：默认 filesystem
- includeDefaultRoots：默认 true
- dshHome：默认 $DSH_HOME or ~/.dsh
- agentsHome：默认 $DSH_AGENTS_HOME or ~/.agents
- customSkillDirs：默认 []
- watch：默认 true
- bundledSkillDir：未设置；具体省略行为见 README
限制与使用条件
- 只扫描一层的目录技能或平铺文件，不递归发现任意深度
Office 文档任务技能@deepseek-ai/dsh-skill-office
提供 Word、PowerPoint、Excel 创建编辑与结构检查指令。优先使用随环境提供的 Python 并尊重显式环境选择。
具体能力
- 提供 Word、PowerPoint、Excel 创建编辑与结构检查指令
- 优先使用随环境提供的 Python 并尊重显式环境选择
- 有 LibreOffice Kit 时渲染选定页面、转 PDF 和重新计算表格
配置与默认行为
- assetRoot：默认 随包 assets/ 目录
- node：默认 当前独立 Node 进程
- cli：默认 已安装工具包的 lib/cli.js
限制与使用条件
- 不安装 Python 或创作库，结构检查不能判断分页、裁剪、字体及图表外观
模型技能加载与用户调用@deepseek-ai/dsh-tool-skill
在首次请求前记录可调用技能名与截断说明。用 skill 工具按需加载完整指令。
dsh-tool-skill · 接口摘录，省略上下文 · skill · packages/skill/tool-skill/README.md// 模型按目录中的准确技能名按需加载正文，收到 skill_content 内容与资源访问指引。
skill具体能力
- 在首次请求前记录可调用技能名与截断说明
- 用 skill 工具按需加载完整指令
- 用户 /name 调用同一内容，目录变化追加完整替换列表
配置与默认行为
- catalogDescriptionMaxLength：默认 500
限制与使用条件
- 目录不包含 whenToUse、来源或提供者元数据，路由只依赖名称和说明
随附脚本环境路径工具@deepseek-ai/dsh-tool-workspace-dependencies
返回随部署提供的 Python、Node 和 pnpm 绝对路径。返回记录的发行版本。
具体能力
- 返回随部署提供的 Python、Node 和 pnpm 绝对路径
- 返回记录的发行版本
- 按载体首次复制到 home 或直接原地使用
配置与默认行为
- source：必填，无插件默认值
- root：未设置；具体省略行为见 README
限制与使用条件
- Linux 载荷要求 glibc，原地 Windows 载荷不自动修复执行权限
大文本溢出存储接口@deepseek-ai/dsh-spill
保存不适合放入上下文的完整文本。返回不透明定位符、精确字节数与取回指引。
dsh-spill · 接口摘录，省略上下文 · ctx.spillStore.saveText · docs/subsystems/spill.md// 原样保存全文，返回不透明位置、精确字节数与后端读取提示。
abstract saveText(input: SaveTextSpill): Promise<SpillRef>具体能力
- 保存不适合放入上下文的完整文本
- 返回不透明定位符、精确字节数与取回指引
- 由调用者在存储失败后决定内联保留或失败
限制与使用条件
- 不提供取回、删除、替换、搜索或保留期 API
本机私有溢出文件@deepseek-ai/dsh-spill-local
把文本写入会话范围私有文件。返回可读或搜索的宿主路径。
具体能力
- 把文本写入会话范围私有文件
- 返回可读或搜索的宿主路径
- 使用不可预测名称与安全目录并在启动按保留期清理
配置与默认行为
- root：默认 private 0700 temp dir
- cleanupPeriodDays：默认 30
限制与使用条件
- 只在启动时清扫，长时间运行不会周期删除旧文件
工具结果共享预算裁剪@deepseek-ai/dsh-spill-policy
按估算 token 预算限制大文本和图像结果。向模型保留顺序头尾内容及完整结果路径。
具体能力
- 按估算 token 预算限制大文本和图像结果
- 向模型保留顺序头尾内容及完整结果路径
- 图像仍在附件存储，溢出文件保存可读路径
配置与默认行为
- maxInlineTokens：未设置；具体省略行为见 README
限制与使用条件
- 不配置 maxInlineTokens 就不启用保留策略，恢复失败会保留原内容
SSH 远程文件系统提供者@deepseek-ai/dsh-fs-ssh
让文件工具访问远程 Shell 和 LSP 所见同一文件。在 helper 侧规范化文件身份。
具体能力
- 让文件工具访问远程 Shell 和 LSP 所见同一文件
- 在 helper 侧规范化文件身份
- 复用远程本地实现执行版本守卫与原子修改
限制与使用条件
- 完整文本与单字节窗口限8 MiB，文件系统监听不受支持
SSH 远程沙箱提供者@deepseek-ai/dsh-sandbox-ssh
对 SSH 子进程在远端执行所选文件策略。使用远端已安装的本地沙箱后端。
具体能力
- 对 SSH 子进程在远端执行所选文件策略
- 使用远端已安装的本地沙箱后端
- 向 Bash 与 Node 返回相同实施等级及拒绝分类
限制与使用条件
- 远端 partial 仍是部分实施，不限制网络或进程可见性
POSIX SSH helper 连接@deepseek-ai/dsh-ssh
使用部署配置的 OpenSSH alias 连接已安装 helper。就绪前验证已安装产物摘要。
具体能力
- 使用部署配置的 OpenSSH alias 连接已安装 helper
- 就绪前验证已安装产物摘要
- 连接关闭、SSH EOF、终止信号或心跳租约过期时，由远端 helper 启动受管清理
配置与默认行为
- host：必填，无插件默认值
- node, helper, workspace：必填，无插件默认值
- helperHash：必填，无插件默认值
- bootstrapPath, bootstrapHash：未设置；具体省略行为见 README
- requestTimeoutMs：默认 30000
- maxFrameBytes：默认 67108864
- maxPending：默认 128
- leaseMs：默认 30000
限制与使用条件
- 不支持 Windows 端点、自动部署、重连或重放，Web 路径界面仍假定本机文件
- 断连客户端无法确认远端清理或操作的最终结果，不自动重连或重放
SSH 远程子进程提供者@deepseek-ai/dsh-subprocess-ssh
在共享 SSH 文件系统旁查找执行文件和启动进程。传输 fd7 控制数据与终端会话。
具体能力
- 在共享 SSH 文件系统旁查找执行文件和启动进程
- 传输 fd7 控制数据与终端会话
- 由远端原生拥有者管理终止和静默完成
限制与使用条件
- 调用者必须消费或关闭原始输出流，已完成 spill 文件由外部临时清理负责
非会话应用存储枢纽@deepseek-ai/dsh-storage
通过已配置介质持久化类型化应用数据。供工作区和会话旁路状态使用。
具体能力
- 通过已配置介质持久化类型化应用数据
- 供工作区和会话旁路状态使用
- 通过 storageDomain 访问而不写模型会话事件
限制与使用条件
- 仅支持键值数据，不提供会话事件日志 facet
验证式键值存储域@deepseek-ai/dsh-storage-domain
声明带 schema 的键值域并打开后端。从已验证内存状态同步读取。
具体能力
- 声明带 schema 的键值域并打开后端
- 从已验证内存状态同步读取
- 每次写入耐久完成后按序发出 domain/changed
配置与默认行为
- backend：必填，无插件默认值
- routes：默认 {}
限制与使用条件
- 变化通知只在同一进程内，不自动感知别的进程修改
可读 JSON 键值后端@deepseek-ai/dsh-storage-json
single 布局每个 unit 保存一个完整 JSON。per-record 布局逐记录保存带版本文档。
具体能力
- single 布局每个 unit 保存一个完整 JSON
- per-record 布局逐记录保存带版本文档
- 每个变动文件原子发布并让域层排序调用
配置与默认行为
- root：必填，无插件默认值
限制与使用条件
- single 每次重写完整 unit，较大或高并发数据更适合其他后端
SQLite 键值后端@deepseek-ai/dsh-storage-sqlite
将所有路由 unit 保存到同一个 SQLite 文件。每个记录对应一行 JSON。
具体能力
- 将所有路由 unit 保存到同一个 SQLite 文件
- 每个记录对应一行 JSON
- 单记录更新只修改一行以支持高频小写入
配置与默认行为
- path：必填，无插件默认值
- journalMode：默认 wal
限制与使用条件
- 同步 DatabaseSync 写入会阻塞事件循环
子代理委派与会话管理@deepseek-ai/dsh-subagent
按名称选择进程内、ACP、SDK 或外部 Agent 后端。支持一次性结果及可继续子会话。
dsh-subagent · 接口摘录，省略上下文 · ctx.subagents.start · docs/subsystems/subagent.md// 按提供者名称启动委托，能力检查通过后返回调用者拥有的运行。
async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>具体能力
- 按名称选择进程内、ACP、SDK 或外部 Agent 后端
- 支持一次性结果及可继续子会话
- 无需加载恢复即可查看活动、完成状态和谱系
限制与使用条件
- 后代目录读取按序进行，规模随可达目录增加
独立 ACP 子代理@deepseek-ai/dsh-subagent-acp
每次在新子进程建立独立运行时模型工具与会话。仅共享选定工作目录并通过 ACP 发送任务。
具体能力
- 每次在新子进程建立独立运行时模型工具与会话
- 仅共享选定工作目录并通过 ACP 发送任务
- 只返回最终回答或安全错误，权限提示按配置自动处理
配置与默认行为
- providerName：默认 acp
- command：必填，无插件默认值
- args：默认 []
- cwd：默认 父会话工作目录
- permission：默认 reject
- env：默认 {}
- disposeEofGraceMs：默认 6000
- disposeGraceMs：默认 3000
限制与使用条件
- 每次运行启动新进程，无池化且不共享父能力
Claude Code 委派组合包@deepseek-ai/dsh-subagent-claude-code
按需启动固定平台版本 Claude Code 处理独立文本任务。保留原生配置与认证并允许 profile 选模型环境及权限模式。
具体能力
- 按需启动固定平台版本 Claude Code 处理独立文本任务
- 保留原生配置与认证并允许 profile 选模型环境及权限模式
- 只回传最终结果或安全诊断
配置与默认行为
- providerName：默认 claude-code
- model：默认 原生 Claude 设置
- env：默认 {}
- permissionMode：默认 dontAsk
- disposeGraceMs：默认 3000
限制与使用条件
- 每次新查询新进程，不支持继续会话和交互权限提示
Codex 委派组合包@deepseek-ai/dsh-subagent-codex
在父工作区启动独立原生 Codex 线程。尊重 Codex 原生配置认证并选择无人值守权限模式。
具体能力
- 在父工作区启动独立原生 Codex 线程
- 尊重 Codex 原生配置认证并选择无人值守权限模式
- 提供兼容原生载荷并只回传最终结果或安全错误
配置与默认行为
- providerName：默认 codex
- model：默认 原生 Codex 设置
- env：默认 {}
- permissionMode：默认 never
- disposeGraceMs：默认 3000
限制与使用条件
- 每次独立进程线程和轮次，不支持继续、恢复、池化、进度流或产品会话持久化
- profile 固定提供者、可选模型和工具绑定，调用时不能动态选择模型；每个工具名必须唯一
独立 Harness SDK 子代理@deepseek-ai/dsh-subagent-dsh-sdk
每次启动拥有独立 profile 会话模型工具的 Harness 子进程。从父级接收任务和工作目录。
具体能力
- 每次启动拥有独立 profile 会话模型工具的 Harness 子进程
- 从父级接收任务和工作目录
- 通过 SDK 只回传最终助手文本或安全错误
配置与默认行为
- providerName：默认 dsh-sdk
- dshBin：默认 SDK 依赖提供的可执行文件
- profile：默认 sdk
- patches：默认 []
- dshHome：必填，无插件默认值
- cwd：默认 父会话工作目录
- provider：默认 deepseek-official
- model：默认 deepseek-v4-flash
- maxTokens：默认 adapter/provider route default
- env：默认 {}
- shutdownTimeoutMs：默认 1000
- disposeEofGraceMs：默认 6000
- disposeGraceMs：默认 3000
限制与使用条件
- 每次重新启动完整进程且中间工具流不进入父会话
继承完成对话的进程内子代理@deepseek-ai/dsh-subagent-fork-in-process
以父级已完成回合为种子创建子 Agent。通过 fork 提供者执行延续性子任务。
具体能力
- 以父级已完成回合为种子创建子 Agent
- 通过 fork 提供者执行延续性子任务
- 复用进程内执行生命周期与父级共享服务
配置与默认行为
- providerName：默认 fork
限制与使用条件
- 只复制创建时快照，不含当前进行中回合或之后新增父回合
进程内子代理共享驱动@deepseek-ai/dsh-subagent-in-process-driver
通过宿主工厂创建子 Agent 并应用定制。接受空历史或完成回合种子驱动一次任务。
具体能力
- 通过宿主工厂创建子 Agent 并应用定制
- 接受空历史或完成回合种子驱动一次任务
- 返回子级最终输出并使用统一静默释放路径
限制与使用条件
- 是后端共享库，不能作为独立功能挂载配置
空对话进程内子代理@deepseek-ai/dsh-subagent-spawn-in-process
创建共享进程、Agent 工厂、模型及工具服务的独立子 Agent。以空会话接收完整任务。
具体能力
- 创建共享进程、Agent 工厂、模型及工具服务的独立子 Agent
- 以空会话接收完整任务
- 默认继承工作目录谱系模型推理强度输出预算并允许覆盖
配置与默认行为
- providerName：默认 spawn
限制与使用条件
- 不继承父对话，任务描述必须自包含
可配置子代理委派工具@deepseek-ai/dsh-tool-subagent
将具名工具绑定到选定子代理后端。one-shot 默认等待而 continuable 返回可继续 ID。
具体能力
- 将具名工具绑定到选定子代理后端
- one-shot 默认等待而 continuable 返回可继续 ID
- 配置子角色、工具访问、深度及允许的模型路由
配置与默认行为
- provider：必填，无插件默认值
- toolName：默认 subagent
- modelSelectionSettings：默认 false
- enableRunInBackground：默认 true
- backgroundMode：默认 one-shot
- agentOptions：未设置；具体省略行为见 README
- persona：未设置；具体省略行为见 README
- toolFilter：未设置；具体省略行为见 README
- maxDepth：默认 宿主设置（1）
限制与使用条件
- 后端必须支持所选模式，运行失败返回错误而不伪装部分成功
子代理消息中断与目录工具@deepseek-ai/dsh-tool-subagent-control
send_message 在直接父子之间传递消息。interrupt_agent 停止当前回合而保留收件箱与后代。
具体能力
- send_message 在直接父子之间传递消息
- interrupt_agent 停止当前回合而保留收件箱与后代
- 独立可挂载的 list-agents 按持久 ID 标签列出可继续子代理
限制与使用条件
- 工具是否存在不决定委派模式，更深后代不开放任意双向续聊
显式子进程和终端接口@deepseek-ai/dsh-subprocess
查找执行文件并显式启动 argv 进程或真实终端。流式或有界收集输出并终止受管进程范围。
具体能力
- 查找执行文件并显式启动 argv 进程或真实终端
- 流式或有界收集输出并终止受管进程范围
- 清除环境凭据与 DSH 变量后再应用显式覆盖
限制与使用条件
- 不接管 SDK 内部自行启动的进程，调用者负责截止时间与模型展示
本机进程范围与 PTY 提供者@deepseek-ai/dsh-subprocess-local
对支持平台使用 OS 拥有的进程管理范围。用 node-pty 提供真实终端并有界保留输出及可选 spill。
具体能力
- 对支持平台使用 OS 拥有的进程管理范围
- 用 node-pty 提供真实终端并有界保留输出及可选 spill
- 释放时终止并等待所选进程范围或会话静默
限制与使用条件
- 未支持的平台显式使用较弱回退，Linux 直接退出后等待清理没有独立截止时间
共享 Win32 进程原语@deepseek-ai/dsh-win32-process
集中可复用 Koffi 绑定表。提供进程、stdio 与 Job Object 操作。
具体能力
- 集中可复用 Koffi 绑定表
- 提供进程、stdio 与 Job Object 操作
- 供 ACL 沙箱和普通 Job 执行器共享句柄管理
限制与使用条件
- 原生加载仅支持 Windows，不选择沙箱策略或公开子进程行为
独立 OTel 报告通道@deepseek-ai/dsh-otel
创建普通事件和会话日志独立通道。分别拥有 exporter、资源、scope 与队列。
// 创建独立且有字节上限的会话报告通道，由消费者负责关闭。
createSessionLogReporter(options: SessionLogOptions): SessionLogReporter具体能力
- 创建普通事件和会话日志独立通道
- 分别拥有 exporter、资源、scope 与队列
- 单独挂载不创建传输身份或发送数据
限制与使用条件
- 仅内存尽力投递，授权脱敏与外层关停截止时间由消费者负责
拥有者隔离的持久终端服务@deepseek-ai/dsh-terminal
铸造不透明终端 ID 并路由注册后端。将每项操作限制到创建终端的准确 Agent。
具体能力
- 铸造不透明终端 ID 并路由注册后端
- 将每项操作限制到创建终端的准确 Agent
- 拥有者或服务释放时等待静默清理
限制与使用条件
- 终端与原始滚动缓冲只在本进程存在，不跨重启恢复
持久交互式 Shell 终端后端@deepseek-ai/dsh-terminal-bash
按部署沙箱策略启动长期 Shell。用 shellDialect 支持 POSIX Bash 与 Windows pwsh。
具体能力
- 按部署沙箱策略启动长期 Shell
- 用 shellDialect 支持 POSIX Bash 与 Windows pwsh
- 检测就绪并保留有界逐行输出，兼容本地或远程子进程
配置与默认行为
- backendType：默认 shell
- shellDialect：默认 bash
- shellPath / shellArgs：默认 按 Shell 方言选择
- maxReadBytes：默认 262144
- timeoutMs：默认 30000
- disposeGraceMs：默认 3000
限制与使用条件
- 只提供逐行终端语义，不承诺完整全屏应用表现
终端创建输入读取与关闭工具@deepseek-ai/dsh-tool-terminal
创建、列出、读取、发送输入、信号或关闭当前 Agent 拥有的终端。发送后等待有界前台输出或返回后台作业 ID 供收集与中断。
具体能力
- 创建、列出、读取、发送输入、信号或关闭当前 Agent 拥有的终端
- 发送后等待有界前台输出或返回后台作业 ID 供收集与中断
- 以 maxResultBytes 限制单次结果，结果保留在会话历史直到压缩
配置与默认行为
- enableRunInBackground：默认 true
- maxResultBytes：默认 262144
限制与使用条件
- 不暴露命名键序列、全屏 TUI、BEL、resize 或自动启动
- 后台模式要求 jobs 与 tool-jobs 同时组合，否则拒绝 run_in_background
Agent 循环测试支撑@deepseek-ai/dsh-agent-loop-testkit
创建真实 Agent 和生产循环驱动。提供 Inbox 认领以测试持久事件恢复与通知。
具体能力
- 创建真实 Agent 和生产循环驱动
- 提供 Inbox 认领以测试持久事件恢复与通知
- 提供仅编辑队列或禁止访问 Inbox 的替身
限制与使用条件
- 测试仍负责适配器、可选插件、加载顺序和释放
客户端槽位与整应用测试支撑@deepseek-ai/dsh-client-test-runtime
在 jsdom 驱动生产槽位、store 与类型化夹具。通过 Remote mock 启动 Web 组合 roster 测试重载重连。
具体能力
- 在 jsdom 驱动生产槽位、store 与类型化夹具
- 通过 Remote mock 启动 Web 组合 roster 测试重载重连
- 缺失服务或未配置调用显式失败并管理清理
限制与使用条件
- 只用于 devDependencies 客户端测试，不是产品插件
脚本化模型 HTTP/SSE 测试端点@deepseek-ai/dsh-llm-mock-server
每次 Messages 请求消费下一项脚本行为。模拟重置、停顿、坏块、限流、服务错误及工具调用。
具体能力
- 每次 Messages 请求消费下一项脚本行为
- 模拟重置、停顿、坏块、限流、服务错误及工具调用
- 捕获请求供断言并支持带种子随机压力情景
限制与使用条件
- 并发请求共享按到达顺序推进的脚本游标；确定分配会话故障需要独立服务器
- 随机权重表示测试压力而不代表生产故障发生率
无密钥模型流回放@deepseek-ai/dsh-llm-replay
从记录的会话 JSONL 回放模型流。按首次调用顺序给父子会话分配独立脚本。
具体能力
- 从记录的会话 JSONL 回放模型流
- 按首次调用顺序给父子会话分配独立脚本
- 通过 override 旁路文件表达早期失败取消挂起与重试
配置与默认行为
- file：默认 $DSH_SNAPSHOT_FILE
- overrideFile：默认 $DSH_SNAPSHOT_OVERRIDE
- childFiles：默认 $DSH_SNAPSHOT_CHILD_FILES
- providers：未设置；具体省略行为见 README
- paceMs：默认 — (burst)
限制与使用条件
- 首次调用顺序绑定假设顺序委派；并发兄弟子代理可能非确定性绑定脚本
- 首次流块前的失败、取消、挂起及未标记外部摘要调用需要 override 辅助文件
真实应用加载冒烟支撑@deepseek-ai/dsh-loader-smoke
在隔离临时目录从真实入口和配置启动夹具。捕获输出并负责清理。
具体能力
- 在隔离临时目录从真实入口和配置启动夹具
- 捕获输出并负责清理
- 驱动单任务返回最终文本用量且可选源码或构建消费路径
限制与使用条件
- 仅供测试作者，不是产品集成启动 API
类型化 Remote 测试替身@deepseek-ai/dsh-remote-mock
用原生 Vitest mock 配置命名空间方法。同一函数回答直接调用与真实 Connection 流量。
具体能力
- 用原生 Vitest mock 配置命名空间方法
- 同一函数回答直接调用与真实 Connection 流量
- 支持显式流帧取消并在调用和清理时报告未匹配请求
限制与使用条件
- 只用于开发依赖，不能代替业务 Host
记录会话快照测试支撑@deepseek-ai/dsh-session-snapshot
提供封闭清单、身份脱敏、归一化与工作区比较。适配 headless、SDK、ACP 和 Web。
具体能力
- 提供封闭清单、身份脱敏、归一化与工作区比较
- 适配 headless、SDK、ACP 和 Web
- ACP 驱动真实子进程并注册记录回放刷新套件
限制与使用条件
- 入口导入 Vitest，只能在 Vitest 运行中使用
会话持久任务列表@deepseek-ai/dsh-tool-todo
整表写入待办并标记进行中与完成。跨回合和重开会话恢复最新计划。
具体能力
- 整表写入待办并标记进行中与完成
- 跨回合和重开会话恢复最新计划
- 配置是否允许多个任务同时进行
配置与默认行为
- allowParallelInProgress：必填，无插件默认值
限制与使用条件
- 只属于调用 Agent 会话，不是跨子代理共享任务表
TypeScript 运行类型产物生成器@deepseek-ai/dsh-typert-generator
从公开 TypeScript 导出生成反射模型。输出可执行 schema 工厂与声明。
具体能力
- 从公开 TypeScript 导出生成反射模型
- 输出可执行 schema 工厂与声明
- 验证 Remote 导出、发布清单及可表达 Zod 投影并支持分析 API
限制与使用条件
- 只在构建期运行，跳过通配 package export 模式
运行类型产物自动装载@deepseek-ai/dsh-typert-loader
监听 Loader 包挂载以注册生成反射和 schema 工厂。卸载时撤销贡献。
具体能力
- 监听 Loader 包挂载以注册生成反射和 schema 工厂
- 卸载时撤销贡献
- 显式 packages 列表覆盖无法解析 specifier 的嵌套插件
配置与默认行为
- packages：默认 []
限制与使用条件
- 仅加载宿主 ./typert 产物，需要配置树解析锚点
Host Remote 调用类型协议@deepseek-ai/dsh-typert-protocol
用 Remote 和 RemoteScope 标记可远程方法。通过可扩展映射关联对象、作用域与线身份。
具体能力
- 用 Remote 和 RemoteScope 标记可远程方法
- 通过可扩展映射关联对象、作用域与线身份
- 让生成物、网关与客户端共享描述符 codec 和提供者类型
限制与使用条件
- 不注册服务或运行 TypeScript 分析，装饰标记仅携带有限元数据
运行反射与懒 schema 注册表@deepseek-ai/dsh-typert-registry
按稳定键登记反射、schema 工厂和远程调用描述。首次访问时实例化并缓存 schema。
具体能力
- 按稳定键登记反射、schema 工厂和远程调用描述
- 首次访问时实例化并缓存 schema
- 原子注册且随组件释放，承载对象与作用域查找提供者
限制与使用条件
- 分别保存每个 face 的产物，不合并宿主和客户端类型图
安全原子文件替换@deepseek-ai/dsh-atomic-write
以新 inode 和调用者权限替换文件。跨进程写锁串行读改写以免覆盖。
具体能力
- 以新 inode 和调用者权限替换文件
- 跨进程写锁串行读改写以免覆盖
- 避免部分内容暴露和跟随恶意临时符号链接
限制与使用条件
- 不调用 fsync，原子替换不等于崩溃耐久
名义字符串与数字类型@deepseek-ai/dsh-brand
使结构相同 ID 在类型层不能互换。提供 brandString 与 brandNumber。
具体能力
- 使结构相同 ID 在类型层不能互换
- 提供 brandString 与 brandNumber
- 让领域拥有者独立声明品牌类型而不引入能力包
限制与使用条件
- 品牌只提供类型约束，不进行运行时输入验证
不可变分块追加列表@deepseek-ai/dsh-chunked-list
追加值时保留旧版本而不复制全列表。按插入顺序迭代。
具体能力
- 追加值时保留旧版本而不复制全列表
- 按插入顺序迭代
- 使用调用者提供的值 schema 验证 JSON 检查点
限制与使用条件
- 专注追加与迭代，不是任意修改的通用数组
统一代码语言扩展名表@deepseek-ai/dsh-util-code-language
大小写不敏感地把路径映射到标准 grammar ID。向预览注册表暴露可认领后缀。
具体能力
- 大小写不敏感地把路径映射到标准 grammar ID
- 向预览注册表暴露可认领后缀
- 从相同映射派生 read 卡片持久短语言 ID
限制与使用条件
- 只提供映射，实际代码分词由客户端高亮器负责
跨浏览器 UUID 与字节编码@deepseek-ai/dsh-util-crypto
用 crypto.getRandomValues 生成 UUID。为宿主和浏览器共享字节编码帮助函数。
具体能力
- 用 crypto.getRandomValues 生成 UUID
- 为宿主和浏览器共享字节编码帮助函数
- 支持普通 HTTP 局域网页面缺少 randomUUID 的环境
限制与使用条件
- 只生成 UUID v4，不提供其他版本、命名空间或解析
- 唯一性依赖122个随机位，不检测碰撞
摊销常数时间双端队列@deepseek-ai/dsh-deque
在头尾添加元素。从头弹出而不平移全部剩余元素。
具体能力
- 在头尾添加元素
- 从头弹出而不平移全部剩余元素
- 管理条目顺序及后备存储释放
限制与使用条件
- 唤醒、失败、取消、容量与过载由消费者处理
Harness 数据根目录解析@deepseek-ai/dsh-home-paths
按显式路径、DSH_HOME、用户默认顺序选数据根。隐藏绝对机器路径展示根并扩展当前用户波浪号。
具体能力
- 按显式路径、DSH_HOME、用户默认顺序选数据根
- 隐藏绝对机器路径展示根并扩展当前用户波浪号
- 规范化尚未存在的监听目标末端
限制与使用条件
- 仅展开裸或当前用户 tilde，不作为可挂载插件
统一出站 HTTP 代理策略@deepseek-ai/dsh-http-proxy
启动时读取标准代理环境并作用于 Node fetch。使本地回环直连且报告跳过不支持的代理 URL。
具体能力
- 启动时读取标准代理环境并作用于 Node fetch
- 使本地回环直连且报告跳过不支持的代理 URL
- 提供独立传输路由、子进程环境及回放清理帮助函数
限制与使用条件
- 只自动覆盖使用内置 fetch 的流量，其他传输须主动接入
带来源的启动环境快照@deepseek-ai/dsh-launch-environment
冻结继承环境、启动目录与 home 的 dotenv 层。按固定信任顺序返回值和来源。
具体能力
- 冻结继承环境、启动目录与 home 的 dotenv 层
- 按固定信任顺序返回值和来源
- 允许敏感读取排除指定层
限制与使用条件
- 仍把各层复制进 process.env，不提供子进程环境隔离
宿主依赖按需加载@deepseek-ai/dsh-lazy-require
延迟 CommonJS 兼容依赖到首次真实操作。按消费者包位置解析。
具体能力
- 延迟 CommonJS 兼容依赖到首次真实操作
- 按消费者包位置解析
- 在同一进程 realm 重用一次成功的模块值
限制与使用条件
- 仅适用于 CommonJS 兼容依赖，不能直接替代任意 ESM 导入
原生命令和桌面打开帮助函数@deepseek-ai/dsh-native-command
不经过 Shell 执行宿主可执行文件并捕获 UTF-8 输出。传播取消并要求明确 Windows 启动可见性。
具体能力
- 不经过 Shell 执行宿主可执行文件并捕获 UTF-8 输出
- 传播取消并要求明确 Windows 启动可见性
- 支持默认应用或编辑器打开、WSL 路径转换及桌面可用性检测
限制与使用条件
- 依赖可用桌面环境和原生程序，不提供 Cordis 服务
有界输出与省略说明@deepseek-ai/dsh-output-retention
保留有序条目头部并统计省略数。按字节保留 UTF-8 安全的文本头尾窗口。
具体能力
- 保留有序条目头部并统计省略数
- 按字节保留 UTF-8 安全的文本头尾窗口
- 统一省略提示并避免字符预算切断代理对
限制与使用条件
- 条目仅支持头部保留，分页分组、spill 与恢复指引由工具负责
共享包清单静态类型@deepseek-ai/dsh-package-manifest
声明 DshPackageManifest 顶层元数据。声明公共 dsh 字段与客户端等领域成员。
具体能力
- 声明 DshPackageManifest 顶层元数据
- 声明公共 dsh 字段与客户端等领域成员
- 让各读取者复用相同静态字段类型
限制与使用条件
- 没有 JSON 解析、验证、默认值求解或文件检查
标准时区验证与规范化@deepseek-ai/dsh-util-time
接受 UTC 或 IANA Area/Location。按平台 ICU 返回规范名称。
具体能力
- 接受 UTC 或 IANA Area/Location
- 按平台 ICU 返回规范名称
- 阻止别名直接进入需要稳定比较的持久记录
限制与使用条件
- 规范化名称依赖运行时 ICU 版本，不格式化时间或定义业务错误
截止时间与读取空闲监测@deepseek-ai/dsh-timeout
校验超时提示并按后端默认和上限夹取。合并本地截止与上游取消信号。
具体能力
- 校验超时提示并按后端默认和上限夹取
- 合并本地截止与上游取消信号
- 仅累计等待读取时间以识别流空闲
限制与使用条件
- 只能通知取消，不能停止忽略信号的进程或任务
无损 JSON 与不可变值工具@deepseek-ai/dsh-util-values
验证未知 JSON 并复制分离快照。冻结公开对象图。
具体能力
- 验证未知 JSON 并复制分离快照
- 冻结公开对象图
- 比较 JSON 结构或终止不可达闭合联合分支
限制与使用条件
- deepEqualJson 只接受 JSON 兼容值，不定义循环原型 Map 或 Set 语义
浏览器安全的工作区路径工具@deepseek-ai/dsh-util-workspace-path
连接相对路径并从 POSIX 或 Windows 路径派生标题。拆分展示路径、缩写 home 和移除 cwd 前缀。
具体能力
- 连接相对路径并从 POSIX 或 Windows 路径派生标题
- 拆分展示路径、缩写 home 和移除 cwd 前缀
- 定义跨侧栏与资源模型的 dsh-resource 文件地址语法
限制与使用条件
- 只做词法解析，不访问文件系统或解析符号链接
模型网页搜索与抓取工具@deepseek-ai/dsh-tool-web
分别启用 web_search 与 web_fetch。将提供者文本明确标为外部不可信并过滤抓取 HTML 的活动隐藏内容。
具体能力
- 分别启用 web_search 与 web_fetch
- 将提供者文本明确标为外部不可信并过滤抓取 HTML 的活动隐藏内容
- 缺失后端时保留工具且返回可行动结构化错误
配置与默认行为
- search：默认 true
- fetch：默认 true
- searchMaxResults：默认 8
- searchMaxQueries：默认 4
- fetchTimeoutMs：默认 30000
- searchTimeoutMs：默认 30000
- fetchMaxOutputChars：默认 200000
限制与使用条件
- searchMaxQueries 只限制输入查询数量，不是批次内原生搜索总次数计数器
供应商无关的网页能力接口@deepseek-ai/dsh-web
按搜索或抓取选择可用后端。统一取消、错误与结果限制。
具体能力
- 按搜索或抓取选择可用后端
- 统一取消、错误与结果限制
- 供插件通过 ctx.web 调用而不依赖具体供应商
配置与默认行为
- searchProvider：默认 (unset)
- fetchProvider：默认 (unset)
限制与使用条件
- 自身不联网，需要可用提供者且无提供者变化事件或状态查询
公共网页安全 HTTP 抓取@deepseek-ai/dsh-web-fetch-http
校验公共地址并固定连接目标。限制同源重定向、字节与字符并设置产品 User-Agent。
具体能力
- 校验公共地址并固定连接目标
- 限制同源重定向、字节与字符并设置产品 User-Agent
- 解码文本响应且将非2xx作为结果返回
配置与默认行为
- maxResponseBytes：默认 5,000,000
- maxBodyChars：默认 100,000
- timeoutMs：默认 30,000
- maxRedirects：默认 5
- userAgent：默认 deepseek-harness/…
限制与使用条件
- 只支持文本及 JSON/XML 家族，拒绝二进制与不支持类型
DeepSeek 原生搜索提供者@deepseek-ai/dsh-web-search-deepseek
使用 DeepSeek 登录或 API key 发起原生搜索。从结构化搜索块提取来源。
具体能力
- 使用 DeepSeek 登录或 API key 发起原生搜索
- 从结构化搜索块提取来源
- 缺少凭据或搜索块时返回明确错误
配置与默认行为
- apiKey：未设置；具体省略行为见 README
- apiKeyEnv：默认 DEEPSEEK_API_KEY
- baseURL：默认 https://api.deepseek.com/anthropic/v1
- model：默认 deepseek-v4-flash
- apiVersion：默认 2023-06-01
- maxTokens：默认 4096
- maxUses：默认 5
限制与使用条件
- 每次搜索占完整 Messages 模型轮次的延迟与 token 成本
Exa 搜索提供者@deepseek-ai/dsh-web-search-exa
使用 Exa API key 执行关键词或神经搜索。映射可引用来源、摘要及发布日期。
具体能力
- 使用 Exa API key 执行关键词或神经搜索
- 映射可引用来源、摘要及发布日期
- 仅返回原生搜索来源而不生成回答
配置与默认行为
- apiKey：默认 $EXA_API_KEY
- baseURL：默认 https://api.exa.ai
- searchType：默认 auto
- numResults：默认 (unset)
- highlightsPerResult：默认 1
限制与使用条件
- 没有非空 highlight 的结果被丢弃，来源数量可能少于请求值
Perplexity 回答式搜索@deepseek-ai/dsh-web-search-perplexity
一次返回生成回答及引用来源。把返回来源截断到调用者上限。
具体能力
- 一次返回生成回答及引用来源
- 把返回来源截断到调用者上限
- 无结构化元数据时降为 URL 引用
配置与默认行为
- apiKey：默认 $PERPLEXITY_API_KEY
- baseURL：默认 https://api.perplexity.ai
- model：默认 sonar
- maxTokens：默认 1024
- searchRecency：默认 (unset)
限制与使用条件
- 供应商不支持结果数控制，降级引用缺少标题摘要等字段
可信事件到会话的规则运行时@deepseek-ai/dsh-webhook
注册可信程序化 webhook 规则。分派标准交付给规则。
dsh-webhook · 接口摘录，省略上下文 · ctx.webhookRuntime.register · docs/subsystems/webhook.md · ctx.webhookRuntime.dispatch · docs/subsystems/webhook.md// 注册可信程序规则，卸载时中止并等待该规则的活动回调。
register<K extends string>(rule: WebhookRule<K>): () => Promise<void>
// 将已认证事件分派给匹配规则，回调结算前即返回。
dispatch<K extends string>(delivery: VerifiedWebhookDelivery<K>): void具体能力
- 注册可信程序化 webhook 规则
- 分派标准交付给规则
- 内置在 Web 工作区创建普通根会话的动作
限制与使用条件
- 进程内即发即弃，无队列重放重试或去重，崩溃可能丢失未准入提示
GitHub 签名 Webhook 入口@deepseek-ai/dsh-webhook-github
在 WebServer 注册精确 HTTP 路由。限制并验证 GitHub 原始 JSON 请求体。
具体能力
- 在 WebServer 注册精确 HTTP 路由
- 限制并验证 GitHub 原始 JSON 请求体
- 投影通用交付后立即返回202而不等待规则和会话
限制与使用条件
- 不提供 TLS，具体事件字段仍由规则验证
多轮新 Agent 目标迭代工具@deepseek-ai/dsh-tool-ralph
固定目标并前台顺序启动全新子代理。每轮只接收上轮有界报告与共享工作区状态。
具体能力
- 固定目标并前台顺序启动全新子代理
- 每轮只接收上轮有界报告与共享工作区状态
- 按完成、具体阻塞或轮数上限结束
配置与默认行为
- subagentProvider：默认 spawn
- maxRounds：默认 256
- maxHandoffChars：默认 16384
- maxResultChars：默认 16384
限制与使用条件
- 完成来自工作者自述而无独立验证，只在用户明确要求 Ralph 迭代时使用
JavaScript 多代理编排工具@deepseek-ai/dsh-tool-workflow
执行编排脚本并返回最终 JSON。前台等待全部工作，异常或取消返回错误。
具体能力
- 执行编排脚本并返回最终 JSON
- 前台等待全部工作，异常或取消返回错误
- 后台立即返回拥有者作业 ID 并提供实时日志
配置与默认行为
- toolName：默认 workflow
- maxResultChars：默认 50000
- enableRunInBackground：默认 true
限制与使用条件
- 后台结束前不返回中间值，只在明确请求工作流或大规模编排时使用
脚本化多代理编排服务@deepseek-ai/dsh-workflow
提供 agent、parallel、pipeline、phase 与 log 钩子。将每个子代理归属调用者并归一化失败取消结果。
// 启动调用者拥有的编排运行，结果结算后仍须释放运行。
abstract start(request: WorkflowStartRequest): WorkflowRun具体能力
- 提供 agent、parallel、pipeline、phase 与 log 钩子
- 将每个子代理归属调用者并归一化失败取消结果
- 释放时等待脚本和子代理清理
限制与使用条件
- 只拥有单个前台执行，后台轮询和 spill 由调用者负责且必须提供引擎
沙箱 Node 工作流执行提供者@deepseek-ai/dsh-workflow-ptc
在新 Node 进程中按会话文件策略执行 JavaScript。保留编排钩子并共享 PTC 执行提供者。
具体能力
- 在新 Node 进程中按会话文件策略执行 JavaScript
- 保留编排钩子并共享 PTC 执行提供者
- 取消时停止受管进程及释放子代理
配置与默认行为
- provider：默认 spawn
- maxConcurrentAgents：默认 0
- maxTotalAgents：默认 1000
- maxItemsPerCall：默认 4096
- syncTimeoutMs：默认 5000
限制与使用条件
- 无整体耗时截止，隔离强度与清理范围继承所选提供者限制