← 返回列表
⚠ 装前注意
DSH 插件：向模型暴露一个 sleep…
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/25 · 已提供中文文档
向模型暴露 sleep 工具，按指定毫秒暂停执行后返回，支持取消/clamp | Exposes a sleep tool that pauses for specified ms then returns, with cancellation/clamping
综合分
36.1
GitHub 分
36.1
用户评分
—
★ Stars
9
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add HuanLinOTO/dsh-plugin-sleep未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 4 天前真实安装成功（L4 · 真实安装）
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 1 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/22
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/25（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@huanlin/dsh-plugin-sleep（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=18.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 08:39:30
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-tools@deepseek-ai/dsh-llm用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-sleep
npm version
DSH 插件：向模型暴露一个 sleep 工具，让模型按指定毫秒数暂停执行后再返回。适合等待时间相关条件成立（服务重启、debounce 窗口、retry backoff）且没有事件型工具可用的场景。
安装
从 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）：
{
"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）：
- [x] 零源码 patch：未修改 DSH checkout 任何文件
- [x] B1: package.json 声明 dsh.bundle.patch
- [x] B2: 插件自带 cordis.patch.yml（insert 行 id/name/config 齐全）
- [x] B3: patch 行 name 用包名（Loader 从 profile node_modules 解析）
- [x] F1: files 含 lib/ + cordis.patch.yml
- [x] F2: peerDependencies 含 cordis + @deepseek-ai/dsh-tools（不用 devDependencies 冒充）
- [x] F3: typecheck/test/build script 齐全
- [x] A4: Config 用 Schemastery schema
- [x] A6: 不导出 default
- [x] C4: 工具返回规范 JSON 值 + render 投影分离
- [x] C6: 尊重 exec.signal 取消在途工作
- [x] G: Unit 测试（tests/tools.spec.ts，35+ 用例）
目录结构
dsh-sleep/
├── src/
│ ├── index.ts # 入口：name、inject、Config（Schemastery）、apply
│ ├── tools.ts # sleep 工具定义 + 可取消等待逻辑 + render 投影
│ └── types.d.ts # @deepseek-ai/dsh-tools + cordis 的环境类型声明
├── tests/
│ └── tools.spec.ts # 单元测试（覆盖正常/取消/clamp/边界）
├── cordis.patch.yml # bundle 层：插入 dsh-sleep 插件行
├── package.json # dsh.bundle.patch 声明 + peerDeps
├── tsconfig.json # NodeNext、ES2022、strict
├── tsdown.config.ts # 单 entry（host-only，无 client bundle）
└── vitest.config.ts # vitest forks pool