UI 增强

dsh-status-rotator

01Virex/dsh-status-rotator · ★ 233

01Virex精选

把回合状态那句 "Deep diving..." 替换成更有梗的自定义文案,按阶段轮换,支持打字机与流动渐变。

许可证
MIT
收录
2026-08-14
维护状态
active
安装方式
github
npm
dsh-status-rotator
查看 manifest 检查详情
manifest 状态
已声明
manifest 路径
package.json#dsh
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:01Virex/dsh-status-rotator

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 效果预览
  2. 状态行与昼夜渐变
  3. 鲸鱼尾巴动画
  4. 主题与弹幕效果
  5. 安装
  6. Desktop:npm 安装图解
  7. 30 秒上手
  8. 方式 A:dsh plugin add(推荐)
  9. 方式 B:手动安装
  10. 首次使用
  11. 特性总览
  12. 设置页
  13. 鲸尾设置
  14. 工作原理
  15. 阶段感知
  16. 零侵入定位
  17. 状态行文案来源(label source)
  18. 词库现状
  19. 词库包
  20. 加权随机
  21. 反重复(洗牌袋)
  22. 条件句(when)与稀有句
  23. 模板占位符
  24. 炫彩渐变
  25. 外观主题
  26. 弹幕模式
  27. 弹幕增强
  28. 与宿主弹窗共存:遮罩期间自动暂停(自 v0.25)
  29. 顶部 / 底部弹幕(bilibili 风格,自 v0.19)
  30. 浏览器标签页标题
  31. 预设与调度
  32. 从另一个插件扩展它
  33. 配置
  34. 从外部写配置(ETag / If-Match)
  35. 可热重载的外部词库
  36. 词库自动更新
  37. QQ 群成员文案生成器
  38. 项目结构
  39. 通过 Issue 投稿词库
  40. 测试
  41. 卸载
  42. 贡献
  43. 致谢
  44. License
  45. Star 趋势

让 DSH 运行时的状态行说你喜欢的话:自定义文案、打字机、白天/黑夜渐变、弹幕,以及可选的鲸尾动画。内置 1564 条梗、14 个主题词库包,可按需启用。

English | 中文 · 效果 · 安装 · 更多说明 · 更新日志

npm version GitHub stars license

一个 DeepSeek Harness (DSH) 客户端插件,把 Deep diving... / 深度求索中... 换成你能编辑的文案,保留宿主的运行时长时钟。

效果预览

状态行与昼夜渐变

自定义文案在官方原版鲸尾旁逐字出现并轮换,浅色和深色主题使用不同渐变配色。

文案轮换 · 打字机 · 昼夜渐变 · 官方原版鲸尾。 来自实际插件在简化 DSH 宿主中的渲染,使用示例文案,并放大状态行便于查看。查看静态预览。

鲸鱼尾巴动画

实际插件的四动作动态对比:官方原版晃动、翻转摆尾、左右摆尾、扭转摆尾。

按从左到右、从上到下的顺序:官方原版晃动 → 翻转摆尾 → 左右摆尾 → 扭转摆尾。官方动作采用推荐的 4 秒一轮,另外三种为 0.5 次/秒。图标容器固定,动的是鲸尾轮廓。查看静态对比。

在「外观 → 鲸鱼尾巴」打开「保留鲸鱼尾巴」和「尾巴摇动」后,用「尾巴动作」选择翻转摆尾、左右摆尾、扭转摆尾、官方原版晃动或随机切换。四种动作均为 150 帧,播放周期继续服从现有速度设置。旧配置没有 animation 时仍使用翻转摆尾。三种补帧动作的 SVG 坐标采用无损压缩,仅在选中时解码。生成与验证方法。

选择 行为
官方原版晃动 150 帧动作,推荐速度为 4 秒一轮
翻转 / 左右 / 扭转摆尾 固定摇速或跟随估算 tok/s;默认 3 档,最高 1.5 次/秒
随机切换 勾选动作池,定时切换与可选的工具调用触发共用这份动作池

摇速预设提供 2–5 档,自定义 tok/s 上限可设为 1–10 次/秒。官方动作保持推荐速度,关闭推荐开关后才跟随通用设置。

摇速设置、动作池与工具调用触发。

主题与弹幕效果

实际插件渲染的五种内置外观主题:经典、霓虹、终端、糖果、故障风。

经典 / 霓虹 / 终端 / 糖果 / 故障风,一键设置字体、发光、动画和渐变,选完仍可逐项调整。主题参数。

实际插件的弹幕在深色预览区域中飘过,下方保留运行状态行。

弹幕支持滚动、顶部和底部布局,可选悬停暂停、点击复制、按阶段分色和密度自适应。图中为实际弹幕的一帧,放大文字并提高不透明度,便于查看。弹幕参数。

安装

Desktop 端可在插件管理器中从 npm 安装,Web 端使用 dsh plugin add。首次安装后重启对应宿主。

Desktop:npm 安装图解

桌面端可以直接从 npm 安装,无需克隆仓库。以下界面来自 DSH Desktop 0.2.0-rc.2;其他版本的布局可能略有不同。

  1. 打开 DSH Desktop,在侧边栏选择 插件,点击右上角 添加插件。

  2. 在「包名或地址」输入框填写:

    dsh-status-rotator
    

    通过「安装源」选择适合当前网络的源,截图使用「中国大陆镜像源」,然后点击 安装。桌面端会下载 npm 包并注册插件。

    添加插件对话框已填入 dsh-status-rotator,安装源为中国大陆镜像源,底部安装按钮可用。

  3. 等待安装完成,在插件列表的 已安装 分组中找到 dsh-status-rotator,确认启用开关已打开。按界面提示完成重启;若设置页尚未出现,完整退出桌面端(包括托盘)后再启动。

  4. 点击左下角账号菜单,选择 设置 → 状态文案。选择词库包、编辑文案,或在 外观 → 鲸鱼尾巴 中打开「保留鲸鱼尾巴」和「尾巴摇动」。设置会自动保存;发起一个新回合即可查看状态行效果。

dsh plugin --profile desktop add dsh-status-rotator

运行后重启 DSH Desktop。桌面端对应 desktop profile;若终端找不到 dsh,直接使用上面的桌面端安装入口即可。

30 秒上手

Web 端执行:

dsh plugin --profile web add dsh-status-rotator

重启 dsh web,打开 设置 → 状态文案,再发起一个回合查看效果。Desktop 端按上面的 npm 图解操作,也可展开其中的命令行方式。后续设置会自动保存并应用;升级插件代码后重启对应宿主。

鲸尾及尾巴摇动默认关闭,在 外观 → 鲸鱼尾巴 中开启。弹幕默认开启,可在 外观 → 弹幕 中关闭。

方式 A:dsh plugin add(推荐)

本插件在 package.json 里声明了 dsh.bundle.patch manifest,安装后自动识别,无需额外标志。命令语法是 dsh plugin --profile <name> add <package>(例如 --profile web):

  • npm 安装(最简单):dsh plugin --profile web add dsh-status-rotator ← 永远装最新版
  • 桌面端:dsh plugin --profile desktop add dsh-status-rotator(DSH Desktop 的 profile 叫 desktop)
  • 克隆仓库:dsh plugin --profile web add ./dsh-status-rotator
  • Release 打包产物:从 Release 页下载 dsh-status-rotator-<版本>.zip(里面是解压即用的插件目录,含 config.json,不是 npm tarball),解压后执行 dsh plugin --profile web add /path/to/dsh-status-rotator。

方式 B:手动安装

  1. 把本项目目录放到 profile 的 node_modules 下(默认 C:\Users\<你>\.dsh\profiles\node_modules\dsh-status-rotator\);

  2. 在 profile 的 cordis.patch.yml 里插入:

    - insert:
        - id: status-rotator
          name: dsh-status-rotator
    
  3. 运行 node gen-config.cjs 初始化本地 config.json(从 config.example.json 复制);

  4. 重启 dsh web,浏览器 Ctrl+F5 硬刷新。

首次使用

首次启动时伺服顺序是:你保存的设置($DSH_HOME/status-rotator/config.json)→ 包目录 config.json → config.example.json(npm 安装时就是这一份,默认的全部 1564 条文案都在里面,见词库现状)。另有自动更新词库(每 6 小时,见词库自动更新)与可选的外部词库($DSH_HOME/status-rotator/phrases.json,优先级最高,见可热重载的外部词库)。改文案可直接改文件(页面开着时热更新),也可走 DSH 左下角「设置 → 状态文案」。

dsh 0.1.7 起的状态行:宿主把运行时文案塞进了回合折叠头 button[data-turn-process](Deep diving for 12s / 深度求索中,用时12秒,长回合里早被滚出视口)。插件把状态行搬回旧版位置 —— 对话下方、输入框正上方那一行,水平方向与消息列同一左边界(复刻 dsh ≤0.1.6 的 .turnStatus:26px 高 / 自带 shimmer / 时钟 13px + 8px 间距),跟着输入框常驻可见;回合折叠头里那行藏起来避免重复,回合结束再把状态行撤掉、放出宿主自己的 Took 12s / Worked。时长与阶段照旧从折叠头标签文本读(React 每秒整段重写它,插件不往里塞东西),读屏公告 span 不改写。0.1.6 及更早的 role="status" 状态行本就在旧位置,行为不变。

dsh 0.2.0 起的状态行:运行中不再是折叠头里的一段文本 —— 宿主把它改成会话流里独立的一行 div[data-chat-running](隐藏读屏公告 + 分隔条 + DeepSeek 鲸鱼尾巴图标 + shimmer 文案),折叠头按钮 button[data-turn-process] 只在回合结束后才渲染。插件因此新增一条宿主路径:接管这一行(把文案写进它、藏掉宿主自己的 shimmer 文案、时长照旧从宿主文本读),位置与观感不变;读屏公告 span 保持原样(不藏整行)。whaleTail(默认关)打开时把那一行的鲸鱼尾巴留下,与插件文案同一行,并按「炫彩渐变」的色板给尾巴做流光。单独打开尾巴摇动后,摇速可跟随 tok/s,也可切换成固定速度;启用这个开关即明确选择播放摇动。

开一个隔离的测试实例(不想动日常 profile 时):把某个 dsh 版本装在临时目录,用独立 DSH_HOME 起 profile 即可 —— DSH_HOME=/tmp/dsh-test node /tmp/dsh-test/node_modules/.bin/dsh test020 --from-default-profile web --no-open --port 3081,再 dsh plugin --profile test020 add <本插件目录> 装插件。测试实例的配置存储、词库、设置都在那个 DSH_HOME 里,与日常实例互不影响。

没有文案可轮换时不会留空行:config.labelSource(默认 "phrases")管状态行写什么。短语库为空(比如装了插件但没 config.json)时,插件自己那条线会回落宿主原文「Deep diving…」/「深度求索中」,而不是一条空状态行;写成 "host" 则完全不轮换,只用宿主原文,外观逐项对齐 0.1.6 的 .turnStatus(字重 500、inline-flex、26px、shimmer、时钟 15 秒后出现)—— 在 0.1.7 上得到 0.1.6 的观感。详见状态行文案来源。

特性总览

想调整什么 可以做什么
状态文案 按思考、运行、长任务阶段轮换;逐字输出、加权抽取、洗牌袋反重复
词库内容 逐包启用、独立编辑;支持条件句、实时占位符和中英文切换
视觉效果 深浅色渐变、外观主题、弹幕;可选悬停暂停、点击复制和鲸尾动作
使用习惯 按星期与时段切换预设;可选标签页标题轮换
保存与更新 设置保存在插件数据目录;配置热更新,设置页并发写入冲突会提示
插件联动 第三方通过 ctx.statusRotator 注册词库、占位符、动态文案或发送弹幕
接下来 入口
选择内容和外观 设置页 · 词库现状 · 鲸尾动画
编写自己的文案 词库包 · 条件句 · 模板占位符
管理文件与自动更新 配置 · 安装
投稿或参与开发 Issue 投稿 · 扩展接口 · 测试

设置页

打开 设置 → 状态文案,按文案、外观、行为和自动化四个标签页调整;改动会自动保存。

打开 DSH 左下角「设置」,导航里会多出一页 状态文案。页面按语义拆成四个 tab,排版与官方插件设置页同规格(760 列,同一套 tab / 字段 / 输入框语言):

文案

  • 编辑目标 —— 一个下拉覆盖基础词库、任意预设(preset:<id>)与任意词库包(pack:<id>),保存时按它决定写进哪里;目标失效(预设或包被删)自动退回基础词库;
  • 中文 / English 两个标签页,各含 thinking / running / long 三个文本框,每行一句,空行自动忽略;行内写 文案 | 权重 可设置该句权重,每个阶段实时显示句数;
  • 词库包开关 —— 十个主题包默认开启,社区、广告及两个 star 包默认关闭;
  • 预设管理 —— 选预设、新建、就地改名(名称按当前编辑语言保存)、删除(引用它的调度规则会一并移除)、「设为当前」写入 activePreset。

外观

  • 字体粗细(状态文字与弹幕共用);
  • 炫彩渐变:启用开关、配色模式(跟随界面深浅色 / 强制白天 / 强制黑夜)、流动方向(从右向左 / 从左向右)、白天 + 黑夜两套颜色序列、流动速度;
  • 弹幕:启用开关、发射间隔、穿越时长、随机字号范围、炫彩开关 + 色板、透明度、同屏上限、层级与文案范围。

行为

  • 轮换间隔、打字机速度、长任务阈值、自动重读间隔、占位符刷新间隔、加权随机开关。

自动化

  • 调度编辑器:以列表增删「星期 + 时段」规则,自动切换预设;页面上实时显示当前生效的预设(含调度命中)。

整页通用:

  • 改动即保存:开关与下拉立即写盘,文本 / 数值停顿 400ms 写盘(预设改名在失焦时),没有保存按钮,只有写盘失败时工具栏标红;
  • 每次写盘把整份 JSON PUT 到 /plugins/dsh-status-rotator/config.json,node half 校验后原子写回,已打开页面立即热应用;非法内容返回 400 并在页面报错,不会写坏文件;
  • 切换编辑目标 / 「重读」都会先落盘再操作,草稿不会被静默丢弃;数值越界即标红,偏离默认时出现「恢复默认」;页脚直接跳源码仓库。

升级到带设置页的版本后,需要重启一次 dsh web(让 node half 注册写接口),之后全部在页面里操作即可。

鲸尾设置

官方原版推荐速度。officialRecommendedSpeed 默认 true,官方动作单独采用 0.25 次/秒(4 秒一轮),避免高帧率素材快速播放时看起来静止。固定模式、tok/s、随机及工具触发都以实际动作判定;切回其他动作后自动恢复用户速度。设置页可关闭此开关,让官方动作也遵循通用速度。

**摇速档位。**这里的 2–5 档是速度预设:最高摇速依次为 1.0 / 1.5 / 2.0 / 2.5 次/秒,档位越高,输出较快时的尾巴也越快。其他动作各档最低速度均为 1 次/秒;默认 3 档的速度为 1.00 / 1.25 / 1.50。选择档位时会同步恢复对应上限;手动修改某档上限后显示「自定义上限」,不再冒充该预设。连续模式可独立保留上限。分档边界两侧有约 4.8 tok/s 的缓冲,减少反复跳档。旧配置明确保存的上限继续生效,不匹配预设时显示自定义。

随机模式每 4–8 秒请求切换,只从「参与切换的动作」中选取另一种动作;到当前动作的衔接姿态后经过 6 帧过渡。只选一个动作时持续播放,不制造重复切换;工具调用触发也遵守这个动作池。四种动作共用摇速与炫彩设置。页面隐藏时暂停,回合结束、关闭动效或卸载时清理轮廓与监听。

调速时保留当前动画进度,避免突然跳帧;宿主重新创建图标后自动恢复当前动作、速度与炫彩,随机模式也沿用原有切换计划。这两项参考了 dsh-whale-sway 的设计,适配与后续灵感见 参考记录。

图标重建会恢复圈内播放进度,正在播放的 6 帧过渡也会继续原来的目标与进度;图标短暂缺席期间保存的进度随回合释放,不保留旧 DOM 节点。

工具调用触发:同一组设置里可开启「工具调用时随机切换动作」,默认关闭,触发概率默认 35%,可调为 0–100%。每次当前会话新增 tool/call 事件只判定一次;历史加载、分页、重复通知和流式参数增量不触发。命中后等到衔接姿态,用 6 帧过渡切换到另一种动作,连续命中合并为一个待切换请求。固定动作与定时随机模式都可使用;固定动作被工具触发替换后保持新动作,直到再次触发、改选动作或关闭此开关。关闭后在衔接姿态处恢复所选动作。宿主没有会话事件窗口时,这项功能静默跳过。

"whaleTail": true,
"whaleTailMotion": {
    "enabled": true,
    "animation": "random",
    "toolSwitchEnabled": true,
    "toolSwitchChance": 0.35,
    "mode": "tps",
    "fixedSpeed": 1.5,
    "tpsTiers": 3,
    "officialRecommendedSpeed": true,
    "randomActions": ["wag", "official"]
}

本地开发可直接打开 动作预览页,切换四种动作、勾选动作池,以及比较固定和 tok/s 摇速。预览使用实际插件代码;运行 npm test、npm run test:browser:turn-process 和 npm run test:browser:settings 可检查配置、轮廓过渡、调速、设置保存与卸载清理。

预览页也提供「模拟一次工具调用」按钮。要单独检查工具触发,先选一个固定动作,将概率设为 100%,再点击模拟;0% 可作为不触发的对照。

工具触发选项下会显示连接状态,连接后显示新调用数、概率命中数和开始切换数。统计从插件连接当前会话后开始,历史调用不回放。新版宿主通过主对话的 data-conversation-session 定位,即使右侧栏关闭也能监听;会话绑定延迟就绪或同一会话更换绑定时会重新订阅。窗口隐藏时命中请求留在队列,恢复可见后在衔接姿态处播放。

待切换请求按当前会话保存:工具调用先于图标出现时仍判定概率,图标出现后再消费。同一会话重连保留工具选出的动作和待切换请求;对应回合结束、关闭功能、切换到另一会话或卸载时会清理队列,避免旧请求进入下一轮。

工作原理

阶段感知

文案按回合进展分三组(判定依据是状态元素里是否出现时钟及其读数):

阶段 触发条件 默认时长
thinking 回合刚启动,无时钟 0 ~ 15s
running 时钟出现,未超时 15s ~ longAfterMs
long 时钟超过 longAfterMs ≥ 60s

阶段切换会立即触发换文案,无需等轮换间隔。某阶段缺文案组时自动回退(running → thinking → 任意非空组)。

零侵入定位

状态标签按 role="status" + aria-live="polite"(dsh ≤0.1.6)或 button[data-turn-process](0.1.7+)精确定位,不碰聊天记录里的代码片段或其它 aria-live 区域。0.1.7+ 上插件只做三件事:在输入框座位里插自己的一行、把折叠头那行藏起来、读折叠头的标签文本取时长;宿主时钟只被读取,阶段与时长由实时引擎按回合开始时刻推导。

状态行文案来源(label source)

config.labelSource 决定状态行里写什么,两代宿主都认:

取值 状态行文案 什么时候用
"phrases"(默认) 从短语库里抽一句,按阶段轮换 插件本来的样子
"host" 只用宿主原文 Deep diving... / 深度求索中 想要纯 0.1.6 观感、不要梗文案
  • 没文案也不会空行:短语库为空时(没 config.json / 预设清空了文案),"phrases" 模式回落宿主原文,0.1.7 上不会只剩一条空行配时钟;
  • "host" 连外观一起对齐 0.1.6:插件那条线逐项照抄 .turnStatus(字重 500、height: calc(26px + …)、inline-flex、同一套 shimmer 与 prefers-reduced-motion 降级)与 .turnStatusClock(13px、tabular-nums、8px 间距、400 字重),时钟也按旧时机(elapsedMs >= 15s)出现,文案一次性写出而不打字;旧宿主(≤0.1.6)在 "host" 下插件完全不碰;
  • 设置页有同名下拉框(「状态行文案来源」),{"labelSource": "host"} 也可直接写进 config.json 或预设。

词库现状

默认词库当前共 1564 条,拆为 14 个主题词库包(核心 phrases 表为空——词条全部住在包里)。其中 10 个默认启用,社区、广告及两个 star 包默认关闭,可在「设置 → 状态文案 → 词库包」里打开:

词库包 zh en 小计 默认
deepseek DeepSeek 专场 107 111 218 开
coding 写代码日常 87 81 168 开
daily 日常 77 64 141 开
internet-memes 网络梗 73 34 107 开
sysadmin 系统管理 41 38 79 开
slacking 摸鱼 40 33 73 开
math-physics 数学与物理 35 22 57 开
western-ai 西方 AI 圈 20 22 42 开
reverse-proxy 反代 20 21 41 开
china-ai 中国 AI 圈 22 14 36 开
community 社区投稿 107 0 107 关
ads 广告 3 3 6 关
star-ask 求 star 11 12 23 关
star-route 星标者路由 233 233 466 关
合计 876 688 1564 开 962 / 关 602
  • 大部分条目 zh/en 成对镜像;近期社区投稿常为中文单语——投稿表单选「zh + en (两种都要)」即可双语收录;
  • 含 5 条加权示范条目(见加权随机),其余均为默认权重 1 的纯文案;
  • 词库通过社区投稿表单持续增长:校验通过并合入的投稿会在 CONTRIBUTORS.md 名单里致谢;
  • 统计由 node scripts/sync-bank-counts.cjs 从 config.example.json 现算并写回(投稿机器人与 star 词库刷新会自动调用;手改词库后跑一次即可);本地用 node scripts/check-bank-memes.mjs 可随时审计当前词库(查重/超长/省略号/系列占比)。

star 词库包(默认关闭) — 拆成两个独立的包,想只要求 star 文案、不要星标者点名,就只开前者:

词库包 内容
star-ask 求 star 纯求 star 文案,如「正在向你讨一个 star…」/ Begging for a star…
star-route 星标者路由 每位当前星标者一条——正在路由 <login> 写代码… / Routing <login> to write code…,让状态轮换真的"路由每个点星的人去干活"

默认关闭是口味问题不是坏了:在「设置 → 状态文案 → 词库包」打开即可。星标名单由 Star packs 工作流刷新(每周、文件有改动时、手动),用仓库自带 GITHUB_TOKEN 读 stargazers,刷新走机器人 PR 且 Test 绿了自动合并;fork 里该 job 整条跳过(那里的令牌看不到上游星标),可用 STAR_TOKEN 覆盖。本地刷新:node scripts/update-star-pack.cjs --token <pat>。

词库包

词库可在核心 phrases 之上按具名「词库包」组合:

{
    "packs": [
        { "id": "community",
          "label": { "zh": "社区投稿", "en": "Community" },
          "phrases": { "zh": { "running": ["正在试用词库包…"] } } }
    ],
    "enabledPacks": ["community"]   // 缺省 = 全部包启用;[] = 只用核心库
}
  • 启用的包按顺序并入生效词库,按文本去重——核心库(或更早的包)已存在的条目会被跳过,保留其权重;
  • enabledPacks 缺省/null = 全部启用;[] = 只用核心库;名单里的未知 id 直接忽略;
  • 包内条目与核心库完全同构(字符串或 {text, weight}、三阶段分组、占位符);
  • 设置页列出每个包:逐个启用开关 + 包编辑目标(选中某包后,词库编辑区读写该包文案);
  • 默认自带 14 个包(deepseek / western-ai / china-ai / coding / reverse-proxy / sysadmin / math-physics / slacking / internet-memes / daily / community / ads / star-ask / star-route);community(社区投稿)和 ads(广告)随包提供、默认关闭,enabledPacks 钉住默认启用的包。
  • 投稿表单的**「目标词库包」**选择器将文案追加到所选包,默认落点为 community;ads 接受带出处的广告,star-route 由星标名单自动生成、不接受投稿。
  • 旧配置没有 packs 字段,零改动兼容。

加权随机

默认按权重抽取。文案条目写成 "文案 | 3"(或 { "text": "文案", "weight": 3 })即为权重 3,未写 = 1;权重上限 1000,非法值按 1 处理。weightedRandom: false 回到完全均匀。词库里有 5 条展示用的加权条目。

反重复(洗牌袋)

自 v0.31.0 起,状态行**按「语言 + 相位」**记住自己刚说过什么,用的是洗牌袋,而不再是「避开上一句」:

  • 袋里的句子抽完之前不会重复 —— 某个相位有 40 句,你就能连着看到 40 句不同的,而不是每抽一次都可能撞上刚说过的那句;
  • 袋子抽空重开时,最近 recentLimit 条会被先剔掉,所以跨袋的接缝处也不会重复;
  • 权重在袋内照样生效(权重 9 的那句每轮都倾向早出现);
  • persist: true 会把记忆写进浏览器本地存储:刷新页面后不会立刻又看到同一句。
"antiRepeat": { "recentLimit": 3, "persist": false }

recentLimit 取 0~50(0 = 只靠袋子,不做跨袋记忆)。设置页在 设置 → 状态文案 → 行为 → 反重复。

条件句(when)与稀有句

一句文案可以只在它真正描述的状态下出现,而不是跟在另外一千多条后面碰运气。加一个 when 对象(或在设置页用 | when:… 后缀):

"phrases": { "zh": { "running": [
    "正在写代码…",
    { "text": "正在敲命令…", "weight": 2, "when": { "tool": "bash" } },
    { "text": "正在满世界翻…",     "when": { "tool": "web_search" } },
    { "text": "又失败了,再试一次…", "when": { "retry": true } },
    { "text": "等你点头…",         "when": { "pending": true } },
    { "text": "夜深了…",           "when": { "hour": [22, 6] } },
    { "text": "初次见面…",         "when": { "firstTurn": true } },
    { "text": "传说级的一句…",      "rarity": 0.01 }
] } }
条件 类型 含义
tool 字符串 / 字符串数组 / "*" 有同名工具在跑("*" = 任意工具)
retry 布尔 正在重试
pending 布尔 / 数字 宿主在等你作答(数字 = 至少这么多)
phase 字符串 / 字符串数组 thinking / running / long / idle
hour [起, 止] 本地小时区间,可跨午夜([22, 6])
firstTurn 布尔 本会话的第一个回合
  • 写出来的条件必须同时成立(AND):{ "tool": "bash", "phase": "long" } 要求两者都满足;
  • 条件命中的句子优先:只要有条件句成立,这一次就从它们里抽 —— 否则一句 bash 会被上千条无条件句按权重淹没。一条都没命中时照常使用无条件句,所以状态行不会空;
  • rarity 取 (0, 1],是彩蛋:只有这个比例的抽取会让它参与。0.01 = 1%;
  • 条件取自实时引擎({tools} / 重试 / {pending} / 相位);宿主没有这些接口时条件句就是不出现,无条件句照常轮换。

在设置页里编辑(每行一句,修饰段写在行尾、顺序随意):

正在写代码…
正在敲命令… | 2 | when:tool=bash
正在满世界翻… | when:tool=web_search
又失败了,再试一次… | when:retry
夜深了… | when:hour=22-6
传说级的一句… | rarity:0.01

when: 里可以写 tool=bash(多个用 + 连,* = 任意工具)、retry、pending、phase=long、hour=22-6、firstTurn;多个条件用 , 分隔表示全部成立。正文里的 | 不会被当成修饰段,而且来回转换是精确的 —— 打开设置页保存一次不会把条件洗掉。

模板占位符

任意文案(以及标题模板)都支持占位符,渲染时替换:

占位符 含义 示例
{elapsed} 当前回合已运行时长(本地化,风格同时钟) 正在写代码 1分02秒…
{phase} 阶段 id:thinking / running / long / idle running
{phaseLabel} 阶段的本地化短标签 运行中
{model} 当前会话的模型名(实时引擎,未知为 —) deepseek-chat
{provider} 当前会话的供应商路由(实时引擎) deepseek
{tps} 流式 token/秒 估算(实时引擎) 12
{pending} 正在等待作答的交互数 —— 审批与提问共用这一个计数(实时引擎) 1
{tools} 正在运行的工具名,+ 连接(实时引擎) bash+web_search
{running} run / idle(实时引擎) run
{retry} 当前步的重试次数(实时引擎,无重试为空) 3
{retryMax} 该重试策略的上限(旧宿主 / always 模式可能为空) 5
{retryProvider} 触发重试的 provider(provider 中立,原样透传) deepseek-official
{retryCode} 失败短码(≤32 字符的安全 token;URL / 路径 / 报文一律不显示) sampling_error
{retryStarted} 重试的那次尝试是否已开始跑(llm/retry-started 之后为 1,否则为空) 1
{detail} 整条观测徽标(按 config.details.badge 模板渲染) ⟳ 3/5
{locale} 当前界面语言(zh / en) zh
{date} 本地日期 YYYY-MM-DD 2026-08-07
{time} 本地时间 HH:MM:SS 12:34:56
  • 随时间变化的占位符({elapsed} {date} {time} {tps} {pending} {tools} {model} {provider} {retry} {detail})按 liveTickMs(默认 1000ms)实时刷新,设为 0 则只随轮换更新;

  • 观测通道(参考 discussion #3669):把宿主写进会话事件日志的结构化信号显示成状态行上的小徽标(llm/retry 等,默认 ⟳ 3/5)并提供同名占位符;拿不到事件窗口就什么都不显示,绝不从日志文本里猜次数。

"details": { "enabled": true, "badge": "⟳ {retry}/{max}" }
"phrases": { "zh": { "thinking": ["正在写代码 {elapsed}…", "正在{phaseLabel}中 ({elapsed})…"] } }
{pending} 与所在会话的审批策略

{pending} 数的是待作答交互——和界面里那些「接管输入框」的面板同一份数据;审批与提问共用这一个计数,只要有一样在等你回答,它就是 1。dsh 对每个会话最多只发布一条(按优先级取最高的一条),所以它实际是个 0 / 1 状态位,不是队列长度。它由事件驱动而非定时器驱动:交互一出现或一消失,标签立刻重渲染,不必等下一次轮换。

审批能贡献多少,完全取决于该会话自己的权限预设(沙箱模式 + 审批策略,用 /permission 切换)——插件既不读也不改这个设置:

  • ask —— 敏感动作先问一句:审批面板等待期间计数为 1,你点完(允许或拒绝)立刻回到 0;
  • never —— 审批提示被关闭:dsh 直接把这类请求判为拒绝,客户端根本不会建面板,所以审批不贡献任何计数。要注意这个计数不表达什么:被拒绝不算「待作答」,所以 {pending} 永远不会告诉你「刚才有动作被拒了」;
  • 提问是另一套域,与审批策略无关:即便在 never 下,dsh 等你回答(比如计划评审)时 {pending} 依然可以是 1。

所以 {pending} 只回答一个问题 —— 现在是不是在等我? —— 而 never 下能让它非零的只剩提问。旧版 dsh 没有待作答交互表时,它保持 0。

炫彩渐变

状态文字默认以流动的七彩渐变显示(仅作用于文案,不影响时钟)。v0.22.0 起渐变带两套配色 —— 黑夜(深色主题)与白天(浅色主题),默认跟随 DSH 界面的深浅色自动切换(mode: "auto");mode: "day" / "night" 可强制其中一套。切主题即时换色,不用刷新。流光方向也可选:direction 为 "rtl"(默认,从右向左)或 "ltr"(从左向右,与打字机同向,issue #41)。可在配置里关闭或自定义配色:

"gradient": {
    "enabled": false,                          // false 关闭;true 用默认配色
    "mode": "auto",                            // auto 跟随界面深浅色自动切换;day / night 强制其中一套
    "direction": "rtl",                        // rtl 从右向左(默认);ltr 从左向右(与打字机同向)
    "colors": ["#ff5f6d", "#00ff88", "#4da6ff"], // 黑夜(深色主题)颜色序列(至少 2 个,循环首尾)
    "dayColors": ["#d92b4b", "#0e7490", "#6d28d9"], // 白天(浅色主题)颜色序列(至少 2 个,循环首尾)
    "speed": 4                                 // 流动速度(秒/圈)
}

只写过 colors 的老配置会继续在两种主题下使用它(升级后观感不变);想要单独的浅色配色,加上 dayColors 即可。

外观主题

过去只有渐变与字重可调,现在补上了整套「配料」,并有一个主题画廊一次设好全部(设置 → 状态文案 → 外观 → 主题包)。

"appearance": {
    "fontFamily": "",        // 留空 = 跟随界面;只允许字母/数字/空格/逗号/引号/连字符
    "fontSize": 0,           // px;0 = 跟随宿主;其余值钳制到 8~96 px
    "glow": false,           // 文字外的一层柔光
    "glowColor": "",         // 留空 = 用渐变色板首色
    "animation": "none",     // none | breathe 呼吸 | glitch 故障风
    "spinner": "none"        // none | ring 环形 | bar 条形
}
  • 每个默认值都表示「什么都不改」 —— 没有这个块的配置,观感与之前完全一致;
  • 主题画廊随包五个(classic / neon / terminal / candy / glitch),选一个会同时写入外观与渐变色板,选完每一项仍可继续手调;
  • animation 与 spinner 以 CSS 类挂在插件自己的文本 span 上,宿主原文与时钟不受影响;prefers-reduced-motion 下呼吸与故障风会自动停掉;
  • 活动指示表达的是「正在跑」,不是百分比 —— 宿主不暴露回合进度;
  • fontFamily 会被写进 CSS,所以走严格白名单(字母 / 数字 / 空格 / 逗号 / 引号 / 连字符),其余字符一律拒绝而不是转义。

弹幕模式

可选:所有文案随机生成视频网站弹幕,从右到左飘过页面(默认在界面后面——弹幕层夹在应用背景与聊天内容之间,可见于空隙,不遮挡聊天):

"danmaku": {
    "enabled": true,
    "intervalMs": 2500,        // 发射间隔(毫秒);越小越接近刷屏
    "speedMs": 18000,          // 从右到左穿过屏幕的时长(毫秒);越大飘得越慢
    "fontSizeMin": 14,         // 随机字号下限(px)
    "fontSizeMax": 30,         // 随机字号上限(px)
    "rainbow": true,           // 炫彩:每颗弹幕从 colors 里随机取色
    "colors": ["#ff5f6d", "#00ff88", "#4da6ff"], // 炫彩色板(至少 1 个)
    "color": "#ffffff",        // rainbow=false 时的单色
    "opacity": 0.3,            // 不透明度(0.05 ~ 1);每颗在此基础上取 75%~100% 抖动,更有层次
    "maxCount": 12,            // 同屏弹幕数量上限
    "zIndex": -1,              // 负数 = 界面后面(默认);非负数 = 浮于界面之上
    "scope": "all",            // all = 当前语言全部文案;phase = 只取当前阶段(带回退)
    "marginTop": 16,           // 弹幕活动区顶部留白(px)
    "marginBottom": 160,       // 底部留白(px),避开输入区
    // ── v0.19 新增:顶部 / 底部弹幕(bilibili 风格)──
    "types": {                  // 类型开关 + 相对权重;scroll = 原有滚动弹幕
        "scroll": { "enabled": true, "weight": 2 },
        "top":    { "enabled": true, "weight": 1 },
        "bottom": { "enabled": true, "weight": 1 }
    },
    "mode": "scroll",           // 可选:强制所有弹幕都发成这一种(scroll/top/bottom,或 bilibili 的 1/4/5);不写 = 按权重分发
    "fixed": {                  // 顶部 / 底部样式 —— 所有数值集中在这一处,改一句就全改
        "fontSize": 25,          // 字号(px)
        "color": "#ffffff",      // 单色:关闭炫彩时生效(默认白字)
        "shadow": "1px 0 1px rgba(0,0,0,.85),-1px 0 1px rgba(0,0,0,.85),0 1px 1px rgba(0,0,0,.85),0 -1px 1px rgba(0,0,0,.85)",
        "marginTop": 16,         // 顶部弹幕距播放区域上边(px)
        "marginBottom": 160,     // 底部弹幕距播放区域下边(px)
        "gap": 4,                // 多条堆叠间距(px)
        "durationMs": 4500,      // 单条停留时长(ms)
        "maxCount": 3,           // 同类弹幕同屏上限
        "zIndex": 10,            // 前层层级:10 压住聊天内容、又低于外壳 overlay 层(20)
        "reserveBands": true,     // 滚动弹幕避开顶部/底部弹幕占用的竖直带(不叠字)
        "anchorBottomToHost": true, // 底部弹幕贴住输入区上沿(状态行上方),而不是只靠 marginBottom
        "overflow": "drop"       // 超限处理:丢弃这一拍(与滚动弹幕一致)
    }
}
  • zIndex 为负(默认)时,弹幕层挂进画应用底色的那个元素内部(通常就是会话面板),夹在底色与聊天内容之间:弹幕在空隙和聊天后面可见,不会盖住气泡或侧边栏。如果主题背景不透明导致看不到,把 zIndex 调成非负数即可浮到界面之上。默认不拦截鼠标;显式开启悬停暂停或点击复制后,只有弹幕条目接收指针事件,容器仍为 pointer-events: none。
  • 挂载点每次发射都会重新解析(v0.15.2 / v0.16.1 两次修的就是它):先按外壳的 data-shell-overlay 找主框架,再取其中「最内层、画不透明底色、覆盖会话列大部分面积」的元素当宿主(给它加 isolation: isolate);外壳还没渲染完时先落到 document.body 以可见层级显示,目标出现即搬进去。仍不可见就开 debug,控制台里找 danmaku layer mounted inside the background panel。
  • 弹幕文案支持与状态文案相同的占位符({elapsed}、{model}、{phase}…),发射时用实时引擎当前值渲染;
  • danmaku: false 完全关闭;fontSizeMin / fontSizeMax 构成随机字号区间(写反了自动纠正,并钳制到 8~200 px)。

弹幕增强

五个可选行为,默认全关(设置 → 状态文案 → 外观 → 弹幕):

选项 作用
hoverPause 悬停在滚动弹幕上把它冻住,移开后从停下的位置继续飞(剩余时长按剩余距离折算)
clickCopy 点一颗弹幕复制它的文案;没有剪贴板 API 时什么都不做,而不是假装复制成功
phaseColors { "thinking": "#5fd4ff", "running": "#7dff7d", "long": "#ffc371" },按当前相位给每颗弹幕上色
adaptDensity 同屏越接近 maxCount 发得越稀;页面不可见时几乎不发
avoidPointer 落点躲开指针所在的高度带

⚠️ hoverPause 与 clickCopy 会把弹幕层变成指针目标,这与「弹幕层永不拦截指针」的承诺相反,所以必须显式打开;而且只有弹幕条目本身接指针,层仍是 pointer-events: none。

自己发一条 —— ctx.statusRotator.sendDanmaku(text)(见从另一个插件扩展它)会立刻让一句飞过,设置页里也有对应的输入框。设置弹窗遮罩期间弹幕层是暂停的,这时发的那条会排队、等遮罩关掉后补发,而不是无声丢掉。

与宿主弹窗共存:遮罩期间自动暂停(自 v0.25)

dsh 设置弹窗的遮罩是全屏 backdrop-filter: blur(2px) 层:弹幕层在它后面继续位移时,浏览器每帧都要重算全屏模糊,设置弹窗会持续闪烁(issue #60)。pauseBehindMask(默认 true)命中这种层就停掉弹幕——拆掉弹幕层与在途弹幕、清掉发射定时器、还原宿主的 isolation,遮罩一消失全部重建恢复。判定用四角 + 中心的命中测试(250ms 合流一次,2 秒一次 rescanAll 兜底),dsh 自己的菜单 / 卡片 / 提示这类小面积或没有模糊的层不会误判。

顶部 / 底部弹幕(bilibili 风格,自 v0.19)

danmaku.types 三种类型(滚动 / 顶部 / 底部)各有开关与权重,样式集中在 danmaku.fixed(字号、单色、描边、间距、停留时长、同类上限、层级、reserveBands 让滚动弹幕避开顶底车道、anchorBottomToHost 让底部弹幕贴住输入区上沿)。

  • mode 可强制所有弹幕发成某一种(scroll / top / bottom,或 bilibili 的 1 / 4 / 5);不写则按权重分发;
  • 顶部 / 底部弹幕默认样式与滚动弹幕不同(白字 + 描边,字号与停留时长独立),数值都在 danmaku.fixed 一处;
  • ⚠️ 默认分布变了:配置里没有 types 时三种都开(scroll 2 : top 1 : bottom 1),想保持 v0.19 之前的样子就把 top / bottom 的 enabled 设为 false(或设置页关掉)。

浏览器标签页标题

可选:默认关闭。开着的时候,回合进行中让标签页标题也按模板轮换:

"title": {
    "enabled": true,
    "templates": ["⏳ {phaseLabel} {elapsed}", "🤔 {phaseLabel}… {elapsed}"], // 每 intervalMs 换一条
    "idleTemplate": "💤 dsh 空闲",   // 无回合时显示;"" = 把标题交还宿主
    "intervalMs": 8000
}

模板支持与文案相同的占位符。没有回合进行中时显示 idleTemplate;idleTemplate 设为 ""(或关掉 enabled)就把标题交还宿主。title: false 完全关闭。

在设置页里改(v0.27.0 起):DSH「设置 → 状态文案 → 行为」页有「标签页标题」一组 —— 开关、模板(每行一条)、空闲时的标题、轮换间隔,保存后随其余设置一起写进插件的配置存储(升级不丢),不用手改 config.json。

只写自己的标题(重要):插件给 document.title 写入的前提是「这个标题是它自己写上去的」;从没接管过、或已经把标题交还之后,它一个字都不会碰 —— 包括宿主自己写的会话标题(<会话名> — DeepSeek Harness)和别的插件对标题的改动。关掉这个开关时,插件把最近一次宿主写的标题还回去,然后就不再插手。

v0.27.0 起插件只写自己接管过的标题:读回的值与启动时缓存不一致(宿主或别的插件写的)就交还并停手。此前是「值变了就写回去」,会把 oh-my-dsh 这类标题写者的成果顶掉(实测 2.6 秒内互相重写 10 次)。

预设与调度

预设 = 命名的词库快照(可带自己的 config),设置页一键切换,或按 schedule 规则自动切换:

"presets": [{ "id": "night", "name": "夜间", "phrases": { "zh": { "thinking": ["夜深了…"] } } }],
"activePreset": null,
"schedule": [{ "preset": "night", "days": [1,2,3,4,5], "from": "22:00", "to": "06:00" }]
  • days 为 0(周日)~ 6(周六);from / to 支持跨零点(22:00 → 06:00);
  • 命中规则时自动切到该预设,离开时段回到 activePreset;设置页「自动化」tab 有可视化编辑器并实时显示当前生效的预设;
  • 预设里没写的键沿用全局配置。

从另一个插件扩展它

自 v0.31.0 起,浏览器半边在宿主上下文上提供一套注册接口:别的插件不改本插件源码就能把自己的内容接进来。

// 另一个插件的客户端半边
export const inject = ["statusRotator"];   // 可选依赖时用 ctx.get("statusRotator")

export function apply(ctx) {
    const api = ctx.statusRotator;
    api.registerPack({ id: "my-pack", label: { zh: "我的词库", en: "My pack" },
                       phrases: { zh: { running: ["正在替我干活…"] } } });
    api.registerPlaceholder("myState", () => "3 项");
    api.registerPhraseProvider({ id: "my-provider", provide: (site) => (
        site.phase === "long" ? [{ text: "第三方条件句…", when: { phase: "long" } }] : []
    ) });
}
调用 加什么
registerPlaceholder(name, resolve, { live }?) 一个 {name} 占位符,文案与标题模板都能用
registerPhraseProvider(fn | { id, provide }) 动态文案来源,每次轮换现算
registerPack({ id, label?, phrases }) 一个具名词库包,与文档里的包同样合并
sendDanmaku(text) 让一句自己写的文案作为滚动弹幕飞过(遮罩暂停期间会排队)
  • 三个都返回注销函数 —— 你的插件卸载时调用,你的内容随之消失;
  • 同名 / 同 id 重复注册、或占用内置占位符名(elapsed、pending、phase …)一律抛错;provider 第一次调用就抛错、或返回值不是文案条目,在注册时就抛错。失败是显式的,不存在"什么都没出现"的静默结果;
  • 只在之后才坏掉的 provider 会记进 status().failures、告警一次,并在那一次抽取里被跳过,状态行照常运行;
  • provider 收到 { locale, phase },返回文案条目数组(与词库同形状:纯字符串或 { text, weight, when, rarity }),或 { thinking, running, long } 分组;空数组表示"此刻没有内容",是合法的;
  • 外部内容与随包词库走同一条管线 —— 包按文本去重、when / rarity、洗牌袋一个都不少 —— 而且不进配置文档:注册过程不写配置,设置页保存既不会把它持久化,也不会把它弄丢;
  • api.status() 报告已注册的内容与出错过的键;api.version 目前是 1,破坏性改动时递增。

ctx.provide 是 cordis 暴露服务的机制(内置 locale 服务也是这么给的)。宿主没有它时,插件其余功能照常,只是第三方注册不可用。

配置

日常编辑使用设置页。保存的设置位于 $DSH_HOME/status-rotator/config.json,外部词库为同目录的 phrases.json。词库默认每 6 小时自动更新,可关闭。

文案已从源码分离,全部放在 JSON 配置文件里。项目根有两个配置文件:

  • config.example.json — 入库的完整模板:默认配置 + 全部文案(中英双语,分三阶段);
  • config.json — 你的本地个性化配置,由 node gen-config.cjs 初始化(仅当不存在时创建,不覆盖你的改动)。已被 .gitignore 忽略,随便改不会污染 git。

自动加载 + 推送(默认):插件的 node half 注册两条路由 —— /plugins/dsh-status-rotator/config.json(配置文档)与 /plugins/dsh-status-rotator/events(SSE 通道)。页面打开时就连上这条通道,触发重读的是通道而不是定时器:只要有任何变更 —— 设置页保存、手改 config.json、词库更新 —— 服务端立刻推一条通知,已打开的页面随即重读。另外,状态行的兜底重扫不再是 2 秒常驻轮询:默认 10 秒一次(rescanIntervalMs 可调、设 0 直接关掉),到点后还要等宿主空闲才跑;新增节点接管、溢出淡出、宿主遮罩开关、sessions 服务晚就绪分别由 DOM / 尺寸观察器、定向属性观察与限次重试立刻处理(issue #166)。通道连着的时候 reloadIntervalMs 轮询是停掉的(页面长时间开着几乎零开销);通道不可用或断开时轮询自动回来。而且服务端在每次(重)连时都会先推一次当前 ETag,所以断线期间错过的变更会在重连那一刻补齐。首次安装才需要重启一次 dsh web。

从外部写配置(ETag / If-Match)

每个 GET 都带 ETag;把它作为 If-Match 带回,基于旧副本的写入就会被拒绝,而不是覆盖掉对方:

请求 结果
PUT 不带 If-Match 200 —— 无条件写。HTTP 里前提本来就是客户端自愿的,所以既有脚本照旧可用,只是拿不到并发保护
PUT 带过期的 If-Match 409 conflict,响应体里带当前 ETag —— 这次写入被拒绝,而不是覆盖掉对方
PUT 带当前 If-Match 200,并回新的 ETag
PUT 带 If-Match: * 200 —— 给脚本留的「显式无条件覆盖」
GET 带 If-None-Match 内容没变时 304(无响应体)

读 → 用拿到的 ETag 写;遇到 409 就重读再改。设置页始终带上它,所以两个设置页标签页之间不可能无声互相覆盖;冲突时它会明确告诉你这次保存被拒绝,并把编辑器拉回服务端的最新配置,而不是让你对着一份服务端从没接受的编辑继续改。

可热重载的外部词库

v0.20.0 起,node 半区还会读取一个包外、可写的词库文件——默认 $DSH_HOME/status-rotator/phrases.json,可用环境变量 DSH_STATUS_ROTATOR_BANK 覆盖(绝对路径,或相对进程工作目录)。它是与 config.example.json 同构的普通 JSON,只写要覆盖的键即可,最小的一份通常就是一个包的一个阶段:

{ "packs": [{ "id": "china-ai", "phrases": { "zh": { "thinking": ["正在飞唐杰马…"] } } }] }

node 半区每次请求都会检查这个文件:变了就重新读取解析(mtimeNs + size 走快速路径,再比内容,同一时间粒度内的改写也不会漏),服务端的变更检测会在两秒内把它变成一次推送——不用重启进程、不用重装包、也不用重发一次 npm 包,更不用等客户端轮询。规则:

  • 只取文件里的 packs / phrases,里面的 config 会被忽略——运行时选项仍然只由设置页 / config.json 管理;
  • 外部词库是优先级最高的词库层:生效文档按 内置 config.example.json → config.json → 自动更新词库 → 用户配置存储 → 外部词库 合并;词库包按 id 逐条合并,写一个包不会动到另外 11 个。想让某个包回到设置页管理,把该包从外部词库文件里删掉即可(词库内容不会被算成你的改动写进配置存储或兼容镜像,所以删掉之后随包 / 上游那份立刻回来);
  • 内置词库始终是兜底:文件不存在时行为与之前完全一致;文件损坏时保留上一次成功加载的内容继续服务,错误可从 externalBankStatus() 读到;
  • 单进程自验:node scripts/verify-phrase-hot-reload.cjs 会 apply 插件、起一个真实 HTTP server、GET 路由,然后连续两次改写词库文件再 GET,全程不重启。

词库自动更新

v0.21.0 起 node 半区每 6 小时拉一次上游 main 的 config.example.json(默认走 jsDelivr,选它是为了可达性),缓存到 $DSH_HOME/status-rotator/bank.remote.json。响应与其它词库层同样校验,只留 packs / phrases,内容真的变了才原子写盘 —— 所以合进 main 的投稿、每周的 star 包刷新都能到达正在运行的实例,不用重启、重装或重发 npm 包。

  • DSH_STATUS_ROTATOR_BANK_URL —— 上游地址(可换自己的镜像);off 或留空 = 关闭自动更新;
  • DSH_STATUS_ROTATOR_BANK_INTERVAL_MS —— 检查间隔(毫秒,0 = 关闭);不设 = 6 小时。

上游更新只作用于你没显式改过的包:设置页改过的包、或在本地词库文件里声明过的包仍以你为准。上游新增的包会合并进来,但在发版带上 enabledPacks 之前保持关闭(自动更新层刻意不带 config)。拉取失败(CDN 不可达 / HTTP 错误 / JSON 非法 / 空文档)只记进 remoteBankStatus(),继续用上一次成功的副本。默认会周期性向 jsDelivr 发请求,想完全本地化就设 BANK_URL=off 或间隔 0。

持久化存储(v0.6.1 起;v0.26.1 起真正落在插件自己的数据目录):保存的设置写入 $DSH_HOME/status-rotator/config.json(可用 DSH_STATUS_ROTATOR_CONFIG 覆盖)——与词库文件同目录,不属于任何包,升级插件不会碰它。

  • 旧方案两次静默失效:配置曾在插件目录里(升级即被替换),后来改存 dsh 官方设置存储,而 0.1.7-rc.1 的 settings 服务没有 register(),整条链路失效 → 设置又被重置(issue #51)。v0.26.1 起持久化不再依赖宿主设置 API 的形状。
  • 插件目录的 config.json 保留为兼容镜像:保存时照样写一份,README 允许的「直接改文件」也照旧 —— 手改内容会在它还在时被搬进用户配置存储(每次 GET 检查,最迟一个 reloadIntervalMs)。
  • 存储里只存与随包默认的差异,装载时按 内置默认 → config.json → 自动更新词库 → 用户配置存储 → 外部词库 合并;带 id 的数组(词库包、预设)按 id 逐条比,每次保存都从零重算差异 —— 所以把某项改回默认值就是把它从存储里去掉,老安装里整份词库也会收敛(实测 82,966 B → 1,586 B,词条零丢失)。

版本变更史见 CHANGELOG.md。升级插件代码后重启对应的 Web 或 Desktop 宿主,必要时再刷新客户端页面。

{
    "config": { "intervalMs": 10000, "typeSpeedMs": 30, "longAfterMs": 60000, "reloadIntervalMs": 15000, "liveTickMs": 1000, "rescanIntervalMs": 10000, "labelSource": "phrases", "weightedRandom": true, "debug": false, "fontWeight": "inherit", "gradient": { "enabled": true, "colors": ["#ff5f6d", "#ffc371", "#ffdd55", "#7dff7d", "#5fd4ff", "#a78bfa", "#ff8adb"], "speed": 4 }, "title": { "enabled": false, "templates": ["⏳ {phaseLabel} {elapsed}", "🤔 {phaseLabel}… {elapsed}"], "idleTemplate": "💤 dsh 空闲", "intervalMs": 8000 }, "danmaku": { "enabled": true, "pauseBehindMask": true, "intervalMs": 2500, "speedMs": 18000, "fontSizeMin": 14, "fontSizeMax": 30, "rainbow": true, "colors": ["#ff5f6d", "#ffc371", "#ffdd55", "#7dff7d", "#5fd4ff", "#a78bfa", "#ff8adb"], "color": "#ffffff", "opacity": 0.3, "maxCount": 12, "zIndex": -1, "scope": "all", "marginTop": 16, "marginBottom": 160 } },
    "phrases": { "zh": { "thinking": ["…"], "running": ["…"], "long": ["…"] }, "en": { "thinking": ["…"], "running": ["…"], "long": ["…"] } },
    "packs": [],            // 可选,见「词库包」(默认配置自带 14 个主题包)
    "enabledPacks": null,   // null/缺省 = 全部启用;随包默认配置列出 10 个启用包
    "presets": [],          // 可选,见「预设与调度」
    "activePreset": null,   // 可选预设 id
    "schedule": []          // 可选时段规则
}
键 默认 说明
intervalMs 10000 轮换间隔(毫秒)
typeSpeedMs 30 打字机每字符间隔(毫秒),0 关闭打字机
longAfterMs 60000 进入 long 阶段的阈值
reloadIntervalMs 15000 页面打开时自动重读 config.json 的间隔(毫秒),0 关闭
liveTickMs 1000 实时占位符({elapsed} / {date} / {time} / {tps} 等)在文案与标题里的刷新间隔(毫秒),0 关闭
rescanIntervalMs 10000 兜底重扫间隔(毫秒),0 关闭。常规接管 / 截断判定 / 宿主遮罩 / 服务晚就绪分别由 MutationObserver / ResizeObserver / 定向属性观察 / 限次重试处理,与这个值无关;这一拍只兜事件覆盖不到的边角(issue #166)
weightedRandom true 加权随机抽取;false = 完全均匀。文案条目可为 "text" 或 { "text": "...", "weight": 3 }(weight 为正数,上限 1000,非法/缺省按 1)
debug false 控制台诊断日志
fontWeight "inherit" 状态文字 / 弹幕的字体粗细:数字(11000,常用 100900)或 CSS 关键字(normal/bold/bolder/lighter);"inherit" = 跟随界面(默认;弹幕保持原有的 600)
labelSource "phrases" 状态行文案来源:"phrases" = 轮换短语库;"host" = 只用宿主原文(Deep diving... / 深度求索中),外观逐项对齐 0.1.6 的 .turnStatus。短语库为空时两种模式都回落宿主原文,见 状态行文案来源
gradient 见上 炫彩渐变:false / true / {enabled, mode, direction, colors, dayColors, speed}(mode:auto 跟随深浅色,day / night 强制;direction:rtl 默认 / ltr 从左向右)
whaleTail false 保留 dsh 0.2.0 运行行里的鲸鱼尾巴图标;需在「外观」页启用
whaleTailMotion {enabled:false, mode:"tps", animation:"wag", tpsTiers:3} 尾巴动作与摇速。official 为 150 帧官方原版晃动;randomActions 指定随机及工具触发可选动作。tok/s 最低 1 次/秒,2–5 档上限分别为 1 / 1.5 / 2 / 2.5;可手动自定义 1–10,或选连续 0。固定摇速仍为 0.25–6 次/秒。
title 见上 标签页标题:false / {enabled, templates, idleTemplate, intervalMs}
danmaku 见上 弹幕模式:false / {enabled, pauseBehindMask, intervalMs, speedMs, fontSizeMin, fontSizeMax, rainbow, colors, color, opacity, maxCount, zIndex, scope, marginTop, marginBottom, types, fixed};pauseBehindMask 默认 true,见「与宿主弹窗共存」
phrases 来自配置文件 文案(中英 × 三阶段;可只写部分,缺的用其它源回退)
packs 无 词库包:[{ id, label?, phrases? }],按顺序并入生效词库(按文本去重)
enabledPacks null(全部) 已启用的词库包;null/缺省 = 全部,[] = 只用核心词库。随包默认配置列出 10 个 id;community、ads、star-ask、star-route 默认关闭
presets 无 命名词库,每项可带独立的 config / phrases
activePreset null 当前启用的预设(null = 用顶层 config/phrases)
schedule 无 自动切换预设的时段规则

取值保护:数值字段在保存与加载时都会钳制(轮换间隔 ≥ 250ms、打字机 ≤ 1000ms/字、弹幕发射间隔 ≥ 200ms、同屏上限 ≤ 60、层级 ±1000 等);颜色只接受 #rrggbb / rgb() / hsl() / CSS 颜色名,非法值会被丢弃并在设置页标红。原因很实在:颜色会被拼进注入的 <style>,数值会直接喂给 setInterval。

写接口只接受同源请求:PUT/POST /plugins/dsh-status-rotator/config.json 要求 content-type: application/json 且来源与 Host 同源(sec-fetch-site 只允许 same-origin / none),跨站请求一律 403 —— 否则任意网页都能改写你的本地配置。

文案来源优先级,从高到低:

  1. localStorage 单条覆盖 dsh-status-rotator.texts[.<locale>] / texts;
  2. localStorage 完整配置 dsh-status-rotator.config(粘贴 JSON,刷新生效);
  3. 外部 JSON:dsh-status-rotator.url > EXTERNAL_URL 常量 > 本地自动加载(/plugins/dsh-status-rotator/config.json);
  4. 内置默认值:仅 lib/client.js 顶部的 DEFAULT_CONFIG(不含文案)。

如果 localStorage 覆盖命中,外部 config.json 会被静默压住;新版本会在浏览器控制台输出一条 [status-rotator] ⚠ localStorage 覆盖生效 告警,看到它就去清掉对应键。

旧的纯文案外部 JSON({ "zh": [...], "en": [...] } 或 { "thinking": [...] })依然兼容,视为"只带文案的配置"(扁平数组落到 thinking 组)。

文案跟随「设置 → 语言」在中英文之间实时切换,未知语言回退到中文。

QQ 群成员文案生成器

想要把某个 QQ 群的每个成员变成一句 正在路由(群成员)写代码... 文案时,用 scripts/fetch-qq-group.cjs 一键生成独立配置文件,不用手抄群成员名单。

前置条件:机器人在目标群内且你有 OneBot v11 兼容 HTTP API(如 NapCat / LLOneBot / go-cqhttp / OpenShamrock)。

# 默认群号是占位符 0——务必用 -g 传你自己的群号,否则默认只生成 config.qq0.json
node scripts/fetch-qq-group.cjs --group 123456789 --url http://localhost:3000 --token 你的token

# 直接替换插件实际使用的 config.json(旧的自动备份为 config.backup-<时间戳>.json)
node scripts/fetch-qq-group.cjs --group 123456789 --url http://localhost:3000 --token 你的token --activate

# 没有机器人接口?把群成员名单存成 members.txt(每行一个昵称)再生成
node scripts/fetch-qq-group.cjs --input members.txt
选项 默认 说明
-g, --group 0(占位符) QQ 群号(也读环境变量 QQ_GROUP_ID)。0 是故意的无意义默认值——务必传真实群号,如 --group 123456789
-u, --url http://localhost:3000 OneBot HTTP 地址(也读 ONEBOT_HTTP_URL)
-t, --token 空 access token(也读 ONEBOT_ACCESS_TOKEN)
-a, --action get_group_member_list 动作路径(也读 ONEBOT_ACTION),带前缀的框架改 /api/...
-i, --input 无 本地名单:txt(每行一个)/ json(数组)/ csv(第一列)
-o, --output config.qq0.json 输出文件
--activate 关 直接写回 config.json 并备份旧文件
--dry-run 关 只预览不写文件

显示名优先取群名片,没有群名片再取昵称。生成的文件只有 zh.thinking 一组:按照本插件的回退规则,thinking 阶段直接用,其余阶段自动回退到同一组。生成产物 config.qq*.json 已被 .gitignore 忽略。

项目结构

dsh-status-rotator/
├── .github/
│   ├── workflows/
│   │   ├── phrase-submit.yml   # 词库投稿机器人(issue opened → 校验 → 自动开 PR)
│   │   ├── release.yml         # 打 tag 发布 GitHub Release
│   │   ├── star-pack.yml       # 用仓库自带的 GITHUB_TOKEN 刷新 star-ask / star-route
│   │   └── test.yml            # 每次 push / PR 跑 npm test
│   └── ISSUE_TEMPLATE/
│       └── phrase-submit.yml   # 「词库投稿」表单模板(自动打 词库投稿 标签)
├── lib/
│   ├── index.js            # node half:注册 config.json 的 HTTP 路由(GET/PUT,带校验)
│   └── client.js           # client half:状态文字替换 / 占位符 / 渐变 / 标题 / 弹幕 / 预设
├── config.example.json     # 完整模板(默认配置 + 中英文主题词库,入库)
├── config.json             # 本地个性化配置(被 .gitignore 忽略)
├── gen-config.cjs          # 初始化 config.json 的脚本
├── cordis.patch.yml        # dsh bundle patch manifest(被 package.json 的 dsh.bundle.patch 引用)
├── scripts/
│   ├── fetch-qq-group.cjs  # 抓取 QQ 群成员并生成文案配置
│   ├── check-bank-memes.mjs # 词库质检(开发期):查重/超长/省略号/系列占比
│   ├── package-release.cjs # 打包发布文件
│   ├── phrase-bot.cjs      # 词库投稿机器人(解析表单 / 校验 / 写入词库 / 开 PR)
│   ├── smoke-test.cjs      # 纯函数冒烟测试(npm test)
│   ├── sync-bank-counts.cjs # 词库计数同步:从 config.example.json 现算并写回 README/描述/注释
│   ├── update-star-pack.cjs # 从星标名单重建 star-ask / star-route
│   ├── verify-phrase-hot-reload.cjs # 外部词库热重载验证:改完文件不重启即可生效(dev-only)
│   ├── verify-bank-auto-update.cjs # 词库自动更新验证:本地上游 A→B→500,全程不重启(dev-only)
│   ├── verify-settings-survive-upgrade.cjs # 设置跨升级存活验证:手改 config.json / 设置页保存 → 升级 → 设置仍在(#51,dev-only,CI 也跑)
│   ├── danmaku-mount-test.html # 弹幕挂载点的真浏览器回归页(dev-only)
│   ├── label-layout-test.html  # 状态行布局回归页:锁宽/截断/配色回退/设置页渲染(dev-only)
│   ├── live-pending-test.html  # {pending} 实时刷新回归页:待作答交互 → 标签(dev-only)
│   ├── title-coexistence-test.html # 标签页标题所有权回归页:与 oh-my-dsh 品牌替换共存(v0.27.0,dev-only)
│   ├── issue-141-coexist-test.html # 状态行与 dsh-claude-style 等待行 CSS 共存回归页(#141,dev-only)
│   ├── run-issue-141-coexist-test.cjs # 无头驱动 #141 共存回归页(dev-only,CI 也跑)
│   ├── run-danmaku-mount-test.cjs # 无头驱动上述回归页(--page=danmaku|label|pending|title,dev-only)
│   ├── turn-process-017-test.html # 0.1.7+ 状态行回归页:折叠头接管/简回合/宿主原文回落/0.1.6 观感比对(dev-only)
│   ├── run-turn-process-test.cjs # 无头驱动 0.1.7+ 状态行回归页(dev-only)
│   ├── probe-danmaku-live.cjs # 探针:检查正在运行的 dsh web 弹幕挂载点/绘制顺序(dev-only)
│   └── unify-ellipsis.cjs  # 默认词库省略号统一 / 完整性校验
├── package.json
├── README.md               # 英文文档
├── README_ZH.md            # 中文文档
├── CHANGELOG.md            # 更新日志
├── CONTRIBUTORS.md         # 英文贡献者
├── CONTRIBUTORS_ZH.md      # 中文贡献者
└── LICENSE

仅本地存在、不入库的产物:demo-wallpapers/、.dsh-web-restart/、dist-release/、config.qq*.json、config.backup-*.json——都列在 .gitignore 里。

通过 Issue 投稿词库

从 0.37.0 起可以不出设置页:DSH 设置 → 状态文案 → 「投稿」 页签 —— 填语种 / 分组 / 目标词库包 / 文案 / 署名,本地先按机器人的同一套规则校验(分号、链接、HTML、长度、条数、查重当场报错并说明原因),点「打开投稿页」直接开好一个已预填正文的 Issue,机器人照常接手。批量或想先看看效果时,也可以在下面用 GitHub 表单。

也可以投广告:投稿表单的「目标词库包」里选 ads(广告) —— 一行一条,写成「功能进行时短句 + 出处」,例如 正在优化提示词 github.com/WestFox-AwA/dsh-prompt-optimizer…;机器人照常校验并开 PR。广告包默认不启用,用户可在设置页自行勾选。

在仓库 Issues 选 「词库投稿」 表单:语种(zh / en / 两种都要)、分组(thinking / running / long)、目标词库包(默认 community)、文案(一行一条,最多 60 条,单条 ≤200 字符)、可选署名。

会被拒绝的写法:行内出现分号 ; ; ﹔ ;(分号串起来的整行只会读成一条连不通的长句;中文冒号 :、逗号 ,、顿号 、 不受影响)、HTML / 链接 / 控制字符、与现有词库重复、未勾选提交须知。被拒会收到 ❌ 原因说明,改完重新提交即可。

机器人接手后:校验并归一化(... → …、末尾补 …)→ 在 Issue 里回复预览表格与**「立即试用」JSON**(粘到设置页即可看到效果)→ 开一个改 config.example.json 的 PR(带 词库投稿 标签),维护者点 Merge 即收录,随下一次 npm 发版分发。

  • 分支自动跟随 main:main 前进(以及每 6 小时、手动触发)时,机器人把每条开着的投稿分支按当前 main 重建,PR 永远可合并 —— 不需要人工解 config.example.json 的冲突(手工解容易出重复键,JSON.parse 会静默丢掉前一个,条目无声少一半);
  • 规则变了会复核:不再合规的投稿会在 PR 与 Issue 上写明原因并自动关闭 PR;机器人读库 / 写盘回读都查重复键,npm test 也断言 config.example.json 无重复键;
  • 只追加进目标词库包,不改代码、不碰默认词库本体;被收录的投稿记入 CONTRIBUTORS.md。实现见 .github/workflows/phrase-submit.yml 与 scripts/phrase-bot.cjs。

测试

npm test(node scripts/smoke-test.cjs)在 Node 沙箱里加载 lib/client.js 跑纯逻辑断言:占位符插值、时长格式化、时钟解析、配置 / 预设 / 调度归一化、调度匹配、node half 的配置校验、词库计数与文档一致;CI 每次 push / PR 都跑(.github/workflows/test.yml)。

node scripts/verify-settings-page.cjs 用同一个沙箱把设置页当独立单元验证:它由模块级的 createSettingsPage(deps) 工厂加八个显式依赖实例化出来,渲染四个 Tab,通过注入的 locale / effect 注册字典,并在 dispose() 时摘掉自有样式表;一旦工厂又伸手回 apply 作用域取东西,这份验证就会失败 —— 那次抽取不会悄悄退回成闭包捕获。

node scripts/verify-phrase-selection.cjs 钉住选句引擎:洗牌袋(袋内不重复、跨袋接缝不重复、按语言 + 相位分键、快照往返)、when 条件与 rarity 掷骰、设置页行语法的精确往返,以及 node 半边的校验与比较键。这些正是眼睛看不出来的故障:少抽一句、条件句在错的时候冒出来,或者保存一次就把条件洗掉。

依赖真实 DOM 的部分(弹幕挂载、状态行锁宽 / 截断 / 配色回退、{pending} 实时刷新、标签页标题所有权)另有专门的真浏览器回归页,由 npm run test:browser 用 CDP 无头跑完(需要本机 Edge / Chrome):

页面 覆盖
danmaku-mount-test.html 挂载时序、顶 / 底弹幕、宿主全屏模糊遮罩下的暂停与恢复
label-layout-test.html 打字机锁宽、超长截断、配色非法回退、设置页渲染
live-pending-test.html 真插件跑 pending 0 → 1 → 0 → 1,以及无 uiSession 服务时的兜底
title-coexistence-test.html 标签页标题所有权:与 oh-my-dsh 的品牌替换共存
issue-141-coexist-test.html 状态行与 dsh-claude-style 等待行的 CSS 共存:0.13.2 旧规则下状态行确实 display:none、补白名单口后可见、0.13.3 修法下可见且宿主文案仍被隐藏,以及行根公开标记 data-dsh-status-rotator-line / .dsh-status-rotator-line
external-api-test.html 一个真的第三方插件通过 ctx.statusRotator 接入:包 / 占位符 / provider 真的渲染出来、非法注册抛错、之后才坏的 provider 被记账,且全程不写配置文档
appearance-danmaku-test.html 外观主题真的落到 CSS(字体 / 字号 / 发光 / 动画类 / ::before 指示器)、弹幕层只在显式打开时才接指针、悬停冻结真的停住、点击复制真的进剪贴板、相位分色生效、sendDanmaku 真的飞过

浏览器页之外,node scripts/verify-push-and-conflict.cjs 用真 HTTP + 真 SSE 长连接驱动 node 半边:ETag / 304 / 409 / *(以及不带 If-Match 时的无条件写)、两个标签页的时间线(A 先写、B 用旧配置写被拒、A 的内容没被覆盖)、保存后推送、手改词库文件后推送,以及重连场景(重连的 hello 带的是当前 ETag)。

单跑用 npm run test:browser:label / :pending / :title / :external / :appearance;0.1.7+ 状态行另有 node scripts/run-turn-process-test.cjs(覆盖:折叠头接管、回合结束交还、座位缺失降级、观测徽标、labelSource: "host" 与 0.1.6 逐项比对)。手动打开页面时用 URL 参数切场景(?modes=1、?mask=1、?case=…、--page=danmaku|label|pending|title|external)。

卸载

从 cordis.patch.yml 删掉 status-rotator 那一行,重启 dsh web 即可。

贡献

欢迎提交 Issue 和 Pull Request —— 动手前请看贡献指南;参与即表示同意行为准则,安全问题请走 SECURITY.md 的私密通道,不要开公开 issue。加新文案最简单的方式:直接编辑 config.json 或 config.example.json 的 phrases 字段,不需要动任何代码;或者用上面的 通过 Issue 投稿词库,机器人会自动帮你校验并开好合并请求。

致谢

本项目的诞生离不开贡献者的帮助,详见 CONTRIBUTORS_ZH.md。

License

MIT

Star 趋势

Star History Chart

图由 star-history.com 生成,随 star 增长自动更新。