安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 简单
- 适合新手
- 可以尝试
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
dsh-dream-skin 9.29.0 基于 DSH 官方 Theme Token 提供八套原生主题、壁纸(本地图/URL/渐变,新增裁剪填满、完整显示、模糊填充三种填充方式)、玻璃材质与各区域透明度、强调色、主题包导入导出与分享链接。
需要DSH 界面、主题、侧边栏能力的用户。
安装前准备
- DSH 0.2.0-rc.2(必需):通过 npx 运行 `@deepseek-ai/[email protected]`,并使用独立的 web Profile 测试。
- Node.js 18+(必需):插件 engines 声明 Node.js >=18。
- 可信壁纸来源(可选):使用图片 URL 壁纸时只填写可信的 HTTPS 图床地址。
如何安装 dsh-dream-skin
本页命令固定使用 DSH 0.2.0-rc.2,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
webProfile- DSH 基线
0.2.0-rc.2- 安装来源
- npm 预构建包(锁定版本)
9.29.0 声明的 DSH 版本范围包含 0.2.0-rc.2,本页固定 DSH 0.2.0-rc.2。仅静态复核,未在本站运行验证。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。npm 预构建包(锁定版本)npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected] - 03确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-dream-skin或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile web --dump-config - 04启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/[email protected] web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-dream-skin插件专属配置
设置 → 外观(Theme)- 切换皮肤、强调色、壁纸与填充方式、玻璃材质透明度,导入或导出主题包。
$DSH_HOME/dream-skin.json- Host 端保存的外观偏好,跨端口和重启保持;由插件自动读写,不需要手改。
主题包文件(*.dsh-theme.json) · json。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
{
"format": "dsh-dream-skin/pack",
"version": 1,
"manifest": {
"id": "aurora-test",
"name": "Aurora Test",
"nameZh": "极光测试",
"author": "RevolutionLA",
"version": "1.0.0",
"colorScheme": "dark",
"accent": "#34d399",
"tokens": {
"--dsw-alias-bg-base": "#04120f",
"--dsw-alias-bg-layer-1": "#0a1d18",
"--dsw-alias-brand-primary": "#34d399",
"--dsw-alias-label-primary": "#eafaf2",
"--dsw-alias-label-secondary": "#92d5b8",
"--dsw-alias-border-l1": "#0f2a22",
"--dsw-alias-border-l2": "#1a3a30"
}
}
}- 重启 DSH Web 后打开 设置 → 外观(Theme),确认出现皮肤、强调色、壁纸与主题包等设置行。
- 先使用内置皮肤和本地图片或渐变壁纸;需要图片 URL 时只填可信 HTTPS 地址,定时刷新按需手动开启。
配置检查与成功结果
- 01导出 web Profile 组合配置,确认 dream-skin 加载条目存在。复制验证命令
npx --yes @deepseek-ai/[email protected] --profile web --dump-config期望结果:输出中出现 id 为 dream-skin、name 为 dsh-dream-skin 的条目。
- 02启动 DSH Web,在 设置 → 外观(Theme)切换一套内置皮肤。复制验证命令
npx --yes @deepseek-ai/[email protected] web期望结果:界面配色立即切换;刷新页面后仍保持所选皮肤。
- 03在浏览器开发者工具控制台读取 window.__DSH_DREAM_SKIN_STATUS__。
期望结果:build 为 9.29.0,status 为 ready。
第一次使用建议这样验证
- 在 设置 → 外观(Theme)选择 nebula 皮肤,把壁纸切到本地图片并选择“模糊填充”。
- 导入示例主题包 sample-theme-pack.json,应用“极光测试”后再导出一份作为备份。
它可能接触哪些数据和能力
浏览器端注册主题、注入一个材质 <style> 并用 MutationObserver/定时器给宿主 DOM 打标记以调整透明度;读写 dsh-dream-skin:* localStorage 键与诊断全局量 window.__DSH_DREAM_SKIN_STATUS__;Host 端注册 /dream-skin/api(Host/Origin 信任围栏,非认证)并原子写入 $DSH_HOME/dream-skin.json(0600)。不读取模型凭据、不注册 Agent 工具、不启动子进程。
数据存储:浏览器 localStorage 的 dsh-dream-skin:* 键,以及 $DSH_HOME/dream-skin.json(经 /dream-skin/api 读写,文件权限 0600)。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- 升级后外观设置整体消失
- DSH 0.2.x 会跳过 peer 不满足的插件;确认已安装 9.29.0 而不是 0.4.10,并查看 DSH 启动日志中的插件跳过记录。
- 图片 URL 壁纸不显示
- 只支持 http、https 与 data:image 链接;检查图床可访问性,或改用本地图片和渐变。
- 安装时提示新版本被拒绝
- 可能是 pnpm 最小发布年龄策略拦截新版本;按作者 README 的更新说明处理,或稍后重试。
- 运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-dream-skin,并重启 DSH Web。
- 如不再需要外观偏好,删除 $DSH_HOME/dream-skin.json,并在浏览器中清除该 DSH 地址下的 dsh-dream-skin:* localStorage 键。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
9.29.0 的 6 条 @deepseek-ai/dsh-client-* peer 为 >=0.1.0-rc.6 <0.3.0-0,按 semver 7 includePrerelease 计算满足 0.2.0-rc.2,也覆盖 0.1.x;0.3.x 被明确排除。@deepseek-ai/cordis ^4.0.1 与 react ^18.2.0 不在宿主预检范围。以上为声明层面兼容,52DSH 未在 0.2.0-rc.2 上运行验证;作者自述在 0.2.0-rc.1 上复核,未覆盖从 npm 全新安装路径。要求 Node.js >=18。
数据流
内置 Token、导入的主题包 JSON 或 URL hash 分享链接 → 客户端格式与 CSS 值校验 → Theme Runtime、localStorage 与 /dream-skin/api → $DSH_HOME/dream-skin.json;选择图片 URL 壁纸时浏览器直接请求该图片主机(出厂预填 uapis.cn bing-daily 链接,但默认壁纸为内联 SVG、定时刷新默认关闭);开启定时刷新后按间隔带时间戳重新拉取;插件自身未发现遥测或其他外部请求。
源码审阅结论
已静态复核 npm 包与 v9.29.0 tag 的绑定(SHA-512 与 dist.integrity 一致,tarball 与锁定提交去除行尾差异后逐字相同,lib/ 为直接提交的 JS)、0.4.10→9.29.0 的 Host API(lib/index.js 未变)、客户端 fetch/网络调用、出厂默认值、分享链接导入与 CSS 值过滤。打开带主题 hash 的链接会直接导入主题包(无二次确认);图片 URL 壁纸和定时刷新会让浏览器向第三方图床暴露 IP 与 UA;卸载不会删除 $DSH_HOME/dream-skin.json 与 localStorage。版本号自 8.28.0 起为日期式 M.D.X,非接管。未执行插件,未在 DSH 0.2.0-rc.2 上做运行时验证。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08f3df46cca1- 固定提交
4e63b25e187f- 许可证
- MIT
- 主要语言
- JavaScript
- 中文资料
- 有完整中文配置资料