SESSION HUB / 使用手册
让会话连起来,
从这一步开始。
一个在线工作台,整理多台电脑的会话。先选对入口,再决定是否需要本地同步端。
已有原电脑配置?直接启动原目录,无需重复下载。
已同步内容随时可看
新增同步与在线 AI 需要来源电脑运行
先选使用方式
我现在需要下载吗?
| 你想做什么 | 需要本地包? | 电脑如何运行 |
|---|---|---|
| 只在线查看、搜索、编辑已同步数据 | 不需要 | 浏览器登录即可。来源电脑可以关闭。 |
| 继续使用已经配置的原电脑 | 无需重新下载 | 双击原目录 start-windows.cmd,保留控制台窗口。 |
| 把另一台电脑的会话也同步上来 | 需要 Windows 同步端 | 每台独立安装并连接同一在线地址;同步和分析时开机、联网、运行同步端。 |
关闭同步端窗口后,本机新增同步与分析执行会暂停;已同步的线上内容仍可浏览。当前不提供自动开机启动,请在需要时手动启动。
已有配置 · 无需重新部署
登录密码,在原电脑上查看
当前这台原电脑已配置时,回到最初的程序目录。保留原来的配置即可继续使用。
双击原目录的启动文件
运行
start-windows.cmd。自动弹出本地页后保留控制台窗口。打开本地设置,查看在线登录密码
http://127.0.0.1:8765/#settings设置→在线管理与增量同步→查看在线登录密码→复制在在线管理页登录
前往 hub.ebeb.fun,将取出的密码填入“管理密码”,点击“进入工作空间”。
https://hub.ebeb.fun
请从原先已经配置的设备查看,或向该站点管理员获取。没有原管理员密码,就不能加入这个专属站点。这一步是登录已有工作空间,不是注册新账号;重复下载也不会找回密码。
WINDOWS 同步端
下载一次,完整解压
先确认运行环境
- 需要 WorkBuddy 自带 Python,或真实的 Python 3.10+。安装过 WorkBuddy 通常已有 runtime,不用再单独安装。启动文件会尝试找到可用的 Python。
- 只使用 Codex 且没有 Python?从 Python 官方 Windows 下载页安装 Python 3.10 或更新版本,再运行启动文件。
- 不需要 Node.js、Docker 或 Cloudflare 账号。
- 压缩 Codex 日志的解析可选用
zstandard。包内预置组件仅支持 Windows x64 + Python 3.13。其他 Python 环境若缺少压缩解析依赖,在解压后的程序目录打开终端执行:
python -m pip install -r requirements.txt请让命令使用启动同步端的同一 Python 环境。缺少该可选依赖时,正常基础管理仍可用,受影响的是需要它的压缩日志解析。
接入另一台电脑
六步,把本机会话带进工作台
先准备原管理员密码。每台电脑只读取自己的本机数据,不要复制原电脑的 data 目录或凭据。
例如
D:\AI-Session-Hub。先解压,再运行;不要在 ZIP 压缩包内直接双击启动。浏览器会自动打开
http://127.0.0.1:8765/。保留启动窗口,首次运行会读取这台电脑上的主会话。D:\AI-Session-Hub\├─ start-windows.cmd ← 双击这里├─ requirements.txt└─ data\ ← 本机运行数据,留在这台电脑“在线地址”填
https://hub.ebeb.fun,“管理员密码”填原先站点的管理员密码。确认地址、密码后保存。全新包无法代你生成或找回原站点密码。
首次历史资料较多时请保持联网和运行,等待同步进度;随后按新增和变化增量上传。
确认出现新设备,再按设备筛选查看会话。需要继续同步或在线分析时,让这台来源电脑保持开机、联网并运行同步端。
清单仅在当前页面内临时勾选;刷新或离开后不保留,不存储任何密码。
从收集到继续研究
日常使用,沿着这条路径
分类与快捷状态
按研究分类、设备和研究状态筛选,或搜索标题、摘要、研究笔记。“建议归档”只是标记,不会自动归档原聊天。
打开正文,编辑笔记
打开会话详情阅读已同步正文,整理研究信息。手动编辑的内容优先保留;长会话可能只展示解析范围内的部分正文。
勾选会话 → 分析所选
点击会产生模型请求。每台来源电脑需要自行配置 AI 接口、模型和 Key;云端不保存 AI Key。来源电脑在线运行后执行,可在“执行队列”查看等待状态。
打开原会话
该动作在当前浏览器所在电脑调用本地已安装的原应用。首次需手动关联当前电脑,并非自动识别;登录期间会记住选择。
如果会话来自另一台电脑,应回到那台电脑并安装对应原应用后打开。网页无法遥控另一台电脑上的原聊天。
理解等待与边界
第一次同步历史,之后跟进变化
分批同步历史
只发送新增或变化
查看已同步内容
运行中约每 10 秒联络一次,约每 5 分钟扫描来源变化。网络、队列、历史量都会影响到达时间,同步不承诺实时。需要检查时可点击“立即增量同步”与“刷新状态”。
原始会话文件保持只读,不会移动或删除。长记录出现 partial 表示遵循解析上限,正文可能不完整;需要完整上下文时回到来源电脑的原应用查看。
遇到问题,按症状检查
常见问题
启动提示找不到 Python,怎么办?
确认已安装 WorkBuddy 自带 runtime 或真实 Python 3.10+。只有 Windows 应用商店的 Python 跳转入口不算实际运行环境。Codex 用户可安装官方 Python 后重试;进阶用户可用 AI_HUB_PYTHON 指向可用的 python.exe。
本地网页打不开,或刚才还可以用?
先检查启动控制台是否还开着;关闭窗口会停止服务。重新双击原目录的 start-windows.cmd,再打开 http://127.0.0.1:8765/。若启动报错,阅读窗口提示,或查看程序目录下的 data\logs\hub.log,分享日志前先检查并去除敏感内容。
8765 端口已有中台,应该再开一个吗?
先访问现有本地页,确认是否就是之前已启动的中台。同一台电脑已有可用中台时复用原实例与原目录,避免重复启动。若端口被其他程序占用,先确认占用来源再处理,不要盲目结束进程。
新电脑上看不到原来的在线登录密码?
这是正常的。新包没有原口令,也不附带密钥;请在原先配置过的设备使用“查看在线登录密码”,或联系管理员取得密码。不要复制旧电脑整份目录、data 或系统凭据来绕过这一步。
在线设备显示离线,还能看数据吗?
已同步内容仍可查看、搜索和编辑。要接收新增会话或执行分析,请在来源电脑开机联网,并运行原目录的启动文件,保留控制台;再刷新本地状态与在线页面。
“分析所选”之后一直等待?
检查会话对应的来源电脑是否正在运行同步端,以及那台电脑是否已配置 AI 接口、模型与 Key。打开“执行队列”检查状态;离线命令等待上线,已回报执行中的分析不会自动重发,避免反复提交产生重复请求。
换电脑后,为什么打不开原聊天?
原会话链接由当前浏览器电脑的本地应用处理。首次手动关联当前电脑,确认本机安装了对应原应用、且该会话确实在本机。如果来源是另一台电脑,应回到来源电脑打开;这个功能不是远程桌面。
为什么有些会话没有中文标题?
读取会话不会自动将标题翻译成中文。原始标题和可读取的信息因来源而异;没有可用标题的空白记录会显示“目录名 · 空白会话”,可用创建时间和 ID 尾号区分。若想补充更易读的标题或研究摘要,可手动编辑,或在配置 AI 后主动发起分析。不要把是否有中文标题当作同步成功的唯一判断。
版本信息没加载,是否还能下载?
可以。“下载最新 ZIP”始终指向下载站的最新 Windows 包。版本、大小与校验值依赖发布清单,加载失败请点击“重新获取发布信息”,或直接打开下载主站与发布清单。未获取到有效校验值前,本页不会提供哈希复制。
在原电脑、原目录升级
替换程序,保留本机数据
- 安全停止本地服务。在本地设置中点击“安全停止”,确认停止服务;等待正在执行的请求结束、服务退出后,再关闭控制台并替换文件。
- 备份当前
data目录。备份只放在自己的安全位置,不要上传或公开分享。 - 下载并解压新版,仅覆盖程序文件。保留原目录的
data和本机系统中保存的密钥,不清空原数据或重置系统凭据。 - 重新双击
start-windows.cmd。在设置中检查同步状态,再刷新在线页面。
升级在原电脑保留数据;新电脑按“新电脑接入”独立配置。不要把整份旧目录复制到新电脑;系统加密的凭据也不能这样搬运。
清楚知道数据去哪里
隐私与使用边界
- 原会话只读。同步端读取资料与正文,不移动、不删除原聊天文件。
- 在线页需要管理密码。同步的资料和正文保存在云端,离线电脑的已同步内容仍可在线阅读;请只同步你愿意放入该工作空间的内容。
- AI Key 留在来源电脑。云端不保存 AI Key;主动点击分析会通过来源电脑向你配置的模型服务发送请求和相关会话内容。
- 管理员密码与设备令牌使用本机系统加密。它们不进入便携数据库。不要公开本机目录、日志、备份或凭据。
- 公开包只含程序、运行依赖与通用安装说明。下载包不附带账号数据、管理员密码、设备令牌、AI Key 或私人项目记录。
- 本页只提供说明与发布信息。只读获取下载清单,不探测本地服务,不调用本地 API,也不要求输入密码。勾选清单仅在当前页面内存中保留。
准备好了,就从你的场景开始。
只看已有内容直接登录;新增一台来源电脑再下载同步端。