@jcy2387/dsh-conversation-ui 0.1.0-rc.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-codex-suite contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,123 @@
+# @jcy2387/dsh-conversation-ui
+
+[![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 viewport follow stays smooth. This package 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
+
+- **Instant turn feedback:** an elapsed timer and a thinking placeholder appear the moment you submit — no more staring at a blank screen.
+- **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.
+
+### 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.
+
+### Two streaming reveal modes
+
+| Mode | Behavior |
+| --- | --- |
+| `teleprompter` (default) | Content appears as instant snapshots that glide smoothly upward — read it like a teleprompter. |
+| `typewriter` | Progressive reveal by grapheme cluster, safe for CJK text and emoji. |
+
+- 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`.
+
+### Smart viewport follow
+
+- New content is followed smoothly within speed bounds: at least `scrollSpeedPxPerSec`, at most `maxScrollSpeedPxPerSec` (a large lag never teleports).
+- Scrolling upward to read **releases the follow**; returning to the bottom resumes it.
+- Respects `prefers-reduced-motion`; when the frame rate degrades, an FPS guard skips DOM commits for offscreen replies so visible frames stay fluid.
+
+### Deliverables card
+
+- Every finished turn ends with a **deliverables** card: produced files and websites with added/removed line counts.
+
+### Plugin settings card
+
+- A durable **Auto-expand thinking** toggle in *Settings → Plugins → Plugin configuration* (live; no restart needed).
+- 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.
+
+## Install
+
+Published package:
+
+```sh
+dsh plugin --profile web add @jcy2387/dsh-conversation-ui
+dsh web
+```
+
+Local development copy:
+
+```sh
+dsh plugin --profile web add link:/path/to/dsh-codex-suite/packages/conversation-ui
+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.
+
+## 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`).
+
+| 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. |
+| `scrollSpeedPxPerSec` | 1–200 | `48` | Minimum viewport-follow speed. |
+| `maxScrollSpeedPxPerSec` | 1–2000 | `1000` | Follow speed ceiling; prevents teleporting after a large lag. |
+
+Overlay example:
+
+```yaml
+- id: conversation-ui
+  name: '@jcy2387/dsh-conversation-ui'
+  config:
+    mode: typewriter
+    preset: silky
+    revealCharsPerSec: 60
+```
+
+User preferences such as *Auto-expand thinking* do not go through the overlay: change them in **Settings → Plugins → Plugin configuration** — they apply immediately and persist across restarts.
+
+### Temporarily disable
+
+The package ships a [`conversation-ui-off.yml`](conversation-ui-off.yml) overlay that disables the plugin (restoring the stock chat renderer) without uninstalling it:
+
+```yaml
+- id: conversation-ui
+  disabled: true
+```
+
+## Architecture
+
+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 the `assistant-step` node view with the Codex-style presentation, wraps every other growing chat row (tool cards, retries, workflows…) in place so they share the follow engine, 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.
+
+## Development
+
+```sh
+pnpm --filter @jcy2387/dsh-conversation-ui typecheck
+pnpm --filter @jcy2387/dsh-conversation-ui test
+pnpm --filter @jcy2387/dsh-conversation-ui build
+```
+
+Tests run on vitest + Testing Library, covering the stream-smoothing hook, follow and folding behavior, and the settings card (both client and host sides). See the [monorepo README](../../README.md) for workspace-wide commands.
+
+## License
+
+[MIT](LICENSE) © jcy2387

package/README.md

@@ -0,0 +1,123 @@
+# @jcy2387/dsh-conversation-ui
+
+[![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 包。
+
+**本包与 Codex Provider 完全独立**，可以单独安装并服务任意模型。
+
+## 功能
+
+### 事件流与 Turn 组织
+
+- **Turn 开始即反馈：** 提交后立刻显示处理计时器和「思考中」占位，不再对着空白等待。
+- **过程与结论分离：** 每个 Turn 的过程内容（Think、Tool、重试等）归入独立过程区；最终答复成功落地后过程区**自动折叠**，需要时可手动展开。
+- **自然顺序保持：** Think、Tool、Retry、Workflow、Compaction、Command 和上下文注入按真实发生顺序排列，不会被分组打散。
+
+### 语义化 Tool 活动
+
+- 搜索、文件读取、编辑、命令、数据库、网页、技能、Agent 等工具各有专属图标，活动流一眼可扫；工具组可折叠/展开。
+
+### 两种流式揭示模式
+
+| 模式 | 行为 |
+| --- | --- |
+| `teleprompter`（默认） | 内容即时快照呈现，整段向上平滑滑动，像提词器一样阅读。 |
+| `typewriter` | 按字素（grapheme）渐进揭示，对中文、emoji 等宽字符安全。 |
+
+- 三档平滑预设：`realtime`（更跟手）、`balanced`（默认）、`silky`（更绵密）。预设控制揭示节奏曲线：到达速率的 EMA 平滑、缓冲目标、追速上限和停顿后的收尾排空速度，让长回复不会整段砸出、快流不会卡顿。
+- `typewriter` 模式另有固定揭示速度 `revealCharsPerSec` 可调。
+
+### 智能视口跟随
+
+- 新内容以限速平滑跟随：最低 `scrollSpeedPxPerSec`、最高 `maxScrollSpeedPxPerSec`（大滞后不瞬移）。
+- 用户向上滚动阅读时**自动释放跟随**，回到底部后恢复。
+- 尊重 `prefers-reduced-motion`；帧率退化时暂停离屏内容的 DOM 提交（FPS 守卫），保住可见帧的流畅。
+
+### 产物卡片
+
+- 每个完成的 Turn 尾部列出**产物**：生成的文件与站点，附增删行数，产出成果一目了然。
+
+### 插件设置卡片
+
+- 在 **设置 → 插件 → 插件配置** 中提供持久化的「自动展开思考」开关（实时生效，无需重启）。
+- 卡片同时显示当前版本与安装形态（npm / 本地开发），npm 安装支持一键更新（更新后需重启）。
+- 界面中英文本地化。
+
+## 安装
+
+已发布版本：
+
+```sh
+dsh plugin --profile web add @jcy2387/dsh-conversation-ui
+dsh web
+```
+
+本地开发版本：
+
+```sh
+dsh plugin --profile web add link:/path/to/dsh-codex-suite/packages/conversation-ui
+dsh web
+```
+
+也可以安装 [`@jcy2387/dsh-suite`](../all/README.md) 组合包，一次启用 Codex Provider 与本插件。
+
+安装后无需任何操作：发起新对话即自动启用事件流渲染，历史会话不受影响。
+
+## 配置
+
+Profile patch ID：`conversation-ui`。在 profile 的 `cordis.patch.yml` overlay 中设置（组合包默认值为 `mode: teleprompter`、`preset: balanced`）。
+
+| 选项 | 范围 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| `mode` | `teleprompter` \| `typewriter` | `teleprompter` | 助手内容的揭示模式。 |
+| `preset` | `realtime` \| `balanced` \| `silky` | `balanced` | 平滑节奏预设。 |
+| `revealCharsPerSec` | 5–200 | `80` | `typewriter` 模式的固定揭示速度。 |
+| `scrollSpeedPxPerSec` | 1–200 | `48` | 视口跟随的最低速度。 |
+| `maxScrollSpeedPxPerSec` | 1–2000 | `1000` | 视口跟随的速度上限。 |
+
+Overlay 示例：
+
+```yaml
+- id: conversation-ui
+  name: '@jcy2387/dsh-conversation-ui'
+  config:
+    mode: typewriter
+    preset: silky
+    revealCharsPerSec: 60
+```
+
+「自动展开思考」等用户偏好不走 overlay：在 **设置 → 插件 → 插件配置** 中修改，保存即生效并跨重启持久化。
+
+### 临时禁用
+
+包内自带 [`conversation-ui-off.yml`](conversation-ui-off.yml) overlay，可在不卸载包的情况下禁用插件（回到原生对话渲染）：
+
+```yaml
+- id: conversation-ui
+  disabled: true
+```
+
+## 架构
+
+本包由两半组成，通过一条极窄的配置通道协作：
+
+- **Host 半**（`src/`）：Cordis 插件。负责校验配置 schema，并把校验后的配置注入每个服务出的 index HTML（启动配置全局变量 `window.__DSH_CONVERSATION_UI_CONFIG__`）；同时注册用户设置命名空间与一条仅限 loopback 的设置 RPC（读取/写入偏好、查询安装形态、触发 npm 更新）。
+- **Web 半**（`src/client/`）：React 视图。以低优先级注册替换 `assistant-step` 节点视图实现 Codex 风格助手呈现；其余增长的对话行（Tool 卡片、重试、工作流等）原位包装以共享跟随引擎；在 Turn 尾部注册产物卡片；并在设置页挂载插件配置卡片。缺少 locale / connection / 设置服务时仍以默认配置运行流式渲染。
+
+## 开发
+
+```sh
+pnpm --filter @jcy2387/dsh-conversation-ui typecheck
+pnpm --filter @jcy2387/dsh-conversation-ui test
+pnpm --filter @jcy2387/dsh-conversation-ui build
+```
+
+测试基于 vitest + Testing Library，覆盖流式揭示 hook、跟随与折叠行为、设置卡片（客户端与 Host 两侧）。工作区级命令见 [Monorepo README](../../README.zh.md)。
+
+## 许可证
+
+[MIT](LICENSE) © jcy2387

package/conversation-ui-off.yml

@@ -0,0 +1,3 @@
+# Optional profile overlay: disable the Conversation UI plugin without removing it.
+- id: conversation-ui
+  disabled: true

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# Applied when this package appears in a profile's dsh.profile.bundles list.
+- insert:
+    - id: conversation-ui
+      name: '@jcy2387/dsh-conversation-ui'
+      config:
+        mode: teleprompter
+        preset: balanced
+        revealCharsPerSec: 80
+        scrollSpeedPxPerSec: 48
+        maxScrollSpeedPxPerSec: 1000