# Dsh Debug Session

> 排查 DSH 启动失败、插件不生效或会话异常时使用：按序收集信息、二分定位、备份回滚。

- Skill: `hackerfish/dsh-debug-session` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hackerfish/dsh-debug-session`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hackerfish/dsh-debug-session/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hackerFish (https://skillmd.com/u/hackerfish)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hackerfish/dsh-debug-session

---


# DSH 问题排查

## 先收集（一并写进求助帖）

- DSH 版本、node/pnpm 版本
- 插件清单（profile 的 package.json 依赖）
- 完整报错与日志、复现步骤

## 排查顺序

1. `dsh --profile web --dump-config`：确认插件层是否真的进入配置
2. 看启动日志：报错是否指向某个插件
3. 二分法：移除最近安装的插件 → 重启 → 确认是否恢复
4. 检查安装摩擦：pnpm 9 需 `--ignore-workspace-root-check`；大依赖树直连超时换 npmmirror；git 插件 prepare 需 allowBuilds 放行
5. 版本漂移：核对插件测试时的 DSH 版本与当前版本（参考 dsh-lab 报告）

## 备份与回滚

- 改配置前备份 `$DSH_HOME/profiles/<名字>/`（核心是 package.json 与 cordis.patch.yml）
- 出问题先恢复到备份状态，再逐项重放改动

## 求助

官方 GitHub Discussions 是明示关注的渠道；发帖附上前面的信息，描述"期望 vs 实际"。