dsh-tui-guide

# dsh-tui 用户手册（索引） 用户手册全文就在**本文件所在目录**——`skill` 工具返回的 `resourceBase`。共 10 篇， 每篇中英各一份：中文文件名无后缀，英文加 `.en.md`。拿不到绝对路径时，用 `glob` 在 dsh-tui 包里搜 `guide/dsh-tui-guide`。 ## 怎么用 1. **跟用户同语言**：中文提问读无后缀文件，英文提问读加后缀的那份；回答也用同一种语言。 2. **先定位再读**：20 个文件按主题分篇，整篇读既慢又挤上下文。先 `grep` 关键词拿到命中行， 再用 `read` 带 `offset`/`limit` 只展开需要的那几段。 3. **一次一到两篇**：按下面的路由表挑最贴近的；跨主题时再补第二篇。 4. **给出处**：回答末尾写清来源（文件名 + 小节标题），用户能直接翻回去核对。 5. **别编**：手册没写的直说"手册没写"，再给保守建议；不要拿记忆里的旧行为顶替。 ## 路由表 | 用户问的 | 文件 | | --- | --- | | 安装、首次启动、启动失败、排障 | `getting-started.md` | | 日常使用、键位、斜杠命令、会话与工作流、设置 | `user-guide.md` | | 输入框、鼠标、选中复制、粘贴、图片、问卷与审批 | `interaction.md` | | 配置覆盖层、TUI 开关、agent preset、模型路由、MCP | `configuration.md` | | Claude 后端：启用、登录、与 DSH 的差异、已知限制 | `claude-backend.md` | | Codex 后端：安装、登录、渠道、Plan、会话与原生能力 | `codex-backend.md` | | 主题、配色、自动检测、自定义主题 | `themes.md` | | 从 Claude Code / Codex / OMP / zcode / Grok 迁移会话 | `migrate.md` | | VS Code 集成、扩展、IDE 选区 | `vscode.md` | | 插件生态、接缝稳定性分级 | `plugins.md` | 英文提问时把上表文件名接上后缀（例如 `user-guide.en.md`）。 > 除本文件外，这些副本由 `scripts/build-guide.mjs` 从仓库 `docs/` 逐字节同步生成， > 不要手改；改文档请改 `docs/` 再跑一次构建。