dsh-live-room · 会话直播间
dsh（DeepSeek Harness）插件：把任意会话变成免登录、只读、可分享的实时观看页。观众在浏览器里实时围观 agent 干活（打字机式 token 流、工具调用状态、思考过程），可发轻量弹幕；主播端一键开播/停播，也支持让 agent 自己开播。
功能
- 设置页「直播间」面板：选择会话开播（可自定义标题与 TTL），房间卡片展示观众数、缓冲条数、过期时间，一键复制本机/局域网观看链接，随时停播
- 观看页：自包含单文件页面（无外部依赖），SSE 实时推送 + 全量快照（断线自动重连），token 打字机、思考流（暗色折叠样式）、工具调用行（运行中/完成/出错）、轮次分隔；弹幕飞屏 + 快捷表情
- agent 工具三件套：
start_live_room / stop_live_room / list_live_rooms，会话里一句"帮我把这个任务直播给同事看"即可
- 归一化协议：宿主 ~50 种会话事件 + 持久层 chunk-run 打包行统一归一为 6 种观看帧，未知事件降级为提示行，永不崩页
安装
dsh plugin --profile web add dsh-live-room
或从源码：pnpm build 后 dsh plugin --profile web add <本目录路径>。
安全模型（必读）
- 观看链接免登录、凭链接即看：任何拿到链接的人（同一局域网）都能实时看到该会话的完整内容，请只发给可信观众
- 房间密钥为 24 字节随机值（SHA-256 +
timingSafeEqual 校验），停播/过期立即失效
- 观看页构造上只读：不含任何会话写路径；弹幕仅在观看层广播，不会进入会话
- 观看服务首房自动启动、末房自动停，最小暴露窗口；绑定了独立端口（默认
0.0.0.0:33210），可在插件配置里把 host 改为 127.0.0.1 收紧到本机
- 直播间为内存态：dsh 重启后自动清空；Windows 首次监听会弹防火墙授权
配置项
| 键 | 默认 | 说明 |
|---|
port | 33210 | 观看服务端口 |
host | 0.0.0.0 | 监听地址（改 127.0.0.1 仅本机可看） |
maxFrames | 2000 | 每房间环形缓冲上限（按事件数） |
snapshotMaxEvents | 500 | 建房时回填持久化历史的末尾事件数 |
defaultTtlHours | 8 | 房间默认存活时长 |
allowReactions | true | 是否开放弹幕 |
reactionCooldownMs | 2000 | 同 IP 两条弹幕最小间隔 |
架构
宿主进程内 dsh-live-room
├─ ctx.on('session/event', …, { global: true }) ← 数据源（post-commit 免轮询）
│ └─ RoomManager（环形缓冲 · seq 去重 · callId→工具名补全 · TTL）
├─ 独立观看服务 node:http（SSE：hello → snapshot → live/viewers/chat/ended）
├─ 管理 API /live-room/api（宿主主服务同源前缀，POST 双重防御）
├─ 设置页面板（settings.section 槽位 · order 62 · React 壳 + 原生 DOM）
└─ agent 工具三件套
开发
DSH_CHECKOUT=<dsh checkout 路径> npm run typecheck
DSH_CHECKOUT=<dsh checkout 路径> npm test
DSH_CHECKOUT=<dsh checkout 路径> npm run build
node scripts/verify-live-room.mjs --base http://127.0.0.1:3080 --token <启动 token>
License
BSD-3-Clause
