askdkc/dsh-cli 预览 preview

askdkc/dsh-cli

DSH向けCLI Plugin / DSH CLIplugin — supports easy ai provider setup for codex, claude, opencode, openrouter, hermes agent, orcarouter and infron

Project Overview项目介绍

dsh-cli is an interactive terminal UI plugin for DeepSeek Harness (DSH), distributed as askdkc's independently developed fork of chimney's dsh-TUI. It renders streaming Markdown, tool cards, inline images, and Mermaid diagrams inside a DSH session, while a pixel whale animation, a context bar, a live TPS gauge, and a clickable timeline give the harness a richer TUI. Installation requires Node.js ^22.19 or >=24, pnpm 11, a DeepSeek Harness source checkout with dependencies already installed, and a DEEPSEEK_API_KEY. Users clone the repository with --recurse-submodules, build a local tarball via node scripts/with-publish-manifest.mjs npm pack --ignore-scripts, then register it inside the harness tree with pnpm dsh plugin --profile dsh-cli add "@askdkc/dsh-cli@file:${TARBALL}" before launching pnpm dsh --profile dsh-cli.

The everyday workflow revolves around a set of slash commands. /resume opens the session manager with resume, fork, rewind, and background-run capabilities, /auth connects providers such as OpenAI, Claude, OpenCode, OpenRouter, Hermes Agent, Infron, and OrcaRouter, and /bg keeps a session running until the TUI exits. /model opens a centered picker with Favorites, Recent, and provider sections, where Ctrl+F toggles a favorite, Ctrl+A connects a provider, and /model seek deep performs an order-independent search; /lang switches the interface language separately from the working-status line that follows each accepted request. The companion dsh-cli migrate command imports conversation history from Claude Code, Codex, OMP, zcode, and Grok Build, although tool traffic is not carried over.

dsh-cli targets the latest DSH release and is primarily validated against Harness version 0.2.0-rc.2, with older supported versions listed in ADAPTER.md. Its license is MIT, the bundled 22-frame pixel whale animation is reused from lhh010's BSD-3-Clause dsh-ui-whale project, and the copyright header retains both chimney's original notice and dkc's fork notice. The first interactive launch registers dsh-cli for new shells, and updates must always be performed by rebuilding the tarball and reinstalling via the explicit @askdkc/dsh-cli@file:绝对路径 form, because a bare tarball reference can fail with ENOENT once a previous file: dependency archive has been removed.

dsh-cli 是 DeepSeek Harness(DSH)的一款交互式终端 UI 插件,作为 chimney 所写 dsh-TUI 的独立分叉继续开发。它在 DSH 会话中渲染流式 Markdown、工具卡片、图片、Mermaid 图形,并提供键盘补全、像素鲸鱼动画、上下文栏、TPS 仪表与可点击时间线。安装前需准备 Node.js ^22.19 或 >=24、pnpm 11、已装依赖的 DSH 源码以及 DEEPSEEK_API_KEY,通过递归克隆子模块后构建本地 tarball,再在 DSH 检出目录执行 pnpm dsh plugin --profile dsh-cli add "@askdkc/dsh-cli@file:${TARBALL}" 完成装载。

典型工作流围绕 /resume、/auth、/model、/bg、/lang 等斜杠命令展开:会话管理器支持恢复、分叉、回退与后台运行,/model 提供收藏、最近使用与按提供方分组的居中选模型面板,/model seek deep 可触发顺序无关的模糊搜索,/model provider/model-id 则直接切换。dsh-cli migrate 命令能把 Claude Code、Codex、OMP、zcode、Grok Build 的历史会话迁入 DSH,但工具调用流量不会被导入,适合需要在多个编码代理之间复用对话记录的用户。

依赖上还需 Git 子模块支持(git clone --recurse-submodules)、一条 MIT 许可的 BSD-3-Clause 像素鲸鱼动画素材,以及由 dkc 与 chimney 共同维护的双层版权声明。主要限制是当前主线验证的 Harness 版本为 0.2.0-rc.2,其它受支持版本记录在 ADAPTER.md;首次运行会在新 shell 中注册 dsh-cli,更新时必须重建并以 @askdkc/dsh-cli@file:绝对路径 形式重装,否则可能因旧 tarball 缺失触发 ENOENT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:askdkc/dsh-cli

把 askdkc/dsh-cli 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-cli animated whale logo

English | 简体中文 | 日本語

CI MIT License Public beta GitHub stars

dsh-cli

An interactive terminal UI plugin for DeepSeek Harness.

This is dkc's independently developed fork of dsh-TUI by chimney.

Preview

Recorded dsh-cli session with an animated pixel whale.

Highlights

  • Streaming Markdown, tool cards, images, Mermaid diagrams, and keyboard completion.
  • A pixel whale, live work status, context bar, TPS gauge, and clickable timeline.
  • Session management with resume, fork, rewind, background work, and export.
  • DSH presets, skills, MCP, goals, subagents, provider authentication, and extensions.
  • Authentication for OpenAI, Claude, OpenCode, OpenRouter, Hermes Agent, Infron, and OrcaRouter.
  • Virtualized rendering and bounded caches for long sessions.

Quick Start

Requires Node.js ^22.19 || >=24, pnpm 11, a DeepSeek Harness source checkout with dependencies installed, and DEEPSEEK_API_KEY. We aim to support the latest DSH release. The primary validated Harness version is 0.2.0-rc.2; older supported versions are listed in ADAPTER.md.

Clone recursively to fetch submodules. In an existing checkout, run git submodule update --init --recursive before installation.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-global-task-list 下一个 Next dsh-debate →