dsh-tps DSH Web 实时 TPS 徽标：在 "Deep diving…" 状态行内显示实时 tokens-per-second，跟随运行行自然显隐。 English: README.en.md ## 特性 - 实时瞬时 TPS：滚动 5 秒窗口采样流式输出（UTF-8 字节 / 5 估算），流暂停 1.5 秒自动显示 --，新步骤自动重置窗口；徽标在首个数值到达时才出现（一次性淡入），新一轮不会显示光秃秃的 TPS --，中途暂停的 -- 保留 - 跟随显隐，零适配：徽标渲染在 "Deep diving… 7分25秒" 行内，turn 结束、提问/审批面板接管时随行一起消失——无需为待办条、队列条或提问面板编写任何隐藏逻辑 - 不重复原生功能：窗口级平均值（AVG/TTFT/token 总数）是内置 StatsLine 的职责，本插件刻意只做瞬时速率 - 悬停淡出：停留 2 秒淡出并变为可穿透（pointer-events: none）；隐藏期间光标在徽标上或其附近（外扩 8px）则保持隐藏，移开后经 3 秒宽限期才恢复（期间回到附近则取消恢复），光标停驻不会循环触发 - 纯前端：所有读数派生自会话快照，无 store、无事件监听、无网络调用 ## 安装教程 ### 第 0 步：前置条件 1. harness checkout 包含 conversation.chat.turnStatus 槽位。检查方式： sh grep -n "conversation.chat.turnStatus" <harness>/packages/client/ui-conversation/src/client/apply.ts grep 有输出：槽位已存在（例如已应用过本补丁、或 checkout 来自作者修改过的版本），可直接进入安装。 grep 无输出是默认状态：该槽位是作者对 ui-conversation 的手动补丁改动（4 个文件：slots.ts / apply.ts / ChatView.tsx / ChatView.module.css），从未合入任何共享/原始快照——所有内测人员的原始快照都不含它。请应用本仓库附带的补丁（git checkout 可还原）： sh cd <harness> git apply <dsh-tps>/patches/turnstatus-slot.patch 说明：槽位改动只存在于作者修改过的 checkout 中（个人快照仓库 dsh2026/test-Small-tailqwq 的推送也不会自动进入其他成员的快照，每日快照是独立更新流程）。因此目前所有内测人员的原始快照都需按本步骤打补丁（或使用下方 AI 安装技能自动完成）；待槽位合入共享的快照更新流程后，方可免去此步骤。 2. 私有仓库访问：本仓库为 dsh-external 内测私有仓库，需要已登录的 gh（或 PAT）： sh gh auth status git clone https://github.com/dsh-external/dsh-tps.git ### 方式一：AI 自动安装（零手动改码，推荐） 本仓库附 SKILL.md（dsh-tps-install）。clone 后告诉你的 AI「按 dsh-tps 仓库的 SKILL.md 安装 dsh-tps」，AI 会自动完成：检测槽位 → 缺失时应用补丁 → 验证 → 重建 ui-conversation bundle → 挂载插件 → 验收。也可把 SKILL.md 放进本地 skills 目录供 AI 直接发现。 ### 方式二：dsh plugin 命令安装（推荐手动方式） sh cd <harness> dsh plugin --profile web add <dsh-tps 本地路径> # 或通过 GitHub 依赖 dsh plugin --profile web add github:dsh-external/dsh-tps 本包声明了 dsh.bundle（patch 指向仓库内 cordis.yml），dsh plugin 会自动把它追加进 profile 的 dsh.profile.bundles（见下文「dsh 端点」），无需手写任何 insert。从 git 安装时若 pnpm 拦截构建，按提示把包加入 profile 的 pnpm-workspace.yaml allowBuilds 后重试。 ### 方式三：手动安装（无 dsh plugin 命令时） 步骤 1：添加依赖。编辑 ~/.dsh/profiles/web/package.json 的 dependencies： json "dependencies": { "@dsh-external/dsh-tps": "github:dsh-external/dsh-tps" } （本地路径可用 "@dsh-external/dsh-tps": "file:../dsh-tps"，然后 cd ~/.dsh/profiles/web && pnpm install。） 步骤 2：添加 dsh 端点（见下节）。步骤 3：验证 dsh --profile web --dump-config | grep -A1 tps。 > 备选挂载：也可直接在 profile 的 cordis.patch.yml 追加 insert 行，或用 dsh web --patch ./cordis.yml 作为启动 overlay（本仓库已附 cordis.yml）——这两种方式同样要求依赖图包含本包。 ### dsh 端点（dsh.profile.bundles）创建教程 什么是 dsh 端点：profile 的 dsh.profile.bundles 数组是 profile 的组合端点列表——启动时按数组顺序叠加每个 bundle 的 patch 层（dsh.bundle.patch 指向的 cordis.patch.yml/cordis.yml），插件的插件行只有在该数组里才会进入组合配置。可以理解为"profile 挂载了哪些 bundle 层"的清单。 创建步骤（继续方式三）：编辑 ~/.dsh/profiles/web/package.json： json { "dsh": { "profile": { "bundles": [ "@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "@dsh-external/dsh-tps" ] } } } 然后 cd ~/.dsh/profiles/web && pnpm install，并验证： sh dsh --profile web --dump-config | grep -A1 tps # → - id: tps # name: '@dsh-external/dsh-tps' 为何需要手动添加端点： - dsh plugin --profile web add 会在安装后自动 reconcile：检测到包声明了 dsh.bundle，就把包名追加进 dsh.profile.bundles。 - 但直接编辑 package.json 或 pnpm add 安装依赖时，dsh.profile.bundles 数组不会自动更新——patch 层只从该数组加载。 - 不添加端点的后果：包被安装了，但它的 patch 层不进入组合 → 组合配置里没有 tps 行 → 插件静默不加载（无报错）。手动添加端点 = 把 dsh plugin add 的 reconcile 那一步自己做掉。 ### 布局与依赖（开发本仓库时） 与 harness checkout 平级（sibling）是约定布局——tsconfig.json extends ../deepseek-harness/tsconfig.base.json，类型解析（tsc -b、vitest 经 vite-tsconfig-paths）都经由它的 paths 直接指向 harness 源码，无需复制任何构建产物： deepseek-harness/ ← harness 源码 checkout（含 turnStatus 槽位） dsh-tps/ ← 本仓库 类型检查、构建与测试都需要该 sibling checkout；消费者安装不需要——prepare 脚本用 tsdown --config tsdown.prepare.config.ts 做无类型检查的 src→lib 转译（tsconfig.prepare.json 自包含），没有 sibling 的机器也能安装构建（pnpm ≥ 10 需 pnpm-workspace.yaml 的 allowBuilds 键）。 ### 构建与生效 sh cd dsh-tps pnpm run typecheck # tsc -b（需 sibling harness） pnpm test # vitest（27 例：形态门禁 + 指标 + 组件/生命周期） pnpm run build # tsc -b + tsdown：产出 lib/index.js 与 lib/client.js pnpm run prepare # 消费者构建：仅 tsdown，无类型检查（src → lib） - 开发模式（dsh web --dev + pnpm run dev:web watcher）：构建后客户端插件自动热更新。 - 生产模式：构建后重启 dsh web（client bundle 的 rev 在启动时计算，仅刷新浏览器可能命中旧缓存）。 ### 验证 任务执行时（turn 运行中）应看到： Deep diving… 7分25秒 | TPS 12.3 turn 结束或提问时整行消失。 ## 使用说明 - 徽标字号 14px/500（--dsw-font-s-strong-14），与 13px 时钟并排时视觉高度接近（拉丁字符 ≈0.7em，中文方块字 ≈1em） - 悬停 2 秒 → 淡出 → 鼠标穿透；光标在徽标上或其附近（外扩 8px）期间保持隐藏，移开后 3 秒恢复（期间回到附近则取消）；重新移回并停留会再次淡出 - 时长均为编译期常量（src/client/TpsOverlay.tsx），暂无客户端配置通道 ## 与官方包的关系 本仓库是独立分发版；上游源码镜像自 DeepSeek Harness monorepo 的 packages/client/ui-tps（官方包名 @deepseek-ai/dsh-client-ui-tps），包装差异仅为独立仓库构建与 @dsh-external/tps 命名。 ## Known Limitations and Deferred Work - 实时 token 为估算值：流式 partial 不携带实时 token 计数，速率按 UTF-8 字节估算（bytes/5）；精确计数由持久化 token-usage 投影与内置 StatsLine 提供 - 悬停时长固定：停留/淡出时长与隐藏判定范围是编译期常量，暂无客户端插件配置通道可调 - 依赖内测槽位：需要含 conversation.chat.turnStatus 槽位的 harness（见第 0 步） ## 许可 BSD-3-Clause