前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。对于习惯在终端中工作的开发者来说，标准的 CLI 交互往往缺乏流畅的视觉反馈和操作体验。dsh-omc-tui 是一个为 DeepSeek Harness 设计的原生终端交互界面插件，旨在提供类似 Claude Code 的全功能 TUI 体验。

该插件不替代 DSH 的核心能力，而是专注于终端侧的渲染、输入处理与工作流集成。

核心定位¶

• 名称：dsh-omc-tui
• 定位：DeepSeek Harness (DSH) 原生全功能终端交互界面
• 维护者：ipromise2021
• 协议：MIT
• 当前版本：v0.2.17（适配 DSH v0.2.0-rc.2）

核心功能¶

1. 独立视口与原生级终端体验¶

插件采用终端备用屏幕与视口差分渲染技术。启动后，交互在独立的全屏视口中进行，退出时自动恢复原 Shell 画面，并将会话内容写回终端历史。

• 顺滑滚轮回看与智能划选：支持 SGR 鼠标协议，支持单击、双击（中英文分词）和三击（整行）选区。复制时自动剥离 ANSI 样式。
• 输入恢复与健壮性：识别 CSI/OSC/DCS 等控制序列，对分片方向键、残缺粘贴和待机后的终端模式丢失设有恢复路径。

2. 双模态视觉体系¶

• 原生直传：支持在终端按 Cmd/Ctrl+V 粘贴图片，或通过 iTerm2/Kitty 协议发送，通过 Harness 附件管道自动落盘。
• 自主 Sidecar：在纯文本/代码模式下，Agent 可自主判断需要查看图片，并自动触发底层的 analyze_image 工具，在后台拉起隔离的视觉子代理处理。

3. 沉浸式排版与代码高亮¶

• Thinking 折叠：流式阶段显示动画与耗时，思考完毕自动收折。按 Ctrl+O 可原位展开思维链与工具组。
• 主题与高亮：内置 claude、deepseek、mono、light 四款主题，支持 Markdown、Diff 和代码块高亮。

4. 实时任务中心与 Plan 联动¶

• Durable 状态感知：全面接入 Harness 的 todo/write 持久化快照，任务状态实时驱动面板与状态栏。
• 会话恢复与 Jobs：支持从历史会话恢复任务进度。运行中的 Shell 命令可用 Ctrl+B 放入后台，或通过 /jobs 管理后台任务。

5. 行内安全审批与原生看门狗¶

• 行级红绿 Diff：文件修改与敏感命令执行前弹出结构化审批卡片，支持单键允许/拒绝与会话级权限提权。
• Danger Guard：在工具执行前拦截 rm -rf /、Fork 炸弹等危险指令，支持自定义规则。

6. 全景状态栏 (HUD) 与效率工作流¶

• 4 行全景状态栏：实时呈现模型、权限、Context 进度、Git 状态与扩展信息。
• 无污染旁路提问：使用 /btw 命令在独立临时会话提问，不污染主会话上下文。
• 自动压缩与回顾：达到 Context 阈值时自动触发压缩（/compact），支持 /recap 生成会话摘要。

安装与启用¶

在安装前，请确保终端支持 ANSI 256 色且已安装 Node.js（22.19+ 或 24.2+）。

1. 使用 DSH 的 tui profile 安装插件：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile tui add dsh-omc-tui@0.2.17

2. 启动 TUI：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile tui

典型用法¶

• 快捷键：
  • Enter：发送消息
  • Ctrl+O：展开/折叠 Thinking
  • Ctrl+J：多行输入
  • Ctrl+G：编辑 Prompt
  • @：浏览工作区
• 常用命令：
  • /model：选择模型
  • /preset：切换预设
  • /vision：配置视觉模型
  • /plan：进入/退出 Plan 模式
  • /btw：旁路提问
  • /compact：压缩上下文

适用场景与注意¶

该插件依赖 DeepSeek Harness 提供的 Agent 运行时、模型选择、会话与权限管理。插件本身仅负责终端交互与渲染。

• 适配版本：当前版本严格适配 DSH v0.2.0-rc.2。
• 权限范围：插件以当前 DSH 进程的权限运行，Agent 的安全沙箱由 DSH 控制。插件内置的 Danger Guard 提供额外的本地层拦截，但请务必检查源码与许可证。
• 环境要求：需要 Node.js 22.19+ 或 24.2+，支持 ANSI 256 色的终端。

总结¶

dsh-omc-tui 将 DeepSeek Harness 的能力封装在一个高性能的终端界面中，通过原生视口、差分渲染和沉浸式排版，解决了传统 CLI 交互体验不足的问题。配合行内审批、全景状态栏和双模态视觉能力，适合需要在终端中高频进行代码操作与任务管理的开发者。

• 项目地址：GitHub - ipromise2021/dsh-omc-tui
• 插件目录：SkillHub - dsh-omc-tui