dsh-plugin-thinking-size 0.1.0

package/README.i18n.yaml

@@ -0,0 +1,7 @@
+# Bilingual-pair consistency record: the git blob hash of each side as of the last
+# confirmed-consistent state (convention from the dsh core repo, docs/i18n/README.md).
+# Both languages carry equal authority; after editing either side, bring the other
+# along and re-record with:
+#   git hash-object README.md README.zh.md
+README.md: a60a5d2e42f935f4f2912e8db12512d6cdda576c
+README.zh.md: e9c0ce1bc84cc03fbb25c96e318522a4dcce066a

package/README.md

@@ -0,0 +1,53 @@
+# dsh-plugin-thinking-size
+
+A live reasoning-token badge for DSH web. It appends a compact `Think(128)` / `Think(5.2K)` marker to the title of every "Think" disclosure row in the conversation — ticking in real time while the model is still thinking, and staying put on history messages afterwards.
+
+English | [中文](README.zh.md)
+
+![platform](https://img.shields.io/badge/platform-web-blue)
+![dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)
+
+## The badge
+
+| Format | Rule |
+| --- | --- |
+| `Think(128)` | Below 1000 tokens: plain integer |
+| `Think(5.2K)` | 1000 – 999 499: one decimal + K, trailing zeros dropped |
+| `Think(1.2M)` | A million or more: one decimal + M |
+
+- **Live** — the number ticks up while the reasoning is streaming.
+- **Persistent** — every historical Think row keeps its badge too, across expand/collapse and session switches.
+- **Subtle** — a 12px caption-colored span in tabular figures, appended inside the row title and marked `aria-hidden`, so the accessible title still reads just "Think".
+
+## 雷霆大思考, measured
+
+Some LLMs are famous for their 雷霆大思考 — thunder-length thinking that opens with several thousand tokens of pure reasoning. With this plugin you can watch the badge sprint in real time and see, at a glance, just how long each burst of thinking really is. No more wondering what the model was doing up there: the length is right on the row.
+
+## How it works
+
+- **Data** comes from the current session snapshot (`sessions` service → `chat.nodes`): the full text of every `reasoning` block of each `assistant-step` node. The collapsed DOM never carries the full reasoning text, so counting must read the snapshot, not the page.
+- **Estimation** follows DeepSeek's official approximation — 1 English character ≈ 0.3 tokens, 1 CJK character ≈ 0.6 tokens, the sum rounded up. Counts are cached per reasoning-block object (its reference is immutable), so a streaming chunk only re-counts the one block that changed.
+- **Writing** appends the badge span into each row's title span. Think rows (`data-variant="think"`) are matched to reasoning blocks by conversation anchor key plus in-anchor index. Snapshot subscription and a `MutationObserver` only set a dirty flag; a 100ms throttled sweep does the work — and if a React re-render wipes a badge, the observer flags it and the sweep puts it back.
+- **Silent by design** — no host code is touched. If the `sessions` service is missing, the DOM contract changes, or a snapshot looks malformed, the plugin idles or skips rows quietly; it can never break the host.
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-plugin-thinking-size
+```
+
+Restart `dsh web` to take effect.
+
+### From source (local development)
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+```
+
+Then add this package to `~/.dsh/profiles/web/package.json` as a `link:` dependency, register it in `dsh.profile.bundles`, and restart `dsh web`.
+
+## Keywords
+
+dsh · deepseek harness · dsh plugin · web plugin · client plugin · chat ui · thinking · deep thinking · reasoning · reasoning tokens · reasoning length · token counter · token estimator · token usage · think badge · badge · streaming · 思考 · 深度思考 · 长思考 · 思考长度 · 思考时长 · 思考过程 · 推理 · 推理 token · 思维链 · token 统计 · token 估算 · 徽标 · 实时显示 · 聊天界面 · 雷霆大思考

package/README.zh.md

@@ -0,0 +1,65 @@
+# dsh-plugin-thinking-size
+
+在 DeepSeek Harness web 界面的 "Think" 折叠行标题后实时显示思考内容的 token 量：
+`Think(128)`、`Think(5.2K)`。思考流式输出时数字实时跳动，历史消息同样显示，
+展开/折叠、切换会话后徽标仍在。
+
+[English](README.md) | 中文
+
+![platform](https://img.shields.io/badge/platform-web-blue)
+![dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)
+
+## 徽标
+
+| 形态 | 规则 |
+| --- | --- |
+| `Think(128)` | 不足 1000：整数 |
+| `Think(5.2K)` | 1000 – 999 499：一位小数 + K，去尾 0 |
+| `Think(1.2M)` | 百万以上：一位小数 + M |
+
+- **实时** —— 思考流式输出期间数字随之跳动。
+- **持久** —— 历史消息的每个 Think 行都保留徽标，展开/折叠、切换会话均不丢失。
+- **克制** —— 12px、说明文字色、等宽数字的 `aria-hidden` span，追加在行标题内；
+  标题的可读文本仍只有 "Think"。
+
+## 亲眼看看「雷霆大思考」有多长
+
+部分 LLM 模型素有「雷霆大思考」之名——一个问题下去，先来几千上万 token 的纯思考。
+装上本插件，你可以亲眼看着徽标里的数字一路狂飙，每一次思考到底有多长，看一眼便知。
+模型在上面究竟想了多久，答案就写在行标题上。
+
+## 原理
+
+- **数据**：订阅当前会话快照（`sessions` 服务 → `chat.nodes`），从 `assistant-step`
+  节点的 `reasoning` 块取思考全文——折叠态 DOM 中没有全文，计数必须来自快照而非页面。
+- **估算**：DeepSeek 官方近似口径——1 个英文字符 ≈ 0.3 token，1 个中文字符 ≈ 0.6 token，
+  合计向上取整。计数按 reasoning block 对象引用缓存（引用不可变），流式增量只需重算
+  当前变化的块。
+- **写入**：把徽标 span 追加进行标题 span。Think 行（`data-variant="think"`）按会话流
+  锚点 key + 锚点内序号与 reasoning 块一一对应。快照订阅与 `MutationObserver` 只置脏
+  标记，100ms 节流 sweep 实际干活——React 重渲染抹掉徽标时，Observer 置脏、sweep 补回。
+- **静默降级**：零侵入宿主。缺失 `sessions` 服务、宿主 DOM 契约改名、快照畸形时，
+  插件闲置或逐行跳过，绝不影响宿主运行。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-plugin-thinking-size
+```
+
+重启 `dsh web` 生效。
+
+### 从源码接入（本机开发）
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+```
+
+然后在 `~/.dsh/profiles/web/package.json` 中加入本包（`link:` 依赖）并登记进
+`dsh.profile.bundles`，重启 `dsh web`。
+
+## 关键词
+
+dsh · deepseek harness · dsh 插件 · web 插件 · 客户端插件 · 聊天界面 · 思考 · 深度思考 · 长思考 · 思考长度 · 思考时长 · 思考过程 · 推理 · 推理 token · 思维链 · token 统计 · token 估算 · 徽标 · 实时显示 · 雷霆大思考

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-plugin-thinking-size：在 web 界面 "Think" 行后实时显示思考 token 数。
+- insert:
+    - id: ui-thinking-size
+      name: dsh-plugin-thinking-size

package/lib/client.js

@@ -0,0 +1,322 @@
+window.__ModuleLoader__.load({
+  id: "dsh-plugin-thinking-size",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.ts
+var index_exports = {};
+__export(index_exports, {
+  apply: () => apply,
+  inject: () => inject,
+  name: () => name
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client/dom.ts
+var BADGE_CLASS = "dsh-thinking-size-badge";
+var STYLE_ID = "dsh-thinking-size-style";
+var BADGE_ATTR = "data-dsh-thinking-size";
+function injectStyle(doc = document) {
+  if (doc.getElementById(STYLE_ID) !== null) return;
+  const tag = doc.createElement("style");
+  tag.id = STYLE_ID;
+  tag.textContent = `.${BADGE_CLASS}{color:var(--dsw-alias-label-caption,#8a8a8a);font-size:12px;font-weight:400;margin-left:2px;font-variant-numeric:tabular-nums;user-select:none}`;
+  doc.head.appendChild(tag);
+}
+function anchorKeyOf(row) {
+  const anchor = row.closest("[data-chat-anchor-key]");
+  return anchor?.getAttribute("data-chat-anchor-key") ?? null;
+}
+function titleSpanOf(row) {
+  const rowEl = row.querySelector("[data-disclosure-row]");
+  if (rowEl === null) return null;
+  for (const span of rowEl.querySelectorAll(":scope > span")) {
+    if (span.textContent === "Think" || span.querySelector(`:scope > [${BADGE_ATTR}]`) !== null) {
+      return span;
+    }
+  }
+  return null;
+}
+function writeBadge(titleSpan, text) {
+  const doc = titleSpan.ownerDocument;
+  let badge = titleSpan.querySelector(`:scope > [${BADGE_ATTR}]`);
+  if (badge === null) {
+    badge = doc.createElement("span");
+    badge.className = BADGE_CLASS;
+    badge.setAttribute(BADGE_ATTR, "");
+    badge.setAttribute("aria-hidden", "true");
+    titleSpan.appendChild(badge);
+  }
+  if (badge.textContent === text) return false;
+  badge.textContent = text;
+  return true;
+}
+function removeBadge(row) {
+  const badges = row.querySelectorAll(`[${BADGE_ATTR}]`);
+  if (badges.length === 0) return false;
+  for (const badge of badges) badge.remove();
+  return true;
+}
+function queryThinkRows(root = document) {
+  return Array.from(root.querySelectorAll('[data-variant="think"]'));
+}
+
+// src/client/snapshot.ts
+function collectReasoning(snapshot) {
+  const out = /* @__PURE__ */ new Map();
+  try {
+    const order = snapshot?.chat?.order;
+    const nodes = snapshot?.chat?.nodes;
+    if (order === void 0 || nodes === void 0) return out;
+    if (typeof nodes.get !== "function") return out;
+    for (const key of order) {
+      const node = nodes.get(key);
+      if (node?.kind !== "assistant-step") continue;
+      const blocks = node.data?.blocks;
+      if (!Array.isArray(blocks)) continue;
+      const reasoning = [];
+      for (const block of blocks) {
+        const candidate = block;
+        if (candidate !== null && candidate !== void 0 && candidate.kind === "reasoning" && typeof candidate.text === "string") {
+          reasoning.push(candidate);
+        }
+      }
+      if (reasoning.length > 0) out.set(key, reasoning);
+    }
+  } catch {
+  }
+  return out;
+}
+function createReasoningSource(sessions) {
+  const listeners = /* @__PURE__ */ new Set();
+  let currentId;
+  let unsubscribeSession = null;
+  let unsubscribeList = null;
+  let disposed = false;
+  const notify = () => {
+    if (disposed) return;
+    for (const listener of listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  const sessionOf = (id) => {
+    if (id === void 0 || typeof sessions.binding !== "function") return void 0;
+    try {
+      return sessions.binding(id)?.session;
+    } catch {
+      return void 0;
+    }
+  };
+  const rebind = () => {
+    if (disposed) return;
+    let next;
+    try {
+      next = sessions.list?.getSnapshot?.().current;
+    } catch {
+      next = void 0;
+    }
+    if (next === currentId) return;
+    currentId = next;
+    try {
+      unsubscribeSession?.();
+    } catch {
+    }
+    unsubscribeSession = null;
+    const session = sessionOf(currentId);
+    if (session !== void 0 && typeof session.subscribe === "function") {
+      try {
+        unsubscribeSession = session.subscribe(notify) ?? null;
+      } catch {
+        unsubscribeSession = null;
+      }
+    }
+    notify();
+  };
+  try {
+    unsubscribeList = sessions.list?.subscribe?.(rebind) ?? null;
+  } catch {
+    unsubscribeList = null;
+  }
+  rebind();
+  return {
+    collect() {
+      try {
+        const snapshot = sessionOf(currentId)?.getSnapshot?.();
+        return collectReasoning(snapshot);
+      } catch {
+        return /* @__PURE__ */ new Map();
+      }
+    },
+    subscribe(fn) {
+      listeners.add(fn);
+      return () => {
+        listeners.delete(fn);
+      };
+    },
+    dispose() {
+      disposed = true;
+      listeners.clear();
+      try {
+        unsubscribeSession?.();
+      } catch {
+      }
+      try {
+        unsubscribeList?.();
+      } catch {
+      }
+      unsubscribeSession = null;
+      unsubscribeList = null;
+    }
+  };
+}
+
+// src/client/tokens.ts
+var CJK = /[\u4E00-\u9FFF\u3400-\u4DBF\u3000-\u303F\uFF00-\uFFEF]/;
+var TOKEN_PER_OTHER_CHAR = 0.3;
+var TOKEN_PER_CJK_CHAR = 0.6;
+function estimateTokens(text) {
+  if (!text) return 0;
+  let cjk = 0;
+  let other = 0;
+  for (const ch of text) {
+    if (CJK.test(ch)) cjk += 1;
+    else other += 1;
+  }
+  return Math.ceil(cjk * TOKEN_PER_CJK_CHAR + other * TOKEN_PER_OTHER_CHAR);
+}
+var blockCache = /* @__PURE__ */ new WeakMap();
+function tokensOfBlock(block) {
+  const hit = blockCache.get(block);
+  if (hit !== void 0) return hit;
+  const tokens = estimateTokens(block.text);
+  blockCache.set(block, tokens);
+  return tokens;
+}
+function formatTokens(n) {
+  if (!Number.isFinite(n) || n <= 0) return "0";
+  if (n < 1e3) return String(Math.floor(n));
+  if (n < 999500) {
+    let s2 = (n / 1e3).toFixed(1);
+    if (s2.endsWith(".0")) s2 = s2.slice(0, -2);
+    return s2 + "K";
+  }
+  let s = (n / 1e6).toFixed(1);
+  if (s.endsWith(".0")) s = s.slice(0, -2);
+  return s + "M";
+}
+
+// src/client/controller.ts
+function thinkIndexOf(row) {
+  const anchor = row.closest("[data-chat-anchor-key]");
+  if (anchor === null) return -1;
+  let index = 0;
+  for (const candidate of anchor.querySelectorAll('[data-variant="think"]')) {
+    if (candidate === row) return index;
+    index += 1;
+  }
+  return -1;
+}
+function createController(deps) {
+  const doc = deps.doc ?? document;
+  let disposed = false;
+  let dirty = true;
+  const disposers = [];
+  injectStyle(doc);
+  disposers.push(
+    deps.source.subscribe(() => {
+      dirty = true;
+    })
+  );
+  const Observer = doc.defaultView?.MutationObserver ?? globalThis.MutationObserver;
+  const observer = new Observer(() => {
+    dirty = true;
+  });
+  observer.observe(doc.body ?? doc.documentElement, { childList: true, subtree: true });
+  disposers.push(
+    deps.interval(() => {
+      if (disposed || !dirty) return;
+      dirty = false;
+      sweep();
+    }, 100)
+  );
+  function sweep() {
+    if (disposed) return;
+    const byKey = deps.source.collect();
+    for (const row of queryThinkRows(doc)) {
+      const key = anchorKeyOf(row);
+      const index = thinkIndexOf(row);
+      const blocks = key !== null ? byKey.get(key) : void 0;
+      const block = blocks !== void 0 && index >= 0 ? blocks[index] : void 0;
+      if (block === void 0) {
+        removeBadge(row);
+        continue;
+      }
+      const title = titleSpanOf(row);
+      if (title === null) continue;
+      writeBadge(title, `(${formatTokens(tokensOfBlock(block))})`);
+    }
+  }
+  return {
+    sweep,
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      for (const disposer of disposers) {
+        try {
+          disposer();
+        } catch {
+        }
+      }
+      disposers.length = 0;
+      observer.disconnect();
+    }
+  };
+}
+
+// src/client/index.ts
+var name = "dsh-plugin-thinking-size";
+var inject = ["timer", "sessions"];
+function apply(ctx) {
+  try {
+    injectStyle();
+  } catch {
+  }
+  const sessions = ctx.get("sessions");
+  if (sessions === void 0) return;
+  const source = createReasoningSource(sessions);
+  const controller = createController({
+    source,
+    interval: (fn, ms) => ctx.interval(fn, ms)
+  });
+  return () => {
+    controller.dispose();
+    source.dispose();
+  };
+}
+
+    return module.exports;
+  }
+});

package/lib/index.js

@@ -0,0 +1,9 @@
+// src/index.ts
+var name = "dsh-plugin-thinking-size";
+function apply(ctx) {
+  void ctx;
+}
+export {
+  apply,
+  name
+};

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "dsh-plugin-thinking-size",
+  "description": "Live reasoning-token badge — Think(5.2K) — on every Think disclosure row of the DSH web UI, ticking while streaming · 在 web 界面 Think 行标题后实时显示思考内容 token 数的 DeepSeek Harness 插件",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "deepseek",
+    "dsh-plugin",
+    "web-plugin",
+    "client-plugin",
+    "chat-ui",
+    "thinking",
+    "deep-thinking",
+    "reasoning",
+    "reasoning-tokens",
+    "reasoning-length",
+    "token-counter",
+    "token-estimator",
+    "token-usage",
+    "think-badge",
+    "badge",
+    "streaming",
+    "思考",
+    "深度思考",
+    "长思考",
+    "思考长度",
+    "思考时长",
+    "思考过程",
+    "推理",
+    "推理token",
+    "思维链",
+    "token统计",
+    "token估算",
+    "徽标",
+    "实时显示",
+    "聊天界面",
+    "雷霆大思考"
+  ],
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/focksor/dsh-plugin-thinking-size.git"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs && node scripts/check-build.mjs",
+    "pretest": "node scripts/build.mjs && tsc --noEmit",
+    "test": "node --test --experimental-strip-types",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "esbuild": "^0.25.0",
+    "jsdom": "^29.1.1",
+    "typescript": "^5.7.0"
+  }
+}