前言¶
DeepSeek Harness（DSH）桌面版启动后通常直接进入对话界面。若希望在首屏做一段可控的「开机仪式」——星尘、角色名、状态卡、接入确认，再溶解进主界面——需要自己改前端或写 bundle，成本和维护都不低。维护者 2524034412-boop 在 GitHub 仓库 2524034412-boop/DSH 中提供了插件 dsh-star-boot（README 中亦称「星图开机」）：在 DSH 启动时插入一整屏片头，素材、配色、字体与位置可在设置或同源控制页中调整。社区目录 SkillHub 上的 DSH 条目 将其归类为「趣味换装」。下文介绍其能力、安装方式与典型改法；事实以仓库 README 与 package.json 为准。
这是什么¶
dsh-star-boot 是 DSH 的 client bundle 插件：在 Harness 启动时播放整屏片头（星尘 → 名字 → 状态卡 → 接入确认 → 两段式溶解进对话界面），Esc 或点击可随时跳过。代码许可证为 MIT；随包视频与图片素材另有说明，见仓库 NOTICE-assets.md。
引擎要求（来自 package.json）：Node ≥ 20，DSH >=0.2.0-rc.1，可选 peer react ^18.2.0。当前资料中插件版本为 1.8.0。
片头节奏与交互¶
README 给出的时间线如下（节奏可在设置里用「快 / 标准 / 慢」缩放等待，不改变交互逻辑）：
0.0s 黑场 + 星点浮现
0.5s 细线 + 眉标
0.8s 名字逐字点亮
1.0s 素材从 1.07 缩放到 1、浮起
1.2s 打字机一句 + 状态卡（记忆 / 心情 / 压力 / 最在意）
2.6s 过曝一闪 → 接入确认四条逐条点亮（01 身份 … 04 通道）
停住等人：点击或 Enter 进入（2.6 秒没人动就自己进）
素材跟播开着时，视频播完才进场（最多 15 秒）
→ 两段式溶解：内容先淡、背景后淡
「素材跟播」最长等待 15 秒；更长视频会被切断。浏览器自动播放策略可能导致音效不响，插件会安静失败、不报错。
核心功能¶
模式与外观¶
| 能力 | 说明 |
|---|---|
| 模式 | 关闭 / 简洁（只有片头）/ 状态卡 |
| 节奏 | 快 0.72× / 标准 / 慢 1.35× |
| 开关 | 授权页、立体字、文字叠加、音效、素材跟播等 |
| 配色 | 四套预设或 #rrggbb 主色 |
| 字体与字样式 | 玻璃（默认）/ 描边 / 挤出；标题与立体字大小、透明度可调 |
| 素材 | 适配、位置、压暗、遮罩、模糊；面板位置六向可选 |
| 文案 | 共 7 条（名字、眉标、两句打字行、3D 词、两行小提示），留空即隐藏 |
默认随包背景为 assets/default-bg.mp4，压暗 85、遮罩 60、面板左下、玻璃字、跟播开；无自定义视频时可用 assets/hero.webp 兜底。
素材与配置迁移¶
在「素材」组选择或拖拽本机图片/视频后，插件会拷贝到 <DSH 数据目录>\star-boot-assets 并使用该副本；旧拷贝会自动清理。控制页比设置页多 导出配置 / 导入配置（JSON，可分享或当皮肤）。
宿主侧能力（文件结构）¶
lib/index.js：首帧遮盖、状态卡代理、素材双槽与上传、同源控制页lib/client.js：动画、授权页、外观变量、设置页- 设置内或
http://127.0.0.1:<DSH 端口>/dsh-star-boot/panel可改配置；设置 → 左侧「星图开机」分组为开关 / 外观 / 文案 / 素材
设置 → 星图开机 → 开场底部提供 检查更新 与 一键更新（下载 Release zip、校验、备份旧目录为 dsh-star-boot.bak-<旧版本>）；更新后须重启 DSH，宿主代码仅在启动时加载。
安装与启用¶
安装前：README 写明 Windows 有专用脚本；macOS / Linux 需按「手动安装」三步操作。须已安装 DSH 桌面版并至少启动过一次（Windows 下 %USERPROFILE%\.dsh 须存在）。装错可能导致 DSH 下次无法打开窗口，建议先备份 profile 的 package.json（官方脚本也会自动备份）。
方式一：Release zip（README 推荐）¶
- 到 GitHub Releases 下载
dsh-star-boot-<版本>.zip - 解压后双击
安装.cmd - 重启 DSH
脚本会定位 DSH 数据目录、拷贝到 plugins\dsh-star-boot、修改 profile package.json 的 dependency 与 bundle、建立 node_modules 链接并做孤儿校验；失败会回滚。
方式二：克隆后执行 install.ps1¶
git clone https://github.com/<你>/dsh-star-boot.git
cd dsh-star-boot
powershell -ExecutionPolicy Bypass -File install.ps1
（仓库 README 示例占位为 <你>/dsh-star-boot；本插件源码在 2524034412-boop/DSH，克隆时请以实际仓库 URL 为准。）
方式三：手动（含 macOS / Linux）¶
- 将整个插件目录放到
<DSH 数据目录>\plugins\dsh-star-boot（非 Windows 路径规则以本机 DSH 数据目录为准） - 编辑
<DSH 数据目录>\profiles\<profile>\package.json，增加：
{ "dependencies": { "dsh-star-boot": "link:../../../plugins/dsh-star-boot" },
"dsh": { "profile": { "bundles": ["dsh-star-boot"] } } }
- 在 profile 的
node_modules中建立指向插件目录的 junction 或 symlink - 重启 DSH
卸载可运行仓库中的 卸载.cmd / uninstall.ps1（-Purge 可连同目录删除）。资料中未提供 dsh plugin add github:... 一类命令，请勿凭插件名拼接。
典型用法¶
- 按上文任选一种方式安装并完整重启 DSH（仅刷新页面不够，宿主 bundle 只在启动时加载）。
- 打开 设置 → 星图开机，将模式设为「简洁」或「状态卡」；需要完整接入确认页时保持授权页开关打开。
- 在「素材」中 选择文件… 或向控制页拖入文件，替换背景；留空则恢复随包素材。
- 调整配色、字体、面板位置与 7 条文案；满意后在控制页 导出配置 留档。
- 若片头被跳过：检查模式是否为「关闭」、地址栏是否带
?star=0；若系统开启「减少动画」，1.7.2 起仍会停约 2 秒再继续。
背景 mp4 不播时：宿主需支持 Range（README 称 1.4.2 起已实现）；可暂时关闭「素材跟播」按固定节奏播放。
适用场景与注意¶
适合：希望在 DSH 启动时统一展示角色名、状态卡与接入确认、并愿意通过 GUI 换皮的用户；分类上偏「趣味换装」与个性化首屏，而非对话能力扩展。
注意：
- 插件以当前 DSH 进程权限运行，安装前应阅读
lib/index.js、lib/client.js与 LICENSE，并理解其对 profilepackage.json的修改。 - 安装脚本主要面向 Windows；其他系统依赖手动三步。
- 素材版权与 MIT 代码分离，商用或再分发随包素材需遵守
NOTICE-assets.md。 - 修改外观与素材后刷新页面即可；仅当宿主代码变更时才需重启 DSH。
结尾¶
dsh-star-boot 把 DSH 启动首屏做成可配置的片头流程，安装以 Release zip + 安装.cmd 或手动声明 bundle 为主，日常改外观走设置或 /dsh-star-boot/panel。目录页：https://www.skillhub.cn/plugins/2524034412-boop/DSH；源码与说明：https://github.com/2524034412-boop/DSH。
