赛博朋克主题

SKILL.md

---
name: 赛博朋克主题
description: Install or customize this OpenClaw cyberpunk chat and dream theme. Use when the user wants this exact theme, wants to import it into another workspace, or wants to swap the bundled avatars and background images.
---

# 赛博朋克主题

这个 skill 用来安装或更新一套 OpenClaw 赛博朋克聊天 + 梦境主题。

## 当前包含

- 赛博朋克 + P5 风格聊天页视觉层
- 聊天背景、助手头像、工具头像、帮助/历史头像、用户头像替换
- 梦境页背景与梦境头像替换
- 聊天消息头像自动纠偏
- 浮动 composer 上方的 context usage、compaction、run status 层级修正
- Codex 用量按钮同时展示 5h 与周额度，避免只显示最紧张窗口造成误读

## 能配置什么

支持替换这七个槽位：

- 主助手头像
- Tool 头像
- Help / 历史消息头像
- 用户头像
- 聊天背景大图
- 梦境头像
- 梦境背景大图

具体文件映射见 `references/theme-slots.md`。

## 怎么用

默认安装：

`python3 scripts/install_cyberpunk_theme.py --workspace <target-workspace>`

带素材覆盖安装：

`python3 scripts/install_cyberpunk_theme.py --workspace <target-workspace> --assistant-avatar /path/to/main.png --tool-avatar /path/to/tool.png --help-avatar /path/to/help.png --user-avatar /path/to/user.png --chat-background /path/to/chat.jpg --dream-avatar /path/to/dream.gif --dream-background /path/to/dream-bg.png`

如果不想在命令行里写长串参数，用 JSON 配置：

`python3 scripts/install_cyberpunk_theme.py --from-config references/theme-config.example.json`

配置示例在：

- `references/theme-config.example.json`

如果主题已经装好了，只是 OpenClaw 更新后需要重新挂载：

`python3 scripts/apply_cyberpunk_theme.py`

## 兼容说明

- 主题通过 `<style id="openclaw-workspace-theme">` 和 `<script id="openclaw-workspace-theme-script">` 注入 live Control UI。
- 不使用 `openclaw-custom-theme` id，避免和 OpenClaw 内建自定义主题注入器冲突。
- 当前主题源适配 OpenClaw 2026.5 系列 chat/control UI。

## 安装后效果

安装脚本会：

1. 把主题文件装进目标工作区的 `customizations/openclaw-control-ui/`
2. 按传入参数或 JSON 配置替换素材槽位
3. 生成目标工作区内可重复执行的 `scripts/apply_cyberpunk_theme.py`
4. 默认立即把主题 apply 到 live OpenClaw control-ui

## 文件说明

- `assets/theme/`：主题默认源文件与默认素材
- `assets/cyberpunk-theme-small.svg` / `assets/cyberpunk-theme-preview.png`：skill 图标与预览图
- `scripts/install_cyberpunk_theme.py`：安装、覆盖槽位、生成 apply 脚本、执行 apply
- `references/theme-slots.md`：七个视觉槽位与落地文件名
- `references/theme-config.example.json`：`--from-config` 的示例配置

## Changelog

- `1.0.15`：修正 WebChat 聊天页 session 下拉选择框的层级链路，移除会裁切菜单的旧 `overflow`，并把 `.content-header`、`.chat-controls`、`.chat-session-picker` 整体抬到消息时间线之上，避免下拉被 transcript 盖住。
- `1.0.14`：修正主题重新注入时的 live `dist/control-ui` 目标发现逻辑，自动兼容本机 OpenClaw 安装路径；同时彻底移除梦境页主舞台残留的毛玻璃遮罩与额外底色，实现 changelog 承诺的直贴背景图效果。
- `1.0.13`：移除梦境页主舞台的毛玻璃与额外底色，让梦境内容直接贴合背景图，不再额外罩一层特殊面板。
- `1.0.12`：修正 WebUI 聊天时间线在 `chatMessages` 和 `chatToolMessages` 合流时的稳定排序，强制同时间戳消息保持 `user -> assistant tool -> toolResult -> assistant 文本`，避免官方前端把最终回复插到工具流前面。
- `1.0.11`：把 tool / helper 立绘从纯 CSS 背景图切到真实 `<img>` 填充层，避免这两路头像在浏览器合成时出现明显糊化 / 压缩感。
- `1.0.10`：修正聊天铭牌来源，helper 固定显示为 `消息助手 helper`，主助手铭牌改为从 `IDENTITY.md` / `SOUL.md` 解析，并同步去掉前端对“菠萝包”名字的硬编码匹配。
- `1.0.9`：微调右侧抽屉展开态上下间距，让顶部控制区和底部输入框避让后的视觉留白保持一致。
- `1.0.8`：新增 Help / 历史消息头像槽位 `--help-avatar` / `helpAvatar`，用于替换聊天里非主助手的帮助立绘。
- `1.0.7`：同步 2026.5 chat 顶栏用量修复，Codex 用量按钮显示 `5h xx / 周 xx`，并保留 tooltip reset 信息。
- `1.0.6`：保留为已发布小版本。
- `1.0.5`：适配 OpenClaw 2026.5 footer status layer，让 context usage、compaction、run-status 在浮动 composer 上方稳定可见。