dsh-debug-mode
English | 中文
为 DeepSeek Harness 提供运行时证据的 Debug Mode 插件。
它不再让 agent 只看源码猜问题，也不需要你在浏览器 console 和服务端日志之间来回复制。Debug Mode 会植入 1–3 个精准探针，将 Browser、Electron 和 Node 的关键事件统一写入结构化 JSONL，再由 agent 基于真实证据修复、验证和清理。
一条命令，一个证据闭环，不再人工翻日志。
安装与使用
需要 Node.js ^22.19.0 || >=24.0.0、PATH 中可用的 pnpm，以及 DSH 0.1.0-rc.7 或更高版本。
dsh plugin --profile web add "github:a554878526/dsh-debug-mode#main"
重启 dsh web，新建任务：
- 执行
/debug并描述问题。 - 按提示复现，然后点击 Continue。
- 确认修复后点击 Fixed，让 agent 清理探针、进程和日志。
JSONL 日志格式
每行是一个独立 JSON 事件：
{"sessionId":"a1b2c3","runId":"pre-fix","hypothesisId":"H1","location":"SessionStore.ts:restore","message":"cache lookup","data":{"hit":true,"entryCount":3,"timestampNs":"1775543428486123456"},"timestamp":1775543428486}
用 helper 生成 session id、日志路径、ingest 命令以及可直接复制的 Browser/Electron 和 Node 探针：
python3 scripts/new_debug_session.py --root .
运行时只记录能证明或否定假设的最小数据；不要记录密钥、凭据、PII 或大数组。生成的 JSON.stringify replacer 会把 bigint 转为十进制字符串，避免序列化失败和精度丢失。
复现后可手动汇总：
python3 scripts/summarize_debug_log.py .codex-debug/debug-.jsonl
正常 Debug Mode 流程中，这些 helper 都由 agent 自动调用。
开发
pnpm install
pnpm run check
dsh plugin --profile web add .
本地重装后需重启 profile 并新建任务，确保 DSH 加载新的 Host 和 client bundle。
旧版历史修复
0.1.1 及更早版本写入过官方 DSH 无法识别的 debug-mode/state 事件。停止 dsh web 后先检查，再执行带备份的修复：
python3 scripts/repair_debug_mode_sessions.py
python3 scripts/repair_debug_mode_sessions.py --apply
当前 Debug Mode 状态仅存在于 Host 进程中；重启 Host、刷新页面或重新打开任务后，需要再次执行 /debug。
