前言¶
DeepSeek Harness 的终端形象偏功能向：窗口打开就直接进入会话。想在启动阶段给使用者一段明确的“正在就绪”提示、而不是靠口头约定，可以让插件接管启动画面。toska1102/poi_theme-dsh-startup-screen 就是这个方向的实现，它在 DSH 启动时播放一段仿《疑犯追踪》The Machine 视觉风格的冷白终端动画，并把播放频率、总时长、音效、跳过行为等全部做成可配置项。
下面介绍这个插件的来源、能力、安装方式与设置项，并说明运行权限与素材授权方面需要注意的地方。
这是什么¶
- 插件名：poi-theme-dsh-startup-screen（仓库名 poi_theme-dsh-startup-screen），版本 2.1.1。
- 维护方：仓库由 Toska1102 维护；项目核心基于 6shenhonghong9/dsh-startup-screen 二次开发，原作者为沈宏宏，package.json 的 author 字段也保留为沈宏宏。
- 定位：macOS DeepSeek Harness 的启动动画插件。冷白终端、16 路摄像头时间线、关键帧放大和双实体锁定组成十阶段连续演出，默认约 9 秒。
- 许可：MIT，沿用上游仓库的许可证与版权声明。
技术形态上，仓库根目录即完整插件，包含全部运行代码、图片、字体和可选人声，不需要构建，也没有额外运行依赖。入口在 lib/index.js，客户端代码在 lib/client.js；engines.node 要求 >=20。
核心功能¶
下面只列 README 中写明的能力，未在资料中出现的行为不在此说明。
1、十阶段连续演出。冷白终端界面依次推进摄像头时间线、关键帧放大、双实体锁定等阶段，终幕显示 DSH 标识。
2、一次确认即可放行。第 03 帧只需点击一次 GRANT ACCESS，也可以按 Enter 或空格；之后自动播放到终幕。人工等待时间不计入默认约 9 秒的演出时长。终幕默认文案为 what are your commands？，可在设置中修改。
3、播放频率可控。默认在每次完全退出并重新启动 DSH 时播放一次；刷新窗口、切换会话、打开设置都不会重复播放。也可以改成每天首次、仅手动预览或完全关闭。
4、常用设置项：身份、播放频率、6–15 秒总时长、终幕文案、人声与短音效开关、各自音量、是否允许跳过。
5、高级设置项：各阶段时长、镜头运动、扫描与锁定速度、效果强度、减少动态效果策略。
6、总时长与阶段时长联动。调整总时长会按比例缩放各阶段；调整某阶段时长会自动更新总时长。每组设置都支持恢复默认，保存后可立即预览。
7、跟随系统减少动态效果。默认跟随 macOS 的减少动态效果设置，并保持同样的播放时长。
8、声音行为可预期。短音效默认开启，人声默认关闭。开启人声后，六段录音按原速播放，对应阶段会等待播放结束，实际时长可能超过 9 秒。允许跳过时，按 SKIP 或 Esc 会立即结束演出并停止声音。
9、素材缺失时的降级。图片或录音加载失败时省略对应素材，不会阻断启动。
10、加载兜底。自动启动超过 1 秒仍无法显示时直接放行；设置页里的主动预览有独立的加载窗口。
安装与启用¶
安装方式不是命令行 dsh plugin add，而是在 DeepSeek Harness 的插件页面通过 Git 链接添加。下面的地址来自 README 的安装说明：
https://github.com/Toska1102/POI_theme-dsh-startup-screen
启用插件名 poi-theme-dsh-startup-screen。如果同时安装了原版启动插件，需要先停用原版，避免两个启动流程互相干扰。按 DSH 的提示应用更改；需要重启时，先把正在运行的任务结束掉再重启。
典型用法¶
安装启用后，重新完全退出并启动 DSH，默认会看到约 9 秒的冷白启动演出：进入第 03 帧时点击 GRANT ACCESS，之后自动播放至终幕。
设置入口在 DSH 设置页的「POI 启动动画」。比如要做两个常见调整：把总时长拉到 15 秒让各阶段更舒展，或者只保留每天首次启动时播放，都可以在这里完成；改完保存即可预览。想临时跳过演出，只需在允许跳过的前提下按 SKIP 或 Esc。
配置保存在固定路径，便于备份或脚本化管理：
$DSH_HOME/dsh-startup.json
默认路径：~/.dsh/dsh-startup.json
已有配置中受支持的设置会被保留，升级或重装时不必重新手填。
适用场景与注意¶
适合这几类使用者：希望在启动阶段给使用者一个明确就绪信号的 DSH 桌面用户；想要自定义启动文案与时长的玩家；以及想研究 DSH 插件接入方式（dsh.client.inject、dsh.bundle.patch 等字段）的开发者。
需要注意三点。
1、插件以当前 DSH 进程的权限运行。安装前建议先打开仓库检查源码与许可证，确认内容符合自己的使用环境。代码部分为 MIT 许可，但 MIT 不覆盖第三方音视频素材。
2、声画素材的授权需要单独确认。六段人声沿用上游素材，上游说明前五段录音来自第三方视频，欢迎录音为自制素材，相关授权范围须单独确认。POI 相关名称与视觉风格不代表官方关联或授权。视觉上参考了 rosehahah/the-machine 的 MPOV 规范，但本轮未复制该参考项目的代码；四张背景为生成图片；Share Tech Mono 来自 Google Fonts，OFL 许可证保留在 lib/assets/sharetechmono-OFL.txt。
3、该插件定位为启动体验层，不改变 DSH 的对话、会话与工具调用逻辑。如果组织内部对启动画面有合规要求（第三方音视频素材、生成图片的使用范围），建议先在测试环境验证，再决定是否推送。
小结¶
这个插件的价值在于把启动动画做成了配置完整的插件：播放时机、时长、音效、跳过行为都有明确开关，素材缺失和加载超时也有降级路径，不会因为一个画面卡住 DSH 启动。目录页与仓库地址如下，源码与许可证请在安装前自行核对。
- 目录页：https://www.skillhub.cn/plugins/Toska1102/POI_theme-dsh-startup-screen
- GitHub：https://github.com/Toska1102/POI_theme-dsh-startup-screen
