dsh-project-hooksv1.0.0

luxbya/dsh-project-hooks

工作流 MIT 最近更新 2026-11-17
1Stars
0Forks
0待解决 Issue
安装命令 dsh plugin --profile web add github:luxbya/dsh-project-hooks#26f6ac117b48218e8b72927fe97907508a3601dd

介绍

Per-workspace project hooks: inject project context on each turn and run a compile gate before commits, with a settings panel and a run log.

标签

dsh dsh-bundle dsh-plugin hooks project-hooks session-start pre-commit git-hooks

概述

dsh-project-hooks

每个工作区各自一套项目钩子:会话(或每轮第一步)注入项目上下文,git commit 前跑项目自己的门禁脚本,内置配置面板与运行日志。

A per-workspace project-hooks plugin for DeepSeek Harness: injects project context at the start of each turn and gates git commit behind a project-owned script, with a settings panel and a run log.

它做什么

  • 项目上下文注入:从当前工作目录向上找到最近的项目根(含 .dsh/hooks.json),跑项目自己的 session-start 脚本,把输出注入成一条上下文消息。 注入时机跟着 hooks.json 里声明的事件走:配 agent/pre-step 就每轮第一步注入一次(同一 轮/步 只跑一次,模型请求重试不会重复执行),配 agent/created 就每会话一次。
  • 提交门禁:匹配 git commit 的 shell 调用先跑 pre-commit 脚本,退出码非 0 就阻断,并把你配置的理由回给模型。
  • 配置面板(设置 → 项目钩子):按项目、按钩子开关;超时、matcher、信任(记录的 hooks.json 哈希)与「试跑」。
  • 运行日志:侧栏独立面板 + 设置内页签;记录时间、项目、钩子、结果、耗时、退出码,可展开看执行的命令原文、脚本 stdout/stderr、解析出的钩子 JSON、注入正文与判定理由。 双上限自动裁剪最旧记录:体积默认 5 MB、条数默认 2000 条、单段输出默认 4000 字,面板里可改,立即生效。

安装

plugin_manager  install_bundle  target = dsh-project-hooks

装好后在 设置 → 项目钩子 里看到面板;侧栏可固定「项目钩子」图标打开运行日志。

项目侧需要一个 .dsh/hooks.json

放在项目根目录,按事件名列钩子脚本:

{
  "hooks": {
    "agent/pre-step": [
      {
        "commandWindows": ""C:\Program Files\nodejs\node.exe" .dsh/hooks/session-start.mjs",
        "command": "node .dsh/hooks/session-start.mjs",
        "timeout": 30,
        "firstStepOnly": true
      }
    ],
    "tools/pre-execute": [
      {
        "matcher": "win_bash|bash|pwsh|powershell",
        "command": "node .dsh/hooks/pre-commit.mjs",
        "timeout": 600
      }
    ]
  }
}
  • timeout 单位是秒。
  • 支持的钩子事件:agent/pre-step(每轮第一步,firstStepOnly: false 则每步)、agent/created(每会话一次)、tools/pre-execute(工具调用前,配合 matcher 与提交门禁)。
  • 脚本从 stdin 收一份 JSON(hook_event_name、session_id、turn_id、cwd、prompt、工具调用的 tool_name/tool_input),把要注入的正文打到 stdout 即可;退出码非 0 表示门禁不通过。
  • hooks.json 第一次被读到时是未信任状态,需要在面板里点一次「信任」;之后文件一变(哈希变),注入与门禁会停下并在日志里记 untrusted。

边界与已知限制

  • 只认 .dsh/hooks.json;工作区里没有该文件就完全不动,不注入也不记日志。
  • 子代理会话不注入(它继承父会话上下文,再注入只是噪声),只在日志里留一条 skipped-subagent。
  • 注入正文默认截到 2400 字(面板可改)。
  • 状态与日志落在 $DSH_HOME/project-hooks/(state.json、runs.jsonl),不写进项目仓库。
  • 目前只做「注入 / 门禁 / 日志」,不提供钩子脚本的自动生成。

许可

MIT。详见 LICENSE 与 docs/DETAIL.md。

星级评价

1.5 按 GitHub Stars 换算的社区热度,非用户打分
Stars1
Forks0
待解决 Issue0
最近更新2026-11-17

基本信息

作者LUXBYA
版本1.0.0
开源许可MIT
默认分支main
入库时间2026-11-17

插件信息来自公开 GitHub 仓库与 SkillHub,版权归原作者所有;安装前请自行审查仓库代码。