DOPPLER Debug Skill
Use this skill when generation fails, outputs drift, or Node/browser parity breaks.
Fast Triage
bash
# Primary debug run (auto surface: Node first, browser fallback) npm run debug -- --model-id MODEL_ID --runtime-preset modes/debug --surface auto --json # Verify pass/fail with inference suite npm run test:model -- --suite inference --model-id MODEL_ID --runtime-preset modes/debug --surface auto --json # Force browser relay for mobile/WebGPU parity checks npm run debug -- --model-id MODEL_ID --runtime-preset diagnostics/debug-logits --surface browser --browser-channel chrome --browser-console --json
Runtime Overrides (Config-First)
Use runtime JSON patches instead of ad-hoc flags:
bash
npm run debug -- --model-id MODEL_ID --surface auto --runtime-config-json '{"shared":{"tooling":{"intent":"investigate"},"debug":{"trace":{"enabled":true,"categories":["attn","ffn"],"maxDecodeSteps":2}}},"inference":{"batching":{"maxTokens":8},"sampling":{"temperature":0}}}' --json
Cache and Surface Control
bash
# Cold browser run (wipe OPFS cache before launch) npm run debug -- --model-id MODEL_ID --surface browser --cache-mode cold --json # Warm browser run (reuse OPFS cache) npm run debug -- --model-id MODEL_ID --surface browser --cache-mode warm --json
What to Inspect in Results
- •
result.metrics.ttftMs,result.metrics.prefillTokensPerSec,result.metrics.decodeTokensPerSec - •
result.metrics.gpu(if available) - •
result.memoryStats - •
result.deviceInfo - •
result.reportInfo(report backend/path)
Canonical Files
- •
tools/doppler-cli.js - •
src/tooling/command-api.js - •
src/tooling/node-command-runner.js - •
src/tooling/node-browser-command-runner.js - •
src/inference/browser-harness.js - •
src/config/presets/runtime/modes/debug.json
Related Skills
- •
doppler-benchfor perf regression quantification - •
doppler-convertwhen conversion integrity is suspected