rakibulrocky14/dsh-cli

⚡ dsh-cli (dsh-terminal)

终端中的 DeepSeek Harness —— 基于 dsh-base 的、与 Web GUI 对等的 Cordis 界面。你的智能体、预设、工具、会话、审批、设置和插件，直接呈现在你的终端中。不多不少，恰到好处。

License: Apache 2.0
Node.js Version
Community Plugin-0066FF.svg)

[!IMPORTANT]
免责声明：这是一个独立的、由社区驱动的开源项目，与 DeepSeek AI 或官方 DeepSeek 团队无关联、未获其认可或赞助。“DeepSeek”和“DeepSeek Harness”是其各自所有者的商标。

dsh-terminal 初始界面

dsh-terminal 智能体预设

✨ 功能特性

- 🎨 DeepSeek 蓝色主题与现代 TUI：简洁的圆角输入框、品牌化 ASCII 鲸鱼横幅、动态状态栏，以及自动适配整个终端宽度。
- 🎛️ 完整的智能体预设对等：使用 /presets 在 标准模式、PTC 模式（代码模式）、极简模式 和 创作者模式 之间动态切换。
- ⚡ Web GUI 对等：实时流式渲染、推理强度指示器、工具调用卡片、会话选择器、模型切换器，以及交互式审批弹窗。
- 🔌 无缝的 Cordis 插件支持：DSH 环境中的任何插件都能自动在终端中运行。
- 🖱️ 完整的终端导航：流畅的鼠标滚轮滚动、PageUp/PageDown、斜杠命令的 Tab 自动补全，以及快捷键。
- 🧩 启动时的三种模式：
- 全屏 TUI：在交互式 TTY 上默认启用。
- 行 REPL：适用于管道、无头环境、CI，或使用 --line。
- 一次性 CLI：通过 --print "" 运行单个任务并输出响应。

📦 安装与设置

前置要求

- Node.js ^22.19 || >=24
- 系统中已安装 DeepSeek Harness (dsh) CLI。

方式一：通过 DSH CLI 直接安装（推荐）

使用 dsh plugin add 将此插件直接添加到你的 DSH 配置中：

Add to a dedicated 'terminal' profile
dsh plugin --profile terminal add github:rakibulrocky14/dsh-cli

方式二：克隆并在本地安装

1. Clone the repository
git clone https://github.com/rakibulrocky14/dsh-cli.git
cd dsh-cli

2. Install dependencies & build
npm install
npm run build

3. Add to DSH profile as a local plugin
dsh plugin --profile terminal add .

🚀 使用方法

启动终端 TUI

启动全屏终端界面：

dsh --profile terminal

命令行标志

Run with a specific model
dsh --profile terminal --model deepseek-reasoner

恢复现有会话
dsh --profile terminal --resume session-c302f9d0

强制使用标准行 REPL（非 TUI）
dsh --profile terminal --line

一次性执行（执行任务、打印结果并退出）
dsh --profile terminal --print "Explain how to set up a git repository"

添加更多插件

将额外的 DSH 插件堆叠到你的终端配置中：

dsh plugin --profile terminal add

🎛️ 智能体预设

随时使用 /presets 打开交互式预设菜单，或通过 /presets  直接切换：

| 预设 | ID | 描述 |
|--------|----|-------------|
| 标准模式 | standard | 功能完整的编码智能体，支持文件编辑、shell 执行、搜索、技能、规划、子智能体和工作流。 |
| PTC 模式 | code | 具备标准模式的全部能力，并通过 Code Mode SDK 暴露工具，用于多步骤 TypeScript 执行。 |
| 极简模式 | minimal | 超快速的双工具编码智能体，配备持久化 bash 和 str_replace_editor。 |
| 创建者模式 | cordis | 专为编写和测试自定义智能体预设而构建，支持实时运行时检查和插件工具。 |

⌨️ 快捷键与导航

| 按键 | 操作 |
|-----|--------|
| Enter | 发送消息 / 确认选择 |
| Esc | 关闭当前对话框 / 返回对话记录 |
| Tab | 自动补全斜杠命令 |
| ↑ / ↓ | 循环浏览命令历史或导航菜单 |
| PageUp / PageDown | 向上 / 向下滚动对话记录 |
| Mouse Wheel | 平滑滚动浏览历史和代码输出 |
| Ctrl + O | 展开 / 折叠工具输出卡片 |
| Ctrl + C | 取消当前回合（空闲时清除提示） |
| Ctrl + D | 退出 / 结束会话 |

🛠️ 斜杠命令

输入 / 后按 Tab 查看所有可用命令：

- 会话：/sessions（交互式会话浏览器）、/resume 、/new、/fork
- 配置：/presets（智能体模式）、/model（提供商和模型选择器）、/effort（推理强度级别）、/settings、/permissions
- 检查：/tools（活动工具定义）、/commands（所有已注册的斜杠命令）、/skills、/agents、/plugins、/jobs、/usage、/doctor
- 工作区：/terminals、/todos、/title、/clear、/stop、/quit

🏗️ 架构

dsh --profile terminal
└── dsh-terminal (Cordis bundle)
├── cordis.patch.yml      base rows + code-runtime + cordis-host + ask-user + startup + runner
├── dsh-terminal/startup  command-line flags → terminalStartup
└── dsh-terminal          runner → TUI | REPL | --print
├── core/dsh.ts         service facade & runtime feature detection
├── core/transcript.ts  durable-log projection & live streaming overlay
├── core/messages.ts    deep-frozen message factories
├── core/lineinput.ts   single-reader TTY/pipe input
├── repl.ts             行 REPL 界面
├── print.ts            一次性执行界面
└── tui/                行为引擎与 Ink React 组件树

🧪 开发与测试

类型检查
npm run typecheck

将 TypeScript 构建到 lib/
npm run build

运行综合测试套件（61 个测试）
npm test

🏷️ 发现与标签

#deepseek #deepseek-harness #dsh #dsh-cli #dsh-terminal #terminal #tui #cli #ai-agent #llm #cordis #coding-assistant

🤝 贡献

热烈欢迎贡献、错误报告和拉取请求！欢迎任何人向 dsh-cli 做出贡献。

- 📖 查看 CONTRIBUTING.md 了解本地开发设置、测试指南和 PR 流程。
- 💡 有想法或发现了错误？随时提交 issue 或 pull request！

⚠️ 免责声明

dsh-cli 是一个独立的、非官方的社区项目，为 DeepSeek Harness 生态系统而构建。它与 DeepSeek AI 或杭州深度求索人工智能有限公司无关联，亦未由其维护、赞助或认可。

所有产品名称、徽标、品牌和商标均为其各自所有者的财产。

📄 许可证

Apache-2.0 © rakibulrocky14