Ycet/dsh-fun-turn-status

dsh-fun-turn-status

把 DeepSeek Harness 任务运行中的 “Deep diving...” 状态文案，替换为会随机轮换的幽默文案 —— 每 30 秒换一条，再也不无聊。

中文
EN
License: MIT

✨ 功能

| 功能 | 说明 |
| --- | --- |
| 🎭 替换状态文案 | 任务运行中的 “Deep diving...” 替换为随机幽默文案（内置 30 条） |
| 🔄 30 秒轮换 | 每 30 秒随机切换到另一条，不与当前重复 |
| ⚙️ 可视化配置 | 「设置 → 插件 → 插件配置」页面增删改文案，最多 50 条；官方折叠卡片（默认收起，点击表头展开；暂存编辑/已覆盖徽章/恢复默认/未保存徽标/保存·放弃） |
| ♻️ 即存即生效 | 保存后立即影响正在运行的任务，无需重启 |

🚀 快速开始

方式一：从 GitHub 远程安装（推荐）

要求本机 git 能用 git+ssh（或 https）访问 GitHub。一条命令即可安装并自动挂载：

dsh plugin --profile web add github:Ycet/dsh-fun-turn-status

方式二：本地开发安装（源码目录）

适合二次开发：改动客户端代码后刷新页面 / HMR 即可生效；bundle/Loader 层改动需重启 dsh web。

1. 安装（link 指向本地源码绝对路径）
dsh plugin --profile web add dsh-fun-turn-status@link:

2. 重启 web 使 bundle/Loader 层生效
在运行 dsh web 的终端 Ctrl+C，然后重新运行 dsh web

3. 运行单元测试
cd  && pnpm install && npm test

刷新页面后，任意发起一个任务：状态栏文案立即变为幽默文案，且每 30 秒随机切换。

⚙️ 配置说明

配置入口：设置 → 插件 → 插件配置（与“终端 / Agent 循环 / 网页搜索”卡片并列）。

- 每条文案可编辑、可删除；底部输入框 + 「添加」新增文案；
- 右上角显示 N/50 计数，达到 50 条时自动锁定添加；
- 「保存」一次性写入（~/.dsh/settings.yaml 的 fun-turn-status: 段）；「放弃」丢弃未保存修改；「恢复默认」清除用户覆盖、回落内置 30 条；
- 保存校验：每条 1–50 字符、总数 ≤ 50、不得包含字面量 Deep diving（见下方优先级说明）；
- 列表为空时保留原始 “Deep diving...” 展示（不接管）。

🧩 工作原理（开发者视角）

| 层 | 文件 | 职责 |
| --- | --- | --- |
| Host | lib/index.js | 注册 fun-turn-status settings 命名空间（schema + 默认 30 条文案 + draftErrors 可测规范） |
| Client | lib/client.js | ModuleLoader bundle：DOM 文本接管器 + 「插件配置」卡片（DSH 官方契约，zh/en 双语） |
| 补丁 | cordis.patch.yml | insert fun-turn-status 插件行 |

- “Deep diving...” 硬编码于 @deepseek-ai/dsh-client-ui-conversation 的 TurnStatus 组件（非 locale key、无槽位），因此采用 DOM 文本接管：以 [role="status"][aria-live="polite"] + turnStatus 类名（可读段）为识别特征，只改写首个子文本节点，保留计时器与渐变流光样式。
- 文案池来自 settings 服务的解析值：用户未配置时回落内置 30 条；显式存空数组时表示“不接管”。
- 配置卡片按 DSH 官方契约实现：settings.plugin.item 键控槽位 + settingsScope.bind；控制器暴露 hooks 快照与 edit/resetField/save/discard 动作，暂存编辑 + base/user 覆盖层（「已覆盖」徽章）、恢复默认=暂存清除→保存时 unset、只读/失败态；客户端用与宿主一致的镜像规则做前端拦截（条数/长度/空串/含 Deep diving 字样），宿主 schema 是唯一权威——settings 服务对每次写入都做 schema 校验，错误提示中英双语映射。注意：浏览器模块表只解析 shell seed（react 等）与 dsh.client 图行包，宿主侧包（如 @deepseek-ai/dsh-client-schema-form）不能被第三方 bundle require。卡片内所有图标（折叠箭头、删除垃圾桶）均内联 DSH 原生 path（IconChevronDownOutline14 / IconTrashOutline16），无任何运行时模块依赖——任何安装环境展示完全一致。

🧪 测试

npm test

覆盖：默认文案 30 条去重/长度/禁用字样、校验规则（空/超长/禁用/超限/非法条目）、轮选取条（空池/单条/两条/避开当前条）、schema 默认与上限、客户端镜像与宿主半逐字一致。

📄 许可证

MIT © dsh-fun-turn-status contributors