# @iroha1145/dsh-modern-ui 中文文档 规范地址：https://npmcn.com/package/%40iroha1145/dsh-modern-ui/ 版本：0\.1\.5 npm 元数据更新时间：2026-11-01T07:53:58.965Z 中文译文更新时间：2026-11-01T12:09:28.517Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40iroha1145/dsh-modern-ui 原文对照：https://npmcn.com/package/%40iroha1145/dsh-modern-ui/?lang=original 项目主页：https://github.com/iroha1145/DSH-Modern-UI#readme 源码仓库：https://github.com/iroha1145/DSH-Modern-UI ## 关键信息（来自 npm 元数据） - 包体积（解压后）：12.3 MB，139 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=24\.0\.0 - 运行依赖：5 个 - peer 依赖：react ^18\.3\.0，react-dom ^18\.3\.0，@deepseek-ai/cordis ^4\.0\.5，@deepseek-ai/dsh-llm \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-web \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-brand \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-scope \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-tools \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-session \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-timeout \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/schemastery ^3\.18\.5，@deepseek-ai/dsh-app-boot \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-attachment \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-http-proxy \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-subprocess \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-credentials \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-util-values \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-atomic-write \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-mcp-resources \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-plugin-market \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-system-prompt \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-chat \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-host-webserver \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-plugin-manager \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-slots \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-theme \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-connection \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-settings \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-subagent \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-launch-environment \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-session-persistence \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-attachment \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-conversation \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-experimental-translator \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-model-selection \>=0\.2\.1-rc\.2 \<0\.3\.0-0 - 首次发布：2026-10-30T15:40:35.831Z - 最新版本发布：2026-11-01T07:53:58.681Z - 已发布版本数：7（近 12 个月 7 个） ## 中文简介 现代UI浏览器扩展为未经修改的官方DSH发布 ## 安装 ```sh npm install @iroha1145/dsh-modern-ui ``` 也可以使用：`pnpm add @iroha1145/dsh-modern-ui`、`yarn add @iroha1145/dsh-modern-ui`、`bun add @iroha1145/dsh-modern-ui` ## README # DSH现代用户界面 一个现代的官方Web界面，未经修改 [DeepSeek利用](https://github.com/deepseek-ai/deepseek-harness) （DSH）：重新设计聊天流程，推理折叠，工具卡，模型选择，主题和八种界面语言。 ## 安装 ```bash dsh plugin --profile web add @iroha1145/dsh-modern-ui ``` 然后刷新浏览器。 `dsh plugin` 转发到pnpm，所以 `pnpm` 必须在PATH上。如果您从未启动过web配置文件，请运行 `dsh web` 一旦第一。 ## Model-visible行为 默认情况下，Modern UI不会更改模型提示符。它呈现 `openui-lang` (OpenUI)和 `followups` 代码隔离已经编写好的模型。打开 **设置→常规→回答可视化组件** 向系统提示符追加大约30 KB（大约7000个令牌）的表示指导。 **分阶段交付成果**是同一页面上的一个单独开关，它附加了大约3kb的指导，让模型在研究下一个答案之前，先交出一个多阶段答案的每个完成部分。相同的开关存在于条目配置中： ```yaml presentation: prompt: false # model-visible guidance progressive: false # model-visible progressive result delivery guidance openui: true # render openui-lang fences as OpenUI components followups: true # render followups fences as suggestion chips jev: # optional TypeSafe Jev presentation advice tool enabled: true # offered only with the presentation prompt on and a key present credential: TYPESAFE_API_KEY # environment-variable name the DSH credentials service resolves model: jev-latest endpoint: https://api.typesafe.ai/v1/systemone timeout: 4000 # ms; past it the tool answers that no suggestion is available ``` 设置→通用在演示开关下有一个“Jev演示建议”行：它通过官方凭据保存密钥。`credentials/set`)放入DSH凭据文件 `jev.credential` 名称，仅显示是否配置了密钥以及从哪个层配置了密钥，并提供 `enabled` 一旦存在密钥就切换。它拒绝带有空格、换行符或非ascii字符的键，这些都是请求头不能携带的。没有凭据的主机“远程”不显示行。 使用可用的密钥，每个主会话的主代理将获得一个 `jev_presentation_advice` 工具;从环境或 `.env` 没有请求头可以携带的文件使工具隐藏并记录一个没有密钥的警告。它在该代理自己的工具范围中注册并遵循 `presentation.prompt`， `jev.enabled` 随着键的变化，它的出现和消失无需重启；子代理加入预设组合而不是父代理的作用域，并且永远不会看到它。没有什么东西会自己召唤杰夫。当模型调用该工具时，插件向正在处理的轮（最多4条，每条6000个字符）和模型发送用户消息 `content_summary`，对计划答案的结构的描述，最多600个字符（较长的字符将被拒绝，而不是剪切），发送给TypeSafe。Jev每回合被问一次：同样的总结再次重复回答，之后不同的总结没有得到新的判断。 回复是一个普通的工具结果：“纯文本”读取为没有额外的建议，任何其他选择作为部分候选，模型可能会忽略，替换或合并；Tool行显示了标题“Ask Jev about presentation”和结果元数据的结果（例如“Possible: table”），而置信度保留在元数据中，既不显示给模型也不显示在卡片上。 工具描述说调用它不是组件的先决条件，也没有提示要求模型调用它。一个缺失的键，一个错误，一个无效的答案，一个超时或一个取消的回合返回“没有可用的建议”，并且永远不会失败一个回合。 ## 切换回官方UI 取消整体选择 `@iroha1145/dsh-modern-ui` 并刷新或删除插件： ```bash dsh plugin --profile web remove @iroha1145/dsh-modern-ui ``` 取消只选择内部 `modern-ui` entry是不够的：bundle禁用了7个官方UI所有者，只有当bundle本身关闭时才返回它们。 ## 官方的桌面 DeepSeek Harness桌面应用程序在其自己的嵌入式主机上呈现相同的Web客户端，并保留插件 `desktop` 简介: 1. 打开Desktop一次，然后完全退出，这样它就可以初始化配置文件。 2. 安装与 **桌面的 `dsh` 命令** (菜单 _App→管理dsh命令…_ 把它放在终端PATH上；在Windows上是 `%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd`）. npm的 `dsh` 拒绝 `--profile desktop`. ```bash dsh plugin --profile desktop add @iroha1145/dsh-modern-ui ``` 3. 退出并重新打开桌面。桌面没有页面重载，所以切换bundle意味着重新启动应用。 要切换回来，请运行 `dsh plugin --profile desktop remove @iroha1145/dsh-modern-ui` 使用相同的命令重新启动Desktop。当选择Modern UI时，Desktop的首次运行登录被记录为跳过，因为它的最后一步编写了这个bundle取代的官方聊天设置；在“设置”→“常规”下调整工作细节和使用情况显示。本地桥接(将文件拖出到操作系统，多个窗口， _打开……_（本机目录选择器）尚未验证；看到 [桌面验收记录](https://github.com/iroha1145/DSH-Modern-UI/blob/main/docs/compatibility/desktop-0.2.1-rc.5.md). ## 兼容性 中声明了支持的主机版本 `dsh.compatibleHost` 并且在 [兼容性矩阵](https://github.com/iroha1145/DSH-Modern-UI/blob/main/docs/compatibility.md). ## 已知的限制 - 更改bundle选择需要刷新浏览器（在Desktop中重新启动应用程序）。 - git托管安装(`dsh plugin add github:...`)不支持；使用这个NPM包或 `modern-ui.tgz` 附在每个GitHub版本上。 - 会话级web交换机(`/web on|off`)退休；Web工具遵循官方插件配置。 ## 许可证 麻省理工学院。来自DeepSeek Harness和其他项目的部分保留了它们的通知 `THIRD_PARTY_NOTICES.md` 和 `licenses/`. ## 常见问题 ### @iroha1145/dsh-modern-ui 是什么？ 现代UI浏览器扩展为未经修改的官方DSH发布 ### 如何安装 @iroha1145/dsh-modern-ui？ 在项目目录运行 npm install @iroha1145/dsh-modern-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.3\.0）、react-dom（^18\.3\.0）、@deepseek-ai/cordis（^4\.0\.5）、@deepseek-ai/dsh-llm（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-web（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-brand（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-scope（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-tools（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-session（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-timeout（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/schemastery（^3\.18\.5）、@deepseek-ai/dsh-app-boot（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-attachment（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-http-proxy（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-subprocess（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-credentials（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-util-values（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-atomic-write（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-mcp-resources（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-plugin-market（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-system-prompt（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-chat（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-host-webserver（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-plugin-manager（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-slots（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-theme（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-connection（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-settings（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-subagent（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-launch-environment（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-session-persistence（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-attachment（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-conversation（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-experimental-translator（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-model-selection（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 modern-ui-data，可以用 npx modern-ui-data 直接运行。 ### @iroha1145/dsh-modern-ui 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @iroha1145/dsh-modern-ui 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @iroha1145/dsh-modern-ui 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @iroha1145/dsh-modern-ui 可以商用吗？ @iroha1145/dsh-modern-ui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @iroha1145/dsh-modern-ui 还在维护吗？ 最新版本 0\.1\.5 发布于 2026/11/01（2 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。