前言¶
DeepSeek Harness（DSH）的 Web 界面支持通过插件换肤，但不少主题只是把深色模式换个底色，浅色与浮层、壁纸叠字可读性往往被忽略。配置里填了多个 pi-ai 模型时，官方「设置 → 模型」页也说不清哪些端点真的能对话、上下文窗口和推理档位实际接受什么。下面介绍社区插件 dsh-xingkong-theme（Nebula Core）：为 DSH Web GUI 提供深浅两套完整视觉，并附带可在设置页使用的模型探测能力。
这是什么¶
dsh-xingkong-theme 是 maintainer sayzwx 维护的 DSH 本地主题包（当前版本 1.13.0，MIT 许可证）。它面向 platform: web 的客户端，通过 cordis.patch.yml 注册为 xingkong-theme，在对话界面背后使用无缝循环星云壁纸，并用 74 个 design token（另含 7 个浮层变量）覆盖明暗两套配色。
核心功能¶
深浅两套主题，而非「深色换底」¶
README 将深色模式称为 深空观测站，浅色称为 黎明星云。浅色使用单独设计的 4K 程序化星云壁纸（长石蓝紫天空、青色电离核心等），不是把深色图去饱和。浮层（设置弹窗、菜单、Popover、Toast）通过 --dshx-float-* 与 {light, dark} 双值联动，避免浅色下仍出现深色弹窗。
壁纸与可读性¶
- 动态星云：24 秒无缝循环视频，host 半身经 HTTP 供给，支持 Range；深色
nebula.mp4，浅色nebula-light.mp4，JPEG 作 poster 与兜底。 - v1.13.0 对「字压在照片上」做了重做：浅色正文改为白字 + 模糊深影（README 给出同区域对比度约 4.4:1），刻意不用
-webkit-text-stroke描边，以免小字号中文内格被吃瘦。 - 底部状态条与消息操作行从中蓝改为白字 + 投影；SVG 图标用
drop-shadow。 - 阅读区放宽官方 920px 上限至
min(1180px, 100%-96px)；composer 用每模式变量恢复不透明底座，避免壁纸穿透。
模型检验面板（v1.11.0 起）¶
在官方「设置 → 模型」页每个 pi-ai 提供商卡片上，通过扩展席位 settings.models.provider-card（key: llm-pi-ai）渲染探测 UI。探测在 host 半身执行（密钥不进入渲染进程；模型端点无 CORS 时由 host 代发请求），浏览器侧负责 UI 与约 1s 轮询。
官方页面难以直接给出的三类信息，探测会尝试回答：
- 哪些模型真的可用：对每个模型发
max_tokens: 1的最小请求，区分可用、未开通、额度耗尽、非对话模型等。 - 上下文窗口与输出上限：优先请求
{origin}/api/v1/models；无目录时用超界max_tokens从 400 报错推断输出上限。 - 推理等级：逐档实测
reasoning_effort（off→none / minimal / low / medium / high / xhigh / max），只展示端点实际接受的档位（README 写明推理等级不在官方可编辑字段之列）。
两种模式：快速筛查（每模型 1 请求）与 完整检验（存活、输出上限、逐档，存活模型最多约 9 请求）。
包结构（与官方主题包同构）¶
host 提供 4 条资源路由（深/浅 × 图/视频）及模型探测 API（/xingkong-model/ping|probe/start|probe/status|probe/cancel）；client 调用 ctx.theme.overrideTokens('xingkong', …) 并挂载动态 <video> 与检验面板。明暗切换优先订阅 ctx.on("theme/change")，并监听 data-ds-theme-source 等信号兜底。
安装与启用¶
该主题是 本地包，README 明确不走 registry，不要手工把目录抄进 node_modules（普通目录会导致加载器一直停在旧字节，表现为改源码无效果）。正确做法是用仓库自带的部署脚本复刻官方 junction 布局：
bash deploy.sh # 部署 / 更新
bash deploy.sh --check # 只校验，不改动
bash verify.sh # 语法 / CSS / 单元 / 部署链 / profile 五道门禁
deploy.sh 会镜像到 .generations/、junction 到 node_modules、在 cordis.patch.yml 注册，并清理 .dsh-market/hot-*.yml 中的重复登记。改完源码后重跑 deploy.sh 并 重启 DSH。
启动后可在 harness 日志中查找 host 半身就绪行（Windows 路径示例见 README）：
[xingkong-theme] host half active (4/4 asset routes registered)
更省事可运行 bash verify.sh，它会 import 部署产物并断言部署的 client.js 与源码逐字节一致。
典型用法¶
- 克隆或下载 sayzwx/dsh-xingkong-theme 到本机（本文不展开 git 命令；以你现有的源码目录为准）。
- 在 DSH profile 对应环境中执行
bash deploy.sh，重启 DSH。 - 在 Web GUI 中切换系统/应用明暗主题，观察星云视频与 token 是否随
theme/change联动。 - 打开 设置 → 模型，在 pi-ai 提供商卡片上使用模型检验面板，按需选「快速筛查」或「完整检验」，查看可用性、上下文与推理档位结果。
卸载时：删除 profiles/web/cordis.patch.yml 里 xingkong-theme 的 insert 行，移除 node_modules/dsh-xingkong-theme junction 与对应 generation 目录，再重启。
适用场景与注意¶
适合谁：希望在 DSH Web 端长期使用统一深空视觉、并需要在设置页快速核实多模型配置是否真能用的开发者。
权限与安全：主题与探测逻辑以 当前 DSH 进程权限 运行，会向已配置的模型端点发起探测请求；安装前应阅读源码与 MIT 许可证，确认 endpoint 与密钥管理方式符合你的环境策略。
开发与二次修改：若改主题，README 要求画布/内容面板半透明、浮层不透明且走 --dshx-float-*；改完需按顺序跑 node --check、_test_client.js、_test_host.js、deploy.sh。DevTools 受限时，README 提供了 host 写文件、client 写 localStorage 与 Code Cache 旁证等排查通道。
结尾¶
dsh-xingkong-theme 把 DSH Web GUI 的明暗肤、动态星云壁纸和设置页模型探测收进同一本地主题包；部署依赖 deploy.sh 的 junction 链，而不是手抄 node_modules。更多截图与版本说明见 GitHub README，社区索引见 SkillHub 插件页。
