DSH / BUNDLE / BUNDLES

dsh-web-app

v0.1.0-rc.5deepseek-ai / deepseek-harness47f943859b

内置 Profile 层组合包组合包与其他模块内置源码可配置
运行时构成
HOSTCLIENTUITOOLDATAFLOW

概览

dsh-web-app

源码级技术说明dsh 浏览器表层组合包。cordis.patch.yml 叠加在 dsh-base 之上:设置 coding persona,插入 Web 宿主行(webserver、API 网关、workspace、投影缓存、存储)、浏览器插件名录与始终挂载的客户端插件重载链(dsh-client-hmr,在重建 watcher 改写客户端 bundle 之前保持空闲),并挂载本包的 web-runtime 粘合插件(配置为 {printUrl, surfaceContext, trustedHosts})。该插件通过 @deepseek-ai/dsh-web-frontend 的 exports 解析已构建的前端 dist,只采样一次依赖 bind 的 LAN 信任信息并将其作为 webRuntime 提供给浏览器信任栅栏和客户端名录,挂载 frontend-static 回退席位所有者,在 surfaceContext 为 true 时注册 Harness 源码与 Web 表层提示词段落,以及 bash 可见的 DSH_WEB_URL 运行时变量,并在 printUrl 为 true 时等自身的 Loader 配置树结算后再打印 dsh web: URL 行,避免兄弟行失败时公告一个已失效的应用。本组合包还持有应用命令行:普通 web-startup 提供方(src/startup.ts)注入 ctx.cmdlineArgsdsh-cmdline),解析 --host--port、可重复的 --trusted-host 以及应用自己的 --help,再提供 webStartup。它会在发布该服务前拒绝 --host 0.0.0.0,因为 CLI 目前有意不支持绑定所有网络接口。由 flag 配置的行会注入该服务,并在惰性配置中直接读取它,因此参数解析完成前不会有任何东西绑定端口,dsh --profile web --help 也不会启动服务器。dsh-headless 是同一 base 之上的同级表层,不挂载本组合包。展开完整技术说明收起技术说明
dsh 浏览器表层组合包。cordis.patch.yml 叠加在 dsh-base 之上:设置 coding persona,插入 Web 宿主行(webserver、API 网关、workspace、投影缓存、存储)、浏览器插件名录与始终挂载的客户端插件重载链(dsh-client-hmr,在重建 watcher 改写客户端 bundle 之前保持空闲),并挂载本包的 web-runtime 粘合插件(配置为 {printUrl, surfaceContext, trustedHosts})。该插件通过 @deepseek-ai/dsh-web-frontend 的 exports 解析已构建的前端 dist,只采样一次依赖 bind 的 LAN 信任信息并将其作为 webRuntime 提供给浏览器信任栅栏和客户端名录,挂载 frontend-static 回退席位所有者,在 surfaceContext 为 true 时注册 Harness 源码与 Web 表层提示词段落,以及 bash 可见的 DSH_WEB_URL 运行时变量,并在 printUrl 为 true 时等自身的 Loader 配置树结算后再打印 dsh web: URL 行,避免兄弟行失败时公告一个已失效的应用。本组合包还持有应用命令行:普通 web-startup 提供方(src/startup.ts)注入 ctx.cmdlineArgsdsh-cmdline),解析 --host--port、可重复的 --trusted-host 以及应用自己的 --help,再提供 webStartup。它会在发布该服务前拒绝 --host 0.0.0.0,因为 CLI 目前有意不支持绑定所有网络接口。由 flag 配置的行会注入该服务,并在惰性配置中直接读取它,因此参数解析完成前不会有任何东西绑定端口,dsh --profile web --help 也不会启动服务器。dsh-headless 是同一 base 之上的同级表层,不挂载本组合包。
BUILT-IN / PROFILE LAYER
随 Profile 使用,无需单独安装

dsh.bundle manifest 只证明这是 DSH profile 的激活层,不代表该 Git 子目录可以独立安装。

能力

它贡献了什么

HostCordis loadable可配置
Client / UIHost only0 contributions
Model tools0None declared
Profile stateenabledweb

README / ZH

插件文档

@deepseek-ai/dsh-web-app

English | 中文

dsh 浏览器表层组合包。cordis.patch.yml 叠加在 dsh-base 之上:设置 coding persona,插入 Web 宿主行(webserver、API 网关、workspace、投影缓存、存储)、浏览器插件名录与始终挂载的客户端插件重载链(dsh-client-hmr,在重建 watcher 改写客户端 bundle 之前保持空闲),并挂载本包的 web-runtime 粘合插件(配置为 {printUrl, surfaceContext, trustedHosts})。该插件通过 @deepseek-ai/dsh-web-frontend 的 exports 解析已构建的前端 dist,只采样一次依赖 bind 的 LAN 信任信息并将其作为 webRuntime 提供给浏览器信任栅栏和客户端名录,挂载 frontend-static 回退席位所有者,在 surfaceContext 为 true 时注册 Harness 源码与 Web 表层提示词段落,以及 bash 可见的 DSH_WEB_URL 运行时变量,并在 printUrl 为 true 时等自身的 Loader 配置树结算后再打印 dsh web: URL 行,避免兄弟行失败时公告一个已失效的应用。本组合包还持有应用命令行:普通 web-startup 提供方(src/startup.ts)注入 ctx.cmdlineArgsdsh-cmdline),解析 --host--port、可重复的 --trusted-host 以及应用自己的 --help,再提供 webStartup。它会在发布该服务前拒绝 --host 0.0.0.0,因为 CLI 目前有意不支持绑定所有网络接口。由 flag 配置的行会注入该服务,并在惰性配置中直接读取它,因此参数解析完成前不会有任何东西绑定端口,dsh --profile web --help 也不会启动服务器。dsh-headless 是同一 base 之上的同级表层,不挂载本组合包。

模型体验

Harness 源码与 Web 表层上下文

模型看到的内容

surfaceContext 为 true 时,harness:source 段落标明磁盘上的 Harness 实现,但不会声称它就是工作目录;全局段落 app:web-surface(顺序 −98)则向模型说明 GUI:规范的本地 URL、「this page」指代什么、更新约定(重载接收端始终开启;无刷新重载还需要 pnpm run dev:web watcher),以及不要启动替代服务器的指令。DSH_WEB_URL 还会连同描述出现在受管 bash 环境中,每次调用时从运行中的服务器解析。当它为 false 时,这两个段落和该变量都不会注册。

Token 影响

每个会话一行源码说明和一段提示词,外加两行受管环境变量;每个进程内保持恒定。

KV Cache 影响

该提示词段落位于系统提示词靠前位置,且在进程整个生命周期内稳定(端口是启动期事实),因此不会使跨轮次缓存失效。

已知限制与延期工作

  • 前端 dist 必须已构建:对 dist 的 require.resolve 在激活时明确报错并给出构建提示;没有从源码直接服务的回退路径。
  • lanAddresses 是启动期快照:启动后的网卡变化不会重新公告;打印的 LAN URL 始终与配置的信任栅栏一致。

LIMITATIONS

已知限制

- **前端 dist 必须已构建**:对 dist 的 `require.resolve` 在激活时明确报错并给出构建提示;没有从源码直接服务的回退路径。 - **`lanAddresses` 是启动期快照**:启动后的网卡变化不会重新公告;打印的 LAN URL 始终与配置的信任栅栏一致。