本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-genui

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

常见问题

什么时候应该让 Agent 生成界面，而不是只回文字？

当任务涉及"看清一个复杂关系"或"同时做几项相互影响的选择"时，例如挑日历时段、调参观察因果、追踪代码路径。普通问答、改写、摘要、简单列表仍返回文字（src/prompt.ts:12-14, README.md:14-16）。

生成的应用会获取我的 MCP 凭据或 Cookie 吗？

不会。生成代码在 iframe 沙箱中运行，只能调用生成时显式声明的工具或 HTTPS 接口；MCP 凭据不会进入生成代码，外部请求必须是无凭据的公开 HTTPS 且走 DNS 私网地址过滤（src/runtime/external.ts:13-40, README.md:66-70）。

应用更新失败会怎样，旧版本会被覆盖吗？

不会。每次更新产生新版本，编译失败时只把该版本标为 failed 并保留最后一个 ready 版本；你可以用 genui_rollback 主动回滚到任一 ready 版本（src/artifacts/registry.ts:140-141, 211-236, README.md:67-68）。

任务状态和已授权权限会保留多久？

都是 7 天：任务状态自最后一次更新起 7 天后过期，权限授予 7 天后过期；过期后 Agent 用 genui_state_read 读不到数据，需要重新保存或重新授权（src/lifecycle.ts:1, src/runtime/server.ts:253-264）。

支持 TUI 终端 profile 吗？

支持但不嵌入 Canvas。TUI profile 用 genui_create 时选 local-link 即可返回 localhost 链接，Agent 在下一轮用 genui_state_read 读取页面上保存的内容（README.md:46-61, 111, src/tools.ts:336-385）。

DESIGN.md 怎么用，能换默认风格吗？

在设置 → 插件 → 插件配置里切换默认设计：自动选、Material 3、Apple Human Interface、shadcn/ui 或导入自定义 DESIGN.md。已生成的应用保留原设计，后续新建的应用才使用新默认（README.md:90-94, src/designs/presets.ts:6-120）。

单次应用源码有多大限制？

默认 1 MiB，最多可调到 16 MiB。每个应用必须有 src/main.tsx，且允许的导入被白名单限定为 react、react-dom/client、lucide-react、recharts、date-fns、zustand、framer-motion 和 @dsh-genui/sdk（src/config.ts:18, src/artifacts/builder.ts:7-17）。

怎么卸载这个插件？

运行 dsh plugin --profile web remove github:pengyue-polaron/deepseek-harness-genui 并重启 dsh web；存放在 .dsh/genui 下的工件记录与状态会随 TTL 到期自动清理（src/artifacts/registry.ts:87-102, src/lifecycle.ts:1）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.6
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则