dsh-notice-hooks
在终端中运行以下命令:
dsh plugin install oliverCJ/dsh-notice-hooks
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install oliverCJ/dsh-notice-hooks 即可安装插件,源码仓库为 https://github.com/oliverCJ/dsh-notice-hooks。
插件介绍
在 DeepSeek Harness 里,很多「会话开始、工具调用前后、权限弹窗、上下文压缩」等时刻,你希望自动跑一段脚本做审计、通知或记录,又不想把这些逻辑写进 Agent 本身。dsh-notice-hooks 把这类需求沉淀成可配置的 Hooks:在用户级与已注册工作区的项目级两套作用域里声明事件、匹配规则与要执行的命令,由 Harness 在对应生命周期点触发。
插件覆盖 14 类事件,匹配器使用完整正则语义,可对工具名、会话来源、压缩方式等取值做精确过滤。命令以非 shell 方式启动(需要管道或变量时请显式调用 shell),并向标准输入写入带 schema 的 JSON 载荷,便于你用任意语言写独立消费者。单次触发是 fire-and-forget:超时、并发上限、禁用或卸载会终止进程树,但 Hook 失败不会阻断 Agent 或工具执行。
安全模型与配置分离:除 enabled 开关外,还需在「Hooks 设置」或会话审查对话框里按执行指纹人工授权;指纹绑定作用域、Hook ID、事件、匹配器、命令、超时与并发,任何变更都会失效旧授权。用户与项目配置各自校验,一方无效不影响另一方,适合既要全局个人习惯、又要按仓库落地团队规范的场景。
适合需要可观测性与合规留痕的开发者、希望在本地或 CI 工作区统一挂钩点自动化的团队,以及想在不改核心 Agent 的前提下扩展会话工作流的同学。配置通过专用设置页与审查流程管理,而不是裸改 JSON 即视为已授权。
使用场景
- 在 PreToolUse / PostToolUse 按工具名正则触发脚本,把调用参数写入本地审计日志
- 会话启动或结束时向通知渠道推送摘要,且不干扰 Agent 对话
- 在上下文压缩前后运行校验或备份脚本,并配合 Hooks 设置完成指纹授权
适合人员
- 希望在 Harness 生命周期挂接自定义命令的开发者
- 需要按用户级与项目级分别治理 Hook 的团队
- 关注合规留痕、权限审查与失败隔离的运维或平台同学