dsh-deep-sleep

DSH 插件：把官方 Web UI 中任务进行中的状态提示换成 "Deep Sleeping... (1分20秒)"。

• 纯 client 插件：host 半部为空壳（no-op），全部逻辑在浏览器侧 lib/client.js
• 零运行时依赖：client 半部不 import 任何模块；host 半部仅 type-only 引用 cordis（构建期擦除）
• 幂等替换：MutationObserver 拦截插入/改写，React 每次重建标签都会被再次替换
• 零源码 patch：不碰 DSH checkout 任何文件，纯官方扩展缝（bundle insert 行 + dsh.client 声明）

官方原版长什么样

@deepseek-ai/dsh-client-ui-chat 的 RunningStatus 从 locale 字典取标签，并带上实时用时：

| 状态 | 官方文案（en / zh） | |---|---| | startTime 未知 | Deep diving / 深度求索中 | | 已知 | Deep diving for 12s ··· / 深度求索中，用时 12秒 ··· |

秒表由官方以 LIVE_RUN_CLOCK_INTERVAL_MS（1s）驱动，每秒重建一次字符串。该标签既没有 slot，也没有对插件开放的 formatter，因此本插件在 DOM 层改写。

原理

两个细节决定了实现方式：

1. 用时从官方字符串里现读，不自建计时器。 官方每秒重写一次标签文本，所以观察器每次都用「官方此刻写的那个字符串」重新解析用时。解析是无状态的：中途加入的轮次、或在任务进行中刷新的页面，都会立刻显示真实用时，也不会累积漂移。

单位同时覆盖 1h 2m 3s 与 1小时2分3秒，输出统一为中文单位，排列规则与官方一致——不补前导零、满 60 秒才出分钟、满 3600 秒才出小时：

12s        → Deep Sleeping... (12秒)
1m 20s     → Deep Sleeping... (1分20秒)
1h 2m 3s   → Deep Sleeping... (1小时2分3秒)
无用时      → Deep Sleeping...

2. 必须同步 data-shimmer-text。 TextShimmer 会把同一个字符串再画一份：装饰副本的节点里没有文本，字形来自 CSS content: attr(data-shimmer-text)，靠一条移动的 mask 扫过高亮。只改文本节点的话，扫光会继续在真实标签上扫过旧字符串的字形，出现重影错位。因此每轮都会把该属性从真实文本重新同步一次。

无障碍那一份（role="status" + aria-live）保持不含用时：官方本来就让它稳定不跳动，以免每秒播报。

安装

# 从 npm 安装（首选）
dsh plugin --profile web add dsh-deep-sleep

# 或从 git 直装（预构建策略，无需 allowBuilds 授权）
dsh plugin --profile web add github:peach0x33a/dsh-deep-sleep

# 或本地目录（开发/验证）
dsh plugin --profile web add /path/to/dsh-deep-sleep

安装后重启 dsh web，浏览器硬刷新（Ctrl+Shift+R），任务进行中即可看到 "Deep Sleeping..."。

开发

pnpm install        # 仅 devDependencies（全部公共包，无 private peer）
pnpm run typecheck  # tsc --noEmit
pnpm test           # vitest（jsdom）：解析/格式化 + DOM 改写 + 构建产物契约
pnpm run build      # tsdown 双 bundle：lib/index.mjs（host ESM）+ lib/client.js（browser CJS）

预构建策略：lib/ 入库（不进 .gitignore），无 prepare 脚本；改源码后必须 pnpm run build 并提交 lib/。

检查

• [ ] package.json 含 dsh.bundle.patch + dsh.client（platform: "web"，immediately: true）
• [ ] exports["./client"] 指向构建产物 lib/client.js
• [ ] lib/client.js 以 window.__ModuleLoader__.load({ id: "dsh-deep-sleep", factory }) 包裹，factory 返回 { name, inject, apply }（test/bundle-contract.test.js 断言）
• [ ] cordis.patch.yml 含 insert 行（id / name 齐全）
• [ ] host 半部不导出 default（A6）
• [ ] peerDependencies = cordis（optional），无 devDependencies 冒充
• [ ] pnpm test 全绿

测试里的 fixture 按官方 RunningStatus + TextShimmer 的真实产物搭建：真实标签一个文本节点，装饰副本只有 data-shimmer-text、没有文本节点。改动选择器时请一并更新 fixture。