web-app 使用指南
dsh 的 Web 表层组合包:在 base 之上挂载 Web 宿主、Web 服务器、API 网关、浏览器插件清单与前端静态回退席位,并提供 dsh --profile web 命令行参数解析与启动 URL 输出
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
Deepseek-Harness-Desktop(vendor/deepseek-harness/packages/bundle/web-app)
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @deepseek-ai/dsh-web-app
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 官方界面 — 对话、工具调用、审批就是
dsh web,没有另做一套聊天页。 - Git — 标题栏切分支、提交、推送、开变更请求。
- 文件与终端 —
Ctrl+\打开右栏(Files / Diff / Browser / Agents);Ctrl+`打开底栏终端,选区可送进对话。 - 模型 — 第三方思考强度、识图兜底;最新一条用户消息可改完再发。
- 外观 — 浅色 / 深色主题。壁纸在外观里选或点「浏览」打开图库(分类、搜索、收藏,确认后按窗口比例裁切);毛玻璃和像素化也在外观里调。
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
装上这个 bundle 之后会得到 dsh --profile web 那个浏览器界面吗?
是。patch 把 webserver、API 网关、workspace、投影缓存、存储、浏览器插件清单以及前端 dist 回退席位都挂上,再由 web-runtime 粘合插件解析构建产物并打印 dsh web: http://127.0.0.1:3080 URL 行。
需要单独构建一次前端 dist 才能用吗?
是。runtime 粘合插件通过 require.resolve('@deepseek-ai/dsh-web-frontend/dist/index.html') 定位 dist,未构建时会在激活阶段直接报错并提示先 pnpm run build,没有从源码服务的回退。
启动后我想换端口或者只允许特定 host 访问,应该怎么写?
用 CLI 标志:dsh --profile web --port 8080 --host 127.0.0.1,可重复 --trusted-host app.internal 把主机名/IP 加入 /api 浏览器信任栅栏;这些都是 web-startup 行在加载阶段解析,不写进 patch。
这个 bundle 跟 dsh-base 是什么关系?
必装叠加:base 是任何 profile 的公共地基(模型、工具、沙箱、遥测、持久化),web-app 在 base 之上插入 Web 特有的宿主持行(webserver、api-gateway、storage、workspace)、命令行列与浏览器插件清单,并禁用 base 中将被 agent preset 接管的那批 agent-plane 工具行。
--host 0.0.0.0 为什么不让用?
CLI 在 publish webStartup 之前显式拒绝这个值,避免绑定全网卡暴露代码执行给整个网络;改用 --host 127.0.0.1 或具体的 LAN IP 即可。
启动后我在浏览器里访问不到 LAN IP 上的页面,怎么办?
把对应的 LAN 网卡 IP 追加到 --trusted-host 中即可,浏览器信任栅栏和 UI 列出来的 LAN URL 都使用同一份快照。变更只在启动时采样一次,运行中网卡变化不会被重新公告。
Agent 用的 bash / fs / skill 工具去哪了?
这部分 agent-plane 工具行在 patch 里被显式 disabled: true,原因是它们改由 agent preset 在每个会话里按需挂载。基座的进程级服务(shell-env、子代理注册表、目标服务、远程 /api 网关等)保留在 host 平面,由 web 表面继续使用。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.6+
- Node: >=22.19.0
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则