Skip to content
Back to search

deepseek-harness-genui

Task-specific React apps for DeepSeek Harness with state carried into the next Agent turn

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pengyue-polaron--deepseek-harness-genui/badge.svg)](/listings/pengyue-polaron--deepseek-harness-genui)

HTML

<a href="/listings/pengyue-polaron--deepseek-harness-genui"><img src="/api/listings/pengyue-polaron--deepseek-harness-genui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js `^22.19.0 || ^24.0.0` and a supported DeepSeek Harness Web profile.

dsh plugin --profile web add dsh-plugin-genui
dsh --profile web

v0.15 supports Inline, Canvas, fullscreen, and localhost on the tested Harness versions listed in the [release notes](docs/release-notes-v0.15.1.md). TUI/headless profiles are not supported. The local compiler uses WebAssembly and needs no install-script approval. Plugin users do not need Chrome or Chromium.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # DeepSeek Harness GenUI
  2. [![DSH Insights health](https://dsh-insights.com/badge/pengyue-polaron/deepseek-harness-genui.svg)](https://dsh-insights.com/p/pengyue-polaron/deepseek-harness-genui/)
  3. English | [简体中文](README.zh-CN.md)
  4. [![npm version](https://img.shields.io/npm/v/dsh-plugin-genui?logo=npm)](https://www.npmjs.com/package/dsh-plugin-genui)
  5. [![Node.js](https://img.shields.io/badge/Node.js-22.19%20%7C%2024-339933?logo=nodedotjs&logoColor=white)](package.json)
  6. [![Paper](https://img.shields.io/badge/paper-arXiv%3A2608.29387-B31B1B?logo=arxiv)](https://arxiv.org/abs/2608.29387)
  7. [![dsh.so risk](https://www.dsh.so/badge/deepseek-harness-genui.svg)](https://www.dsh.so/artifact/deepseek-harness-genui/)
  8. [![License](https://img.shields.io/badge/license-MIT-202124)](LICENSE)
  9. <img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/assets/hero-en.png" width="1280" alt="DeepSeek Harness with an interactive day plan inline and a scientific model open in Canvas">
  10. DeepSeek Harness GenUI lets an Agent build a focused interface when a task is awkward in text. The Coding Agent writes ordinary React + TypeScript—not a component-tree DSL—and the interface can save user selections for the next Agent turn.
  11. The result is a task-specific app that can explain a difficult relationship, collect connected choices, or continue a tool-backed workflow without asking the user to repeat their input.
  12. Related research: [*EvoGenUI-Bench: Evaluating LLMs as Multi-Turn Generative UI Assistants*](https://arxiv.org/abs/2608.29387).
  13. ## Install
  14. Requires Node.js `^22.19.0 || ^24.0.0` and a supported DeepSeek Harness Web profile.
  15. ```sh
  16. dsh plugin --profile web add dsh-plugin-genui
  17. dsh --profile web
  18. ```
  19. v0.15.2 supports Harness `0.2.1-rc.2` (npm `latest` checked on 2026-10-23) and `0.2.1-rc.3` (`next`), alongside the previously tested hosts. See the [compatibility report](docs/compatibility-2026-10-23.md) for validation and source-install instructions. Inline, Canvas, fullscreen, and localhost are supported. TUI/headless profiles are not supported. The local compiler uses WebAssembly and needs no install-script approval. Plugin users do not need Chrome or Chromium.
  20. ## Where It Helps
  21. Use an interface when the user needs to see a complex relationship or make several connected choices. Plain questions, rewriting, summaries, and simple lists should stay in prose.
  22. <table>
  23. <tr>
  24. <td><strong>Pick calendar slots</strong><br><br>Select useful writing blocks and save them to the task. A later calendar action remains separate and permission-gated.</td>
  25. <td><img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/screenshots/en/calendar-planner.jpg" width="280" alt="English interface for choosing three writing slots"></td>
  26. </tr>
  27. <tr>
  28. <td><strong>Explore photosynthesis</strong><br><br>Move four causal controls and see the limiting step change immediately.</td>
  29. <td><img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/screenshots/en/photosynthesis-explorer.jpg" width="280" alt="English interactive photosynthesis model with four causal controls"></td>
  30. </tr>
  31. <tr>
  32. <td><strong>Trace a code path</strong><br><br>Turn a source-grounded CLI explanation into a local explorer of files, functions, and branches.</td>
  33. <td><img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/screenshots/en/code-path-explorer.jpg" width="280" alt="English source-grounded code path explorer returned from a CLI request"></td>
  34. </tr>
  35. </table>
  36. ## The Core Loop
  37. 1. The Agent writes and builds a React + TypeScript app for the current task.
  38. 2. The user saves meaningful values such as selections, form answers, drafts, or progress.
  39. 3. A later Agent turn reads those values and continues the task.
  40. 4. Connected tools and public HTTPS routes must be declared. Harness asks for task-scoped access, and undeclared calls are blocked.
  41. Later edits update the same app. A candidate that fails the build or source checks does not replace the last working version; a crashing version is quarantined and rolled back when possible.
  42. ## Inline & Canvas
  43. | Inline | Canvas |
  44. | --- | --- |
  45. | <img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/screenshots/en/code-path-inline.jpg" width="620" alt="An interactive code path shown inline in a DeepSeek Harness conversation"> | <img src="https://raw.githubusercontent.com/pengyue-polaron/deepseek-harness-genui/main/screenshots/en/code-path-canvas.jpg" width="620" alt="The DeepSeek Harness sidebar, conversation, and code-path explorer visible together in the right-side Canvas"> |
  46. | A compact control or focused choice. | More room without covering the conversation. |
  47. Inline, Canvas, fullscreen, and localhost are different surfaces over the same task state.
  48. ## Try It
  49. Start a new Web session and paste a prompt:
  50. ```text
  51. Plan a Saturday route with a museum, a riverside garden, and dinner. Build an
  52. interface where I can change the times and make the garden optional.
  53. ```
  54. ```text
  55. Build an interactive double-slit experiment. Let me change wavelength, slit
  56. spacing, and screen distance and see the interference pattern update.
  57. ```
  58. After saving something in the interface, ask:
  59. ```text
  60. What did I just choose in the interface? Continue from the saved result.
  61. ```
  62. The useful proof is not only that an interface appears—it is that the next Agent turn can continue from the interaction.
  63. ## Why Code-First
  64. Component-schema renderers are usually better for predictable cards, tables, charts, and forms. This plugin is for structures that cannot be known in advance: simulations, spatial tools, source explorers, and multi-step task apps whose saved result must continue the same Harness task.
  65. The trade-off is deliberate: generated code is more expressive than a fixed component catalog, while this project remains DeepSeek Harness-specific rather than a cross-client UI protocol. See [`dsh-genui`](https://github.com/omdsh-dev/dsh-genui), [`dsh-visualize`](https://github.com/Nagi-ovo/dsh-visualize), [A2UI](https://a2ui.org/introduction/what-is-a2ui/), and [MCP Apps](https://modelcontextprotocol.io/extensions/apps/overview) for related approaches.
  66. ## DESIGN.md
  67. Open **Settings → Built-in plugins → Generated app design** on current hosts (or **Settings → Plugins → Plugin configuration** on older hosts) to choose automatic design selection, use `material-3`, `apple-human-interface`, or `shadcn-ui`, or import a custom `DESIGN.md`. The file controls visual language, not page structure; React remains free to implement the interaction the task needs.
  68. ## Safety
  69. Generated code runs in an opaque-origin sandbox. A trusted parent keeps the real task capability token and brokers only saved state, declared tools, and declared credential-free public HTTPS routes. MCP credentials never enter generated code. Temporary links and grants expire after 7 days, as does task state 7 days after its last update.
  70. This boundary protects host credentials and capabilities, but it cannot make malicious code safe to trust with data already authorized for it to read. Do not put secrets in generated-app state or grant access to data the app should not display. See [Security](SECURITY.md) for the threat model.
  71. ## Development
  72. Building from source requires pnpm 11:
  73. ```sh
  74. pnpm install
  75. pnpm run typecheck
  76. pnpm run build
  77. pnpm test
  78. pnpm run package:plugin
  79. ```
  80. [Acceptance scenarios](examples/real-user-scenarios.md) · [Release notes](docs/release-notes-v0.15.2.md) · [Contributing](CONTRIBUTING.md) · MIT
  81. Listed on [dsh-market](https://dshmarket.com/p/pengyue-polaron/deepseek-harness-genui/) · [dsh.so](https://www.dsh.so/artifact/deepseek-harness-genui/) · [awesome-dsh-plugin](https://awesome-dsh-plugin.com/p/pengyue-polaron/deepseek-harness-genui/) · [dsh.plus](https://www.dsh.plus/en/plugins/deepseek-harness-genui/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.