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

快速上手

deepseek-harness-ux（packages/bundle/web-app）

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @deepseek-ai/dsh-web-app

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

— 源: plugins.install

关键要点

• Agent Loop、模型路由、工具、权限、沙箱和 Session Log 仍沿用 DeepSeek Harness 的执行方式。
• 原始思考、上下文、命令和工具证据没有被删除，只是收进“运行详情”。
• 展示辅助不会修改 System Prompt、用户消息、工具、原始回答或会话历史。
• Session Log 默认仍保存在本地。
• 这是基于上游源码快照维护的社区版本，不会自动获得官方后续的修复、兼容性更新和安全更新。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上之后怎么打开网页界面？

在 DSH 安装目录下执行 dsh --profile web 即可。终端会打印一行 dsh web: http://127.0.0.1:3080（绑定全网卡时还会附 (LAN: http://<你的局域网IP>:3080)），浏览器访问这个地址就能进入 GUI。

端口被占用了怎么办？

启动时加 --port 0 让操作系统随机分配空闲端口，或显式指定 --port 8080 换一个端口；绑定地址可以用 --host 0.0.0.0 让局域网或公网机器也能访问。

我从另一台机器访问这个 Web 界面，浏览器一直报 host 不被信任？

那是 /api 网关的浏览器信任栅栏在拦请求。启动时加 --trusted-host 你的主机名或IP:端口（可重复），或在部署的 patch 中把 connection.trustedHosts 扩展成包含你的来源；IP 字面量 host 不需要带端口也能通过。

终端只打印 dsh web: http://127.0.0.1:3080，没有 LAN 地址，怎么从别的设备访问？

只有当你启动时用了 --host 0.0.0.0 才会额外打印 LAN 地址。其他情况下只打印本机回环地址，需要让别的设备访问必须显式 bind 全网卡。

启动时报 frontend dist not built; run pnpm run build from the repository root first 怎么办？

这意味着这个仓库 checkout 还没编译前端 dist。在仓库根目录执行 pnpm run build（包含 build:lib 与 build:web），等前端 dist 生成后再重新 dsh --profile web。

dsh-base 已经装过了，还要再装 web-app 吗？

需要。base 是所有 profile 的公共地基，不带 Web 宿主行；web-app 是在 base 之上叠加 webserver、API 网关、存储、投影缓存、浏览器插件名录以及 web-runtime 粘合插件的那一层，缺了它 dsh --profile web 打不开。

能用 dsh --profile web --help 看启动参数吗？

可以。--help 不会绑定端口或打印 URL，只列出 --host、--port、--trusted-host 等可用参数与示例。

默认的 system persona 能换吗？

能。在更上层 profile 的 cordis.patch.yml 用 id: system-prompt 整行覆盖 config.persona，或换用 Agent Preset 中的 system 字段；web-app 这一层只提供默认 You are a coding agent powered by the {{model}} model. Your working directory is {{cwd}}.。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则