修复 DSH 兼容性 Hooks 通过 shell bridge 执行导致会话无响应

[anpark]

背景

deepseek-harness 需要兼容 Codex 和 Claude Code 风格的外部 hooks，包括 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse 和 Stop。

这些 hooks 可能调用宿主机上的 Python、Shell 或其他命令，并依赖标准 JSON stdin/stdout、环境变量、工作目录、超时和取消机制。

此前 DSH bridge 使用 ctx.shell 执行兼容性 hooks。对于 task-harness 这类会执行宿主脚本、读写任务状态并同步等待结果的 hooks，可能导致 DSH 会话无响应。

同时，workspace build 脚本会错误处理 monorepo solution root，导致 tsdown workspace 配置和 client synthetic workspace 配置被破坏。

解决方案

1. 兼容性 Hooks 改为宿主 subprocess 执行

新增：

• packages/hooks/hook-protocol/src/runner.ts
  • 增加 runHookOnHost
  • 通过 ctx.subprocess 在宿主环境执行 hook
  • 保留 stdin JSON 传递、stdout/stderr 捕获、cwd/env 传递
  • 支持 timeout、cancel 和进程树终止
  • 限制 stdout/stderr 大小，避免异常输出拖垮会话

更新：

• packages/hooks/hooks-codex/src/index.ts
• packages/hooks/hooks-claude-code/src/index.ts

两个 bridge 都从注入 shell 改为注入 subprocess，统一走宿主执行路径。

2. 更新依赖、锁文件和测试

更新：

• packages/hooks/hook-protocol/package.json
• packages/hooks/hooks-codex/package.json
• packages/hooks/hooks-claude-code/package.json
• pnpm-lock.yaml
• 两个 bridge 的 tests/bridge.spec.ts
• 两个 bridge 的 tests/coverage-cases.ts

新增对 @deepseek-ai/dsh-subprocess 和相关 timeout 能力的依赖，测试 mock 也切换到 subprocess 执行路径。

3. 更新 Hooks 文档

更新：

• packages/hooks/hook-protocol/README.md
• packages/hooks/hook-protocol/README.zh.md

补充 shell 兼容路径与 trusted host subprocess 执行路径的说明。

4. 修复 workspace build

更新：

• scripts/build-workspace.ts
• scripts/wine-windows-gates.sh
• package.json
• docs/api-gateway.md
• docs/api-gateway.zh.md
• docs/development.md
• docs/development.zh.md

解决 solution root 被错误纳入 tsdown workspace，以及 synthetic client workspace 配置被清理的问题。

验证结果

• hooks bridge 测试：36/36 通过
• TypeScript 编译通过
• oxlint 通过
• workspace host build 通过
• pre-commit 全部通过
• DSH web profile 可以正常启动
• host subprocess runner 已完成实际执行验证

本地提交

当前分支：fix/tsdown-workspace-root-entry

1e3eebdd8b fix(build): exclude solution root from tsdown workspace
35434c342f fix(build): retain synthetic client workspace configs
6a101006f5 fix: run compatibility hooks in host subprocesses

当前代码已在本地完成并通过验证，欢迎维护者 review 该方案。