web-app 使用指南

DSH 浏览器表层组合包，在 dsh-base 之上叠加 Web 宿主与浏览器插件，注册前端 dist、URL 输出与 DSH_WEB_URL 变量。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

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

快速上手

— 源: plugin_wiki.wiki_content

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

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

— 源: plugins.install

真正的桌面客户端——Electron 将本地 Harness 运行时打包到 macOS、Windows 与 Linux，负责原生窗口行为，并在启动异常时提供恢复页面。
更安静的 CodePilot 风格界面——统一 Token、圆角、菜单、Hover、设置卡片、Markdown、对话/轨迹切换与平台化标题栏。
服务商与模型管理——连接受支持的服务商，声明 OpenAI 兼容接口，将凭证和普通设置分开管理，浏览实时模型目录，并识别支持图片输入的模型。
不杂乱的工作区上下文——对话列表可展示分支、状态、提醒摘要、模式与模型，Files 则作为真正的右侧栏打开。
插件优先的扩展方式——主题、Worktree 侧栏、Schedule 摘要与 Session 日志导出仍是 Cordis/DeepSeek Harness 配置行，而不是写死在桌面端的业务逻辑。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个 bundle 是什么，有什么用？

它是 dsh 的「Web 表层」组合包，在 dsh-base 之上叠加一层浏览器界面所需的全部宿主与浏览器插件，安装后通过 dsh --profile web 启动一个本地 GUI 服务。

和 dsh-headless、dsh-desktop 是什么关系？

这三个是 dsh-base 上的同级表层组合包。web-app 是浏览器表层，headless 是无界面表层，desktop 是桌面应用；它们互不嵌套，按 --profile 选其一加载。

启动后会自动打开浏览器吗？能不能关掉？

这个 bundle 本身不负责拉起系统浏览器，只在端口就绪后打印一行 dsh web: http://127.0.0.1:<port>。是否由其它层（如 desktop 或外部 supervisor）打开浏览器不在此 bundle 范围内。

为什么 --host 0.0.0.0 被拒绝？

bundle 当前有意不支持绑定所有网卡（会在激活前报 usage error 并退出），因为这会把远程代码执行能力暴露到网络。请使用 127.0.0.1 或 LAN 信任主机模式。

报「frontend dist not built」该怎么办？

这表示仓库未构建前端 dist。此 bundle 把 dist 路径当作工作区内部知识，要求在仓库根先执行 pnpm run build，然后再启动 dsh --profile web。

提供的 DSH_WEB_URL 变量是干什么用的？

bundle 会注册一个 bash 可见的运行时变量 DSH_WEB_URL，每次调用时由当前监听的本地 URL 解析，模型与脚本可用它定位当前 GUI。

Web 和 dsh-base 共享的工具/工具栏为什么有些被禁用了？

Web 把 agent 平面（tool-bash、tool-pwsh、tool-fs、tool-skill、tool-subagent 等）移到会话级别的 agent 预设中，宿主平面只保留 registry 与服务，因此联网后的 agent 由各自 preset 决定如何装配。

HMR 好像没在工作？

当前 hmr 行在 cordis.patch.yml 中被置为禁用，并标注 TODO：等 Web 端重载生命周期测试完成后重新启用；客户端插件热重载需配合 pnpm run dev:web watcher 才会触发。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则