核心功能与用法
pubblue 是一套面向 Agent 工作流设计的实时内容发布与可视化系统，通过 CLI 工具实现程序化内容托管与双向 P2P 通信。其核心工作流分为两个层面：
静态发布层：支持将 HTML、Markdown 等内容通过 pubblue create 发布为可访问的 URL，默认私有访问，可选公开分享，支持自定义 slug、标题与过期时间。内容更新通过 pubblue update 完成，形成版本化的发布机制。
实时交互层（Live）：这是 pubblue 的差异化能力。用户启动守护进程后（pubblue start），浏览器端访问页面并点击「Go Live」即可建立 P2P 会话通道。Agent 可通过 pubblue write 向特定通道（chat/canvas）推送内容，实现真正意义上的"浏览器即终端"的实时可视化。pubblue read 则支持反向消费用户输入，形成闭环交互。
桥接模式：原生支持 OpenClaw 与 Claude Code 两种 Bridge 模式，配置文件默认存放于 ~/.openclaw/pubblue/，可通过环境变量覆盖，体现了对现代 Agent 运行时的深度适配。
显著优点
- 实时双向通道：不同于传统静态托管，Live 模式实现毫秒级浏览器-Agent 通信，适合需要即时反馈的交互式场景（如实时数据可视化、逐步推理展示）
- 零配置快速发布：单条命令即可将本地文件转为可分享链接，无需服务器部署
- Agent 原生设计：CLI 接口、环境变量配置、Bridge 模式均为自动化工作流优化
- 隐私优先：默认私有发布，权限控制粒度细至单个 pub
潜在局限与风险
- Node.js 生态依赖：强制要求 Node 18+ 环境，对非 Node 技术栈用户形成门槛
- P2P 连接稳定性：Live 模式依赖浏览器端主动发起与守护进程的持续连接，网络波动或进程重启会导致会话中断
- 安全边界模糊：API Key 存储于本地 JSON 文件，虽支持环境变量覆盖配置目录，但缺乏内置的密钥轮换或短期凭证机制
- 消费型读取设计：
read操作为消费式（consumptive），多消费者场景需自行协调，易引发消息丢失
适用人群
- 需要实时可视化 AI 推理过程的开发者（如 Chain-of-Thought 展示、工具调用追踪）
- 构建交互式 Agent Demo 的技术布道者
- 追求快速分享、即时反馈工作流的自动化工程师
常规风险提示
- 密钥管理：生产环境建议通过
PUBBLUE_CONFIG_DIR指向受控目录，避免密钥泄露于共享环境 - 守护进程生命周期：
pubblue start为前台阻塞进程，生产部署需配合 systemd/screen 等进程管理工具 - 版本锁定：文档明确要求 CLI 0.6.9+，旧版本可能存在协议不兼容
- 数据残留：
delete操作不可逆，且 Live 通道内容默认不落盘，重要交互需外部持久化