DeepSeek Harness Web UI 功能异常:CLI 能用 Web 不能用、输入框消失与技能搜不到
DeepSeek Harness Web UI 功能异常,最典型的三组:技能在 CLI 能用 Web 不能用(profile 能力不一致)、报 crypto.randomUUID is not a function 后 Composer 输入框消失(明文 HTTP 非安全上下文禁用 Web Crypto)、技能菜单搜索落空(只按前缀匹配)。 按「走 HTTPS/本机访问 → 校准 profile → 用前缀搜索 → 修复图片引用」逐项解决。
DeepSeek Harness Web UI 功能异常:三个现象
三个现象互不相同:技能差异是配置问题、输入框消失是加密上下文问题、搜索落空是匹配规则问题。 逐一说明(来源):
- 技能 CLI 能用 Web 不能用——终端里技能正常,浏览器里同一技能消失或不可用,常见于同时用 CLI 和 Web UI 的场景;
crypto.randomUUID is not a function+ Composer 输入框消失——用 IP 地址走明文 HTTP 打开网页时,控制台报该错,随后输入框渲染失败、无法输入(来源);- 技能菜单搜索落空——在技能菜单里输入关键词搜不到已装的技能,或技能列表只显示前缀匹配的少数条目;
- 三者都可能被当成「Web UI 坏了」,但修复方向不同,先对号入座。
DeepSeek Harness Web UI 功能异常根因:明文 HTTP 破坏 Web Crypto + profile 不一致 + 前缀匹配
四条根因:明文 HTTP 让 Web Crypto 失效(输入框消失);CLI 与 Web 读到不同 profile(技能不一致);技能搜索只按前缀(搜不到);Markdown 图片引用损坏(图不显示)。 展开说:
- 明文 HTTP 禁用 Web Crypto——
crypto.randomUUID()只在安全上下文存在:https://,或http://localhost/http://127.0.0.1;用 IP 地址走明文 HTTP(如http://192.168.1.50:3080)不算安全上下文,crypto.randomUUID就是undefined(来源),前端脚本崩溃导致 Composer 输入框消失; - profile 能力不一致——技能由 profile 下的插件提供;CLI 与 Web UI 若读的不是同一个 profile,能力就不同(来源);
- 技能搜索只按前缀匹配——搜索逻辑按名称前缀过滤,搜中间词、别名或中文名都会落空;
- Markdown 图片引用损坏——相对路径写错、文件被移动/删除、外链失效时图片渲染不出来(来源)。
解决 DeepSeek Harness Web UI 功能异常:HTTPS/本机访问 → 校准 profile → 前缀搜索 → 修引用
按现象分流:输入框消失改安全访问方式,技能不一致校准 profile,搜索落空改用前缀,图片不显示修引用。 逐步执行:
- 改用 HTTPS 或本机访问(解决 crypto.randomUUID 与输入框消失):
- 本机使用:浏览器访问
http://localhost:3080或http://127.0.0.1:3080,属于安全上下文; - 远程使用:给 dsh web 配 HTTPS 反向代理(如 Nginx + 证书),或 SSH 端口转发后走
http://localhost:3080; - 刷新页面后输入框恢复、报错消失(来源)。
- 本机使用:浏览器访问
- 校准 profile(解决技能 CLI 能用 Web 不能用):
bash
# CLI 显式指定 web profile 再试技能 dsh --profile web- Web UI 顶部确认当前 profile 与 CLI 一致;不一致就切换;
- 确认该 profile 下插件已安装且激活,然后重启 Web 服务:终端按
Ctrl+C,再执行dsh web。
- 用前缀搜索技能(解决搜索落空)——按技能名称的开头字母搜索,例如找 MCP 类技能搜
mcp;不确定完整名称就在技能列表里翻页浏览,不依赖搜索。 - 修复 Markdown 图片引用(解决图片不显示)——检查引用路径:
- 相对路径:确认从当前文件所在目录能走到目标图;
- 绝对路径:确认文件在磁盘上存在;
- 外链:确认 URL 可访问;修复后刷新页面验证。
DeepSeek Harness Web UI 功能修复后怎么验证?访问方式、profile 与技能回归三查
修复后三查确认:访问方式是安全上下文、profile 与 CLI 一致、技能与图片都回归——三查全过才算修好。 按顺序执行:
-
确认访问方式是安全上下文——浏览器地址栏应是
https://、http://localhost:3080或http://127.0.0.1:3080;若是 IP 明文 HTTP,crypto.randomUUID报错还会复现。 -
控制台无报错——打开开发者工具(F12)→ Console,刷新页面后不再出现
crypto.randomUUID is not a function,Composer 输入框正常渲染。 -
确认 profile 一致——CLI 显式指定 web profile,并核对 Web UI 顶部当前 profile:
bashdsh --profile web dsh plugin --profile web list两者指向同一 profile、插件列表完整且激活,技能差异问题即消除。
-
技能回归——在技能菜单用前缀搜索(如
mcp)能命中,调用一次该技能正常响应。 -
图片渲染验证——有图片引用的页面刷新后正常显示;仍不显示则对照上节第 4 步逐项检查路径与外链。
注意事项:DeepSeek Harness Web UI 功能异常先对号入座
- 输入框消失先改访问方式,别急着重装——
crypto.randomUUID是安全上下文问题,不是安装问题。 - 技能在 CLI 与 Web 不一致,先对 profile,再查插件激活状态。
- 技能搜索只按前缀是设计如此,搜不到不代表技能没装。
- 技能来自插件——想装更多技能,到 DSH Plugin Hub 按分类浏览社区精选插件,一键安装。
- 其他安装报错可参考安装报错排查。

来源:dshbase 常见问题排错、deepseek-harness Discussion #4653、Mozilla MDN 安全上下文、DeepSeek Harness apps/web
常见问题
DeepSeek Harness 技能 CLI 能用 Web 不能,多数是 profile 能力不一致:CLI 与 Web UI 读到的是不同 profile 的插件与技能配置。校准到同一 profile(CLI 用 dsh --profile web,Web UI 顶部确认当前 profile 是 web)后重启 Web 服务,技能即可用(来源)。
DeepSeek Harness Web UI 报 crypto.randomUUID is not a function:crypto.randomUUID() 只在安全上下文存在(https://,或 http://localhost / http://127.0.0.1);用 IP 走明文 HTTP 访问它就不存在,前端脚本崩溃导致输入框消失。改用 https、localhost 访问,或通过反向代理提供安全上下文(来源)。
DeepSeek Harness 技能搜不到是搜索按前缀匹配:搜中间词、别名、中文名都可能落空。改成搜技能名称的开头几个字母(如搜 mcp 找 MCP 类技能),或在技能列表里翻页浏览;想装更多技能,到 DSH Plugin Hub 按分类浏览插件再装。
是。DeepSeek Harness 对话图片不显示是 Markdown 图片引用损坏(相对路径写错、文件被移动/删除、外链失效)时页面渲染不出图。检查图片路径指向的文件是否存在、是否用了绝对路径,修复后刷新页面即恢复(来源)。
相关术语
- crypto.randomUUID
- crypto.randomUUID() 是浏览器生成 UUID 的 Web Crypto API,只在安全上下文(https、localhost、127.0.0.1)存在;明文 HTTP 下它未定义,调用即报 crypto.randomUUID is not a function。— Mozilla MDN
- 安全上下文(secure context)
- 安全上下文是浏览器认为可信的浏览环境:https:// 或 http://localhost / http://127.0.0.1;用 IP 地址走明文 HTTP 不算安全上下文,Web Crypto 等能力会被禁用。— Mozilla MDN
- profile 能力
- profile 能力指某个 profile(如 web)下启用的插件与技能集合;CLI 与 Web UI 若读到不同 profile,同一技能就会出现 CLI 能用、Web 用不了的差异。— dshbase 常见问题排错
- Composer
- Composer 是 DeepSeek Harness Web UI 的消息输入区,负责接收提示词与附件;前端脚本因 crypto.randomUUID 崩溃时它会消失或无法输入。— deepseek-ai(GitHub Discussions)
来源
- dshbase 常见问题排错(Web UI 类报错)· dshbase
- deepseek-harness Discussion #4653:linux 安装后打开 web 界面报 crypto.randomUUID is not a function· deepseek-ai(GitHub Discussions)
- MDN:安全上下文(Secure contexts)定义· Mozilla MDN
- DeepSeek Harness apps/web(Web 前端源码)· deepseek-ai