DeepSeek Harness Plugin Hub

Publish and manage complete Harness Profiles. Discover Plugins for your next setup.

Explore

PluginsPresetsDocsNews

Community

Publish a pluginContactReport an issue

Resources

Plugin Hub on GitHubDeepSeek HarnessSystem statusPrivacy notice
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

Independent and unofficial. Not affiliated with, authorized by, or endorsed by DeepSeek.

DeepSeek Harness Plugin Hub
ProfilesPluginsCategoriesNewsDocsSign inManage Profiles
ProfilesPluginsCategoriesNewsDocsSign in
← Plugins
S

dsh-shutdown-hook

Shutdown Hook

dsh unified exit barrier plugin: the sole SIGTERM/SIGINT interception point. Other plugins register pre-exit checks (drain/flush/persist), which are scheduled in parallel on exit. process.exit is called only after all checks complete. Prevents messages from being lost during asynchronous delivery wh

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:fatatalia/dsh-shutdown-hook#66a516379f01e5cd3ac44f010f34b07fd67accef
READMECompatibilityVersions

Description

dsh unified exit barrier plugin: the sole SIGTERM/SIGINT interception point. Other plugins register pre-exit checks (drain/flush/persist), which are scheduled in parallel on exit. process.exit is called only after all checks complete. Prevents messages from being lost during asynchronous delivery when restarting or stopping.

Compatibility and provenance

Shutdown Hook is published as dsh-shutdown-hook and currently resolves to version 0.1.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility
*
Runtime surfaces
any
Release source
github
Registry updated
10/18/2026

Versions

0.1.0stable
10/18/2026

Related plugins

Loading related plugins…

Latest
0.1.0
DSH
*
HMR
Process restart
Tree shaking
Safe tree shaking not declared
Unpacked size
Unavailable
Files
Unavailable
Surface
any
License
Not declared
Source
github
GitHub
★ 0
Weekly downloads
0
Last push
10/18/2026
View source ↗
README badge

Click the badge to copy Markdown for your README.

Do you maintain this Plugin?Claim benefit · Priority security scan

Verify the GitHub repository declared in package.json to manage this listing. After you claim it, Hub will prioritize a security scan of the current version and publish the result when it passes.

Claim this Plugin →
Report an issue

Related plugins

More verified plugins in developer-tools.

Web App@deepseek-ai/dsh-web-appThe dsh browser-surface bundle: the web patch layer over dsh-base plus the runtime glue plugin (frontend dist serving, web-surface prompt, bash runtime variables, URL line)Sdk Minimal@deepseek-ai/dsh-sdk-minimalThe standalone minimal SDK profile bundle: JSON-RPC, one DeepSeek adapter, persistent shell, and JSONL sessionsSdk App@deepseek-ai/dsh-sdk-appThe dsh SDK profile bundle: stdio JSON-RPC serving and process lifecycle over dsh-baseExperimental Inspector@deepseek-ai/dsh-experimental-inspectorExperimental cross-realm CDP hub for Host debugging and Client Runtime inspection

README

dsh-shutdown-hook

dsh 统一退出屏障插件：唯一 SIGTERM/SIGINT 拦截点，其他插件注册"退出前检查"（drain / flush / 落盘），进程退出时统一并行调度，全部完成才 process.exit(0)。

解决的问题

dsh 中 agent 回复经 iMessage 等渠道是异步投递的（assistant/message 事件 → 排队 → imsg 子进程）。进程被杀（重启 / 停止）时，未完成的投递直接丢失——表现为 Web 会话可见消息，但 iMessage 收不到。

本插件在进程层强制"退出前等投递完成"：由插件统一拦截信号并调度检查，不依赖模型自觉调用工具、不依赖 agent 纪律。

工作原理

launchctl kickstart / stop / Ctrl+C
        │  SIGTERM / SIGINT
        ▼
┌─────────────────────────────────────────┐
│  dsh-shutdown-hook（唯一信号拦截点）       │
│  ┌─────────────────────────────────────┐ │
│  │ 检查注册表: name → { fn, timeoutMs }│ │
│  │  imessage-drain ← dsh-imessage 注册 │ │
│  │  xxx-flush       ← 未来插件注册     │ │
│  └─────────────────────────────────────┘ │
│  并行执行所有检查（各自超时 + 全局兜底）   │
│  记录耗时/超时/失败 → process.exit(0)     │
└─────────────────────────────────────────┘

用法（其他插件）

硬依赖模式（服务必在，shutdown-hook 缺失时插件不激活）：

export const inject = ["shutdownHook"];  // cordis 保证本插件先加载

ctx.shutdownHook.register("imessage-drain", async () => {
  await core.drain();  // 等投递链清空
}, { timeoutMs: 5000 });

软依赖模式（推荐：独立插件不强绑，服务缺失时优雅降级，延迟加载/重载自动补注册）：

// 不要 inject "shutdownHook"
let registered = false;
const register = (barrier) => {
  if (registered || !barrier) return;
  barrier.register("imessage-drain", async () => { await core.drain(); }, { timeoutMs: 5000 });
  registered = true;
};
register(ctx.get("shutdownHook"));  // 立即尝试（可能尚未加载）
ctx.on("internal/service", (name, value) => {  // 服务出现/注销事件
  if (name !== "shutdownHook") return;
  if (value) register(value);
  else registered = false;
});

服务 API：

方法说明
register(name, fn, { timeoutMs })注册退出前检查（超时默认 5000ms）
unregister(name)注销检查
list()当前已注册的检查名列表

调度逻辑

收到 SIGTERM/SIGINT
  → 幂等检查（多次信号只执行一次）
  → 并行执行所有检查（Promise.allSettled，互不阻塞）
  → 每个检查独立超时（默认 5s），全局 10s 兜底
  → 记录每个检查的耗时/超时/失败（[sh] 日志）
  → process.exit(0)

边界

  • SIGKILL（kill -9）/ 进程崩溃：无法保证（进程直接死，任何方案都保证不了）
  • 检查超时：超时强制继续退出，避免进程悬挂
  • dsh 未来版本：若 dsh 核心自己注册 SIGTERM handler 并立即退出，本插件拦截会失效（当前 dsh 版本无）

已注册检查

插件检查名作用
dsh-imessageimessage-drain等 iMessage 投递链清空（重启不丢消息）

实战验证

  • 2026-08-28：两次 launchctl kickstart -k 重启均被拦截，imessage-drain 正常执行，重启前消息完整送达，新进程 2 秒内恢复。

日志示例

[2026-08-28 16:21:27] [sh] 收到 SIGTERM，执行 1 个退出前检查...
[2026-08-28 16:21:27] [sh] 检查完成: imessage-drain（17ms）
[2026-08-28 16:21:27] [sh] 退出前检查完成 1/1，总耗时 85ms，退出