baobaolaodie / dsh-tui-vscode

dsh-tui-vscode

dsh-TUI 的 VS Code companion 扩展——体验与 Claude Code 官方 VS Code 扩展几乎一致
真实集成终端承载 · 编辑器区另一侧打开 · 多会话并存 · 侧边栏会话历史 · 指定会话恢复

English

---

dsh-tui-vscode

dsh-tui-vscode 让 dsh-tui 跑在 VS Code 真实的集成终端里（编辑器区另一侧新开一列，Windows 默认 PowerShell）——与 Claude Code 官方 VS Code 扩展的终端模式同构（createTerminal + 在终端内运行 CLI），没有 webview、没有 xterm 模拟层。 这是 ccch1mneyyy/dsh-TUI#161 的实现。

展示

点击鲸鱼按钮后，DeepSeek 终端在编辑器区另一侧打开并自动运行 dsh-tui——真实终端、真实 shell、完整 TUI：

特性

• 真实终端，非模拟：会话运行在 VS Code 集成终端（你的默认 shell），拥有终端的一切原生能力：shell 集成、原生 Ctrl+C、复制粘贴、字体主题跟随。
• 打开位置 = 另一侧：ViewColumn.Beside——在编辑器区旁边新开一列，绝不占你正在看的列（同 Claude Code）。
• 多会话并存：每次点击「启动新会话」都新开一个终端 + 会话，旧会话继续运行（同 Claude Code）。
• 侧边栏会话历史：只展示当前 VS Code 工作区下的会话（含工作区子目录里启动的会话；多根工作区取并集；未打开工作区时为空列表），隐藏只有启动记录、没有任何对话的空会话、子代理派遣运行与已归档会话（与 dsh web 列表同源：读 storages/workspace.json 的归档集合）——与 dsh 浏览器默认视图一致；标题 + 紧凑相对时间（与 Web 会话列表同源），点击条目恢复该指定会话；条目悬停可归档（dsh 原生归档：日志保留、可随时恢复）与重命名，右键菜单可永久删除（危险操作，默认从右键进入）；「管理已归档会话」命令可恢复或彻底删除；目录变化自动刷新。
• 一键启动/恢复：Start new session、Resume last session、侧边栏指定会话恢复——恢复指定会话走 DSH_TUI_RESUME_SESSION 环境变量通道（profile 的 cordis.patch.yml 启动时读取），与 --resume 互不干扰。
• 自动启停 + 环境注入：打开 = 启动，关闭终端 = 进程结束；$VISUAL / DSH_TUI_LANG / $DSH_HOME 自动注入终端环境。

快速开始

前置条件：全局安装 DSH CLI 与 dsh-tui（首次启动自动初始化 profile，需 pnpm），运行模型需要 DEEPSEEK_API_KEY：

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

从 VS Code 扩展面板安装（推荐）：Ctrl+Shift+X 搜索 dsh-tui 一键安装；或从源码构建：

git clone https://github.com/baobaolaodie/dsh-tui-vscode.git
cd dsh-tui-vscode
npm install
npm run install:local

使用

• 启动 / 多开：点编辑器标签栏右侧鲸鱼按钮，或命令 dsh-tui: Start new session / 启动新会话——每次都在编辑器区另一侧新开一个 DeepSeek 终端并自动运行 dsh-tui；再次点击 = 再开一个，多会话并行。活动栏鲸鱼图标打开侧边栏「会话历史」（欢迎页含启动/恢复按钮）。
• 恢复上次会话：dsh-tui: Resume last session / 恢复上次会话（--resume，读 ~/.dsh-tui/resume.txt）。
• 恢复指定会话：侧边栏「会话历史」展开项目 → 点击会话条目——新终端携带 DSH_TUI_RESUME_SESSION=<id> 环境变量启动该会话。
• 终止：关闭终端标签（只结束该会话），或在 TUI 内双击 Ctrl+C；命令 dsh-tui: Terminate session / 终止会话 向最近终端发送 Ctrl+C。

架构

flowchart LR
  classDef ext fill:#4D6BFE22,stroke:#4D6BFE
  classDef data fill:#2ea04322,stroke:#2ea043

  subgraph host["VS Code 扩展宿主"]
    CMD["入口：活动栏鲸鱼 · 编辑器标签栏按钮 · 命令面板"]:::ext
    TERM["createTerminal{ name: DeepSeek, location: Beside, env, iconPath, isTransient }"]:::ext
    SESS["会话历史 TreeView"]:::ext
    WATCH["fs.watch 监听会话目录"]:::ext
  end

  CMD -->|启动命令| TERM
  TERM -->|shell 就绪后运行 dsh-tui| SHELL["默认 shell（Windows: PowerShell）"]
  SHELL -->|node dsh-tui| TUI["dsh-tui 进程"]
  TUI -->|读写| STORE["~/.dsh/sessions（zstd JSONL）"]:::data
  TUI -->|最近使用| MRU["~/.dsh-tui/last-used.json"]:::data
  WEB["dsh web 会话列表"] --- STORE
  SESS -->|zstd 解码 + 标题三级兜底| STORE
  SESS -->|storage 账本标题| CACHE["~/.dsh/storages/session_projcache.json"]:::data
  SESS -->|last-used 排序| MRU
  WATCH -->|自动刷新| SESS

要点：

• 会话 = 真实终端：扩展只负责 createTerminal 与发送启动命令，进程、信号、滚动、复制粘贴全部由 VS Code 终端承载（与官方扩展同一架构）。
• 指定会话恢复：profile 的 cordis.patch.yml 在启动时读取 DSH_TUI_RESUME_SESSION env；刻意不传 --resume（启动器遇到 --resume 会用 ~/.dsh-tui/resume.txt 覆盖 env——已读 bin/dsh-tui.js 源码确认）。
• 会话历史数据源：会话日志（zstd 多帧串联，有界窗口读取：64KB 头 + 128KB 尾，逐帧拆解容错解码）→ 标题取日志 session/title 事件 → dsh-storage 账本（Web 列表同源）→ 首条真人消息（含 agent/inbox/spliced）→ 工作目录名兜底；按当前工作区过滤 + 隐藏空会话/子代理运行/已归档会话，组内按 last-used 排序。

配置

键	默认	说明
dsh-tui-vscode.command	dsh-tui	启动命令（按宿主 PATH 解析为绝对路径后发送）
dsh-tui-vscode.extraArgs	[]	每次启动追加的 CLI 参数，如 ["--lang","en"]
dsh-tui-vscode.lang	""	""/zh/en，写入 DSH_TUI_LANG
dsh-tui-vscode.injectEditor	true	未设 $VISUAL/$EDITOR 时导出 $VISUAL
dsh-tui-vscode.editorCommand	code -w	导出为 $VISUAL 的命令
dsh-tui-vscode.dshHome	""	覆盖会话的 $DSH_HOME（空 = 继承）

目录结构

dsh-tui-vscode/
├── src/
│   ├── extension.ts        # 激活入口：命令注册、createTerminal、视图注册
│   ├── session.ts          # 环境注入与启动命令解析（宿主 PATH）
│   ├── sessions.ts         # 会话数据层（多帧 zstd 拆帧解码 + 有界窗口读取 + storage 账本 + 工作区过滤 + 重命名/删除 + MRU 排序）
│   ├── sessions-view.ts    # 侧边栏会话历史（当前工作区 + 隐藏空会话/子代理 + fs.watch 自动刷新）
│   ├── status.ts           # 状态栏项
│   ├── test/               # 数据层单元测试（node:test）
│   └── test-suite/         # 真实扩展宿主 e2e（@vscode/test-electron）
├── media/icon.svg          # DeepSeek 鲸鱼图标（活动栏 / 终端标签）
├── media/icon.png          # Marketplace 图标
├── scripts/
│   ├── install-commit-hook.mjs  # 本地钩子安装脚本
│   └── install-local.mjs        # 安装本地打包的 vsix（从 package.json 动态取版本号）
├── .githooks/              # pre-commit / commit-msg（入库分发）
├── .github/
│   ├── workflows/ci.yml    # 完整 CI（test 矩阵/e2e/quality/pr-policy/release-consistency/security-scan/docs-links）
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── ISSUE_TEMPLATE/     # 四类 issue 表单
├── CONTRIBUTING.md / CONTRIBUTING_EN.md
├── SECURITY.md / SECURITY_EN.md
├── CODE_OF_CONDUCT.md / CODE_OF_CONDUCT_EN.md
├── CHANGELOG.md / CHANGELOG_EN.md
├── README_EN.md
├── package.json
└── LICENSE

技术栈

层	技术
语言	TypeScript 5.6（源码 ESM 语法，编译产物 CommonJS；Node 24 开发运行时）
平台	VS Code Extension API（engines ^1.90.0）
运行时依赖	@bokuweb/zstd-wasm（会话日志 zstd 解压，唯一依赖）
测试	node:test 单测 + @vscode/test-electron 真实扩展宿主 e2e
打包	@vscode/vsce
CI	GitHub Actions（Linux/Windows 矩阵 + xvfb）

CI / 验证

.github/workflows/ci.yml 在每次 push/PR 运行：test job（Linux/Windows × Node 22/24 矩阵：npm ci → typecheck → npm test）与 e2e job（Linux + xvfb：npm ci → npm run test:e2e → npm run package）。 另有 quality（双语镜像对称 / BOM 防线 / actionlint）、pr-policy（Conventional Commits 标题、分支前缀、PR 模板完整性、CHANGELOG 自查真实性）、release-consistency（版本五处一致 + 每版本段 PR 链接）、security-scan（凭据扫描）与 docs-links（死链检查）job。

e2e 覆盖：命令注册、真实终端创建与环境注入、输入回环、多会话、Ctrl+C 终止、--resume 恢复、指定会话恢复（env 通道、不传 --resume），以及受保护的真实 dsh-tui 恢复测试（恢复成功 = 不新建会话，可观测）。

贡献

请阅读 CONTRIBUTING.md（中英双语）——分支前缀、Conventional Commits 提交、PR 模板与验证要求由 CI 强制。

许可

MIT © 2026 baobaolaodie。dsh-tui 本体为 ccch1mneyyy/dsh-TUI（MIT）。