dsh-startup-secret
DeepSeek Harness 的启动界面与启动动画插件（二次创作版）。
暗色赛博风格开机动画：黑幕党徽标识 → 过曝洗白 → 暗色「技术档案」底板 →
五步交互式访问授权 → 色散故障揭幕。右下角配赛博电子风人物立绘（可切换，也可设为「空」）。
播放方式可三档设置：完全自动播放 / 仅需点击一次进入 / 不自动播放。
全程配背景音乐：可以只用内置合成曲（两种曲风），也可以填一个链接或本机文件换成自己的曲子；
台词出声时自动压混。
安装后首次启动还会弹出一次「降世」事件窗口（可在设置里改成每次都弹）。
本作品为二次创作，仅用于学习交流，没有任何商业用途。如有侵权，请联系移除。
更新记录
v1.5.2
- 修「点试听没声」 根因是 Host 半侧还在跑旧代码（客户端 bundle 会在窗口加载时重建，
Host 只在进程启动时加载），
/dsh-startup/bgm 路由不存在 → 404 → <audio> 静默失败。
- 试听不再静默 先给
正在读取… / 正在播放… 状态；路由缺失、解码失败、被自动播放策略
挡住，各有明确文案（路由缺失时直接提示「完全退出（含托盘）再启动」）。
- 面板自检 Host 版本 读
/config 时若 defaults.bgmSource 缺失，就在背景音乐分组
顶部亮橙色告警，不用再猜。
- 测试增至 348 项断言（
smoke-client 新增 9 项真实点击试听的用例）。
v1.5.1
- 响度整体抬高约 2.5 倍 默认音量 0.4 → 0.55，主增益 0.85 → 1.25，
各层乐器增益提高 60–90%，压缩器阈值收到 −14 dB 当限幅器用；琶音之外新增一条
「动机」钟声长音 —— 上一版确实太轻，笔记本扬声器上像没放。
- 可以换成自己的背景音乐 设置页「音乐来源」可选
内置合成 / 自定义，
自定义支持两种填法：音频直链（mp3 / m4a / aac / wav / ogg / flac / mp4），
或本机绝对路径（D:\music\jun-ge.mp3，中文与空格都行）。带「试听 12 秒」。
本机文件由 Host 新增的 /dsh-startup/bgm 路由下发（扩展名白名单、80MB 上限、
Range、信任栅栏）。
- 「点击任意位置开启声音」提示 浏览器把音频挂起时，画面底部出现一条呼吸的
小提示，点一下起播后淡出 —— 不再让人以为"音乐没做"。
- 抖音 / B 站分享链接不能直接用（那是网页不是音频），需要先把音频存到本机再填路径。
- 测试增至 334 项断言，新增本地音频路由的端到端用例。
v1.5.0
- 背景音乐（默认开启） 整段开机动画的底噪，三层全部 WebAudio 现场合成：
低频垫底（sub bass + 底鼓）、暗色和声铺底（Dm–Bb–F–C）、16 分琶音 + 短噪声镲。
不打包任何音乐文件、不发网络请求，也不牵进第三方音乐版权，直接用
file:// 打开预览页也能响。详见 AUDIO-FIELDS.md。
- 强度跟着动画走 黑幕只有一层薄垫 + 一声很轻的心跳；底板出来后抬到第二档，
鼓点与琶音进来；揭幕前一段上行扫频把最后那下光爆托起来；镜头后撤时淡出，不硬切。
- 台词自动压混 念台词时音乐压到 34%，念完自动抬回；多句重叠用计数管理。
- 两个内置曲风
电影感氛围（84 BPM，默认）/ 工业脉冲（100 BPM）。
- 设置页新增「背景音乐」面板 开关、音量、曲风；关掉不影响台词与音效。
- 新增
test/bgm-audio.mjs（45 项断言），全套 297 项断言通过。
v1.4.0
- 自动播放三档 设置里的「需要人工确认」换成
自动播放：完全自动播放 /
仅需点击一次进入（需空密码）/ 不自动播放。旧配置按 requireInteraction
自动迁移，升级无感；顺带修掉「不自动播放」连按第二下 Enter 被吞的问题。
- 降世事件窗口改为默认关闭 安装后首次启动弹一次，之后不再出现；
设置里勾选后恢复每轮都弹。
- 人物立绘新增「空」 最后一项「空（不显示立绘）」，右下角完全不渲染立绘。
- 修复「立即预览」看不到刚保存的设置 重播前先拉最新配置。
- 测试增至 242 项断言，并补测跨设备环境（无 WebAudio / 无语音合成 /
隐私模式 / 小屏 / 移动端 / 全新 profile 安装）。
v1.3.1
- 终幕「黑框」改为透明底 + 国旗金字 WELCOME 那一幕中间那行
（原为黑底白字方块）底色去掉，字色改为五星红旗星徽黄
#FFDE00，
并加一层暖金外发光，在纯黑终幕里像一块发亮的铭牌。配色散副本也从
红/蓝改成同一支金的两侧色散（偏橙 / 偏浅黄）——红蓝加色混合会把金字
洗成脏白；光晕峰值时刻这一行仍保持纯金，只有上下两行转青。
- 三张人物立绘换新 长征（中山装）、长征（J装）、长征（最美好的主唱）
三款立绘更新为红黑霓虹线稿风格，与第一款长征（水手服）统一。
- 修复 Windows 安装脚本在别的机器上可能失效的问题
安装.cmd / 打开预览.cmd 原先存为 UTF-8，而简体中文 Windows 控制台
默认码页是 GBK(936)。cmd.exe 按字节数定位下一行，编码不匹配时会丢失
同步，表现为 echo 被吞掉、下一行被当外部命令执行、变量被吃
（例如 %PROFILE% 直接消失）。现已改为 GBK + CRLF，本机实测三个
分支（找不到安装包 / 找不到 dsh / 找不到预览页）中文提示均完整。
仓库另加 .gitattributes 锁定该约定，避免往返一趟被规范化回去。
v1.3.0
- 新增访问密码、事件窗口、真声台词与界面音效。
- 新增赛博电子风人物立绘（4 款可切换）。
- 设置页扩充至三十余项。
功能
开机序列 冷启动时播一段完整的开机动画，六幕连贯：厂牌标识 → 过曝洗白 →
暗色底板 → 五步授权 → 揭幕。中央一圈环形准星缓慢自转，缺口留在正下方，
不会挡住底部文字。
可交互，不是播片 第一、二步要你点按钮或按 Enter 才会继续（可以关掉）。
右上角有跳过按钮，Esc 也能跳。
访问密码（可选） 可在设置页为第二步「身份资料确认」设置访问密码，
密码输对才能继续，输错会提示并停留在原地。密码留空则不启用。
中文主字 + 英文等宽副标题 英文副标题逐字打出来，像终端在接收数据。
赛博电子风人物立绘（可切换） 从第一步授权起，右下角亮出人物形象，带霓虹辉光
呼吸与偶发信号抖动。设置页「视觉」板块可在 4 款立绘之间切换，风格贴合赛博电子质感。
事件窗口（可选） 动画全部结束后，会在主界面中央弹出一张事件图片窗口，提示
「向前！向前！向前！ / 按下 Enter 进入」。按 Enter 或点击窗口任意处即可进入主界面；
设置页「视觉」板块可开关。无任何操作 20 秒后也会自动放行，避免卡死挡住主界面。
真声台词 + 界面音效 五句台词和终幕欢迎语都是真声素材，界面音效取自同一段素材。
浏览器要求先有一次点击才准出声，所以点过按钮之后才会听到声音。
背景音乐（可关，可换成自己的曲子） 内置曲是三层 WebAudio 现场合成：低频垫底
（sub bass + 底鼓）、暗色和声铺底、16 分琶音与一条钟声动机，跟着剧情推进换强度，
揭幕前上行扫频、镜头后撤时淡出；一开口念台词就自动压混，念完抬起。
没有任何音乐文件，所以离线、file:// 预览、没有网络的机器都能响。
想换成自己的曲子：设置页「音乐来源」选「自定义」，填音频直链或本机文件路径即可，
旁边能试听 12 秒。浏览器把音频挂起时，画面底部会出现「点击任意位置开启声音」。
语音没播完不会推进 每一步停留多久由实际音频时长决定。你点得快也不会把语音掐断。
三十余项设置 身份名称、编号、权限等级、访问密码、人物立绘、事件窗口、
配色、速度、音色、语速、开口留白、每处文案……都能在设置页实时改，改完立即生效。
播放序列
| # | 中文主字 | 英文副标题 | 需要操作 |
|---|
| 1 | 需要访问许可 | ACCESS PERMISSION REQUIRED | 点按钮 / 按 Enter / 空格 |
| 2 | 身份资料确认 | IDENTITY VERIFICATION | 点按钮 / 按 Enter / 空格 |
| 3 | 接收访问需求 | ACCESS REQUEST RECEIVED | 自动 |
| 4 | 开始读取权限 | PERMISSION READ STARTED | 自动 |
| 5 | 读取完毕 · 核验通过 | READ COMPLETE · VERIFIED | 自动 |
| 6 | 欢迎「身份名称」访问 | WELCOME, NAME | 自动 |
安装
推荐用脚本安装（脚本会自动完成下面两步，避免漏掉关键步骤）：
- Windows：解压后双击「安装.cmd」
- macOS / Linux：
./install.sh（可加参数 ./install.sh desktop 装到桌面端）
手动安装（两步，缺一不可）
DSH 加载插件依赖 dsh.profile.bundles 层堆栈，但 dsh plugin add 只是
pnpm add 的转发，只写 dependencies、不会自动把包名加入 bundles。
漏掉第二步，插件会"装上了但完全没效果"（不报错、无动画、设置页无入口）。
第 1 步：安装依赖
dsh plugin --profile web add ./dsh-startup-secret-1.3.1.tgz
第 2 步：把插件加入 bundles（关键）
打开 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 数组里加入
"dsh-startup-secret"：
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-startup-secret"
]
}
}
（desktop profile 同理，文件在 ~/.dsh/profiles/desktop/package.json。）
装完重启 dsh web（关掉启动器窗口再重新双击）。重启后刷新页面就能看到启动动画，
设置页里会多出一项「启动动画」。
环境要求
| 项 | 要求 |
|---|
| 平台 | DSH web profile（含 DeepSeek Harness Desktop 桌面端） |
| Node | >= 20 |
| 依赖 | 无（不需要 npm install） |
卸载
dsh plugin --profile web remove dsh-startup-secret
设置选项
装好后进入 DSH 设置页 →「启动动画」。
播放
| 选项 | 默认 | 作用 |
|---|
| 启用 | 开 | 总开关，关掉就完全不播 |
| 显示模式 | 每次会话 | 每次会话 一个浏览器会话播一次 / 总是 每次刷新都播 / 每天 一天一次 |
| 主题 | 暗色 | 暖白 参考片原色 / 暗色 暗底板 |
| 速度 | 1× | 整段动画的快慢，0.35 – 3 倍 |
| 自动播放 | 完全自动播放 | 三档：完全自动播放（全程不停、无需操作）/ 仅需点击一次进入（开头停一次，需空密码）/ 不自动播放（第 1、2 步都等确认，即旧版「需要人工确认」）。旧配置的 requireInteraction 会自动迁移 |
| 允许跳过 | 关 | 是否显示右上角跳过按钮、是否响应 Esc |
身份资料
| 选项 | 默认 | 作用 |
|---|
| 身份名称 | Pavel Korchagin | 终幕「欢迎 xxx 访问」里的名字 |
| 身份编号 | 89757 | 第二步身份卡上的编号，建议填数字 |
| 权限等级 | 3 | 第二步身份卡上的权限等级 |
| 访问密码 | 空 | 第二步「身份资料确认」的访问密码；留空则不启用密码校验 |
语音
| 选项 | 默认 | 作用 |
|---|
| 语音播报 | 开 | 是否念台词 |
| 语音来源 | 真声素材 | 真声素材 用内置录音 / 系统 TTS 用浏览器合成音 |
| 音色 | 自动（优先神经网络女声）-US | 五个内置真声音色，选音色即决定语种与嗓音 |
| 音量 | 0.9 | 台词音量 |
| 播报前提示音 | 开 | 念台词前先响两声轻提示，更像系统播报 |
内置五个音色（均为随包内联的真声素材，无需联网）：
| 音色选项 | 说明 |
|---|
| 自动（优先神经网络女声）-US | 英文神经网络女声，默认 |
| 智性少女音-CN | 中文少女音 |
| 清冷优雅-日语 | 日语女声 |
| 威严铿锵宣示-朝鲜语 | 朝鲜语男声播报 |
| 清冷脆弱-俄语 | 俄语女声 |
界面音效
| 选项 | 默认 | 作用 |
|---|
| 界面音效 | 开 | 文字出现、阶段推进、按钮确认的「哒」声 |
| 音效音量 | 0.5 | 界面音效音量（不影响台词） |
| 音效来源 | 内置素材 | 内置素材 用录音 / 现场合成 用代码合成 |
背景音乐
| 选项 | 默认 | 作用 |
|---|
| 背景音乐 | 开 | 整段动画的底噪；可只用内置合成曲，也可换成自己的音频 |
| 音乐来源 | 内置合成 | 内置合成 三层 WebAudio 现场合成（不含音乐文件）/ 自定义 用你给的链接或本机文件 |
| 音频链接 / 本机路径 | 空 | 直链（mp3 / m4a / aac / wav / ogg / flac / mp4）或本机绝对路径（D:\music\a.mp3）；右侧「试听 12 秒」 |
| 曲风 | 电影感氛围 | 仅内置合成时生效：电影感氛围 84 BPM 慢而暗 / 工业脉冲 100 BPM 八分推子 + 四拍底鼓 |
| 音乐音量 | 0.55 | 音乐音量，独立于台词与音效；台词出声时自动压混 |
抖音 / B 站 / 网易云的分享链接是网页不是音频文件，粘进去放不出来；请先把音频下载到本机，再填文件路径。
视觉
| 选项 | 默认 | 作用 |
|---|
| 强调色 | #c70000 | 阶段条、进度条、准星的红 |
| 故障色 A / B | #ff3b30 / #ce0912 | 揭幕那下色散故障的红 |
| 人物立绘 | 第 1 款（默认） | 在 4 款赛博电子风立绘之间切换；最后一项「空」= 不显示立绘（mascot: -1） |
| 降世事件窗口 | 关 | 勾选后每次动画结束都弹事件窗口（按 Enter / 点击进入）；不勾选时只在安装后的首次启动弹一次 |
文案
| 选项 | 默认 | 作用 |
|---|
| 品牌三行 | 银河意识体 / LONG MARCH HARNESS / 长征机 人民公仆 | 左上角品牌块 |
| 黑幕三行 | 伟大智能统辖 / GREAT INTELLIGENT DOMINATION / 愿无一人被遗忘 | 开场黑幕上的字 |
| 终幕方框 | 亚洲人民统辖体 | 揭幕后中央的黑底白字框 |
| 页脚 | Powered By LONG MARCH | 右下角页脚 |
声明
本作品为二次创作，仅用于个人学习与交流，没有任何商业用途。
本作品的视觉风格、图形素材（党徽、人物形象）与音频素材的相关权利均归原权利人所有，
本作品不对上述内容主张任何权利，亦未获得任何形式的授权或背书。
任何人基于本作品进行的再修改、再分发等行为，产生的侵权、纠纷或任何法律责任，
均由该行为人自行承担。
本作品未授权任何商业用途。
如有侵权，请联系移除。
