@khorsheed/dsh-context-lens 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# 变更记录
+
+## 0.1.0（2026-10-26）
+
+首个公开发布：上下文透镜——点一下任意一轮对话，就能看到模型这一轮到底收到了什么、token 花在哪、时间耗在哪。随「开发套件」和「多Agent协作」安装。
+
+- **从对话直接打开**：每轮回答下面的「请求明细」图标跳到这一轮，会话顶部的图标打开最新一轮；对话还没渲染到的旧轮次也能跳过去，「回到最新」一键回底。
+- **会话地图**：面板顶部是整段会话的轮次地图（有其它 agent 参与的轮次带标记），下面平铺这一轮的参与者——主对话、外部 agent、子 agent、压缩；外部 agent 的页签跨轮保留。长会话按 30 轮一窗加载，可往前往后翻。
+- **看清请求里装了什么**：系统提示、工具定义、历史和本次新增分块显示，系统提示每一段标出来源，可展开原文；「只看重复」挑出重复塞进去的内容，只计多出来的副本。
+- **知道缓存为什么断**：真实的缓存命中与未命中（含缓存写入），和上一次请求的差异精确到字，并逐条列出每一处变化及其背后的宿主事件（替换、压缩、裁剪）。
+- **看时间花在哪**：总耗时拆成模型、工具执行和空档，各 agent 独立泳道，工具表可排序；子 agent 的时间不在主对话里重复计算。
+- **协作间看得清**：协调者交接后，人发给成员的每次派活单独成一轮；Codex / Claude Code / Kimi 这类 CLI 成员的会话按它们的日志重建，一次调用算一次请求、从上一个事件计时；协作间发言卡片的明细按钮直接定位到那位成员的那一轮；「房间」页签列出协作间自动判断的每次模型调用（场景、概率、输入输出 token、延迟、发出的状态与得到的答案）。
+- **装之前的对话也能看**：打开时从会话日志补出插件装上之前的轮次，遵守上下文替换与压缩。
+- **只看不改**：只读监听宿主的三条请求接缝，从不改写发给模型的请求；数据只放在内存里（有总量上限，最旧的回溯先让位）。
+
+技术面：Remote 动词 `listTurns` / `getTurn` / `getRequest` / `getTurnTiming` / `getSessionTrend` / `loadTurns`，可带 `filter.scopes` 供可信服务端按授权过滤；需要宿主 0.1.5-rc.1 起，turn 动作行入口需 0.1.7-rc.1 起（旧宿主只有会话头部入口）。本包由仓内的 request-inspector 改名而来，`requestInspector` 服务与 Remote 命名空间保持兼容；迁移时替换依赖与行，不要两个同时挂载。

package/README.en.md

@@ -0,0 +1,53 @@
+# @khorsheed/dsh-context-lens
+
+English | [中文](README.md)
+
+Click any turn in the conversation and see exactly what the model received, where the tokens went, and where the time went.
+
+When you're tuning a prompt or building a plugin, the questions are always the same: what actually went into this request? Why did the cache miss? Why was this turn so slow? Until now that meant digging through logs and piecing it together yourself. With the context lens, click the icon next to a turn and the right sidebar lays out every model request in it: where each part of the system prompt came from, how many tools came along, what's history and what's new this time, plus a breakdown of the timing. You can tell at a glance whether too much is being injected, at which character the cache broke, and which step ate the time.
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-1.png" width="560" alt="Click the request-details icon under a reply and Context Lens opens that turn on the right: one tab for the main conversation and one per member, the requests listed on the left, the cache hit and breakpoint comparison of the selected request on the right">
+
+## What it does
+
+- **Open it from the conversation**: every answer gets an extra icon underneath that jumps to that turn; the icon at the top of the session opens the latest one, and "Jump to the latest turn" always brings you back to the end.
+- **See what's in the request**: each request is split into system prompt, tool definitions, history and what's new this time; every part of the system prompt is labeled with where it came from, and you can expand the full text.
+- **Find out why the cache broke**: it shows how much really hit the cache, and pinpoints, down to the character, what changed since the previous request.
+- **Catch duplicated content**: press "Duplicates only" to pick out the same text sent more than once, counting only the extra copies.
+- **See where the time went**: switch to "Timing" and the total splits into model, tool execution and the gaps in between, with a sortable list of how long each tool took.
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-2.png" width="560" alt=""This exchange": the new input on the left (an assistant message and a few tool results), the model's output and each tool call's arguments on the right">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-3.png" width="560" alt=""Context composition": a colored proportion bar, then groups for system, tools, history and new with their character counts, the new entries listed one by one">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-4.png" width="560" alt=""Time breakdown": the turn's total split into model calls, tool calls and other, a color-coded timeline of thinking, tool execution and idle, and a tool-time table sorted by total">
+
+- **Subagents add up correctly**: each delegated subagent gets its own entry, and its time isn't counted twice in the main conversation.
+- **Turns from before you installed it**: when you open it, it fills in earlier turns from the session's record.
+- **It only looks**: it never changes what's sent to the model, and what it collects stays in memory rather than being written into the session.
+
+## Install
+
+In DSH, open Plugins → Add plugin, enter this package name, and press Install:
+
+```
+@khorsheed/dsh-dev-suite
+```
+
+The context lens comes with the Dev Suite, and with 「多Agent协作」 (multi-agent, `@khorsheed/dsh-bundle-local-agent`) too. Then open any session, have one exchange, and click the icon under that answer.
+
+## Known limitations
+
+- A turn that's still running doesn't update live; open it again once it's done.
+- For older turns filled in from the session record, the system prompt shows as one block, without where each part came from.
+- What you see is the content as assembled before sending, not the raw bytes that finally go to the model provider.
+
+## Compatibility
+
+Needs DSH 0.1.5-rc.1 or later; verified on 0.2.1-rc.1.
+
+## For developers
+
+- Entry points: `src/index.ts` (capture and service), `src/client/index.ts` (the sidebar panel); `examples/workbench/` previews the panel on made-up data (`pnpm exec tsx packages/context-lens/examples/workbench/serve.mts`).
+- You can install it alone (`dsh plugin --profile web add @khorsheed/dsh-context-lens`); it was renamed from the old request-inspector, so when migrating, replace the old package rather than installing both.
+- Part of [dsh-plugins](https://github.com/Khorsheed/dsh-plugins); open issues and contributions there. Changes: [CHANGELOG.md](CHANGELOG.md).

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record: the git blob hash of each side as of the
+# last confirmed-consistent state. Both languages carry equal authority; after
+# editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/context-lens/README.en.md
+packages/context-lens/README.en.md: e599d8a9b4c70027e6f5bfed976447ffb767fc47
+packages/context-lens/README.md: 9f6d8a078c41522614700b7546aa09c81f42e749

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# @khorsheed/dsh-context-lens
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](README.en.md) | 中文
+
+点一下任意一轮对话，就能看到模型这一轮到底收到了什么、token 花在哪、时间耗在哪。
+
+调提示词、写插件的时候，你最想知道的往往是：这次请求里到底塞了什么？缓存为什么没命中？这一轮怎么这么慢？以前只能翻日志、自己拼。装上上下文透镜，在对话里点一下某一轮旁边的图标，右栏就把这一轮的每一次模型请求摊开给你看：系统提示每一段从哪来、带了多少工具、哪些是历史、哪些是这次新加的，再配上耗时的拆分。你一眼就能看出注入是不是太多、缓存从哪个字开始断的、时间都花在了哪一步。
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-1.png" width="560" alt="点回答下面的「请求明细」图标，右栏的上下文透镜摊开这一轮：主对话和每个成员各一个页签，左边逐次列出请求，右边是这次请求的缓存命中和断点对比">
+
+## 能做什么
+
+- **从对话直接打开**：每一轮回答下面多一个图标，点一下就跳到这一轮；会话顶部的图标打开最新一轮，「定位到最新 turn」随时回到最后。
+- **看清请求里装了什么**：每次请求拆成系统提示、工具定义、历史和本次新增几块，系统提示每一段都标出来源，想看原文就展开。
+- **知道缓存为什么断**：显示真实的缓存命中多少，再把和上一次请求不一样的地方精确到字标出来。
+- **揪出重复内容**：点「只看重复」，把重复塞进去的同一段内容挑出来，只算多出来的那几份。
+- **看时间花在哪**：切到「耗时分布」，总耗时拆成模型、工具执行和中间的空档，每个工具花了多久也能排序看。
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-2.png" width="560" alt="「本次交换」：左边是这次新增的输入（助手消息和几条工具结果），右边是模型的输出和每个工具调用的参数">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-3.png" width="560" alt="「上下文构成」：一条彩色比例条，下面按系统、工具、历史、新增分组，每组的字符数，新增的几条逐条列出">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-lens-4.png" width="560" alt="「耗时分布」：本轮总耗时拆成模型调用、工具调用和其他，一条时间线按颜色标出模型思考、工具执行和空闲，下面是按合计排序的工具耗时表">
+
+- **子 agent 也算得清**：委派出去的子 agent 单独列出来，主对话里不会把它的时间重复算一遍。
+- **装之前的对话也能看**：打开时会从会话记录里补出插件装上之前的轮次。
+- **只看不改**：它从不改动发给模型的请求，看到的数据只放在内存里，不写进会话。
+
+## 安装
+
+在 DSH 的「插件 → 添加插件」里输入下面的包名，点安装：
+
+```
+@khorsheed/dsh-dev-suite
+```
+
+上下文透镜会跟着「开发套件」一起装好；「多Agent协作」（`@khorsheed/dsh-bundle-local-agent`）里也带着它。装完随便开一个会话，聊一轮，再点那一轮回答下面的图标就能看。
+
+## 已知限制
+
+- 正在进行中的那一轮不会实时刷新，要等它结束后重新打开。
+- 从会话记录补出来的旧轮次，系统提示只能显示成一整块，分不出各段来源。
+- 显示的是发出前组装好的内容，不是最终发到模型服务商那里的原始字节。
+
+## Compatibility
+
+需要 DSH 0.1.5-rc.1 或更新版本，已在 0.2.1-rc.1 上验证。
+
+## 给开发者
+
+- 入口：`src/index.ts`（采集与服务）、`src/client/index.ts`（右栏面板）；`examples/workbench/` 能用假数据单独预览面板（`pnpm exec tsx packages/context-lens/examples/workbench/serve.mts`）。
+- 也可以单独安装（`dsh plugin --profile web add @khorsheed/dsh-context-lens`）；本包由旧的 request-inspector 改名而来，迁移时替换掉旧包，不要两个同时装。
+- 隶属 [dsh-plugins](https://github.com/Khorsheed/dsh-plugins)，问题与贡献请到该仓库；变更见 [CHANGELOG.md](CHANGELOG.md)。

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+# dsh-context-lens bundle patch: inserts the plugin row into the composing
+# profile, so `dsh plugin --profile <name> add @khorsheed/dsh-context-lens`
+# reconciles it into the bundles layer. The row is a bare mount — the host half
+# captures per-call request snapshots and mounts its Remote face; the browser
+# half mounts the Remote contribution and the panel surfaces.
+#
+# NOTE: a composition must mount this row id exactly once. Official images
+# mount no context-lens row, so plugin-adding this package is the install
+# path there; a composition that already mounts the id by other means must NOT
+# also add it — a duplicate loader entry id fails boot.
+- insert:
+    - id: context-lens
+      name: "@khorsheed/dsh-context-lens"