← 返回列表
⚠ 装前注意
DSH 插件：在 DeepSeek Harness Web 界面对话/轨迹顶部新增「终端」Tab，内置…
基本兼容但装前注意：npm 同名包「dsh-web-terminal」归属 iamsee123/dsh-web-terminal，装到的可能不是本插件 · 最近上游提交 2026/8/15 · 已提供中文文档
DSH 插件：在 DeepSeek Harness Web 界面（对话/轨迹）顶部新增「终端」Tab，内置 xterm.js + node-pty 交互式终端，让你在编码完成后即时在终端执行指令调试。
综合分
32.9
GitHub 分
32.9
用户评分
—
★ Stars
5
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add helays/dsh-web-terminalnpm 同名包「dsh-web-terminal」归属 iamsee123/dsh-web-terminal，装到的可能不是本插件，改用 GitHub 源安装
信任档位：需留意实装验证未通过
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 实装验证未通过（dependency_conflict），装前请到仓库确认最近更新与 issue
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 更新放缓：最近一次提交在 41 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
⚠︎ 实装验证未通过（dependency_conflict · 2026/9/22） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-web-terminal @ 0.1.1
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
npm 同名包「dsh-web-terminal」归属 iamsee123/dsh-web-terminal，装到的可能不是本插件
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 18:48:51
依赖的 DSH / Cordis 模块
@deepseek-ai/dsh-client-ui-commands@deepseek-ai/dsh-client-ui-settings-plugins@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-commands@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-settings@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-conversation用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成🖥️ dsh-web-terminal
在 DeepSeek Harness 里，给你的 AI 编码工作台嵌一块「真·终端」。
内置 xterm.js + node-pty 的交互式 PTY 终端，作为第三个 Tab（对话 · 轨迹 · 终端）挂在 Web UI 顶部。
模型跑完代码后，你不用切窗口、不用离开对话，直接在旁边开一个你自己的 shell —— 立即构建、git、测试、调试。
中文 · English
💡 一分钟看懂
| 🤯 痛点 | ✅ dsh-web-terminal |
|---|---|
| 模型改完代码，只能 复制粘贴 回自己的终端慢慢复现 | 在对话旁边打开一块真实 PTY，命令即输即跑 |
| 一切都要挤进对话上下文，token 和噪音翻倍 | 终端与 模型 / agent 会话完全解耦——是你的私有终端，零上下文占用 |
| 换会话/刷新后命令和会话丢失，得重头再来 | 跨会话保活：切走切回 / 刷新，自动重连并补回滚动历史 |
| 每次只为一个命令开一次性 shell，效率低 | 持续进程：打开一次，多次命令、常驻 shell（Ctrl+C 中断可再跑） |
一句话：把「写代码」和「跑代码」放进同一个界面，互不干扰。
✨ 亮点
- 🗂️ 第三个 「终端」Tab，与「对话 / 轨迹」并列，一键切换。
- 🧯 真实 PTY，不是伪终端：
- Windows 走 ConPTY，POSIX 用交互式 shell；
- 支持 Ctrl+C / Ctrl+D 等控制键、resize 窗口自适应、彩色 + 光标闪烁；
- 持续会话（进程常驻，多次命令，不用每次重开）。
- 🔄 会话保活 + 断线回放：切走再切回、甚至刷新页面，自动重连并补齐滚动历史（会话池在插件侧持有）。
- 🚪 零侵入对话：完全独立于 agent 流，不占用上下文 token，不混入会话记录。
- ⚡ 即时可用、零配置：默认 Windows 自动用 PowerShell、POSIX 自动用 bash；终端 Tab 内多终端并存，每条终端的 shell 类型（bash / zsh / pwsh / powershell / cmd / python 等）可在右侧下拉随时切换。
- 🗂️ 多终端并存：同一个「终端」Tab 里可开多个终端，左侧 tab 卡片切换，各自进程独立。
- ⌨️ composer 输入 /terminal，候选一键直达终端（与官方 /plan 同源的单步命令），连空会话也能开终端。
- 🧩 纯 DSH bundle 插件，安装即用，与官方 UI 槽位原生集成。
🚀 快速开始
环境：DeepSeek Harness 0.1.0-rc.6（next 通道） 的 web profile。
安装
方式一：GitHub（推荐，稳定可复现）
dsh plugin --profile web add dsh-web-terminal@github:helays/dsh-web-terminal#main -w
方式二：本地开发目录
cd dsh-web-terminal && dsh plugin --profile web add . -w
⚠️ -w 必须带：当前 dsh profile 模板是 pnpm workspace 根（pnpm-workspace.yaml 含 packages: [.]），
不带会报 ERR_PNPM_ADDING_TO_ROOT。dsh plugin 会把其余参数原样转发给 pnpm。
安装后重启 dsh web（插件集合 / 宿主变化需重启生效），再刷新浏览器页面。
使用
1. 打开任意会话（进入后顶部出现 对话 · 轨迹 · 终端）；
2. 点「终端」，或在输入框输 /terminal；
3. 直接输命令，例如：
npm run build # 改完代码立刻构建
git status # 查看改动
pytest # 跑测试
4. 顶栏可看连接状态；想隐藏时切回「对话」即可——终端和会话都还在。
🧩 技术栈
| 层 | 选型 | 说明 |
|---|---|---|
| 前端终端 | @xterm/xterm + @xterm/addon-fit | 打包进 client bundle（lib/client.js），__ModuleLoader__.load 注册 |
| 后端 PTY | node-pty | 原生 PTY（Windows ConPTY / POSIX pty），进程常驻 |
| 传输 | ws | 经 ctx.webServer 提供 WebSocket 双向字节流 + resize |
| UI 装配 | ctx.slots.inject('conversation.view') | 注册 id:'terminal' tab，与官方 dsh-client-ui-trajectory 同构 |
为什么是“真”终端 & 与官方 dsh-terminal 的区别
dsh 自带 ctx.terminals 是 Agent 所有权 + 模型面 line-oriented 语义，无浏览器传输、Windows 下不可用。
我们选择直接用 node-pty spawn 一个完全属于你的 shell，与 agent 会话彻底解耦——这是你自己的终端。
🔧 本地开发
pnpm install # 依赖（含类型）
pnpm build # 产出 lib/index.js + lib/client.js + lib/client.css
pnpm typecheck # tsc --noEmit 类型检查
- 改 host half（src/）：重启 dsh web；
- 改 client half（src/client/）：重装 + 刷新页面即可。
❓ FAQ
Q：这个终端会占用我的对话上下文吗？
不会。终端与模型/agent 会话完全解耦，不写入上下文，也不混入会话记录。
Q：重启/刷新后会话还在吗？
在。会话池由插件持有，跨会话、跨刷新保活；重连后自动补回最近的输出历史。
Q：只想临时跑一条命令，也要开终端吗？
打开后进程常驻，你可以在里面持续操作；切走再切回仍是同一个 shell。
Q：能换 shell 吗？
可以，而且按每条终端单独换。在「终端」Tab 右上角的“终端类型”下拉里切换 bash / zsh / pwsh / powershell / cmd / python 等（取自当前系统可用候选），切换即重启当前这条终端为新 shell。默认 Windows→PowerShell、POSIX→bash 自动识别。
Q：终端默认在哪个目录打开？
默认跟随当前对话会话的 workspace 目录；无法打开时才回退到 dsh web 的启动目录。无需额外配置。
📝 License
MIT © helays