天枢群管家

首次使用：安装并启动 ​

这篇帮你做什么：把天枢群管家在自己的电脑或服务器上启动，并打开管理页面（控制台）。不需要另装数据库，也不需要注册控制台账号；接入 QQ 所需的机器人账号和 OneBot 实现端需要另行准备。

开始前确认 ​

  • 一台 Windows 64 位电脑或服务器（当前发布包只提供 Windows 版 datahub.exe）。
  • 你能拿到完整的 Windows 64 位发布包，内含 datahub.exe、configs/、web/。
  • 默认配置使用 6700 提供 API、6701 提供控制台，两者都需要可用，不能被其他程序占用或被系统保留。控制台端口始终是 API 端口加 1，后面会讲怎么改。
  • 一台用于打开管理页面的浏览器（Edge、Chrome 等）。

⚠️ 先读这段再部署：控制台没有登录密码、没有账号体系。谁能打开这个网页，谁就能操作全部功能。请只把它部署在你自己可信的电脑或内网里，API 与控制台端口都不要直接开放到公网（默认是 6700 和 6701；改过配置时按实际值核对）；如需远程访问，请自行加装带访问控制的反向代理等网络层隔离。这不是疏漏，是当前版本的既定边界。

安装：把发布包放到目标位置 ​

  1. 把发布包目录整体复制到一个你方便管理、且有读写权限的位置。路径建议不含空格，例如 D:\tensuu\。
  2. 本文使用直接运行程序的方式，不需要注册系统服务。以后想移除，应先正常停止程序，再确认数据库、部署配置、备份及自定义路径中的文件均已按需保留；不要直接删除正在使用的目录。

启动：运行 datahub.exe ​

  1. 打开命令提示符（按 Win 键，输入 cmd 回车），执行：

    cd /d D:\tensuu
datahub.exe

  2. 窗口开始滚动日志即表示在启动。首次启动会自动完成两件事：

    • 在 data\ 目录创建数据库文件 datahub.db（保存应用的数据库配置和记录；不包含程序目录里的全部文件）；
    • 创建 logs\ 日志目录。

  3. 怎样确认 API 正常：再开一个命令提示符窗口，执行 curl http://localhost:6700/ping；返回 {"message":"pong"} 表示 API 可访问。改过端口时使用实际 API 端口；这一步不证明控制台文件或页面可用，继续按下面的地址检查控制台。

打开控制台 ​

  1. 在启动窗口找到 Static Web Console，用浏览器打开它给出的完整地址。默认配置下是 http://127.0.0.1:6701/web/，不是 API 端口 6700。若窗口提示 Frontend index.html not found, serving API only，表示当前只提供 API，请先核对发布包的 web\index.html 是否完整。
  2. 直接进入"仪表盘"页面，没有登录步骤（原因见上文安全提示）。如果页面打开了"登录"样式的页面，说明你访问的是模板残留地址 /web/login，它不是真正的入口，请改用上面的完整地址。
  3. 首次启动你会看到几样"自带"的东西，属于正常现象：
    • 一条名为 默认连接 的连接配置，状态显示"异常"（它没有填写地址，用来提醒你还需要配置机器人连接，见连接机器人）；
    • 监控方案里有一个默认监控方案，自带"加群 / 兼职 / 广告"三条示例规则。

数据在哪里、怎样停止 ​

  • 常见数据位置：默认配置下，data\datahub.db 是数据库，logs\ 是日志，backups\ 是备份；部署配置在 configs\。如果改过存储路径，应按实际配置查找，不要只保留数据库就删除其他文件。备份目录与定期备份见完成第一次配置。
  • 停止：回到运行 datahub.exe 的命令提示符窗口，按 Ctrl+C，等待程序退出。不要用强制结束进程代替正常停止。停止后刷新浏览器将无法再从该程序加载控制台。
  • 再次启动：重复上面的启动命令即可，配置和数据都会保留。

只能在本机打开？默认是的 ​

默认配置里 server.host 是 "127.0.0.1"，意思是控制台服务只接受来自这台电脑本身的访问。机器人通信还需要单独核对连接方式、监听地址和端口，不能因为控制台能打开，就认定另一台设备上的实现端也能接入。如果你确实需要从内网另一台电脑打开控制台：把 config.yaml 里的 host 改为 "0.0.0.0" 并重启；改了之后，同一内网的所有设备都能打开这个无密码的控制台，请确认网络环境可信，并不要同时开放到公网。

没成功先检查什么 ​

  • 双击 datahub.exe 窗口一闪而过：多半是端口被占用或配置文件格式错误。先在命令提示符里用上面的方式启动，看窗口里留下的错误文字。
  • 提示端口被占用 / 页面打不开：先看启动窗口指出的是 API 端口还是控制台端口。确认不可用后，可修改 configs\config.yaml 里 server: 下的 port（例如改成 6800，同时确认 6801 也可用），保存后重新启动，按 Static Web Console 日志访问控制台。Windows 的“访问套接字的方式不被允许”（10013）也可能来自系统保留端口，并不一定有别的程序占用；不要因此关闭防火墙或强行结束无关程序，见常见问题。
  • 浏览器打不开但 ping 正常：/ping 只证明 API 可访问。控制台要使用日志给出的地址（默认 http://127.0.0.1:6701/web/，带 /web/）；若没有控制台地址并提示只提供 API，先确认 web\index.html 存在，并从发布包目录启动程序。
  • 更多排查见常见问题。

改端口：一个真实例子 ​

  1. 用记事本打开 configs\config.yaml，找到开头几行的：

    yaml
    server:
  host: "127.0.0.1"
  port: 6700

  2. 把 API 端口 6700 改成可用的端口（例如 6800），同时确认它加 1 后的控制台端口 6801 也可用，再保存。带静态控制台时 API 端口须在 1–65534 之间。

  3. 正常停止后重启 datahub.exe，核对启动日志。此例 API 为 http://127.0.0.1:6800/ping，控制台为 http://127.0.0.1:6801/web/；访问地址以 Static Web Console 日志为准。

  4. 注意：配置文件在启动时读取，改完必须重启才生效。若设置了网络访问控制，API 与控制台两个端口都要按新值核对，不要只保护其中一个。

更多说明 ​

  • config.yaml 里还有日志、备份目录、时区等部署项。一般保持默认即可开始使用；本文不逐项展开，需要时再到对应功能页查。
  • 系统的时间边界（例如 AI 每日额度按"哪一天"计算）由 deployment.timezone 决定，默认 Asia/Shanghai，留空或填错也是这个值；改它需要重启。
  • 想先理解机器人、连接、群和方案的关系：工作方式与作用范围。
  • 想接着做：连接机器人 → 完成第一次配置。