在 VS Code 中使用

August 16, 2026 · View on GitHub

dsh-tianshu-tui 是终端应用,在 VS Code 内置终端中直接运行即可。当前没有官方 VS Code 扩展;本文给出推荐的终端配置与常见问题。

启动

  1. 安装插件(见快速开始)。
  2. 在 VS Code 内置终端(Terminal → New Terminal)运行:
npx -y @deepseek-ai/dsh --profile tui

推荐终端设置

VS Code 内置终端默认即可用;以下设置可提升体验(settings.json):

{
  // 图片渲染:内置终端支持终端图形协议时,剪贴板图片可内联显示
  "terminal.integrated.enableImages": true,
  // 高对比下 TUI 颜色更准;按你的主题选择
  "terminal.integrated.minimumContrastRatio": 1,
  // 宽终端(顶部栏/工具卡有更多空间)
  "terminal.integrated.defaultProfile.osx": "zsh",
  // 字体:等宽 + 中文兼容(如 JetBrains Mono / Sarasa 更纱黑体)
  "terminal.integrated.fontFamily": "JetBrains Mono, 'Sarasa Mono SC', monospace"
}

常见问题

图片粘贴不生效 VS Code 内置终端的图片支持取决于版本与协议(kitty graphics / iTerm2 内联)。 确认 terminal.integrated.enableImages 已开;仍不行时用文本粘贴(Ctrl+Shift+V)。

颜色与外部终端不一致 TUI 会自动检测终端能力并降级(16 色/ASCII);VS Code 终端通常支持真彩色,无需 处理。若自定义主题与你的 VS Code 主题冲突,用 /theme 切换(见主题)。

退出后终端残留 Ctrl+Q / /exit 退出会恢复硬件光标并把 TTY 还给 shell(0.1.2-rc.6 起)。 若异常退出导致终端错乱,在 VS Code 里执行 reset 即可。

快捷键冲突 VS Code 会拦截部分组合键(如 Ctrl+W 关闭终端、Ctrl+K 快捷键面板)。 TUI 的键位设计避开了这些(核心键是 Ctrl+N/S/Q/P/F/O/E/T 与 Ctrl+.); 若仍有冲突,可在 VS Code 键位绑定里把对应组合改为 terminal.sendSequence 或 workbench.action.terminal.sendSequence 转发。