dsh-tui

DeepSeek Harness 的终端客户端（TUI）。在 DeepSeek 生态内，以插件形式提供类似 Claude Code 的 agent 对话 + 类似 Vim 的模态输入 —— 在两者之间找一个平衡。

• Claude Code 功能：会话对话、斜杠命令、流式回复、工具调用、模型/成本状态栏
• Vim 形式：normal / insert / command 三模态，i/a/o 输入、h/j/k/l 移动、ESC 切换
• PTC 模式：默认用 DSH 的 code agent preset（Code Mode SDK，多步操作一次往返）
• 实时流：mux SSE 流式渲染，assistant/chunk 边生成边显示
• 成熟产品对齐的状态栏：Claude Code 风格 HUD（上下文窗 model[1M]、回合耗时 ⏱、内置文档计数、子 agent 计数）——综合 OpenCode / Codex 的输入与键位理念
• 会话管理：记忆最近会话、/resume 恢复、/new 新建、会话中切换
• 开放核心：core/ 纯 Node 零依赖，ui/ 是 Ink 层——VSCode 集成可直接复用 core

安装

已发布到 npm，一条命令全局安装：

npm install -g dsh-tui # 或局部：npm install dsh-tui

需要本机已运行 dsh web（DeepSeek Harness host，默认 http://127.0.0.1:3080）。启动 host 后即可运行下面的用法。

工作区建议（重要）：请在项目子目录而非用户根目录启动（如 cd C:\Users\zhntd\Desktop\my-project && dsh-tui）。 DSH 沙箱有硬性规则：临时目录必须在工作区之外。若在 C:\Users\zhntd 这类用户根目录启动， 系统临时目录 ...\AppData\Local\Temp 会落在工作区内而被拒绝，导致部分工具（如写临时文件、 浏览器临时文件）报错。切到项目子目录即可避开。

用法

# 交互式 TUI（TTY 下自动进入）
dsh-tui

# 新建 / 恢复最近 / 指定会话进入交互
dsh-tui --new
dsh-tui --resume
dsh-tui --session session-xxxx

# 一次性调用（默认新建 PTC 会话 → 打印回复）
dsh-tui run "帮我写个排序函数"
dsh-tui run --resume "继续刚才的"
dsh-tui run --session session-xxxx "接着干"

# 非 TTY（管道/脚本）下列出会话
dsh-tui --new | head

环境变量：
  DSH_URL    host 地址，默认 http://127.0.0.1:3080

TUI 操作

键	作用
i / A / o 等	进入 insert 模式输入
ESC	回 normal 模式
:	命令模态：:w 提交、:cancel 停止回合、:q 退出
/	斜杠命令：/new /resume /status 或 host 命令（/git status）
!cmd	当作 shell 命令交给 agent 执行（OpenCode 式）
@file	引用文件、可带行范围 @src/a.ts#10-20（OpenCode 式；Tab/方向键选择，Enter 插入）
Enter（normal/insert）	发送

HUD 状态栏

● deepseek-chat | PTC | $0.0123 | 1.2ki/450o  abcdef12 C:\work
   ↑ 运行状态    模型   成本      token         ↑ 会话id 工作目录

架构

lib/        core 层（零依赖）：client/fold/session/stream/live/vim/hud/policy/... 
ui/         Ink 组件层
bin/        cli 入口（interactive + run + list）
test/       单元飞轮（161 例）
test-live/  live 飞轮（真实 host，DSH_TEST_LIVE=1 才跑）

lib/index.js 导出 core API，供 VSCode 集成等复用，不依赖任何 UI。 自带 TypeScript 类型声明（lib/types/*.d.ts + exports 具名子路径，对齐官方 @deepseek-ai/* 插件规范）：

import { foldEvents, LiveConversation, hudState } from "dsh-tui"; // 全量类型
import { countProjectDocs } from "dsh-tui/docs";                 // 子路径
import { resolveVersion } from "dsh-tui/version";

贡献与社区

• 提交 issue / 需求 / PR：见 CONTRIBUTING.md，或用 GitHub 的 issue / PR 模板。
• 了解项目的 协同机制与反馈升级飞轮：见 docs/community.md —— 从上报到修复、测试、发布的完整闭环。
• 社区路线图：见 dsh-ecosystem。

开发

npm test          # 单元飞轮（快，161 例）
npm run check:types # 真实 TS 消费者编译校验（零错误）
npm run test:live # live 飞轮（真实 host，会调真实模型）
npm run flywheel  # --watch 快速迭代

详见 docs/flywheel.md。

授权

MIT