01Virex/dsh-status-rotator

English | 中文

把 DeepSeek Harness(dsh)Web 界面底部回合运行时那行 Deep diving... 状态文字,替换成自定义文案:按回合阶段切换、打字机逐字输出、流动炫彩渐变(可关)、定时轮换。运行时长时钟(15 秒后出现)不受影响。

安装

两种方式:推荐用 dsh plugin add 命令,或手动复制。无论哪种方式,首次安装后都需要重启一次 dsh web。

方式 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 web add ./dsh-status-rotator
• Release 打包产物:从 Release 页下载打包好的 tgz,再执行 dsh plugin --profile web add /path/to/dsh-status-rotator-<版本>.tgz。

方式 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 硬刷新。

特性

• 阶段感知:thinking(刚启动)/ running(15s 后)/ long(超过阈值)三组文案,时钟出现或超时立即切换,不用等轮换间隔;
• 打字机效果:文案逐字"打"出,速度可调,设 0 即关闭;
• 炫彩渐变:文字以流动渐变显示,颜色序列与流速可配,可一键关闭;
• 文案与代码分离:文案全在 config.json 里,改文案零代码、免重启;
• 设置页编辑:在 DSH「设置」里新增「状态文案」页,中英 × 三阶段词库可视化编辑,保存即生效;
• 自动加载:node half 注册 HTTP 路由 serve config.json,开箱即用,无需 localStorage 或部署;
• 热更新:页面保持打开也会定时重读 config.json,切回标签页立即重读,改文案不用刷新;
• 多语言:中英文文案跟随「设置 → 语言」实时切换,未知语言回退中文;
• 零侵入定位:按 role="status" + aria-live="polite" 精确定位 TurnStatus,不误伤聊天记录代码片段与其它 aria-live 区域,不碰时钟。

阶段感知

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

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

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

炫彩渐变

状态文字默认以流动的七彩渐变显示(仅作用于文案,不影响时钟)。可在配置里关闭或自定义配色:

"gradient": {
    "enabled": false,                          // false 关闭;true 用默认配色
    "colors": ["#ff5f6d", "#00ff88", "#4da6ff"], // 渐变颜色序列(至少 2 个,循环首尾)
    "speed": 4                                 // 流动速度(秒/圈)
}

配置

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

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

自动加载(默认):插件的 node half 注册了一个 HTTP route(/plugins/dsh-status-rotator/config.json)来 serve 插件同目录的 config.json(每次请求实时读文件)。浏览器端默认自动 fetch 它,并且页面保持打开时每 reloadIntervalMs 自动重读、切回标签页立即重读,所以只要 config.json 放在插件目录里,改完文案不用刷新页面、不用重启就会生效。首次安装才需要重启一次 dsh web。

{
    "config": { "intervalMs": 10000, "typeSpeedMs": 30, "longAfterMs": 60000, "reloadIntervalMs": 15000, "debug": false, "gradient": { "enabled": true, "colors": ["#ff5f6d", "#ffc371", "#ffdd55", "#7dff7d", "#5fd4ff", "#a78bfa", "#ff8adb"], "speed": 4 } },
    "phrases": { "zh": { "thinking": ["…"], "running": ["…"], "long": ["…"] }, "en": { "thinking": ["…"], "running": ["…"], "long": ["…"] } }
}

键	默认	说明
intervalMs	10000	轮换间隔(毫秒)
typeSpeedMs	30	打字机每字符间隔(毫秒),0 关闭打字机
longAfterMs	60000	进入 long 阶段的阈值
reloadIntervalMs	15000	页面打开时自动重读 config.json 的间隔(毫秒),0 关闭
debug	false	控制台诊断日志
gradient	见上	炫彩渐变:false / true / {enabled, colors, speed}
phrases	来自配置文件	文案(中英 × 三阶段;可只写部分,缺的用其它源回退)

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

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": [...] })依然兼容,视为"只带文案的配置"。

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

设置页编辑词库

打开 DSH 左下角「设置」,导航里会多出一页 状态文案:

• 中文 / English 两个标签页,各含 thinking / running / long 三个文本框,每行一句,空行自动忽略;
• 每个阶段实时显示句数;
• 基本设置(轮换间隔、打字机速度、长任务阈值、自动重读间隔)也在同一页;
• 点「保存词库」后,浏览器把整份 JSON PUT 到 /plugins/dsh-status-rotator/config.json,node half 校验后原子写回,已打开的页面无需刷新、立即热应用;
• 提交内容会做结构校验(phrases 必须是字符串数组等),非法内容返回 400 并在页面显示错误,不会写坏配置文件。

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

QQ 群成员文案生成器

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

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

# 默认群号就是 684306814,直接生成 config.qq684306814.json
node scripts/fetch-qq-group.cjs --url http://127.0.0.1:3000 --token 你的token

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

# 没有机器人接口?把群成员名单存成 members.txt(每行一个昵称)再生成
node scripts/fetch-qq-group.cjs --input members.txt

选项	默认	说明
-g, --group	684306814	QQ 群号(也读环境变量 QQ_GROUP_ID)
-u, --url	http://127.0.0.1:3000	OneBot HTTP 地址(也读 ONEBOT_HTTP_URL)
-t, --token	空	access token(也读 ONEBOT_ACCESS_TOKEN)
-a, --action	get_group_member_list	动作路径,带前缀的框架改 /api/...
-i, --input	无	本地名单:txt(每行一个)/ json(数组)/ csv(第一列)
-o, --output	config.qq684306814.json	输出文件
--activate	关	直接写回 config.json 并备份旧文件
--dry-run	关	只预览不写文件

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

项目结构

dsh-status-rotator/
├── lib/
│   ├── index.js            # node half:注册 config.json 的 HTTP 路由
│   └── client.js           # client half:状态文字替换 / 渐变 / 打字机
├── config.example.json     # 完整模板(默认配置 + 全部文案,入库)
├── config.qq684306814.example.json  # QQ 群成员文案模板(scripts/fetch-qq-group.cjs 生成正式文件)
├── config.json             # 本地个性化配置(被 .gitignore 忽略)
├── gen-config.cjs          # 初始化 config.json 的脚本
├── scripts/
│   └── fetch-qq-group.cjs  # 抓取 QQ 群成员并生成文案配置
├── package.json
├── README.md               # 英文文档
├── README_ZH.md            # 中文文档
├── CONTRIBUTORS.md         # 英文贡献者
├── CONTRIBUTORS_ZH.md      # 中文贡献者
└── LICENSE

卸载

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

贡献

欢迎提交 Issue 和 Pull Request。加新文案最简单的方式:直接编辑 config.json 或 config.example.json 的 phrases 字段,不需要动任何代码。

致谢

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

License

MIT