@jcy2387/dsh-conversation-ui 0.2.0-rc.2 → 0.2.1-rc.2

package/README.en.md

@@ -1,51 +1,48 @@
 # @jcy2387/dsh-conversation-ui
 
-This release targets Harness `0.2.0-rc.2`. The deliverables card uses an independent list entry alongside native file previews, change review, and other plugins’ Turn-tail contributions. Settings appear on the Suite or standalone bundle page. Elapsed labels use the host Chat's localized duration units. Older Harness users should keep the corresponding older plugin version.
+This release targets Harness `0.2.1-rc.2`. The deliverables card uses an independent list entry; files defer to the native changed-files card when it is active, while the plugin adds websites without drawing a second file card. Settings appear on the Suite or standalone bundle page. Assistant rows delegate to the native renderer; DSH owns work-details modes, tool groups, folding, and scrolling. Older Harness users should keep the corresponding older plugin version.
 
 [![CI](https://github.com/DamonBao/dsh-codex-suite/actions/workflows/ci.yml/badge.svg)](https://github.com/DamonBao/dsh-codex-suite/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 English | [简体中文](README.md)
 
-A Codex-style conversation UI enhancement plugin for DeepSeek Harness (DSH): the Web chat is re-rendered as one ordered event stream — process updates, thinking, tool activity, retries, workflows, and the final answer appear in the order they happened, while DSH retains authoritative viewport control. This package is the Conversation UI package of the [DSH Codex Suite](../../README.md) monorepo.
+A conversation enhancement plugin for DeepSeek Harness (DSH): progressive reveal and auto-expanded thinking augment the native assistant renderer, with deliveries contributed through an independent slot. DSH retains its ChatView, tool cards, Turn controls, and file previews. This is the Conversation UI package of the [DSH Codex Suite](../../README.md) monorepo.
 
 **The package is fully independent from the Codex Provider** and can be installed alone to enhance conversations with any model.
 
 ## Features
 
-### Event stream and turn structure
+### Native conversation integration
 
-- **Instant turn feedback:** the native DSH running status and elapsed clock appear after submission, with one localized status throughout the turn.
-- **Process vs. answer:** each turn's process content (Think, tools, retries…) is grouped into its own section; once the final answer lands successfully, the process section **auto-collapses** and stays expandable by hand.
-- **Natural ordering:** Think, Tool, Retry, Workflow, Compaction, Command, and context-injection rows keep their real order instead of being regrouped away.
-- **Markdown images:** local absolute-path images in assistant replies use DSH's authenticated file route.
-
-### Semantic tool activity
-
-- Search, file read, edit, shell, database, web, skill, and agent tools each render a distinct icon, so the activity stream is scannable at a glance; groups collapse and expand.
+- Compact, Standard, Detailed, and Verbose work-details modes retain DSH's native grouping, reasoning previews, and process disclosure.
+- The native assistant renderer owns Markdown, protected local images, attachments, file mentions, stopped markers, and final-answer actions.
+- Tool, retry, workflow, command, and context rows retain their native layout. The plugin only wraps the winning assistant renderer in place, keeping its children, inject, store, and locale; it leaves other rows and portals untouched.
 
 ### Two streaming reveal modes
 
 | Mode | Behavior |
 | --- | --- |
-| `teleprompter` (default) | The latest model snapshot appears immediately, with no extra character-reveal queue. |
-| `typewriter` | Progressive reveal by grapheme cluster, safe for CJK text and emoji. |
+| `typewriter` (default) | Progressive reveal by grapheme cluster, safe for CJK text and emoji. |
+| `teleprompter` | The latest model snapshot appears immediately, with no extra character-reveal queue. |
 
 - Three smoothing presets: `realtime` (snappier), `balanced` (default), `silky` (extra smooth). Presets shape the reveal cadence — EMA-smoothed arrival rate, buffer targets, catch-up ceilings, and the settle drain after the input idles — so long replies never dump whole paragraphs at once and fast streams never stutter.
-- `typewriter` mode also exposes a fixed reveal rate via `revealCharsPerSec`.
+- `typewriter` mode exposes a fixed reveal rate via `revealCharsPerSec`. When the turn settles, the remaining reveal queue drains at a faster settle rate before switching to the full snapshot; stopped and failed turns use the same drain. Loading history or switching sessions does not replay the animation, and reduced motion shows the full snapshot immediately.
 
 ### Streaming viewport cooperation
 
 - Current DSH `ChatView` exclusively owns the running status, per-session restoration, bottom-follow, and reader unpinning. The plugin no longer adds a second waiting row or writes `scrollTop` and row transforms.
-- Respects `prefers-reduced-motion`; when the frame rate degrades, an FPS guard skips DOM commits for offscreen replies so visible frames stay fluid.
+- Respects `prefers-reduced-motion` by showing the latest snapshot immediately.
 
 ### Deliverables card
 
-- Every finished turn ends with a **deliverables** card: produced files and websites with added/removed line counts.
+- Every finished turn ends with a **deliverables** card: produced files and websites with real added/removed line counts.
+- While DSH’s native changed-files card is active (developer tools on and the turn has git changes), files belong to that card, including its diff preview and review; the plugin lists websites only so one turn never shows two file cards.
+- Relative and absolute spellings of the same file are merged, so the file is counted once.
 
 ### Plugin settings card
 
-- A durable **Auto-expand thinking** toggle in *Plugins → DSH Codex Suite (or Conversation UI)* (live; no restart needed).
+- Durable reveal mode (typewriter / teleprompter), smoothing preset (realtime / balanced / silky), reveal speed, and **Auto-expand thinking** controls in *Plugins → DSH Codex Suite (or Conversation UI)*; changes apply live without a restart.
 - The card also shows the current version and installation kind (npm / local development); npm installs get a one-click update action (restart required after updating).
 - Localized in Chinese and English.
 
@@ -54,7 +51,7 @@ A Codex-style conversation UI enhancement plugin for DeepSeek Harness (DSH): the
 Published package:
 
 ```sh
-dsh plugin --profile web add @jcy2387/dsh-conversation-ui@0.2.0-rc.2
+dsh plugin --profile web add @jcy2387/dsh-conversation-ui@0.2.1-rc.2
 dsh web
 ```
 
@@ -67,17 +64,17 @@ dsh web
 
 Alternatively install the [`@jcy2387/dsh-suite`](../all/README.md) bundle to enable both the Codex Provider and this plugin.
 
-No further steps are needed: the event-stream renderer activates automatically for new conversations, and existing sessions are untouched.
+Native assistant enhancement activates automatically; existing session data stays unchanged.
 
 ## Configuration
 
-Profile patch ID: `conversation-ui`. Set values in the profile's `cordis.patch.yml` overlay (the suite bundle defaults to `mode: teleprompter`, `preset: balanced`).
+Profile patch ID: `conversation-ui`. The overlay sets deployment defaults (the suite bundle defaults to `mode: typewriter`, `preset: balanced`); `mode`, `preset`, and `revealCharsPerSec` are also live, persistent settings in the plugin card.
 
 | Option | Range | Default | Notes |
 | --- | --- | --- | --- |
-| `mode` | `teleprompter` \| `typewriter` | `teleprompter` | Reveal style of assistant content. |
-| `preset` | `realtime` \| `balanced` \| `silky` | `balanced` | Smoothing cadence preset. |
-| `revealCharsPerSec` | 5–200 | `80` | Fixed reveal rate for `typewriter` mode. |
+| `mode` | `typewriter` \| `teleprompter` | `typewriter` | Deployment default reveal style; live-editable in the card. |
+| `preset` | `realtime` \| `balanced` \| `silky` | `balanced` | Deployment default smoothing preset; live-editable in the card. |
+| `revealCharsPerSec` | 5–200 | `80` | Deployment default reveal rate; live-editable in the card. |
 | `scrollSpeedPxPerSec` | 1–200 | `48` | Deprecated; retained for old Profile compatibility. DSH owns scrolling. |
 | `maxScrollSpeedPxPerSec` | 1–2000 | `1000` | Deprecated; retained for old Profile compatibility. DSH owns scrolling. |
 
@@ -108,7 +105,11 @@ The package ships a [`conversation-ui-off.yml`](conversation-ui-off.yml) overlay
 The package ships two halves that cooperate over one very narrow config channel:
 
 - **Host half** (`src/`): a Cordis plugin. It validates the config schema, injects the validated value into every served index HTML (the boot global `window.__DSH_CONVERSATION_UI_CONFIG__`), and registers the user-settings namespace plus a loopback-only settings RPC (read/write preferences, report installation kind, trigger an npm update).
-- **Web half** (`src/client/`): React views. It registers at low priority to shadow Assistant and Turn-process presentation, wraps other chat rows (tool cards, retries, workflows…) in place while delegating all scrolling to DSH `ChatView`, adds the turn-tail deliverables card, and mounts the plugin configuration card in Settings. The stream still renders with defaults when locale, connection, or the settings service is absent.
+- **Web half** (`src/client/`): wraps the winning `assistant-step` renderer in place in `conversation.chat.node`, preserving its children, inject, store, and locale while adjusting streaming text and native `useDisclosure`. It does not replace `conversation.view` or `turn-process`, or read host DOM. Deliveries use an independent `conversation.chat.turnTail` list entry; settings use `plugins.bundle.config`. Registration follows the slot declaration lifetime; the native entry's child slots, inject, store, and locale stay intact.
+
+### Presentation after upgrading
+
+The old custom tool icons, tool group frames, and process folding styles now use native DSH presentation. Select a work-details mode in DSH; reveal configuration and the persisted Auto-expand thinking preference continue to apply. No session format or credential migration is needed. Delivery cards read persisted Turn data rather than scanning other rows' DOM or hiding native file previews.
 
 ## Development
 
@@ -118,10 +119,10 @@ pnpm --filter @jcy2387/dsh-conversation-ui test
 pnpm --filter @jcy2387/dsh-conversation-ui build
 ```
 
-Tests run on vitest + Testing Library, covering stream smoothing, native scroll delegation, Turn folding, and the settings card (both client and host sides). See the [monorepo README](../../README.md) for workspace-wide commands.
+Tests run on vitest + Testing Library, loading the published DSH Chat factory and covering native modes, reasoning disclosure, images, stream reveal, load/unload order, and the settings card (both client and host sides). See the [monorepo README](../../README.md) for workspace-wide commands.
 
 ## License
 
 [MIT](LICENSE) © jcy2387
 
-This release targets DSH `0.2.0-rc.2`. It imports `conversation-ui.thinkAutoExpand` from `settings.yaml` or `settings.yaml.imported` into the active profile’s `cordis.patch.yml`, recording a marker after success and retaining the source after failure. The plugin’s compatibility import fills only missing values. Exported `locale/en.json` and `locale/zh.json` localize the name and description in DSH.
+This release targets DSH `0.2.1-rc.2`. It imports `conversation-ui.thinkAutoExpand` from `settings.yaml` or `settings.yaml.imported` into the active profile’s `cordis.patch.yml`, recording a marker after success and retaining the source after failure. The plugin’s compatibility import fills only missing values. Exported `locale/en.json` and `locale/zh.json` localize the name and description in DSH.

package/README.md

@@ -1,51 +1,48 @@
 # @jcy2387/dsh-conversation-ui
 
-本版本面向 Harness `0.2.0-rc.2`。产物卡片使用列表插槽中的独立条目，与原生文件预览、变更审阅及其他插件的回合尾部内容共存；插件设置位于 Suite 或独立插件的配置页。时长文案使用宿主 Chat 的本地化单位。旧版 Harness 用户应继续使用对应旧版插件。
+本版本面向 Harness `0.2.1-rc.2`。产物卡片使用列表插槽中的独立条目；文件在原生 changed-files 卡启用时交给原生卡，插件补充网站，避免重复；插件设置位于 Suite 或独立插件的配置页。助手行委托原生组件渲染，工作步骤展示模式、工具分组、折叠和滚动由 DSH 管理。旧版 Harness 用户应继续使用对应旧版插件。
 
 [![CI](https://github.com/DamonBao/dsh-codex-suite/actions/workflows/ci.yml/badge.svg)](https://github.com/DamonBao/dsh-codex-suite/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 [English](README.en.md) | 简体中文
 
-DeepSeek Harness（DSH）的 Codex 风格对话界面增强插件：把 Web 对话重绘为一条有序事件流 —— 过程答复、思考、Tool 活动、重试、工作流与最终答复按发生顺序呈现，同时保持平滑的视口跟随。本包是 [DSH Codex Suite](../../README.zh.md) Monorepo 的对话 UI 包。
+DeepSeek Harness（DSH）的对话增强插件：在原生助手组件上增加逐字揭示和思考自动展开，并通过独立插槽展示产物。原生 ChatView、工具卡片、回合控制和文件预览保持宿主的呈现。本包是 [DSH Codex Suite](../../README.zh.md) Monorepo 的对话 UI 包。
 
 **本包与 Codex Provider 完全独立**，可以单独安装并服务任意模型。
 
 ## 功能
 
-### 事件流与 Turn 组织
+### 原生对话协作
 
-- **Turn 开始即反馈：** 提交后由 DSH 原生状态栏显示本地化的运行状态和计时，整轮只保留一处提示。
-- **过程与结论分离：** 每个 Turn 的过程内容（Think、Tool、重试等）归入独立过程区；最终答复成功落地后过程区**自动折叠**，需要时可手动展开。
-- **自然顺序保持：** Think、Tool、Retry、Workflow、Compaction、Command 和上下文注入按真实发生顺序排列，不会被分组打散。
-- **Markdown 图片：** 助手回复中的本地绝对路径图片通过 DSH 的受保护文件接口显示。
-
-### 语义化 Tool 活动
-
-- 搜索、文件读取、编辑、命令、数据库、网页、技能、Agent 等工具各有专属图标，活动流一眼可扫；工具组可折叠/展开。
+- 工作步骤展示的简洁、标准、详细和完全展开模式继续使用 DSH 的原生分组、思考摘要和过程折叠。
+- Markdown、受保护的本地图片、图片附件、文件引用、停止标记和最终答复操作由原生助手组件渲染。
+- 工具、重试、工作流、命令和上下文行保留原生布局；插件只原地包装获胜的 assistant 渲染器，保留其 children、inject、store 和 locale，不改其他行，也不通过 Portal 重排。
 
 ### 两种流式揭示模式
 
 | 模式 | 行为 |
 | --- | --- |
-| `teleprompter`（默认） | 直接呈现模型的最新内容快照，不引入额外逐字队列。 |
-| `typewriter` | 按字素（grapheme）渐进揭示，对中文、emoji 等宽字符安全。 |
+| `typewriter`（默认） | 按字素（grapheme）渐进揭示，对中文、emoji 等宽字符安全。 |
+| `teleprompter` | 直接呈现模型的最新内容快照，不引入额外逐字队列。 |
 
 - 三档平滑预设：`realtime`（更跟手）、`balanced`（默认）、`silky`（更绵密）。预设控制揭示节奏曲线：到达速率的 EMA 平滑、缓冲目标、追速上限和停顿后的收尾排空速度，让长回复不会整段砸出、快流不会卡顿。
-- `typewriter` 模式另有固定揭示速度 `revealCharsPerSec` 可调。
+- `typewriter` 模式另有固定揭示速度 `revealCharsPerSec` 可调。回合结束后不会丢掉待揭示队列：剩余内容以更快的收尾速率排空，再切换到完整快照；停止和失败同样按此收尾。加载历史和切换会话不会重播逐字效果，减少动态效果时直接显示完整快照。
 
 ### 流式视口协作
 
 - 当前 DSH `ChatView` 独占会话级位置恢复、底部跟随和用户上滑释放；插件不再直接写 `scrollTop` 或行变换，避免切换会话时争抢滚动所有权。
-- 尊重 `prefers-reduced-motion`；帧率退化时暂停离屏内容的 DOM 提交（FPS 守卫），保住可见帧的流畅。
+- 尊重 `prefers-reduced-motion`，启用减少动态效果时直接显示最新快照。
 
 ### 产物卡片
 
-- 每个完成的 Turn 尾部列出**产物**：生成的文件与站点，附增删行数，产出成果一目了然。
+- 每个完成的 Turn 尾部列出**产物**：生成的文件与站点，附真实增删行数。
+- 当 DSH 原生 changed-files 卡启用（开发者工具打开且该回合有 git 变更）时，文件交给原生卡（含 diff 预览和审阅），插件只列网站，避免同一回合出现两张文件卡。
+- 路径在相对/绝对写法之间归一化并合并，同一文件不会重复计数。
 
 ### 插件设置卡片
 
-- 在 **插件 → DSH Codex Suite（或 Conversation UI）** 中提供持久化的「自动展开思考」开关（实时生效，无需重启）。
+- 在 **插件 → DSH Codex Suite（或 Conversation UI）** 中提供持久的揭示模式（typewriter / teleprompter）、平滑预设（realtime / balanced / silky）、揭示速度和「自动展开思考」；修改实时生效，无需重启。
 - 卡片同时显示当前版本与安装形态（npm / 本地开发），npm 安装支持一键更新（更新后需重启）。
 - 界面中英文本地化。
 
@@ -54,7 +51,7 @@ DeepSeek Harness（DSH）的 Codex 风格对话界面增强插件：把 Web 对
 已发布版本：
 
 ```sh
-dsh plugin --profile web add @jcy2387/dsh-conversation-ui@0.2.0-rc.2
+dsh plugin --profile web add @jcy2387/dsh-conversation-ui@0.2.1-rc.2
 dsh web
 ```
 
@@ -67,17 +64,17 @@ dsh web
 
 也可以安装 [`@jcy2387/dsh-suite`](../all/README.md) 组合包，一次启用 Codex Provider 与本插件。
 
-安装后无需任何操作：发起新对话即自动启用事件流渲染，历史会话不受影响。
+安装后自动增强原生助手行，既有会话数据不变。
 
 ## 配置
 
-Profile patch ID：`conversation-ui`。在 profile 的 `cordis.patch.yml` overlay 中设置（组合包默认值为 `mode: teleprompter`、`preset: balanced`）。
+Profile patch ID：`conversation-ui`。overlay 设置部署默认值（组合包默认值为 `mode: typewriter`、`preset: balanced`）；`mode`、`preset`、`revealCharsPerSec` 也可在插件设置卡中实时修改并持久化。
 
 | 选项 | 范围 | 默认 | 说明 |
 | --- | --- | --- | --- |
-| `mode` | `teleprompter` \| `typewriter` | `teleprompter` | 助手内容的揭示模式。 |
-| `preset` | `realtime` \| `balanced` \| `silky` | `balanced` | 平滑节奏预设。 |
-| `revealCharsPerSec` | 5–200 | `80` | `typewriter` 模式的固定揭示速度。 |
+| `mode` | `typewriter` \| `teleprompter` | `typewriter` | 部署默认揭示模式；设置卡可实时修改。 |
+| `preset` | `realtime` \| `balanced` \| `silky` | `balanced` | 部署默认平滑预设；设置卡可实时修改。 |
+| `revealCharsPerSec` | 5–200 | `80` | 部署默认揭示速度；设置卡可实时修改。 |
 | `scrollSpeedPxPerSec` | 1–200 | `48` | 已弃用；仅保留旧 Profile 配置兼容，滚动由 DSH 管理。 |
 | `maxScrollSpeedPxPerSec` | 1–2000 | `1000` | 已弃用；仅保留旧 Profile 配置兼容，滚动由 DSH 管理。 |
 
@@ -108,7 +105,11 @@ Overlay 示例：
 本包由两半组成，通过一条极窄的配置通道协作：
 
 - **Host 半**（`src/`）：Cordis 插件。负责校验配置 schema，并把校验后的配置注入每个服务出的 index HTML（启动配置全局变量 `window.__DSH_CONVERSATION_UI_CONFIG__`）；同时注册用户设置命名空间与一条仅限 loopback 的设置 RPC（读取/写入偏好、查询安装形态、触发 npm 更新）。
-- **Web 半**（`src/client/`）：React 视图。以低优先级注册替换 `assistant-step` 与 Turn 过程呈现；其余对话行（Tool 卡片、重试、工作流等）原位包装，但滚动完全委托给 DSH `ChatView`；在 Turn 尾部注册产物卡片，并在设置页挂载插件配置卡片。缺少 locale / connection / 设置服务时仍以默认配置运行流式渲染。
+- **Web 半**（`src/client/`）：通过 `conversation.chat.node` 的 `assistant-step` 键原地包装获胜渲染器，保留既有组件的 children、inject、store 与 locale，只调整流式文本和原生 `useDisclosure`。不接管 `conversation.view` 或 `turn-process`，不读取宿主 DOM。产物使用 `conversation.chat.turnTail` 的独立列表条目，设置使用 `plugins.bundle.config`。组件装卸跟随插槽声明；获胜的 assistant 渲染器原地包装，children、inject、store 和 locale 保持原样。
+
+### 升级后的呈现
+
+旧版插件的自定义工具图标、工具分组框和过程折叠样式已交由 DSH 原生 UI。请使用 DSH 的「工作步骤展示」选择呈现模式；插件的揭示配置与持久化「自动展开思考」偏好继续生效。没有会话格式或凭据迁移。产物卡片只读取持久化回合数据，不再扫描其他行的 DOM 或隐藏原生文件预览。
 
 ## 开发
 
@@ -118,10 +119,10 @@ pnpm --filter @jcy2387/dsh-conversation-ui test
 pnpm --filter @jcy2387/dsh-conversation-ui build
 ```
 
-测试基于 vitest + Testing Library，覆盖流式揭示、原生滚动委托、Turn 折叠与设置卡片（客户端与 Host 两侧）。工作区级命令见 [Monorepo README](../../README.zh.md)。
+测试基于 vitest + Testing Library，加载已发布 DSH Chat 工厂，覆盖原生模式、思考折叠、图片、流式揭示、装卸顺序与设置卡片（客户端与 Host 两侧）。工作区级命令见 [Monorepo README](../../README.zh.md)。
 
 ## 许可证
 
 [MIT](LICENSE) © jcy2387
 
-本版面向 DSH `0.2.0-rc.2`。旧 `conversation-ui.thinkAutoExpand` 从 `settings.yaml` 或 `settings.yaml.imported` 导入当前 profile 的 `cordis.patch.yml`，成功后记录迁移标记；失败保留源文件供重试。插件兼容导入只补充缺失的值。名称和描述通过导出的 `locale/en.json`、`locale/zh.json` 跟随 DSH 界面语言。
+本版面向 DSH `0.2.1-rc.2`。旧 `conversation-ui.thinkAutoExpand` 从 `settings.yaml` 或 `settings.yaml.imported` 导入当前 profile 的 `cordis.patch.yml`，成功后记录迁移标记；失败保留源文件供重试。插件兼容导入只补充缺失的值。名称和描述通过导出的 `locale/en.json`、`locale/zh.json` 跟随 DSH 界面语言。

package/cordis.patch.yml

@@ -3,7 +3,7 @@
     - id: conversation-ui
       name: '@jcy2387/dsh-conversation-ui'
       config:
-        mode: teleprompter
+        mode: typewriter
         preset: balanced
         revealCharsPerSec: 80
         scrollSpeedPxPerSec: 48