deepseekplugins

DeepSeek Harness 插件

deepseek-harness-tui

Interactive terminal chat TUI for the DeepSeek Harness (dsh)（英文原文）

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
gxinxing/deepseek-harness-tui
最近更新
2026年8月13日
分类
插件开发工具
GitHub stars
7
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/gxinxing/deepseek-harness-tui
插件名：deepseek-harness-tui
作者：gxinxing

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh-CN.md来源说明 · 只读预览
README 语言

deepseek-harness-tui

为 DeepSeek Harness 打造的交互式终端聊天界面——终端原生风格，基于 Ink（React 终端 UI 框架）构建。

准备一个 TokenDance key 和 dsh 安装，运行 dsh --profile tui 即可获得一个 zero-chrome 的终端聊天界面：底部锚定对话流、工具调用折叠成 cell、thinking 折叠、背景色经 OSC 11 自适应终端主题。它是一个精简、可读的插件（约 800 行 UI），不是对 harness 的重实现。

English · 简体中文

![GitHub stars](https://github.com/gxinxing/deepseek-harness-tui) ![License](LICENSE) ![DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)

![deepseek-harness-tui 终端运行截图](assets/screenshot.png)

安装

需要 Node.js ≥ 20 和 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh        # 安装 harness（暂无 Homebrew tap）
git clone https://github.com/gxinxing/deepseek-harness-tui
cd deepseek-harness-tui && pnpm install

把插件包装进 tui profile（一次性）：

dsh plugin --profile tui add @deepseek-ai/dsh-headless
dsh plugin --profile tui add /path/to/deepseek-harness-tui

使用

export TOKENDANCE_API_KEY=sk-...   # 或写入 ~/.dsh/.credentials.yaml（0600）
dsh --profile tui                  # 打开 TUI

TUI 内：ctrl + t 折叠 thinking，esc 中断当前回合，/help 查看全部按键与命令。

它能做什么

  • 终端原生 UI，而不是换个皮的复读机。 transcript 即界面——无边框、无装饰。DeepSeek 品牌 banner（ANSI Shadow logo，渐变配色）只在空态出现；model · cwd 放在底部 dim footer。
  • 工具调用折叠成 cell。 执行中 ⠋ Running <cmd> → 结束后 ✓ <cmd> • 1.2s（出错为 ✗），输出合并进 cell、置暗显示，按 head + tail 截断（… +N lines），不会刷出一大墙原始输出。
  • 主题由终端推导。 OSC 11 探测真实背景色：消息底色与代码 chip 由它混合而来（深色 12% 白、浅色 4% 黑），绝不写死十六进制；可用 DSH_TUI_BG=#ffffff 强制主题测试。
  • Thinking 可折叠。 ctrl + t 切换推理轨迹；esc 随时通过 agent.cancel({ kind: 'user' }) 中止回合。
  • Markdown 保持原形。 标题保留 #、围栏代码块保留围栏、行内代码有 chip 底色；中英文/emoji 按正确字符宽度折行，gutter 对齐。
  • 实时视口。 transcript 底部锚定，最新内容始终可见；忙碌时显示 braille spinner + 紧凑计时（Working 5s）。

了解更多

  • [INTEGRATION-NOTES.md](INTEGRATION-NOTES.md) —— 事件结构、patch 语义、集成深入解析（session/event 如何映射到 UI）
  • DeepSeek Harness —— 底层 agent 框架
  • [模型路由（TokenDance）](README.zh-CN.md#模型路由tokendance) —— 网关配置、凭据、一次性 tool-call 守卫

模型路由（TokenDance）

profile 补丁（cordis.patch.yml）把 llm-deepseek 路由到 TokenDance 网关：

llm-deepseek:
  apiKeyEnv: TOKENDANCE_API_KEY
  baseURL: https://tokendance.space/gateway/v1

provider 注册在 ~/.dsh/settings.yaml（llm-pi-ai.providers.tokendance）：OpenAI 兼容端点、thinkingFormat: deepseek，模型为 deepseek-v4-flash（默认）与 deepseek-v4-pro。切换模型：编辑该文件的 models 列表，或在 profile patch 里覆盖 llm-deepseek.model。

> 前置修复（一次性，每次安装 dsh 后需重打）。 TokenDance 流式返回 tool-call 增量时 name/id 为空串，官方 @deepseek-ai/dsh-llm-deepseek 适配器会用空串覆盖首个 frame 的 call id，导致 harness 陷入 unknown tool "" 死循环。请在 node_modules/@deepseek-ai/dsh-llm-deepseek/lib/index.js 应用守卫： > > ``diff > - if (call.id !== void 0) block.callId = call.id > + if (call.id) block.callId = call.id > - ... if (call.function?.name !== void 0) ... > + ... if (call.function?.name) ... > ` > > 已于 2026-08-13 在本机应用。该改动位于全局 dsh 安装中，升级 dsh` 后会丢失——升级后需重新应用（值得提一个上游 PR）。

自检 · 自修 · 自更新闭环

本项目内置完整的自动化质量门控，形成 自检 → 自修 → 自更新 闭环：

┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  本地开发时   │    │  提交前      │    │  CI / PR时   │
│  pnpm check  │───▶│ lint-staged  │───▶│  ci.yml     │
│  (一键全检)   │    │  (git commit) │    │  (GitHub)    │
└──────────────┘    └──────────────┘    └──────────────┘
      ▲                                       │
      │                                       ▼
      │                            ┌──────────────────────┐
      │                            │  lint + format:check  │
      │                            │  + test (Node 20/22)  │
      │                            └──────────────────────┘
      │                                       │
      ▼                                       ▼
┌──────────────────────────────────────────────────────────┐
│              deps.yml  (每周一自动依赖扫描)              │
│  发现更新 → 自动开 PR → review 后合并 → 闭环更新         │
└──────────────────────────────────────────────────────────┘

本地自检

pnpm check        # 一键全检：lint → format:check → test
pnpm lint         # 代码质量（ESLint）
pnpm format:check # 格式一致性（Prettier）
pnpm test         # 单元测试（Node built-in test runner）

本地自修

pnpm lint:fix     # ESLint 自动修复可修复的问题
pnpm format       # Prettier 自动格式化全部源码

提交时自动触发（husky + lint-staged）：

  • git commit → lint-staged 对 staged 文件自动执行 prettier --write + eslint --fix
  • 无需手动执行 pnpm format / pnpm lint:fix，已提交的代码始终整洁

依赖自更新

pnpm deps:check   # 扫描所有依赖的可用更新（分组展示 + 安全审计）
pnpm deps:update  # 将 package.json 升级到最新兼容版本并 pnpm install

GitHub Actions 自动执行（.github/workflows/deps.yml）：

  • 每周一 06:00 UTC 自动扫描依赖
  • 发现更新 → 自动创建 deps/auto-update-YYYYMMDD 分支 + PR
  • 可随时在 GitHub 手动触发 Dependency Update workflow

CI 门控（.github/workflows/ci.yml）

触发节点矩阵
push / pull_request to maininspectNode 20 + Node 22
lint✅
format:check✅
test (57 cases)✅
coverage uploadNode 22 only

任一阶段失败均阻断合并，确保主线始终通过全部自检。

贡献

欢迎提 issue 和 PR。适合新手的好任务：把两个运行时补丁提到上游（TokenDance tool-call 守卫、grep 权限错误容忍）、补充浅色主题截图、把欢迎 banner 移植到其他模型 provider。动事件桥之前先读 [INTEGRATION-NOTES.md](INTEGRATION-NOTES.md)。

License

[MIT](LICENSE)。独立社区项目，与 DeepSeek、TokenDance 无关联。

返回搜索打开 GitHub 仓库

更多相关插件

查看分类