事件触发器jarvis959/galvanize-dsh

galvanize-dsh：在你的 DSH 代理中触发

给你的 DeepSeek Harness 代理一种自我唤醒的方式。 安装此
捆绑包后，你的 DSH 代理会自行注册事件触发器：文件落入某个文件夹、
收到一封电子邮件、webhook 触发、git push。当其中任一事件发生时，
galvanize 核心会用一个全新的无头 DSH 会话启动，并带上你的提示词
和事件数据——因此“当我的下载文件夹里出现一份简历时唤醒我”是一个
真正的推送触发器，而不是轮询任务。该插件本身是一个轻量、经过验证的
客户端：代理 schema 中有五个 trigger_ 工具，每个答案都从核心的
本地 API 代理而来。安装过程以证明插件已加载结束——一次无头启动
探测加上三项绿色检查——因为损坏的 DSH 插件会以静默无操作的方式失败，
而“应该没问题”是这个安装程序拒绝给出的唯一答案。

安装

适用于 Windows、macOS 和 Linux（Node ^22.19 || >=24——DSH 自身的
范围）。无需克隆；一条命令即可直接从 GitHub 运行：

npx github:jarvis959/galvanize-dsh install
或全局安装：npm install -g github:jarvis959/galvanize-dsh
从克隆安装：npm ci && node lib/cli.js install

install 需要机器上先具备两样东西：

1. galvanize 核心（同一系列；包含守护进程 + 自启动）：
pipx install "git+https://github.com/jarvis959/galvanize.git"
galvanize init

2. 将 DeepSeek Harness 及其 CLI 加入 PATH：
npm install -g @deepseek-ai/dsh

然后那一条 npx github:… 命令会将捆绑包挂载到你的 DSH web
配置文件（用 --profile  更改），引导无头唤醒配置文件，
启动一次 DSH 作为探测，并且只有在插件可验证地运行时才会打印三项
绿色检查：

✔ core /version handshake        core 0.1.2, api 1
✔ patch row 'galvanize/tools'    row present, package resolvable
✔ plugin heartbeat               plugin 0.1.2, core_api_ok=true, 3s ago
LOADED: all three checks green.

galvanize-dsh verify 可随时重新运行这些检查；
galvanize-dsh uninstall 会撤销一切。

第一个触发器

galvanize add folder ~/inbox --name triage --wake dsh \
--prompt 'Read {file} and write a triage summary to ~/inbox-out/{file}.md'

echo hello > ~/inbox/demo.txt   # 一分钟后：~/inbox-out/demo.txt.md

或者跳过 CLI，直接在 DSH 聊天中告诉你的代理：
“当一份实验室报告落到我的收件箱时唤醒我”——它会自行调用
trigger_add，先测试触发一次让你看它工作，然后保持安静，直到
事件真正发生。

代理获得什么

| 工具 | 作用 |
|---|---|
| trigger_add | 注册一个触发器（folder / webhook / emit / imap）——轮询任务的事件形态替代方案* |
| trigger_list | 正在监视什么，以及相关设置 |
| trigger_test | 通过真实调度路径触发一个合成事件 |
| trigger_status | 诚实的健康状况：守护进程、上次触发、今日触发次数、上次错误 |
| trigger_remove | 移除一个（包括路由清理） |

event ── galvanize core ── wake ──▶ dsh --profile headless ""
(folder/        (dedupe, cooldown,          │
mail/webhook/   routes, delivery)          ▼
git/emit)                          fresh DSH session

- 瘦客户端： JS 中没有唤醒或触发逻辑——一切都代理到核心的环回 API（GET /version、POST /manage/、bearer token），因此行为与核心针对 Hermes / Claude Code / Codex 的插件一致。
- 恰好一个表面： 插件和 galvanize mcp 从不共存；活跃的那个会占用 ~/.galvanize/surfaces.json，而核心的 doctor 会标记重复挂载。
- 唤醒预设： 核心会针对每个事件生成 dsh --profile  ""；配置文件、命令和心跳节奏是 bundle 行上的配置。

开发

npm ci && npm run build && npx vitest run && npx publint

src/index.ts（工具）· src/core-client.ts（serve 客户端）·
src/cli.ts（安装器 / 验证 / 卸载）· test/（针对桩核心的 18 个测试——无需 DSH）。CI 在 Windows、Linux 和 macOS 上运行矩阵。

许可证

MIT