dsh-hooks-pack

DeepSeek Harness 的一键 Claude Code / Codex hooks 整合包。

已经有 Claude Code 或 Codex 的 hooks.json？装上这个包，那些 hooks 直接在 DSH 里生效 —— 不用写代码、不用改配置。还没有 hooks？复制自带的示例包，一分钟获得「危险命令拦截 + 全量工具调用审计日志」。

重活由官方桥插件完成（@deepseek-ai/dsh-hooks-claude-code、@deepseek-ai/dsh-hooks-codex、共享协议 @deepseek-ai/dsh-hook-protocol），本包补上手动安装缺的三块：

1. 自动发现 —— 自动探测标准位置下的现有 hooks 配置。
2. 一行装配 —— 单个 bundle 行把两种方言挂到宿主平面。
3. 空闲安全 —— 任何配置都不存在时不注册任何东西；安装本身绝不改变 agent 行为。

安装

在插件市场界面搜索 dsh-hooks-pack → 安装。

或用命令行：

dsh plugin --profile web add github:REPLACE_ME/dsh-hooks-pack
# npm 发布后也可以：
dsh plugin --profile web add dsh-hooks-pack

安装后重启 profile（或刷新 Web 界面）。

会发现什么

方言	探测位置（命中即停）
Claude Code	$CLAUDE_CONFIG_DIR/hooks.json → ~/.claude/hooks.json → ~/.claude/settings.json（仅当含 hooks 键）
Codex	$CODEX_HOME/hooks.json → ~/.codex/hooks.json

显式路径优先于自动发现：

# 你 profile 的 cordis.patch.yml
- id: hooks-pack
  name: dsh-hooks-pack
  config:
    claude:
      configPath: D:/my-hooks/claude-hooks.json
    codex:
      configPath: D:/my-hooks/codex-hooks.json

支持的钩子点

经官方桥（仅 command 类型 hook）：

• Claude Code 方言：SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStart、SubagentStop
• Codex 方言：PreToolUse、PostToolUse、SessionStart、UserPromptSubmit、Stop

deny / ask 决策、阻断反馈、additionalContext 上下文注入均可用；每个事件的 stdin 载荷与 stdout 决议格式见各桥 README。

Hook 输出格式

决策必须使用 Claude Code 的结构化格式 —— 顶层的 permissionDecision 会被忽略：

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "deny",
    "permissionDecisionReason": "blocked by policy X"
  }
}

hookEventName 必须与触发事件同名（PreToolUse、SessionStart…），否则事件级字段被丢弃。退出码 2 同样会阻断，以 stderr 作为原因。

示例包

examples/claude-hooks.example.json 自带两个开箱即用的 hook：

• guard-dangerous（shell 工具的 PreToolUse）：拦截 rm -rf、force push、Remove-Item -Recurse -Force、格式化磁盘、fork 炸弹等
• audit-log（所有工具的 PostToolUse）：把每次工具调用追加到 ~/.dsh-hooks-audit.jsonl

启用方法：

# 1. 把 examples 复制到一个稳定位置
xcopy /E /I <profile-node-modules>\dsh-hooks-pack\examples %USERPROFILE%\dsh-hooks-examples\
# 2. 复制示例配置为你的 hooks 文件
copy %USERPROFILE%\dsh-hooks-examples\claude-hooks.example.json %USERPROFILE%\.claude\hooks.json
# 3. 编辑该文件，把 <ABS-PATH> 替换为 %USERPROFILE%\dsh-hooks-examples

配置项

键	类型	默认	说明
autoDiscover	boolean	true	无显式路径时探测标准位置
claude.configPath	string	自动发现	显式指定 Claude Code 配置文件
claude.pluginRoot	string	—	替换命令中的 ${CLAUDE_PLUGIN_ROOT}
claude.projectDir	string	会话 cwd	替换 ${CLAUDE_PROJECT_DIR} 并导出该环境变量
claude.defaultTimeoutMs	number	600000	hook 未设置超时时的默认值
codex.configPath	string	自动发现	显式指定 Codex 配置文件
codex.model	string	—	Codex 载荷中的 model 字段

已知限制

继承自官方桥：仅运行 shell 型 command hook（http / mcp_tool / prompt 型会告警跳过）；配置在进程加载时读取一次，暂不支持按会话发现项目级 hooks.json；部分 Claude Code 新事件未映射。完整清单见各桥 README。

兼容性

在 DeepSeek Harness 0.1.0-rc.7 + 桥包 0.1.0-rc.7 上测试通过。依赖范围同时接受 0.1.1-rc.1 以支持更新的部署。

许可

MIT