xing-shuyin/ds-web-ui 预览 preview

xing-shuyin/ds-web-ui

为 DeepSeek Harness (DSH) 打造的 Web 聊天界面 —— agent 通过官方 DSH stdio JSON-RPC runtime(纯 Node,随包自带)在子进程中执行,事件经 WebSocket 流式推送到浏览器。界面从 pi-web-ui 忠实移植。

catalog descriptioncatalog 简介 / catalog description:My DeepSeek Harness Web UI

Project Overview项目介绍

ds-web-ui is a web chat interface for DeepSeek Harness (DSH), where the agent runs in a subprocess via the official DSH stdio JSON-RPC runtime, streaming events to the browser over WebSocket. It supports streaming thinking blocks and tool calls, attachment uploads, an xterm.js-based terminal, concurrent multi-session chat, model switching, and a status bar with token and cost estimates. Use it for local interactive coding and chat sessions. Requires Node.js ≥ 22.19 and a valid DeepSeek API key. Uninstallation preserves session data under ~/.ds-web.

ds-web-ui 是为 DeepSeek Harness (DSH) 打造的 Web 聊天界面,agent 通过官方 DSH stdio JSON-RPC runtime 在子进程中执行,事件经 WebSocket 流式推送到浏览器。支持思考块与工具调用流式输出、附件上传、xterm.js 内置终端、多会话并行、模型切换、token 与花费估算。适用于本地交互式编码与对话。需 Node.js ≥ 22.19 和 DeepSeek API key。卸载不删除会话数据。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
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:xing-shuyin/ds-web-ui

把 xing-shuyin/ds-web-ui 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

ds-web-ui

ds-web-ui — DeepSeek Harness Web Chat UI

简体中文 | English

简介

为 DeepSeek Harness (DSH) 打造的 Web 聊天界面 —— agent 通过官方 DSH stdio JSON-RPC runtime(纯 Node,随包自带)在子进程中执行,事件经 WebSocket 流式推送到浏览器。界面从 pi-web-ui 忠实移植。

  • 思考块与工具调用,流式输出
  • 附件上传与文件浏览
  • 内置终端(xterm.js + node-pty)
  • 多对话并行、会话管理与模型切换
  • 状态栏:token 统计 / 1M 上下文窗口 / 花费估算

需要 Node.js ≥ 22.19 和一个有效的 DeepSeek API key。

安装

npm i -g ds-web-ui            # 全局安装(推荐)
npx --yes ds-web-ui           # 或免安装直接运行(最新版,默认 :8989)
npm i -g .                    # 或安装本地源码

使用

启动

ds-web-ui                                  # 前台运行,http://localhost:8989
ds-web-ui --port 9099                      # 指定端口
DS_WEB_CWD=/path/to/project ds-web-ui      # 指定工作区

端口优先级:--port 参数 > DS_WEB_PORT > PORT > 8989。API key 通过 DEEPSEEK_API_KEY 环境变量、~/.ds-web/dsh-key.json 或自动复用 ~/.pi/agent/auth.json 提供。

停止

  • 前台:在运行它的终端按 Ctrl+C。

更新

npm i -g ds-web-ui@latest     # 升级到最新发布版本

卸载

npm uninstall -g ds-web-ui

卸载不会删除你的聊天记录 —— 会话数据保存在 ~/.ds-web(或 DS_WEB_DATA_DIR),卸载/升级后依然保留。

作为系统服务运行(开机自启)

ds-web-ui 暂无内置的 server 子命令,推荐用 pm2 管理(跨平台,Windows / macOS / Linux 通用):

npm i -g pm2
pm2 start ds-web-ui --name ds-web-ui -- --port 9000    # 启动
pm2 save                                                # 保存进程列表
pm2 startup                                            # 配置开机自启(按提示执行命令)
pm2 status / pm2 logs ds-web-ui / pm2 restart ds-web-ui

如需自定义端口或工作区:pm2 start ds-web-ui -- --port 9000、pm2 start ds-web-ui -- --port 9099 --cwd /path/to/project(DS_WEB_CWD 也可用环境变量传入)。Linux 也可以用 systemd,macOS 用 launchd,Windows 用任务计划程序。

License

MIT

← 上一个 Prev firmware-forge 下一个 Next dsh-ocr1-memory →