dsh-sleep

DSH 插件：向模型暴露一个 sleep 工具，让模型按指定毫秒数暂停执行后再返回。适合等待时间相关条件成立（服务重启、debounce 窗口、retry backoff）且没有事件型工具可用的场景。

安装

# 从 git 安装（推荐）：
dsh plugin --profile 
 add github:huanlinoto/dsh-plugin-sleep

# 从本地 checkout 开发安装：
dsh plugin --profile 
 add link:D:\Projects\deepseek-harness\dsh-sleep

预构建策略：lib/ 入库，无 prepare 脚本，github: 安装开箱即用，无需 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）：

{
  "requested_ms": 1000,   // 调用方原始请求值
  "actual_ms": 1002,      // 实际等待毫秒数
  "cancelled": false,     // 是否被 abort 信号中断
  "clamped": false,       // 是否因超过 maxDurationMs 被钳制
  "reason": "..."         // 可选回显
}

取消语义：如果 sleep 中途 exec.signal 被 abort，工具不抛错，而是立即返回 cancelled: true（取消属于业务非理想态，不属基础设施失败，参见 plugin-development-guide.md §3 C5）。

开发

pnpm install          # 安装开发依赖（schemastery、typescript、vitest）
pnpm run typecheck    # tsc --noEmit 类型检查
pnpm test             # vitest run 单元测试
pnpm run build        # tsc + tsdown → lib/

检查

合规自检（参见 plugin-development-guide.md §10）：

• 零源码 patch：未修改 DSH checkout 任何文件