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

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

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

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

— 源: plugins.install

关键要点

• Node.js ^22.19.0 || >=24.0.0
• Rust stable toolchain
• Windows：Microsoft C++ Build Tools 与 WebView2
• macOS：Xcode Command Line Tools
• Linux：WebKitGTK 4.1、Ayatana AppIndicator、RSVG 与 XDO 开发包

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

启动 dsh --profile web 时报 "frontend dist not built" 怎么解决？

需要先在仓库根目录运行 pnpm run build 把前端 dist 编出来。本 bundle 通过 require.resolve('@deepseek-ai/dsh-web-frontend/dist/index.html') 拿 dist，找不到会立刻报错并提示构建命令，不会临时从源码服务。

怎么改监听端口或绑定地址？

用命令行参数 --port <port> 和 --host <host>；端口写 0 表示让操作系统自动分配空闲端口。这两个参数由 bundle 自带的 web-startup provider 解析，并把结果作为 webStartup 服务发布给其它 row。

能不能用 --host 0.0.0.0 让局域网设备都能访问？

当前明确不支持。CLI 在 src/startup.ts:69-71 主动拒绝 --host 0.0.0.0，理由是会把远程代码执行暴露到网络。源码注释明确写了"intentionally not supported yet for safety"，需要局域网访问请走反向代理等方案。

--trusted-host 怎么用？什么时候需要它？

当浏览器访问的 Host header 不是 127.0.0.1 而是其它主机名或 IP+端口组合时，需要用 --trusted-host <authority...> 把它加入 /api 的浏览器信任栅栏（防止 DNS rebinding）。参数可重复，按书写顺序累加。

这和 dsh-headless 是什么关系？

都是叠加在 dsh-base 之上的同级表层 profile bundle。web-app 提供带 GUI 的浏览器界面，headless 是无 Host 无 Web 层的一次性任务模式，README 明确说 headless 不挂载本 bundle。

怎么关闭控制台打印的 dsh web: URL 行？

把 web-runtime row 的 printUrl 设为 false。这是非交互场景下关掉提示用的开关，URL 信息仍然可以从 webServer 服务读到。

模型在 bash 里看到的 DSH_WEB_URL 是干什么的？

这是本 bundle 在 surfaceContext 为 true 时注册的 bash 运行时变量，存当前 Web GUI 的规范本地 URL（默认 http://127.0.0.1:端口），供 bash 工具在受管环境里读出指向自身会话的 GUI。关掉 surfaceContext 也会一并关掉它。

怎么从 profile 里卸载这个 bundle？

把 dsh.profile.bundles 里 web-app 那条移除，或在你的 cordis.patch.yml 里把 web-runtime / web-startup / webserver / modules / 浏览器 roster 这些 row 全部 disabled。注意它要叠加在 dsh-base 之上，单独移除 web-app 会让 base 的 agent 平面工具回到 host 平面。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.5+（package.json#version；叠加在 dsh-base 之上）
• Node: >=22.19.0 || >=24.0.0（来自仓库根 package.json#engines）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则