dsh-project-hooksv1.0.0
luxbya/dsh-project-hooks
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-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。
星级评价
基本信息
插件信息来自公开 GitHub 仓库与 SkillHub,版权归原作者所有;安装前请自行审查仓库代码。