dsh-better-display 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,10 +1,183 @@
 # Changelog
 
-## Unreleased
+## 0.2.1 — 2026-09-20
+
+### Fixed
+
+- Pinned reader lanes no longer paint over the composer. The live status row
+  (`执行过程` / `正在使用工具`) pinned at the scrollport top with `z-index: 8`,
+  while the host's sticky composer seat owns `z-index: 7` and nothing between
+  the reader and `<body>` creates a stacking context. A scrolling reader clamps
+  every turn-level sticky lane down into the footer band — the lane stops at its
+  containing block's bottom, which passes behind the input card — so the reader
+  painted its own opaque plate over the composer.
+  - The live status lane now owns the measured lane under the toolbar, exactly
+    like the closed summary rows, instead of sharing the toolbar's lane.
+  - Lanes a scroll can clamp into the footer band stay below the composer seat
+    (`z-index` 6); only the top toolbar lane keeps 7, which also keeps it above
+    the host's code-block banners.
+  - Skin mode no longer carries a second lane ladder of its own.
+  - `tests/footer-precedence.test.ts` guards the ladder in the source sheet and
+    in the committed bundle.
+
+## 0.2.0 — 2026-09-18
+
+### Diff review and tool presentation
+
+- Re-engineered diff review panel: line addition/deletion statistics (`+A -R`) are pushed
+  flush to the right margin, perfectly aligned on the same 32px baseline as the summary text.
+- Diff overlay expands cleanly within the reading column (0px horizontal overflow) with
+  independent vertical scrolling (`max-height: 420px; overscroll-behavior: contain`),
+  preventing mouse-wheel events from leaking into the conversation stream.
+- Multi-file tabs scroll horizontally with adaptive content height on file switches.
+- PR #12 custom tool cards: delegate tool view rendering to `tool.call.toolview` slot with
+  error boundary isolation and auto-expand capabilities.
+
+### Translucent frosted glass and skin mode
+
+- Translucent frosted glass mode is an opt-in toggle in Settings.
+- When enabled, all card backgrounds, tool detail frames, and code blocks become translucent
+  with backdrop blur, eliminating opaque white patches and seamlessly adapting to third-party
+  wallpaper and window skins.
+
+### Refined folding and liveness
+
+- Reverted to a single, intuitive auto-fold toggle (**自动折叠开 / 关**) on the reading toolbar
+  and in Settings, removing complex multi-level rules while keeping reasoning and tools
+  completely unfolded when turned off.
+- Fixed line-wrapping bug so digest rows stay strictly single-line when space permits.
+- Real-time wait clocks (`WaitClock`), execution time tracking, and token throughput
+  metrics (`TurnMetrics`) fully preserved and active.
+- Animated disclosures include fallback timeouts to prevent rendering stalls.
+
+### Better Display settings
+
+- Glass, auto-fold, and deliverable open-mode share the root `dsh.reader.v1` store so
+  Settings and the reading view stay in sync across refresh.
+- Deliverable open-mode: default system app, optional Sidebar. Folder/reveal stay OS.
+- Generative-mcpapps skill installation detection and status reporting.
+
+### Compatibility and liveness
+
+- A wait now restarts when a tool returns. The handover set named kinds from the
+  conversation contract (`tool-result`) while the reader matches against the chat
+  layer's kinds, where a returned tool is the `tool-call` row whose `data.root`
+  carries a result. No node ever had the old name, so the branch was dead and a
+  returned tool never restarted the clock. The set and every kind it reasons about
+  are now typed against the host's own kind union, so a wrong name fails `tsc`
+  instead of failing silently at runtime, and a tool that is still running is
+  explicitly not a wait.
+- The fold choreography can no longer stall. Each phase advances on animation
+  promises and rendered frames, and a cancelled animation rejects while a hidden
+  tab delivers no frames — either one used to leave the machine in a non-idle
+  phase forever, which holds the frame source at the shown snapshot and pauses the
+  text reveal, so the turn looked stuck until the view remounted. Every phase now
+  also has a wall-clock deadline that forces the next phase.
+- While the choreography holds the reveal, the stream buffer keeps absorbing the
+  source instead of returning early, so text never resumes from a stale target
+  once the fold settles.
+- Status shows how many sub-agents the turn dispatched, read from the host's own
+  turn-process row instead of being counted again here.
+- Drop the `command-input` render branch: that string is not a chat node kind in
+  any released host, so it only made the file look like it handled a case that
+  cannot occur.
+- Give every animated disclosure a wall-clock deadline as well. `fill: 'both'`
+  pins the opening keyframe, so a Web Animation that never reaches `onfinish`
+  (cancelled, unmounted, or skipped by the compositor) left the row in the DOM at
+  zero height and zero opacity — clicking it looked like nothing happened.
+- Add a Better Display settings section: deliverables still open in the system app
+  by default, with an optional right-Sidebar preview, plus generative-mcpapps
+  skill-root detection and install guidance.
+- Guard pending-submission image echoes so a text-only send cannot crash
+  `conversation.view` (`images` / `attachments` may be missing).
+- Install guidance names only conventional relative roots (`.dsh/skills`,
+  `.agents/skills`) and never prints host home or plugin pack absolutes.
+
+### Reading and folding
+
+- A later reasoning step folds only the finished process run it follows. The run
+  that is still streaming stays fully expanded, so a long turn reads as
+  alternating digests and prose instead of collapsing mid-thought.
+- Fold intensity 2 (`过程摘要`) is PR #14's process-only mode: prose is never
+  folded; each finished run of reasoning / tool / record steps collapses into
+  one digest that names what the tools actually did (`读取 Reader.tsx`,
+  `运行 pnpm test`), read from the same tool identity the tool cards use. It is
+  not the default — standard fold (level 1) keeps current-main choreography.
+- A finished process-only turn folds its trailing run too, and skips the
+  duplicate closed-turn counter row it no longer needs.
+
+### Reading surface
+
+- When frosted glass is on, sticky lanes use the same liquid glass as the
+  dsh-auto-memory pane: translucent `bg-layer-2` wash, `blur(28px)`, hairline
+  border, 16px radius and a soft lift. Detail chips stay transparent until
+  hovered or focused. When the toggle is off, chrome matches current main.
+- The toolbar reserves the width of its whole control group. Measuring only the
+  first button let the status lane paint over every later control.
+- A compaction divider now arrives instead of simply appearing: the rule sweeps
+  out from its centre, the pill settles in, and the dial turns once. Gated by
+  `data-motion=off` and `prefers-reduced-motion` like every other transition.
+
+### Diff review
+
+- Read the changed line counts from the tool result the host already attaches
+  (`meta.diffs`, `{ path, oldText, newText }`), and fall back to the call's own
+  arguments for `write` / `edit` / `str_replace_editor` when a host build does
+  not send them. The name whitelist matters: several unrelated tools take a
+  field called `content`, and counting those invented additions for calls that
+  changed no file.
+- Fold a parent call's child calls into its own counts. A `run_code` that writes
+  files reports what its children changed rather than what its own arguments
+  contain, so a run whose edits live one level down no longer loses its counts.
+  Each child contributes through its own arguments, read from either the landed
+  result or the pending call.
+- `+N -M` sits at the end of the row in green/red and opens a panel listing one
+  entry per changed file — the file tabs, the removed lines on a red wash and
+  the added lines on a green one, using the same `DiffBlock` primitive the
+  official tool row renders. The panel is in flow, never a floating popup, so
+  the flow cell's `overflow: clip` cannot cut it off.
+- Opening and closing the panel animate real height in the plugin's own motion
+  language, and the card is brought back into view when it opens below the
+  fold; an open panel keeps its caret lit.
+
+### Waiting and timing
+
+- Show how long the model has been given the turn, next to 「深度求索中」and the
+  in-flow wait indicator. The clock is anchored to the last event that handed
+  control to the model — a returned tool, an injected context, a run command,
+  the user's own message — never to the start of the turn, so a wait that has
+  just begun does not inherit the minutes the tools already spent.
+- Past ten seconds the readout adds a「暂未响应」badge, and the moment the model
+  produces its first block the whole indicator is withdrawn. A tool that is
+  still running is not a wait: the tool is the one working.
+- A command that ran long keeps its duration after it returns (warning colour
+  past ten seconds); a fast one shows nothing once it is done. Running steps
+  show a live seconds readout and a shimmering summary while they work.
+
+### Scroll
+
+- Tail-follow only detaches on a real upward move by the reader. Content growth
+  and the follow easing itself also move `scrollTop`, and reading that as "the
+  user left the bottom" froze following mid-turn.
+- Disable browser scroll anchoring on the conversation scroller while the reader
+  is mounted: it moved the viewport on its own as the transcript grew.
+- Only a focused text field suspends following, and only inside the reader.
+  Focusing the composer used to stop the transcript from advancing.
+- Stream at the source's own rate: add a feed-forward term estimated from the
+  arrival rate on top of the proportional controller. A purely proportional
+  reveal settles at a constant `catchUpMs` of lag regardless of model speed,
+  which read as 「慢」 while the backlog grew with faster models; the feed-forward
+  term drains the backlog and the proportional term absorbs transport jitter.
+- Reveal a batch of words on one clock instead of one word per fixed gap.
+  Per-word spacing pinned the rate near 16 words/second, so a fast model still
+  arrived one word at a time; a batch now lands inside one short window while a
+  lone new word keeps the original typing cadence.
+- The reasoning pane's own follow steps with the backlog rather than at a fixed
+  step-and-hold: it used to advance two lines every ~1.3 seconds no matter how
+  fast the text arrived, which is what made the pane look like it was lagging
+  behind a fast model.
+### Host DOM hooks
 
-- Add a Better Display settings section: deliverables still open in the system app by default, with an optional right-Sidebar preview, plus generative-mcpapps skill-root detection and install guidance.
-- Guard pending-submission image echoes so a text-only send cannot crash `conversation.view` (`images` / `attachments` may be missing).
-- Install guidance names only conventional relative roots (`.dsh/skills`, `.agents/skills`) and never prints host home or plugin pack absolutes.
 - Keep ChatView's `data-chat-flow=""` hook on the Reader column so skins that hide `[data-composer-seat]` when the scrollport has no chat-flow (maid-atelier, phoebe-atelier, and others) still show the composer in reading view.
 
 ## 0.1.1 — 2026-09-16

package/README.en.md

@@ -2,17 +2,31 @@
 
 [中文](./README.md)
 
+Prefer npm (version-pinable):
+
+```sh
+dsh plugin --profile web add dsh-better-display@0.2.1
+```
+
+Or latest:
+
+```sh
+dsh plugin --profile web add dsh-better-display
+```
+
+Fallback: install from GitHub (tracks the default branch tip):
+
 ```sh
 dsh plugin --profile web add github:aa2246740/dsh-better-display
 ```
 
-You need official `dsh` (or `npx @deepseek-ai/dsh`) and **pnpm** on PATH. `dsh plugin add` runs pnpm in `$DSH_HOME/profiles/web`. This repo commits built `lib/`, so a git install does not need `prepare` or a profile `allowBuilds` entry.
+You need official `dsh` (or `npx @deepseek-ai/dsh`) and **pnpm** on PATH. `dsh plugin add` runs pnpm in `$DSH_HOME/profiles/web`. This repo commits built `lib/`, so git / npm installs do not need `prepare` or a profile `allowBuilds` entry.
 
 Then restart that Host and reload the page. `dsh plugin add` writes the profile. It does not hot-load a running process.
 
 Adds a **阅读** tab to DeepSeek Harness. While a turn runs you see steps, thinking, and progress. After a successful turn those collapse and the final answer stays. Native Chat / Trajectory, the composer, model picker, tools, and approvals stay. The reading column keeps ChatView's `data-chat-flow` hook so third-party skins that gate the composer on that mark still treat Reader as an interactive conversation.
 
-A ````mcp-app` fence in the final answer mounts as an interactive card in the reading view, inside `<iframe sandbox="allow-scripts allow-forms">` without `allow-same-origin`. The card can fill the next prompt via JSON-RPC. The skill pack is [`skills/generative-mcpapps/`](skills/generative-mcpapps/). Settings → **Better Display** can preview deliverables in the right Sidebar (system app remains the default) and reports whether that skill is installed in a harness skill root.
+A ````mcp-app` fence in the final answer mounts as an interactive card in the reading view, inside `<iframe sandbox="allow-scripts allow-forms">` without `allow-same-origin`. The card can fill the next prompt via JSON-RPC. The skill pack is [`skills/generative-mcpapps/`](skills/generative-mcpapps/). Settings → **Better Display** can preview deliverables in the right Sidebar (system app remains the default), turn on translucent frosted glass (off by default), toggle process auto-folding (On is the default), and reports whether that skill is installed in a harness skill root.
 
 Targets DeepSeek Harness **0.1.5-rc.2**. Display only. It does not change Agent execution, the SDK, or credentials. Node.js `^22.19.0 || >=24`. New sessions default to reading.
 
@@ -20,7 +34,7 @@ From a local checkout or tarball:
 
 ```sh
 dsh plugin --profile web add ./dsh-better-display
-dsh plugin --profile web add ./dsh-better-display-0.1.1.tgz
+dsh plugin --profile web add ./dsh-better-display-0.2.1.tgz
 ```
 
 `dsh.bundle` is captured at Host boot. Do not also insert the same row by hand in the profile `cordis.patch.yml`, or it will mount twice.

package/README.md

@@ -2,17 +2,31 @@
 
 [English](./README.en.md)
 
+推荐用 npm（可钉版本）：
+
+```sh
+dsh plugin --profile web add dsh-better-display@0.2.1
+```
+
+也可以装 latest：
+
+```sh
+dsh plugin --profile web add dsh-better-display
+```
+
+备选：从 GitHub 直装（跟默认分支最新提交）：
+
 ```sh
 dsh plugin --profile web add github:aa2246740/dsh-better-display
 ```
 
-PATH 上要有官方 `dsh`（没有就用 `npx @deepseek-ai/dsh`）和 **pnpm**。`dsh plugin add` 会在 `$DSH_HOME/profiles/web` 里跑 pnpm。仓库已提交编译好的 `lib/`，git 安装不用 `prepare`，也不用改 profile 的 `allowBuilds`。
+PATH 上要有官方 `dsh`（没有就用 `npx @deepseek-ai/dsh`）和 **pnpm**。`dsh plugin add` 会在 `$DSH_HOME/profiles/web` 里跑 pnpm。仓库已提交编译好的 `lib/`，git / npm 安装都不用 `prepare`，也不用改 profile 的 `allowBuilds`。
 
 然后重启这个 Host，再刷新页面。`dsh plugin add` 只写 profile，不会热挂正在跑的进程。
 
 给 DeepSeek Harness 加一个 **阅读** 页签：执行时能看到步骤、思考和进度；整轮成功结束后把过程收起来，留下最终回答。原版「对话 / 轨迹」、输入框、模型选择、工具和审批都还在。阅读列保留宿主 ChatView 的 `data-chat-flow` 钩子，依赖该标记显示输入框的第三方皮肤不会把阅读页当成仅检视视图。
 
-最终回答里的 ````mcp-app` 代码块会在阅读视图里挂成交互卡片，跑在 `<iframe sandbox="allow-scripts allow-forms">` 里，没有 `allow-same-origin`。卡片可以通过 JSON-RPC 把下一轮 prompt 填进输入框。技能包在 [`skills/generative-mcpapps/`](skills/generative-mcpapps/)。设置里的 **Better Display** 可把产物改为右侧栏预览（默认仍用系统应用），并检测该技能是否已装进宿主技能目录。
+最终回答里的 ````mcp-app` 代码块会在阅读视图里挂成交互卡片，跑在 `<iframe sandbox="allow-scripts allow-forms">` 里，没有 `allow-same-origin`。卡片可以通过 JSON-RPC 把下一轮 prompt 填进输入框。技能包在 [`skills/generative-mcpapps/`](skills/generative-mcpapps/)。设置里的 **Better Display** 可把产物改为右侧栏预览（默认仍用系统应用），打开半透明毛玻璃（默认关），设置过程自动折叠开关（默认开），并检测该技能是否已装进宿主技能目录。
 
 面向 DeepSeek Harness **0.1.5-rc.2**。只改展示，不改 Agent 执行、SDK 或模型凭据。Node.js `^22.19.0 || >=24`。新会话默认进阅读。
 
@@ -20,7 +34,7 @@ PATH 上要有官方 `dsh`（没有就用 `npx @deepseek-ai/dsh`）和 **pnpm**
 
 ```sh
 dsh plugin --profile web add ./dsh-better-display
-dsh plugin --profile web add ./dsh-better-display-0.1.1.tgz
+dsh plugin --profile web add ./dsh-better-display-0.2.1.tgz
 ```
 
 `dsh.bundle` 是开机捕获的。不要再往 profile 的 `cordis.patch.yml` 手写同一条 insert，会重复挂载。