# 主页 · 使用手册

给用它的人。想改代码的看 [AGENTS.md](AGENTS.md)，想追根究底的看 [README.md](README.md)。

## 现在是什么样

打开 DSH（或刷新页面）之后的顺序是：

1. **整屏就是那支 PV**，全屏铺满、循环播放；
2. 右下角一个 **`/ sound` 面板**（音量），左下角一个 **`/ esc` 面板**（返回）；
3. **按 Esc** 就回到 DSH 界面，落点是**默认窗口**（空白会话）——不是你上次在聊的那个。

**默认是静音的。** 这是浏览器的硬规则：没有用户手势不许带声自动播放，静音是它唯一无条件允许的状态。所以第一次打开你要自己点一下。

## 三个操作

| 想做什么 | 怎么做 |
|---|---|
| **回到 DSH** | 按 **Esc**（或点左下角那个「返回 DSH 界面」面板） |
| **开声音 / 静音** | 点右下角 `/ sound` 面板，或按 **M** |
| **调音量** | 鼠标滚轮停在 `/ sound` 上滚，或按 **↑** / **↓** |

音量与静音**会被记住**：下次打开还是你上次调的那个值。所以「首次默认静音」那个设置只影响第一次。

面板 3 秒不动会自动变暗到 34%，动一下鼠标就恢复——不想让它挡住画面。

## 设置在哪

**设置 → 插件 → 「主页」**。和其他插件卡片一样是**收起的**，点一下标题才展开。

| 项 | 什么意思 |
|---|---|
| **开启主页** | 总开关。关掉再刷新，就完全是 DSH 原生的启动页——不注入任何东西，也不发影片请求 |
| **打开默认窗口而不是上次会话** | 就是「每次打开都落到空白会话」。关掉它，DSH 会恢复上次的对话，主页只当一张背景图 |
| **循环播放** | 关掉＝放一遍后停在最后一帧等你按 Esc |
| **首次默认静音** | 关掉＝第一次就尝试带声播放。浏览器多半还是会拦，那它会自动退回静音——不会卡住 |
| **显示 esc 提示框** | 关掉只留音量按钮 |
| **标题栏跟随影片配色** | 主页播放时，右上角那三个窗口按钮会变成影片的深色；返回界面时恢复应用配色。关掉就一直是应用主题 |
| **画面适配** | 「完整呈现」＝整幅 16:9 完整显示，多出来的地方留黑边（默认）；「铺满裁切」＝填满窗口并按比例裁掉超出的部分。窗口不像 16:9 时裁得很凶：1280×820 的窗口左右各裁 89px，片子里左边那个聊天窗口就没了 |
| **初始音量 / 返回时的淡出时长 / 画面压暗** | 字面意思。压暗设 0 就是原片不动 |

**改完刷新页面生效**（不用重启 DSH）。展开的卡片里还有「显示主页 / 返回界面」两个按钮可以就地预览，以及 Host 实际在送的那个影片的信息。

## 常见问题

**没有声音**
先点一下 `/ sound` 面板或按 `M`。还是没声音，看下面两条：
- 想看永久免点击：Chrome/Electron 里多点几次（积累媒体参与度），或在系统里给这个应用的音频权限放开；
- 面板上显示 `MUTED` 说明**当前**是静音态，不是坏了。

**主页没出现 / 还是 DSH 原来的启动页**
1. 设置里确认「开启主页」是开的；
2. 影片文件在不在：`assets/video/film.mp4`。Host 找不到它时**故意不注入**（宁可回到原生启动页，也不给一块黑屏），并在 Host 日志留一条告警；
3. 地址加 `?dshpvdiag=1` 刷新，左上角会显示这是哪一步断的。

**主页先黑了一两秒才出画面**
`moov` 索引表在文件末尾了。设置卡片里那行影片信息会标「未优化」。用任意工具把 `moov` 前置（`ffmpeg -movflags +faststart`）再替换文件即可，替换后不用改任何代码。

**卡住了，Esc 也没反应**
理论上不会：Esc 的监听是在脚本一执行就同步挂上的，比影片加载、比偏好读取都早，影片解码失败也照样有效。真遇上就把窗口关掉重开；如果重开还是这样，那是这个插件坏了——把 `cordis.patch.yml` 里 `- insert: - id: pv-home` 那两行删掉即可完全恢复（见下）。

**我想彻底关掉它**
两个办法，任选：
- 温和：设置 → 插件 → 主页 → 关掉「开启主页」，刷新。插件还在，只是什么都不做；
- 彻底：把 profile 的 `cordis.patch.yml` 里这两行删掉，再删掉 `node_modules/dsh-pv-home` 链接，重开 DSH。Windows 上是 `tools\uninstall-live.ps1`。

**每次打开都是空白会话，我上次的对话去哪了**
没丢。它还在左边会话列表里，点一下就回去。这是「打开默认窗口而不是上次会话」的本来意思：DSH 只是**不再自动打开**上一次那个，不是删除。

**这样会不会攒出一堆空会话**
不会。每次回到默认窗口时，DSH 会**复用**同一个空白会话（同一个工作区、同一个目录下的那个仍然是空白的会话）；只有你上一次真的聊过内容之后，下一次才会开一个新的空白会话 —— 这正是「又开了一轮新对话」的意思。

**我不想每次都回默认窗口**
设置里关掉「打开默认窗口而不是上次会话」。这样主页还在，但 DSH 会像以前一样恢复上次的对话。

**右上角那三个窗口按钮会跟着影片变深**
这是故意的，也是可以关的：设置里「标题栏跟随影片配色」。关掉就一直是应用主题色。
它只能改**颜色**——那三个符号的形状是系统画的，插件改不了。

**锁屏的时候也想看到它**
已装好一个**视频屏保**（Windows 锁屏界面本身不支持视频，屏保才是唯一能播放的地方）。**它是静音的** —— 开机第一版会自己唱起来，已改成默认静音。
`cmd /c "%LOCALAPPDATA%\dsh-pv-home\PvScreensaver.scr" /s` 可以立刻看一次；想开声音、想只在一块屏上放、想改时间或撤销，看 [README.md](README.md) 的「锁屏时也播放它」。

**屏保怎么会有两路声音（已修）**
那是双显示器的 bug：每块屏各一个窗口、各解码一遍同一条音轨，叠加起来是一条发闷加倍的音轨。现在**无论几块屏，只有一路出声**。如果你其实是想让画面只出现在一块屏上，`install.ps1 -Screens primary`。

## 侧栏那颗锁屏按钮

它**不在这个插件里**，是另一个独立插件 `dsh-lock-button`（同样有独立的开关与卸载路径）。
侧栏左下角、和「一键重启」「远程控制」同排。它有两种方式，设置里切：

- **先播放 PV**（默认）：点一下全屏放这支 PV，一动鼠标就落到登录界面。**这是唯一能看到「锁屏时在放 PV」的路子** —— Windows 自己的锁屏界面不能放视频，必须先起屏保、退出时再锁。它靠带 `/lock` 启动本插件的屏保来实现；屏保不在位就自动退回直接锁屏。
- **直接锁屏**：立刻锁，等效于 `Win+L`，不放任何东西。

两条都值得知道的细节：
- 点完之后上方会浮出「正在锁屏…」，**解锁回来时它已经清掉了**（成功后排了 2 秒的定时器，另外窗口一重新获得焦点也会立刻清）—— 上一版会一直挂着，那是 bug。
- **改了锁屏方式要重启 DSH**（Host 半侧的改动不会热更新）；只是显示/隐藏按钮的话刷新页面就够。

卸载与全部细节看它自己的仓库 `dsh-lock-button` 的 README（设置 → 插件 → 「锁屏按钮」里也有开关）。


## 关于这支片子

它是**非官方同人作品**，不是这个插件的一部分：

- B 站 [BV1xCai6aE9g](https://www.bilibili.com/video/BV1xCai6aE9g/)，上传者 西西弗斯的风车；
- 角色美术按 **CC BY-NC-SA 4.0** 分享（**不得商用**，再改编按同协议分享），署名链见 [NOTICE.md](NOTICE.md)；
- 音乐是 **Mili - world.execute(me);**，权利归 Mili，个人非商业二创按官方指引使用；
- 片中含 **AI 生成画面**，分享时不能描述成「全部非 AI」。

**自己看没问题；要往外发（截图、录屏、二次发布）请先把 NOTICE.md 读一遍。**