A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Document the Docker fallback for older glibc hosts
klarkxyda0198387ca6
diff --git a/README.md b/README.mdindex 57c84d36..3b69af07 100644--- a/README.md+++ b/README.md@@ -23,7 +23,7 @@ The desktop app brings its own DSH, so you don't need to install DSH first. Down- Windows (x64): `DS-Bot-<version>-win-x64.exe`. Run it; it installs for your user only, without administrator rights. If Windows shows "Windows protected your PC", select **More info** → **Run anyway**.- macOS: `DS-Bot-<version>-mac-arm64.zip` for an Apple chip, `DS-Bot-<version>-mac-x64.zip` for Intel. Safari unzips it by itself; drag **DS Bot** into **Applications** and open it. When macOS says it cannot check the app, open **System Settings** → **Privacy & Security** and select **Open Anyway**.-- Linux (x64): `DS-Bot-<version>-linux-x86_64.AppImage` runs on every distribution — make it executable and open it. It mounts through FUSE 2, which you may need to install first (`sudo apt install libfuse2t64` on Ubuntu 24.04+, `sudo dnf install fuse-libs` on Fedora, `sudo pacman -S fuse2` on Arch). On Ubuntu 24.04 and later an AppImage can refuse to start (Ubuntu restricts the sandbox it needs); the `DS-Bot-<version>-linux-amd64.deb` on Debian/Ubuntu does not have this problem and adds a menu entry.+- Linux (x64): `DS-Bot-<version>-linux-x86_64.AppImage` runs on every distribution with glibc 2.28 or newer — make it executable and open it. It mounts through FUSE 2, which you may need to install first (`sudo apt install libfuse2t64` on Ubuntu 24.04+, `sudo dnf install fuse-libs` on Fedora, `sudo pacman -S fuse2` on Arch). On Ubuntu 24.04 and later an AppImage can refuse to start (Ubuntu restricts the sandbox it needs); the `DS-Bot-<version>-linux-amd64.deb` on Debian/Ubuntu does not have this problem and adds a menu entry. On older-glibc systems such as CentOS 7 the app and DSH Web fail with `GLIBC_2.27 not found`; run the Docker image instead (see below and [known issues](docs/known-issues.md)).At the first start the app asks where to keep its data and the Bots' files, and offers to copy a Bot team from your DSH (it only reads your DSH). Set up a model in its settings. The Windows app and the Linux AppImage update themselves; the macOS app and the Linux deb tell you when a new version is ready to download.@@ -47,7 +47,7 @@ DS Bot 0.2.1 and earlier cannot update themselves in DSH Desktop 0.2.1-rc.2 or l**DSH Web (Windows, macOS, Linux)**-Needs Node.js `22.19` or later, and pnpm.+Needs Node.js `22.19` or later, and pnpm. On Linux it needs the same glibc 2.28 or newer as the desktop app — the DSH install loads its own native libraries, so CentOS 7 and other older-glibc systems take the Docker route below instead.```shnpx @deepseek-ai/[email protected] plugin --profile web add ds-botdiff --git a/README.zh.md b/README.zh.mdindex f261173f..a955d9ff 100644--- a/README.zh.md+++ b/README.zh.md@@ -23,7 +23,7 @@ DS Bot 是一个基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepsee- Windows(x64):`DS-Bot-<版本>-win-x64.exe`。运行它即可安装,只装给当前用户,不要管理员权限。如果提示“Windows 已保护你的电脑”,点 **更多信息** → **仍要运行**。- macOS:Apple 芯片下载 `DS-Bot-<版本>-mac-arm64.zip`,Intel 下载 `DS-Bot-<版本>-mac-x64.zip`。Safari 会自动解压;把 **DS Bot** 拖进 **应用程序**,再打开。如果提示无法检查这个 App,打开 **系统设置** → **隐私与安全性**,点 **仍要打开**。-- Linux(x64):`DS-Bot-<版本>-linux-x86_64.AppImage` 通用于所有发行版——加上可执行权限后打开即可。它通过 FUSE 2 挂载,可能需要先安装(Ubuntu 24.04+ 用 `sudo apt install libfuse2t64`,Fedora 用 `sudo dnf install fuse-libs`,Arch 用 `sudo pacman -S fuse2`)。Ubuntu 24.04 及以后版本会限制 AppImage 需要的沙箱,AppImage 可能因此拒绝启动;Debian/Ubuntu 上的 `DS-Bot-<版本>-linux-amd64.deb` 没有这个问题,还会加菜单项。+- Linux(x64):`DS-Bot-<版本>-linux-x86_64.AppImage` 通用于 glibc 2.28 及以上的所有发行版——加上可执行权限后打开即可。它通过 FUSE 2 挂载,可能需要先安装(Ubuntu 24.04+ 用 `sudo apt install libfuse2t64`,Fedora 用 `sudo dnf install fuse-libs`,Arch 用 `sudo pacman -S fuse2`)。Ubuntu 24.04 及以后版本会限制 AppImage 需要的沙箱,AppImage 可能因此拒绝启动;Debian/Ubuntu 上的 `DS-Bot-<版本>-linux-amd64.deb` 没有这个问题,还会加菜单项。CentOS 7 这类旧 glibc 系统上应用和 dsh Web 会因 `GLIBC_2.27 not found` 失败,改用 Docker 镜像(见下文和[已知问题](docs/known-issues.zh.md))。第一次打开时,App 会问数据和 Bot 的文件放在哪里,并可以从你的 dsh 复制 Bot 团队(只读取你的 dsh,不改它)。在 App 的设置里配好模型就能用。Windows 版和 Linux 的 AppImage 会自动更新;macOS 版和 Linux 的 deb 有新版本时会提示你下载。@@ -47,7 +47,7 @@ DS Bot 0.2.1 及更早的版本在 DSH Desktop 0.2.1-rc.2 及以后的版本里**dsh Web(Windows、macOS、Linux)**-需要 Node.js `22.19` 以上和 pnpm。+需要 Node.js `22.19` 以上和 pnpm。Linux 上它和桌面应用一样要求 glibc 2.28 及以上——dsh 自身会加载原生库,CentOS 7 这类旧 glibc 系统请走下面的 Docker 路线。```shnpx @deepseek-ai/[email protected] plugin --profile web add ds-botdiff --git a/app/README.md b/app/README.mdindex f0eead05..792e4e24 100644--- a/app/README.md+++ b/app/README.md@@ -93,7 +93,7 @@ electron-builder packs only the packages that it finds through `dependencies` anThe Windows installer installs for the current user only, without administrator rights, by default into `%LOCALAPPDATA%\Programs\DS Bot` (`build/installer.nsh` skips the page that asks for all users or only for the current one). The uninstaller removes the program and keeps the data location and the app's own data. CI builds the Windows installer on every pull request, checks the packaged app, then installs it, checks the installed app and uninstalls it. For a change to `app/` or the workflows, it also updates the installed app before the uninstall (see [Updates](#updates)).-Linux gets one AppImage for every distribution — it runs on any glibc system, updates itself, and needs no per-distribution packages — and a deb for Debian/Ubuntu, built in the same `npm run dist`. An AppImage mounts through FUSE 2 (`libfuse2t64` on Ubuntu 24.04+/Debian 13+, `libfuse2` on Ubuntu 22.04, `fuse-libs` on Fedora, `fuse2` on Arch; `--appimage-extract-and-run` works without it). Ubuntu 24.04 and later restrict the unprivileged user namespaces that Chromium's sandbox needs, so an AppImage can refuse to start there ("The SUID sandbox helper binary was found, but is not configured correctly"): the deb does not have this problem, since its post-install sets `chrome-sandbox` up (electron-builder 26 also writes an AppArmor profile). The binary and the deb's menu entry are `dsbot` (`executableName`); the deb installs into `/opt/DS Bot`. CI builds the Linux packages on every pull request, checks the AppImage's self-update on a throwaway copy, and installs, checks, update-checks and removes the deb.+Linux gets one AppImage for every distribution with glibc 2.28 or newer — it updates itself and needs no per-distribution packages — and a deb for Debian/Ubuntu, built in the same `npm run dist`. Hosts with an older glibc (CentOS 7, glibc 2.17) fail to load DSH's `libghostty-vt.so`; [`docker/`](../docker/) is the fallback there. An AppImage mounts through FUSE 2 (`libfuse2t64` on Ubuntu 24.04+/Debian 13+, `libfuse2` on Ubuntu 22.04, `fuse-libs` on Fedora, `fuse2` on Arch; `--appimage-extract-and-run` works without it). Ubuntu 24.04 and later restrict the unprivileged user namespaces that Chromium's sandbox needs, so an AppImage can refuse to start there ("The SUID sandbox helper binary was found, but is not configured correctly"): the deb does not have this problem, since its post-install sets `chrome-sandbox` up (electron-builder 26 also writes an AppArmor profile). The binary and the deb's menu entry are `dsbot` (`executableName`); the deb installs into `/opt/DS Bot`. CI builds the Linux packages on every pull request, checks the AppImage's self-update on a throwaway copy, and installs, checks, update-checks and removes the deb.## Updatesdiff --git a/app/electron-builder.yml b/app/electron-builder.ymlindex be113d8e..ef7cb673 100644--- a/app/electron-builder.yml+++ b/app/electron-builder.yml@@ -59,7 +59,7 @@ mac:linux:# The Linux Host uses the payload's plain Node, which cannot read asar archives.asar: false- # One AppImage runs on every distribution and updates itself; the deb is for Debian/Ubuntu,+ # One AppImage runs on every distribution with glibc 2.28 or newer and updates itself; the deb is for Debian/Ubuntu,# where it avoids Ubuntu 24.04's AppArmor question of an AppImage and adds a menu entry.target:- target: AppImagediff --git a/docker/README.md b/docker/README.mdindex a865e3ee..835362e2 100644--- a/docker/README.md+++ b/docker/README.md@@ -13,6 +13,14 @@ box. The container is the sandbox boundary — see [Permissions](#permissions).- A DeepSeek API key (or another Anthropic-Messages-compatible endpoint through`DEEPSEEK_BASE_URL`).+The image is a Debian Bookworm userland, so the host's glibc does not decide+anything: this is also the supported route on hosts too old to run the desktop+app or a host-installed `dsh` (CentOS 7, glibc 2.17 — see [known+issues](../docs/known-issues.md)). The container brings its own DSH and native+libraries, so keep the host's `libghostty-vt.so` and other system libraries+out of it; the only host requirement is a Docker (or Podman) that can run a+Bookworm image.+## Quick startFrom the repository root, edit `docker-compose.yml`: fill in@@ -49,6 +57,10 @@ docker compose up -d --buildThat file publishes host port **3080** by default. Choose one deploymentmethod; do not run both against the same data directory.+Stop it with `docker compose down` (run in the directory that holds the+Compose file you started). The container gets 15 s to flush sessions; data and+workspace stay in their host folders.+## PermissionsThe container is the only sandbox. DSH's own kernel sandbox (bubblewrap /diff --git a/docs/known-issues.md b/docs/known-issues.mdindex fa88db52..fabce7d7 100644--- a/docs/known-issues.md+++ b/docs/known-issues.md@@ -76,3 +76,20 @@ The error code is `WEB_PROVIDER_CONFIGURED_MISSING`.To check the result, run `npx @deepseek-ai/[email protected] --profile web --dump-config` and look at the `web` row. Another plugin can also set the search provider while DSH runs, after the profile patch. If you turn such a plugin off later, check this setting again.See also [Web search](../ds-bot/README.md#web-search) in the plugin README and issue [#128](https://github.com/Fei2411/DS-Bot/issues/128).++## Linux: "GLIBC_2.27 not found" loading libghostty-vt.so++**Where:** on a Linux system whose glibc is older than 2.28 (CentOS 7 ships glibc 2.17), the desktop AppImage or deb, or a host-installed `dsh web`, fails at start. The loader reports a missing glibc version, for example:++```text+libghostty-vt.so: GLIBC_2.27 not found+```++**Why:** DeepSeek Harness ships native libraries, including `libghostty-vt.so`, built against newer glibc symbols than CentOS 7 provides. DS Bot is a plugin and cannot rebuild DSH's libraries, so there is no glibc-2.17 build to install. Check your version with `ldd --version`.++**What to do:** run the Docker image instead — the container has its own, newer glibc, so the host's glibc no longer decides. See [`docker/`](../docker/README.md): build or pull the image, publish the port, and open the UI from any browser on the LAN. Keep these points in mind:++- The container brings its own DSH and its own native libraries. Do not copy or mount the host's `libghostty-vt.so` into the container — mixing them breaks it.+- The container needs a Docker (or Podman) new enough to run a Debian Bookworm image. CentOS 7's stock kernel and Docker are old; if Docker itself fails, Podman or a newer Docker engine is the route. This exact combination is untested — the image itself is covered by CI on a modern host.+- Data lives in the mounted data directory (`/data`), not your real `~/.dsh`; the container never reads or writes it.+- Stop with `docker compose down` (or `docker stop`), which flushes sessions cleanly.diff --git a/docs/known-issues.zh.md b/docs/known-issues.zh.mdindex 07362b86..f21b1ccb 100644--- a/docs/known-issues.zh.md+++ b/docs/known-issues.zh.md@@ -76,3 +76,20 @@ Error: configured web provider "auto" is not registered想确认结果,可以运行 `npx @deepseek-ai/[email protected] --profile web --dump-config`,看 `web` 那一行。另外,有的插件会在 DSH 运行时设置搜索 provider,时间在 profile patch 之后。以后关掉这类插件时,也要再检查一下这个设置。另见插件 README 的 [Web search](../ds-bot/README.md#web-search) 一节和 issue [#128](https://github.com/Fei2411/DS-Bot/issues/128)。++## Linux:加载 libghostty-vt.so 报「GLIBC_2.27 not found」++**在哪里:** 在 glibc 低于 2.28 的 Linux 系统上(CentOS 7 自带 glibc 2.17),桌面 AppImage、deb 或本机装的 `dsh web` 启动即失败。动态加载器报告缺少某个 glibc 版本,例如:++```text+libghostty-vt.so: GLIBC_2.27 not found+```++**原因:** DeepSeek Harness 自带的原生库(包括 `libghostty-vt.so`)是按比 CentOS 7 更新的 glibc 符号编译的。DS Bot 是插件,没法重编 DSH 的库,所以没有适配 glibc 2.17 的版本可装。可以用 `ldd --version` 查看本机版本。++**怎么处理:** 改用 Docker 镜像——容器里有自己的、更新的 glibc,宿主 glibc 不再起决定作用。见 [`docker/`](../docker/README.md)(英文):构建或拉取镜像、发布端口,然后用局域网内任意浏览器打开 UI。注意这几点:++- 容器自带 DSH 和配套原生库。别把宿主机的 `libghostty-vt.so` 复制或挂载进容器,混用会破坏它。+- 需要能跑 Debian Bookworm 镜像的 Docker(或 Podman)。CentOS 7 自带的内核和 Docker 偏旧,如果 Docker 本身就跑不起来,换 Podman 或更新版 Docker。这个组合没有实机验证过——镜像本身是在现代宿主机上由 CI 测过的。+- 数据存在挂载的数据目录(`/data`)里,不是你真实的 `~/.dsh`;容器不会去读写它。+- 停止用 `docker compose down`(或 `docker stop`),会话能正常收尾。