前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过扩展组件丰富智能体能力。在默认对话中，AI 的回复往往局限于文本、Markdown 代码块或静态表格。用户需要手动复制粘贴数据、在脑海中计算或逐项填写表单，这增加了交互成本。
dsh-genui 插件将这种单向的文字输出转变为双向的交互界面。它允许 DSH 在对话中直接渲染图表、表单、计算器等 UI 元素，用户的点击或输入会回流到对话流中，供模型继续处理。
插件定位¶
dsh-genui 是 DeepSeek Harness 的一个客户端插件，由开发者 lhuans 维护，遵循 MIT 协议。它通过在 DSH 前端注入渲染逻辑，将模型返回的指令转化为可视化的交互组件。
核心功能¶
该插件支持将自然语言指令直接转换为多种 UI 组件：
- 交互图表：支持柱状图、折线图、饼图、环形图、雷达图、仪表盘、漏斗图、散点图和瀑布图。
- 表单控件：文本框、文本域、下拉菜单、单选、复选、开关、数字步进器、日期选择器、搜索框和穿梭框。
- 小应用：计算器、BMI 计算器、货币转换器、待办事项列表。
- 数据展示与布局：支持分页与搜索的表格、树形视图、时间轴、面包屑导航、选项卡、折叠面板、卡片、轮播图和提示框。
- 多轮交互：交互动作可以回流至模型，支持构建“点击-继续”的复杂工作流。
安装与启用¶
安装过程需要确保环境依赖已就绪。
前置条件¶
- 安装 Node.js。
- 安装 pnpm（DSH 使用 pnpm 管理插件）。可通过
corepack enable或npm i -g pnpm安装，并打开新终端验证版本。 - 确保已启动 DeepSeek Harness 服务（默认运行在 http://127.0.0.1:3080）。
安装步骤¶
在终端中执行以下命令将插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-genui
安装完成后，必须重启 DSH 才能使插件生效。重启步骤如下：
- 在运行 DSH 的终端按
Ctrl+C停止服务。 - 重新启动：
dsh web。 - 刷新浏览器页面。
- 开始新的对话。
验证安装¶
在新的对话窗口中输入以下指令：
Generate a calculator
如果对话中出现了可用的计算器界面，说明插件已成功激活。
典型用法¶
无需学习特殊语法或编写 JSON，直接使用自然语言描述需求即可。
生成图表：
“Chart revenue for the last three quarters as bars, and mark year-over-year growth”
构建表单：
“Make a time-off request form with leave type, start and end date, days, and reason”
创建计算工具：
“Build a BMI calculator — enter height and weight, get the result”
制作对比表格：
“Put these options in a comparison table: price, timeline, risk”
适用场景与注意事项¶
该插件适合需要快速展示数据趋势、收集结构化输入或构建简单交互工具的场景。
注意事项：
* 插件依赖 Node.js 和 pnpm 环境。
* 安装后必须重启 DSH 进程，否则界面不会更新。
* 默认开启 GenUI 编写引导，重启后会记住上一次的选择。
总结¶
dsh-genui 通过将静态文本转化为交互组件，降低了 DSH 使用者在数据处理和表单填写上的操作成本。它保持了 DSH 原有的插件化生态理念，无需修改源码即可扩展前端渲染能力。
