npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsbot-hub

v0.11.14

Published

DSBots Hub: one hub for one or more DS Bot servers inside DSH

Readme


DSBots Hub 为 DeepSeek Harness(DSH)增加服务器切换器,并内嵌所选服务器的 真实 DS Bot 界面。每个服务器保留自己的来源(origin)、自己的会话 Cookie 和 自己的机器人。浏览器始终不会持有上游团队的凭据。

它面向一名运维人员管理一个或多个自托管 DS Bot 团队:一个 DSH 配置、 一个 Hub、任意数量的服务器。

这不是多租户服务。 没有用户账号、角色或审计日志。请部署在 Tailscale 或 TLS 代理之后的局域网中,绝不要直接暴露在公网。见安全。

功能

  • 一个切换器,多个服务器。 切换器下方的机器人属于所选服务器;切换时保留 每个服务器各自的会话。
  • 来源隔离。 内嵌界面从不从 DSH 来源提供。每个服务器有自己的代理来源和 仅限该来源的会话 Cookie。
  • 服务器端表情回应。 用户每条消息最多两个回应,机器人最多一个。机器人获得 react 工具,并在你对其消息作出回应后收到下一轮提示。(需要随附的 DS Bot 分支。)
  • 返回手势。 Android 返回键和边缘滑动会先关闭最上层——操作面板、引用、 消息阅读器、设置、服务器面板——然后才允许 Hub 导航离开。
  • 手机与平板流程。 长按面板、系统表情输入、可选择文本的消息阅读器; 仅桌面端的悬停工具栏在触摸设备上隐藏。
  • 不复制数据。 机器人、聊天、记忆和凭据都留在各自服务器上。

工作原理

浏览器
  |
  +-- DSH + DSBots Hub 面板 .......... DSH 来源
  |     |  同源面板 API: /dsbot-hub/api
  |     |  GET /dsbot-hub/api/servers/<id>/open -> 短期 grant
  |     v
  +-- iframe --> 每服务器来源 --> Hub 代理 --> DS Bot 服务器
  |              (host-only Cookie)   (注入团队 Cookie)
  |
  +-- 工具 --> 每个服务器 endpoint 上的 /api/bot

Hub 申请 grant,grant 在该服务器来源上设置 host-only Cookie,代理再向上游注入 真实的团队 Cookie。没有 HTML 重写、没有共享 Cookie、没有跨服务器操作。来源 端口在 13090–13199 之间自动分配。

要求

| 组件 | 版本 | 说明 | |---|---|---| | DSH | 0.2.2-alpha.3+ | Web 配置;移动端外壳需要 0.2.2+ | | Node | 24.9.0+ | 主机 CLI 与构建 | | DS Bot | 0.2.6 | 原版即可用于 Hub;随附分支增加回应和返回手势 | | Docker + Compose | 当前版本 | 仅用于随附的服务器镜像 | | 模型提供商 | 任意 DSH 支持的提供商 | OpenCode Go 是随附默认值;见模型提供商 | | 网络 | Tailscale、局域网或 TLS 代理 | Hub 在其后使用明文 HTTP |

以上任何一项都不在发布包内。发布包安装的是 DSH 插件和服务器镜像构建;DSH、 Node、Docker 以及提供商账号需要你自行准备。SETUP.zh-CN.md 按阶段列出。

快速开始

发布包包含 Hub、移动端 gate、DS Bot 分支以及服务器镜像构建文件。

1. 解压并校验

mkdir -p dsbot-hub-0.11.14
tar -xzf dsbot-hub-release-0.11.14.tar.gz -C dsbot-hub-0.11.14
cd dsbot-hub-0.11.14

sha256sum -c SHA256SUMS     # 每一行都必须以 OK 结尾
./preflight.sh              # 检查主机与产物

2. 配置并启动 DS Bot 服务器

把提供商密钥放进私有环境文件,而不是命令行:

cp server/.env.example server/.env
chmod 600 server/.env
$EDITOR server/.env         # 填写提供商密钥;OpenCode Go 是默认值

docker compose -f server/compose.yml up -d --build

compose 会把服务器发布到 127.0.0.1:13081,数据存放在 /opt/ds-bot。两者 都是默认值而非固定路径:server/.env 中的 DS_BOT_PORT、DS_BOT_CONTAINER、 DS_BOT_DATA_DIR 和 DS_BOT_WORKSPACE_DIR 可以覆盖。如果数据目录不存在,请先 创建并交给 PUID/PGID(默认 1000:1000)。

容器会读取 server/.env 中的所有值。随附的 compose 针对 OpenCode Go 路由 编写,但这只是一种选择,不是硬性要求——见模型提供商。

3. 把 Hub 安装到 DSH

./install.sh web            # 或: ./install.sh "$DSH_PROFILE"

这会安装 dsbot-hub、移动端 gate 以及固定版本的桌面插件集。只安装 Hub 和 gate:WITH_DESKTOP=0 ./install.sh web。

4. 重启 DSH 并打开 Hub

重启提供 DSH Web 的进程,然后强制刷新浏览器。面板会出现在侧边栏,移动端 外壳中出现在 Bots。

5. 添加服务器

打开 DS Bot Hub → 齿轮 → Add server,填写:

| 字段 | 值 | |---|---| | Name | 任意名称,例如 Main | | Endpoint | http://127.0.0.1:13081 | | Login token | 容器打印的 token(见下) |

容器内的 DSH 会在启动时打印登录 URL。读取 token 时不要把它输出到共享日志:

docker logs ds-bot 2>&1 | grep -o 'token=[^ ]*' | tail -1 | cut -d= -f2-

把该值粘贴到 token 字段。Hub 将其保存为 DSH 机密,并换取团队 Cookie; 浏览器永远看不到该 Cookie。

容器重启后 token 会改变。如果服务器之后显示 sign in,请粘贴新的 token。

完成。切换器应显示服务器名称,其机器人应正常加载。

模型提供商

DS Bot 不绑定 OpenCode Go。模型来自 DSH 的 llm-pi-ai 适配器:每条路由都指定 保存其密钥的环境变量(apiKeyEnv)。随附的 compose 会把整个 server/.env 传入容器,因此添加提供商不需要修改 compose。

随附的 compose 使用一条 OpenCode Go 路由(OPENCODE_GO_API_KEY)。使用其他提供商:

  1. 在容器配置的 llm-pi-ai 行中,把路由加入 providers。
  2. 把密钥写入 server/.env,变量名与路由的 apiKeyEnv 一致。
  3. 重启容器,然后在 DS Bot 中为机器人选择模型。
providers:
  opencode-go:
    apiKeyEnv: OPENCODE_GO_API_KEY
  openai:
    apiKeyEnv: OPENAI_API_KEY

补丁中的 config: 块会替换该条目的整个配置,因此要重新列出所有仍需保留的 路由。自定义网关还需要 api、baseURL 和 models。

完整字段、网关示例和密钥存储方式见 docs/providers.md。

使用已有的 DS Bot 服务器

Hub 调用的是 DS Bot 界面自身使用的路由,因此已有的 DS Bot 0.2.6 服务器无需 改动:用它的 endpoint 和登录 token 添加即可。

随附分支增加了服务器端回应、机器人 react 工具和共享返回栈。有两种迁移方式:

# 已有容器:备份并更新其正在使用的数据配置
./server/install-existing.sh ds-bot ds-bot-0.2.6-hub.3.tgz

# 或重建镜像,让新容器直接使用该分支
docker compose -f server/compose.yml up -d --build

install-existing.sh 会在 /data/profiles/web/node_modules/ds-bot.bak-<timestamp> 保留带时间戳的旧包备份, 并重启容器。它不会删除数据卷。

多台本地服务器

一个容器就是一个团队。要在同一主机上运行第二个团队,请给它独立的名称、主机 端口、数据目录和 token:

docker run -d --name dsbot-b \
  --restart unless-stopped \
  -p 127.0.0.1:14001:3080 \
  --env-file server/.env \
  -v /opt/dsbot-b/data:/data \
  -v /opt/dsbot-b/workspace:/workspace \
  dsbots/ds-bot:0.2.6-hub.3

主机端口不要落在 13090–13199:Hub 在该区间分配浏览器来源端口。绝不要让 两个容器共用同一个数据卷。然后在 Hub 中用独立的 id、名称和 token 添加 http://127.0.0.1:14001。每台服务器重复一次;每个容器有自己的 token,其中一台 离线不影响其他服务器。

更多见 docs/multiple-servers.md。

手机与远程访问

手机加载 DSH Web 应用,Hub 的内嵌来源也必须能被手机访问。让两者指向同一 接口:

- id: dsbot-hub
  config:
    proxy:
      listen: 127.0.0.1:13091
      bind: 100.x.y.z        # tailnet 地址,或在 ACL 之后的 0.0.0.0

然后在手机上打开 DSH URL,例如 http://<tailnet-ip>:3080/,选择 Bots。 Tailscale 会路由主机上的所有端口,因此不需要逐端口转发。

如果 DSH 使用 HTTPS,来源端口也必须是 HTTPS,否则浏览器会因混合内容阻止 iframe。一张覆盖该主机名的证书即可用于所有端口;用 Caddy 或 tailscale serve 终止 TLS。

完整步骤(包括 SSH 隧道和公网子域名)见 docs/install.md。

配置

齿轮面板是常规编辑方式;dsbot-hub 行上的 YAML 用于引导和自动化:

- id: dsbot-hub
  config:
    servers:
      - id: main
        label: Main
        endpoint: http://127.0.0.1:13081
    proxy:
      listen: 127.0.0.1:13091
      bind: 127.0.0.1

| 字段 | 默认值 | 含义 | |---|---|---| | servers[].endpoint | — | Hub 访问的地址;Cookie 绑定到它的主机和端口 | | servers[].origin | 自动 | 内嵌界面的浏览器来源;会分配一个 loopback 端口 | | servers[].cookieRef | DSBOT_<ID>_COOKIE | 保存团队 Cookie 的 DSH 机密名 | | proxy.listen | 127.0.0.1:13091 | 基于主机名的来源共用监听器 | | proxy.bind | 127.0.0.1 | 每服务器来源绑定的接口 | | proxy.grantTtlSeconds | 60 | grant 有效期 | | proxy.sessionHours | 12 | 内嵌会话有效期 |

所有字段和来源规则见 docs/config.md。

发布内容

| 文件 | 用途 | |---|---| | dsbot-hub-0.11.14.tgz | DSH Hub 插件 | | dsbot-mobile-desktop-gate-0.1.2.tgz | 移动端桌面 UI gate | | ds-bot-0.2.6-hub.3.tgz | DS Bot 分支:回应与返回手势 | | dsbot-hub-release-0.11.14.tar.gz | 解压后的发布包:文档、配置、安装脚本、服务器构建 | | SHA256SUMS | 产物校验和 | | preflight.sh | 主机与发布包检查 |

故障排查

| 现象 | 可能原因 | |---|---| | 侧边栏没有面板 | DSH 未重启,或 bundle 不在配置中 | | 内嵌框空白 | 来源端口未绑定到所用接口,或 HTTPS 页面内嵌 HTTP 来源 | | 服务器显示 Sign in / 401 | token 已变,或 Cookie 创建后 endpoint 的主机/端口变了 | | Link expired / 403 | grant 一次性且有效期短;重新打开该服务器 | | compose 退出并提示 env file ... not found | 缺少 server/.env;复制 server/.env.example | | 机器人回复 MISSING_CREDENTIAL | 该路由没有密钥;按 apiKeyEnv 名称写入 server/.env | | 第二台服务器的内嵌框空白 | 主机端口与 13090–13199 冲突,或未绑定到所用接口 | | 上游返回 403 | endpoint 的 authority 与 Cookie 的 authority 不一致 |

更多内容见 docs/troubleshooting.md。

文档

安全

  • DS Bot 登录 token 等同于该团队的完全控制权;提供商密钥是可消费的额度。 两者都不要进入 shell 历史、聊天记录或 git。
  • 把 Hub 保持在私有网络。Tailscale ACL 是外层边界,grant/会话 Cookie 是内层。
  • 不要把 DSH 端口、代理端口或 DS Bot 端口暴露到公网。
  • 以非 root 用户运行。server/.env 保持 600,DSH 主目录保持私有。
  • 在把 Hub 暴露给他人之前先读 SECURITY.md。

许可证

Apache-2.0。随附的 DS Bot 分支同样使用 Apache-2.0,其 tarball 内含独立的 LICENSE、NOTICE 和 MODIFICATIONS.md。见 NOTICE 与 THIRD_PARTY.md。