dsh-better-display

dsh plugin --profile web add dsh-better-display

dsh-better-display

[English](./README.en.md)

安装

DSH Studio 桌面 App（推荐）

打开 设置 → 插件 → 添加插件，在“包名或地址”中输入：

github:aa2246740/dsh-better-display#v0.3.12

桌面端的插件管理器负责 Desktop profile 和其内置包管理器。v0.3.12 是目前已打 tag、且 engines.dsh 接受 Harness 0.2.1-rc.5 的安装目标。本 tag 已包含编译好的 lib/；普通使用不需要 clone、构建或安装 DSHX。若应用在安装完成后提示刷新或重新打开，请按提示完成。

Web CLI

dsh plugin --profile web add github:aa2246740/dsh-better-display#v0.3.12

这条官方 CLI 命令只写入 web profile，不能修改 Desktop App 的 profile。本机 PATH 上需要有 pnpm。对于已经运行的 Web Host，请重新打开该 Host 一次，再刷新网页；插件 bundle 会在启动时读取。

给 DeepSeek Harness 加一个 阅读 页签：执行时能看到步骤、思考和进度；整轮成功结束后把过程收起来，留下最终回答。原版「对话 / 轨迹」、输入框、模型选择、工具和审批都还在。阅读列保留宿主 ChatView 的 data-chat-flow 钩子，依赖该标记显示输入框的第三方皮肤不会把阅读页当成仅检视视图。若另一个插件用低于官方的 priority 替换了 assistant-step（例如 dsh-raw-html-v2 渲染 <div id="vcp-root"> 卡片），阅读页把回答正文交给它，思考、折叠和过程动效仍由阅读页负责。详见 [官方能力接入说明](docs/official-rendering-bridge.md)。

另一个插件可以在展示层改写思考和回答（例如翻译），阅读页仍负责浮现、跟随和折叠。复制的是原文，会话记录不变。契约和最小例子见 [扩展点](docs/extension-points.md)。

最终回答里的 ```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.2.1-rc.5（dsh-v0.2.1-rc.5，b830ec950faba0a46dda564be3e2d854afed94f1）。只改展示，不改 Agent 执行、SDK 或模型凭据。Node.js ^22.19.0 || >=24。新会话默认进阅读。@deepseek-ai/dsh-* peer 与 engines.dsh 是 >=0.2.1-rc.1 <0.2.2：接受 0.2.1-rc.5 和稳定版 0.2.1，拒绝 0.2.1 alpha，也拒绝 0.2.0 系列。

0.3.0 保留现有阅读布局、折叠和动效，接入官方反馈、工具详情、文件卡片及文件链接；并修复重新开启自动折叠后仍保持展开的问题。接入范围和升级检查见 [官方能力接入说明](docs/official-rendering-bridge.md)。

本地目录或 tarball（开发/本地测试）：

dsh plugin --profile web add ./dsh-better-display
dsh plugin --profile web add ./dsh-better-display-0.3.12.tgz

dsh.bundle 是开机捕获的。不要再往 profile 的 cordis.patch.yml 手写同一条 insert，会重复挂载。

dsh plugin --profile web remove dsh-better-display

开发

干净检出后：

npm ci
npm run build
npm test
npm run typecheck

npm run build 里的 Harness 兼容检查需要 ripgrep 和一份 Harness 检出。可选环境变量写在 .env.example 和 [AGENTS.md](AGENTS.md)。阅读页怎么点开、空白页、样式丢失和折叠停住见 [docs/runbooks/blank-reader.md](docs/runbooks/blank-reader.md)。

许可

展示与 Markdown 部分来自 DeepSeek Harness（MIT）。动效参考 Transitions.dev。本仓库代码 [MIT](LICENSE)。