跳到主内容

dsh-web-ui-settings 使用指南

在 DSH Web 设置页加一个「Web UI 插件」一级分区，归组 dsh-web-ui 全家桶插件的开关与配置；并提供 rc.6 兼容设置桥接，让旧版宿主也能读写这些配置。

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

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

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-client-ui-web-ui-settings

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

— 源: plugins.install

关键要点

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后设置页里看不到这个分区怎么办？

需要重启 dsh web 才会出现；分区依赖官方的 @deepseek-ai/dsh-client-ui-settings 提供 settings.section 插槽，如果宿主未装该 SDK，分区不会显示（README.zh.md:47）。

这个插件需要我额外配置什么吗？

默认无需任何配置即可用。若要让同主机的反向代理代为转发，需要在 profile 里写 trustedProxyHosts 与 proxyTokenEnv（后者是承载令牌的环境变量名），并设置同名环境变量。

我用的是 rc.7 及以上的宿主，还需要本桥接吗？

多数情况下不需要。当宿主 apiproxy 已原生暴露相应命名空间时，浏览器侧自动走官方 settings scope，本包提供的桥接不会激活（src/client/compat-settings-scope.ts:230-262）。

卡片显示「未向设置页暴露」怎么办？

表示当前宿主 apiproxy 不识别该命名空间。本包提供的回环桥接会让本机的浏览器优先接管，但仍要求该命名空间已在宿主 settings 中注册（allowlist.ts:85-94）。

trustedProxyHosts 该怎么填？

必须是规范化的 host[:port]，比如 dsh.example.com 或 127.0.0.1:8443。解析时会校验大小写与端口范围，不合规会启动失败（bridge.ts:88-102）。

我能否把反向代理令牌明文写到 profile 里？

不行。profile 只允许写 proxyTokenEnv（环境变量名），不允许写真实令牌；令牌从进程环境变量读取，避免泄露到配置仓库（README.zh.md:43 / src/index.ts:36-39）。

「社区插件」卡里的条目安全吗？

该卡片只是链接列表，索引条目由贡献者自行登记，本包不收录、不打包第三方代码；安装前请自行评估作者与仓库（locales.ts:39-41）。

怎么卸载？

用 dsh plugin --profile web remove 卸载即可。本插件不写本地存储，也不创建宿主外的资源，卸载后无残留数据。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >=0.1.0-rc.7（package.json devDependencies 中 @deepseek-ai/dsh-* 系列均要求 ^0.1.0-rc.7）
  • Node: ^22.19 || >=24（据 packages/AGENTS.md:9；本包 package.json 未声明 engines）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则