ds-web-ui

by xing-shuyin

GitHub ↗ npm ↗

2 UI 增强github收录于 08-23

我的 DeepSeek Harness Web UI

My DeepSeek Harness Web UI

安装

$ dsh plugin --profile web add github:xing-shuyin/ds-web-ui

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

简体中文 | 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 用任务计划程序。