dsh-better-display 0.2.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.3.2 — 2026-09-24
+
+- 补齐 0.1.7-rc.1 官方桥接的运行时契约：工具视图传入 `phase`/`useDisclosure`/`hookContext{callId}`，聊天节点改用 `{turnData, disclosureReset}` 快照 store；修复真实宿主里官方工具视图静默落到 fallback 的问题。
+- 折叠区吸顶车道的绘制缝隙：车道只给自己的框刷实心底色，`.turn` 14px gap、前一 cell 16px padding、status 车道右侧 `--reader-control-width` 保留区三条缝滚动时透出内容；改用同色 `box-shadow` 向上/向右补漆连成连续色带。
+
+## 0.3.1 — 2026-09-24
+
+- Accept Harness `0.1.7-rc.1`. Peer range is `>=0.1.7-rc.1 <0.1.8`.
+- `conversation.chat.turnTail` is a list slot. The old chain expectation threw during client boot and left the page on “Failed to load plugins”.
+- Icon imports use the rc.1 weight names (`IconBrowseOutlineRegular` and the rest). Size stays a prop.
+- Pending confirmation now reads `useSessionStatus` (`pendingInteraction`). The removed `useSessionPendingInteraction` hook threw as soon as the reader painted.
+- Code and terminal labels include the rc.1 toolbar fields (`codeLabel`, wrap, and `noExitCode`).
+
+## 0.3.0 — 2026-09-21
+
+- 修复关闭自动折叠、查看过程详情后，再开启仍无法折叠的问题；重新开启会恢复自动折叠规则，仍保留文本选择保护和之后的手动展开。
+- 在现有阅读布局中接入官方反馈、工具详情、显式产物卡片、命令和未知节点渲染；官方渲染器负责注入、翻译、store 和子插槽。
+- 移除直接调用工具组件及模拟点击展开的逻辑，保留现有摘要、折叠、动效和文件快捷操作。
+- 接入官方文件链接服务，传递工具文件行号，补齐 RC2 本地 Markdown 图片及加载失败降级。
+- 修复滚动跟随拉回底部的问题，统一阅读列轨道和吸顶区域的位置。
+- 代码解释器结果按终端输出展示，上下文行兼容 `provenance` 和 `producer`。
+- 增加可重放的官方组件集成测试、自动折叠交互回归和 Harness 升级兼容检查，依赖对齐 Harness `0.1.5-rc.2`。
+- 设计范围、接口边界和待收敛模块见 `docs/official-rendering-bridge.md`。
+
 ## 0.2.1 — 2026-09-20
 
 ### Fixed

package/README.en.md

@@ -5,7 +5,7 @@
 Prefer npm (version-pinable):
 
 ```sh
-dsh plugin --profile web add dsh-better-display@0.2.1
+dsh plugin --profile web add dsh-better-display@0.3.1
 ```
 
 Or latest:
@@ -28,13 +28,15 @@ Adds a **阅读** tab to DeepSeek Harness. While a turn runs you see steps, thin
 
 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.
+Targets DeepSeek Harness **0.1.7-rc.1**. Display only. It does not change Agent execution, the SDK, or credentials. Node.js `^22.19.0 || >=24`. New sessions default to reading.
+
+**0.3.0** keeps the existing reading layout, folding, and motion while using official feedback, tool details, file cards, and file links. It also fixes process content staying expanded after auto-folding is re-enabled. See the [official integration notes](docs/official-rendering-bridge.md) for coverage and upgrade checks.
 
 From a local checkout or tarball:
 
 ```sh
 dsh plugin --profile web add ./dsh-better-display
-dsh plugin --profile web add ./dsh-better-display-0.2.1.tgz
+dsh plugin --profile web add ./dsh-better-display-0.3.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

@@ -5,7 +5,7 @@
 推荐用 npm（可钉版本）：
 
 ```sh
-dsh plugin --profile web add dsh-better-display@0.2.1
+dsh plugin --profile web add dsh-better-display@0.3.1
 ```
 
 也可以装 latest：
@@ -28,13 +28,15 @@ PATH 上要有官方 `dsh`（没有就用 `npx @deepseek-ai/dsh`）和 **pnpm**
 
 最终回答里的 ````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`。新会话默认进阅读。
+面向 DeepSeek Harness **0.1.7-rc.1**。只改展示，不改 Agent 执行、SDK 或模型凭据。Node.js `^22.19.0 || >=24`。新会话默认进阅读。
+
+**0.3.0** 保留现有阅读布局、折叠和动效，接入官方反馈、工具详情、文件卡片及文件链接；并修复重新开启自动折叠后仍保持展开的问题。接入范围和升级检查见 [官方能力接入说明](docs/official-rendering-bridge.md)。
 
 本地目录或 tarball：
 
 ```sh
 dsh plugin --profile web add ./dsh-better-display
-dsh plugin --profile web add ./dsh-better-display-0.2.1.tgz
+dsh plugin --profile web add ./dsh-better-display-0.3.1.tgz
 ```
 
 `dsh.bundle` 是开机捕获的。不要再往 profile 的 `cordis.patch.yml` 手写同一条 insert，会重复挂载。

package/compat/harness-rc2.json

@@ -0,0 +1,97 @@
+{
+  "harnessVersion": "0.1.7-rc.1",
+  "hashes": {
+    "packages/client/ui-slots/src/index.ts": "27a453937cdcc28923c37ad90cd01489e458e205dc03032629183087b5b585d0",
+    "packages/client/ui-slots/src/renderer.ts": "ee834aafc19367922c139d41f677233fbdfcc042b4deff9f616aa43220ee09ee",
+    "packages/client/ui-renderer/src/client/registry.ts": "6b8b6b969d8bcf0314ea20438a223f3a90e1bd516571faecae5c3c01008ecf21",
+    "packages/client/ui-renderer/src/client/scoped-slots.tsx": "082ebd62a6d287704d116fa1b233f12ab62a91bc6ccccf99d8137b1f33b8d02b",
+    "packages/client/ui-chat/src/client/contract/slots.ts": "4bfe6f2b3d33d0ba4dc82f7ed93255ad4a2df16c6540937a07a658bd66d4d664",
+    "packages/client/ui-tool/src/client/contract/slots.ts": "4ae6334ebb0c6a267c13e8b6b504a614d302e77b4080a63408b97f4d25b22a3f",
+    "packages/client/ui-deliverables/src/client/Deliverables.tsx": "b8d0a19dc208af7f8f44459adba9afe648cd3c398d75917ccfaf2f8c730cfe74",
+    "packages/client/ui-chat/src/client/chat/AssistantMarkdown.tsx": "d0a60ef4c8620e7916579f1e7f959fa2c81e8dcdbc1dea1d7ea16b5b667adb62",
+    "packages/client/ui-chat/src/client/chat/MessageItem.tsx": "181844e9c1809607458dfdfbbffa50cbc16357d0696ae78a8ee13f86b5fd6354",
+    "packages/client/ui-chat/src/client/chat/AssistantNodeView.tsx": "239c8fe1305ede17d3786bfdd61e7e52f3cab30ae548befe172867c52deef388",
+    "packages/client/ui-chat/src/client/chat/TurnTailNodeView.tsx": "4b493845e7d28b93a2db2198e70deffcf4b290c31218923fc7c945af737b56d1",
+    "packages/client/ui-chat/src/client/chat/TurnProcessNodeView.tsx": "731a879e517c9ff28c7d833863e774745666cffe3a2fd2f9aa3fff1adcbc4a17",
+    "packages/client/ui-tool/src/client/tool/models/tool-call-model.ts": "d3373fbb23ae4fb158ed009d0c0d7aaa5a22609946adb52e48a30cb02323c16f",
+    "packages/client/ui-primitives/src/markdown/MarkdownText.tsx": "ff500ab71ac6a55df416f84cc1f5900327b9908c5180c4e2b3888377bd417a97",
+    "packages/client/ui-primitives/src/markdown/render.tsx": "6bcd477f6830587e5258aed48df81b0c7c0c0e661ea74ba8828fc4be653875de",
+    "packages/client/ui-primitives/src/markdown/parse.ts": "e281b4120306987cce9cf6d8bccfeddec2fe0c7b7b1cc190966f6dcbfd320b1b",
+    "packages/client/ui-primitives/src/markdown/incremental.ts": "eaa266bb77dfb646738d0fdd79be4f1c4bc5490f7bf3f4127f9ffb72ef741ff8",
+    "packages/client/ui-primitives/src/markdown/katex.tsx": "8227e04d29333d2568021ed012143237b457852bce25d82cf394d72b941e74a5"
+  },
+  "registrations": [
+    "conversation.chat.assistant-actions | feedback | packages/client/ui-message-feedback/src/client/index.ts",
+    "conversation.chat.node | assistant-step | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | command | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | command-input | packages/client/ui-goal/src/client/index.ts",
+    "conversation.chat.node | compaction | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | context | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | manual-compaction | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | model-retry | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | steering | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | system-prompt | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | tool-call | packages/client/ui-tool/src/client/apply.ts",
+    "conversation.chat.node | turn-error | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | turn-max-tokens | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | turn-process | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | turn-tail | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | turn-trigger | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | unknown | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | user | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
+    "conversation.chat.node | workflow-run | packages/client/ui-workflow-run/src/client/index.ts",
+    "conversation.chat.turnTail | (chain/single) | packages/client/ui-plan/src/client/index.ts",
+    "conversation.chat.turnTail | @deepseek-ai/dsh-client-ui-deliverables | packages/client/ui-deliverables/src/client/index.ts",
+    "conversation.message.images | (chain/single) | packages/client/ui-attachment/src/client/index.ts",
+    "tool.call.images | (chain/single) | packages/client/ui-attachment/src/client/index.ts",
+    "tool.call.toolview | ask_user_question | packages/client/ui-tool/src/client/tool/toolviews/ask-question-row.tsx",
+    "tool.call.toolview | bash | packages/client/ui-tool/src/client/tool/toolviews/bash-sample.tsx",
+    "tool.call.toolview | cordis_inspect_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | cordis_inspect_query | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | cordis_inspect_self | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | create_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | edit | packages/client/ui-tool/src/client/tool/toolviews/file-mutation-row.tsx",
+    "tool.call.toolview | get_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | glob | packages/client/ui-tool/src/client/tool/toolviews/search-row.tsx",
+    "tool.call.toolview | grep | packages/client/ui-tool/src/client/tool/toolviews/search-row.tsx",
+    "tool.call.toolview | interrupt_agent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | job_kill | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | job_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | job_output | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | list_agents | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | list_subagent_models | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | lsp | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | present | packages/client/ui-deliverables/src/client/index.ts",
+    "tool.call.toolview | ralph | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | read | packages/client/ui-tool/src/client/tool/toolviews/read-row.tsx",
+    "tool.call.toolview | read_image | packages/client/ui-tool/src/client/tool/toolviews/read-image-row.tsx",
+    "tool.call.toolview | schedule_create | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | schedule_delete | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | schedule_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | send_message | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | session_event_read | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | session_event_search | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | session_event_trace | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | session_search | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | session_trace | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | skill | packages/client/ui-skill/src/client/index.ts",
+    "tool.call.toolview | spawn_teammate | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | subagent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | team_task_create | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | team_task_get | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | team_task_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | team_task_update | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | terminal_close | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | terminal_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | terminal_open | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | terminal_read | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | terminal_signal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | todo_write | packages/client/ui-tool/src/client/tool/toolviews/todo-row.tsx",
+    "tool.call.toolview | update_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | wait_agent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | web_fetch | packages/client/ui-tool/src/client/tool/toolviews/web-row.tsx",
+    "tool.call.toolview | web_search | packages/client/ui-tool/src/client/tool/toolviews/web-row.tsx",
+    "tool.call.toolview | workflow | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
+    "tool.call.toolview | write | packages/client/ui-tool/src/client/tool/toolviews/file-mutation-row.tsx"
+  ]
+}

package/docs/official-rendering-bridge.md

@@ -0,0 +1,65 @@
+# 官方能力接入说明
+
+`0.3.0` 在 `v0.2.1` 的阅读布局上接入官方内容和控件，经过试用验收后发布。当前验收目标是 Harness `0.1.7-rc.1`。`conversation.chat.turnTail` 在这一版是 `list`，不再是 `chain`。后续仍需维护的自有展示逻辑和升级边界见下文。
+
+## 一个具体例子
+
+一条回答的持久化 `messageId` 进入 `OfficialActions`，随后进入 Reader 自己的回答操作插槽。里面的反馈组件、状态注入和弹窗控制器来自当前已加载的官方反馈插件。点击按钮后，由官方控制器打开原来的官方弹窗；Reader 不实现反馈请求、类别或状态管理。
+
+工具详情同理：传递 `callId`、原始 `block`、工作目录、Host home、图片加载器、带行号的文件打开操作和轨迹入口，再由官方工具组件呈现。原来只取函数组件、手工传四个参数并模拟点击展开的路径已经移除。
+
+## 代码归属
+
+| 模块 | 负责什么 |
+| --- | --- |
+| `official-slots.tsx` | 用公开注册表 API 将官方注册信息映射到 Reader 的独立插槽；保留注入、locale、store、selector 和子插槽。监听贡献增删，逐条挂载和释放。 |
+| `OfficialContent.tsx` | 将回答身份、工具、节点和产物上下文传给官方控件。这里只组合，不处理业务请求。 |
+| `Reader.tsx`、`ToolActivity.tsx` | 原有阅读布局、过程组织、摘要和交互。工具详情里的控件采用官方形式。 |
+| `platform-media.ts` | RC2 的本地媒体 URL 约定；读取授权仍由 Host 文件 API 负责。 |
+| `compat/harness-rc2.json` | 已验收的官方接口、被自有展示覆盖的实现和注册清单基线。 |
+
+## 为什么有插槽映射
+
+RC2 的一个子插槽只能有一个声明者，只有声明它的组件能获得相应 `renderSlot` 权限。Reader 不能把官方插槽再声明一次，也不能从 `ctx.slots` 任意渲染子插槽。
+
+本适配用 `spec`、`entriesOfSlot`、`register`、`inject`、`subscribe` 建立 Reader 自己的名字空间，交给同一个官方渲染器运行。组件声明的子插槽名称在一层薄包装中转换，其余属性原样传递。没有私有源码导入，没有修改官方注册对象或官方 DOM，没有复制官方渲染器。现有控件保持组件和注入身份；增加别的控件不会重挂它们。
+
+这仍是 RC2 的受限适配方案。若官方将来提供可直接组合的共享渲染入口，应优先替换这层映射。
+
+## 这版覆盖的能力
+
+| 能力 | 处理方式 |
+| --- | --- |
+| 回答操作、反馈 | 官方 `conversation.chat.assistant-actions`，使用持久化 messageId；中断的临时片段不伪造身份。 |
+| 工具详情 | 官方 `tool.call.toolview`，包括 memo、注入状态、翻译和递归子插槽；未注册的工具保留原有结果预览。 |
+| 显式 `present` 产物 | 官方 turnTail 中的文件卡片和菜单，保留官方状态和打开操作。 |
+| 已修改文件快捷操作 | 保持原 Reader 的复制、定位和打开模式；仅从 Reader 的官方 tail 展示参数中排除重复的 produced chips，不改变官方源数据。未知匹配结构原样呈现。 |
+| 文件行号和正文文件链接 | 保留工具传来的行号；正文优先采用官方 file-mention 服务，现有路径匹配作为补充。 |
+| 本地 Markdown 图片 | 和 RC2 相同的同源文件 API，加载失败保留替代文本，危险协议不直接渲染。 |
+| 命令、新节点类型 | 接入官方节点渲染及其子插槽；无可用渲染器时保留记录并提供“在对话中查看”。 |
+
+阅读布局、折叠、逐字动效、阅读速度、默认设置保持现版。移除了未被使用的全局 `body.dataset.readerFolding` 写入。
+
+## 验证与升级
+
+在选定 Harness 运行时上执行：
+
+```sh
+node scripts/link-harness-dependencies.mjs "$DSHX_HARNESS"
+npm run build
+npm test
+npm run test:official
+npm run test:auto-fold
+```
+
+`test:official` 使用测试目标里的真实官方 SlotRegistry、React renderer、反馈插件、ReadRow 和 Deliverables，只有远程业务服务使用内存替身。测试私有源码仅用于验证，不进入交付 bundle。浏览器验证使用本机固定的 Codex Playwright runtime，不附着用户会话。
+
+`test:auto-fold` 使用真实 Reader 和独立的全局、会话 store，验证关闭后阅读再开启、此前步骤、设置同步、文本选择及连续切换；分别覆盖普通动画和减少动态效果。
+
+`build` 先检查兼容基线。Harness 版本、敏感接口、尚未收敛的官方实现或相关注册清单改变时，构建明确要求审查。审查差异并通过功能与视觉测试后，才可运行 `check-harness-compat.mjs --record` 记录新基线。记录本身不构成兼容证明。
+
+## 后续仍需完成
+
+Markdown 定制仍保留逐字动效和 MCP 展示钩子，官方公共组件还没有对应的注入接口。上下文行、部分过程展示和工具摘要也仍有自有实现。本分支先建立官方能力的完整运行路径，后续按视觉基线逐模块收敛这些副本，并拆分 Reader 的阅读策略与动画执行。不能据此承诺所有未来版本零维护，也不承诺任意第三方插件兼容。
+
+已有客户端通过 HMR 更新时，无需新增 Host 或改写会话数据；应先核对实际安装来源、构建产物和同页行为。正式版本保留 Git 标签及发布包，便于按版本安装和回退。