跳到正文
  • 首页
  • 插件说明
  • dsh-plugin-sleep

HuanLinOTO/dsh-plugin-sleep

60最近提交 2026年8月15日

dsh-plugin-sleep DSH 插件

该插件提供一个 `sleep` 工具，AI 模型可在 DSH 中调用它来暂停执行指定毫秒数。返回详细状态包括实际等待时间、是否被取消或钳制。适用于需要等待服务重启、重试退避等场景。

skills-workflowsdeveloper-tools

如何安装 dsh-plugin-sleep DSH 插件

dsh plugin --profile web add @huanlin/dsh-plugin-sleep

复制不会执行命令。安装 dsh-plugin-sleep DSH 插件前请核对仓库和版本。

dsh-plugin-sleep DSH 插件数据来源

dsh-plugin-sleep DSH 插件快照日期：2026年8月16日

discovered

dsh-plugin-sleep DSH 插件能做什么

  • 暴露 `sleep` 工具，可配置最大持续时长（默认 60,000 毫秒）。
  • 支持通过 `exec.signal` 取消，返回 `cancelled: true` 而不抛出错误。
  • 将请求时长钳制到 `maxDurationMs`，并报告 `clamped: true`。
  • 返回详细 JSON，包含 requested_ms、actual_ms、取消、钳制及可选原因。
  • 可配置模型省略参数时的默认时长。

dsh-plugin-sleep DSH 插件适合哪些场景

  • 等待服务重启后再继续后续操作。
  • 在模型驱动的工作流中实现防抖窗口。
  • 在 API 调用之间添加重试退避延迟。
  • 让模型有意暂停固定时间再继续。
  • 测试和调试模型行为，加入定时暂停。

dsh-plugin-sleep DSH 插件适合谁

  • 希望为工具添加等待能力的 DSH 插件开发者。
  • 需要模型等待外部条件的 AI 应用开发者。

dsh-plugin-sleep DSH 插件的限制

  • 仅提供单一 `sleep` 工具，没有其他等待机制（如轮询、事件驱动）。
  • 依赖 DSH 环境及其 peer 依赖（`cordis`、`@deepseek-ai/dsh-tools`）。
  • 最大时长被钳制到 `maxDurationMs`（默认 60,000 毫秒），无法无限期休眠。
  • 从模型角度看工具执行是同步的，但内部使用异步取消逻辑。

dsh-plugin-sleep DSH 插件的仓库 README 摘录

以下文字摘自 dsh-plugin-sleep DSH 插件的上游仓库 HuanLinOTO/dsh-plugin-sleep 的 README，版权归原作者，仅作引用。

> 📌 本插件已收录于 [dshfind](https://dshfind.com/zh) 插件超市，点击上方徽章直达主页。 # dsh-sleep [![npm version](https://img.shields.io/npm/v/@huanlin/dsh-plugin-sleep)](https://www.npmjs.com/package/@huanlin/dsh-plugin-sleep) DSH 插件：向模型暴露一个 `sleep` 工具，让模型按指定毫秒数暂停执行后再返回。适合等待时间相关条件成立（服务重启、debounce 窗口、retry backoff）且没有事件型工具可用的场景。 ## 安装 ```sh # 从 npm 安装（推荐）： dsh plugin --profile web add @huanlin/dsh-plugin-sleep # 从本地 checkout 开发安装： dsh plugin --profile web add link:D:\Projects\deepseek-harness\dsh-sleep ``` 预构建策略：`lib/` 入库，无 `prepare` 脚本，npm 安装开箱即用，无需 `allowBuilds`。 ## 配置 在 DSH GUI 设置页或 `cordis.patch.yml` 中配置： | 字段 | 类型 | 默认值 | 说明 | |------|------|--------|------| | `maxDurationMs` | number | `60000` | 单次 sleep 上限毫秒数。超过会被 clamp 到此值，并在返回中标 `clamped: true`。 | | `defaultDurationMs` | number | `0` | 当模型省略 `duration_ms` 时的回退值。 | ## 工具 ### `sleep` 暂停 N 毫秒后返回。 **参数：** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | `duration_ms` | integer | 是 | 暂停毫秒数，必须 ≥ 0。超过 `maxDurationMs` 会被 clamp。 | | `reason` | string | 否 | 人类可读的暂停理由，会原样回显。 | **返回（规范 JSON）：** ```jsonc { "requested_ms": 1000, // 调用方原始请求值 "actual_ms": 1002, // 实际等待毫秒数 "cancelled": false, // 是否被 abort 信号中断 "clamped":

阅读完整 README仓库许可: NOASSERTION

dsh-plugin-sleep DSH 插件常见问题

如何安装 dsh-plugin-sleep？

在 DSH 环境中运行 `dsh plugin --profile web add @huanlin/dsh-plugin-sleep` 即可。该命令会从 npm 安装包并激活插件。确保你已经安装并配置好 DSH。

最大睡眠时长是多少？

默认最大时长为 60,000 毫秒（60 秒）。你可以在插件配置中修改 `maxDurationMs` 字段。如果模型请求的时长超过该值，会被自动钳制，并在返回结果中标记 `clamped: true`。

睡眠可以被取消吗？

可以。如果睡眠期间 `exec.signal` 被中止，工具会立即停止等待并返回 `cancelled: true`。这是一种优雅的取消，不会抛出错误，模型可以将其视为正常的业务结果。

为什么 AI 模型需要睡眠插件？

模型有时需要等待外部条件，比如服务器重启或防抖窗口。没有睡眠工具，模型只能轮询或依赖其他工具。这个插件提供了一个简单、可取消的暂停，与 DSH 的工具系统集成良好。

有哪些配置项？

你可以配置 `maxDurationMs`（单次睡眠最大毫秒数，默认 60000）和 `defaultDurationMs`（模型省略 `duration_ms` 时的回退值，默认 0）。这些可在 DSH GUI 设置或 `cordis.patch.yml` 中修改。