技能介绍

要解决的问题

自适应界面开发常面临三个痛点：实时性需求与静态 UI 模板的冲突，多运行时（如 claude-code、openclaw）与发布流程的割裂，以及配置分散导致的初始化复杂。开发者需要反复调整代码、手动管理发布内容，且难以统一处理会话生命周期。

核心能力与工作方式

Pub 技能通过 CLI 0.11.23+ 提供端到端方案：

配置解析：按优先级读取 PUB_HOME/config/config.json → XDG_CONFIG_HOME/pub/config.json → ~/.config/pub/config.json，PUB_HOME 需为绝对路径，同时作为数据、状态、socket 和工作区的根目录。
命令体系：pub create（支持 --slug）创建 pub，pub update（支持 --file/--public/--slug）更新，pub list 检查已有 pub——注意每个用户限 10 个 pub，优先复用而非新建。
UI 约束：使用 DaisyUI 5 + Tailwind CSS 4 的语义 token（如 primary/success）和工具类布局，禁止内联样式、任意值（text-[...]）、emoji 等，确保 UI 一致性。
上线流程：

1. 启动 daemon（pub start），通过 bridge.mode 配置桥接（支持 openclaw/claude-code/claude-sdk 等）；
2. 检查状态（pub status），owner 在 daemon 在线时自动连接 live 模式；
3. 用 pub write 输出非聊天内容（聊天需正常回复文本，由桥接转发），停止用 pub stop，验证用 pub validate。

注意点与适用边界

元数据强制来自 HTML 的 og:title 和 og:description，无 CLI 参数，更新时需保持标签准确。
桥接模式依赖本地环境：claude-sdk 需 @anthropic-ai/claude-agent-sdk，claude-channel 需运行 pub channel-server，openclaw 类桥接需显式配置工作区路径。
桥接故障时优先查看 daemon 日志，或用 pub config --set bridge.verbose=true 开启详细日志；pub 可设为 live-only（无内容），但初始化时需先配置桥接模式。
聊天消息严禁用 pub write，避免破坏 live-session 契约。