dsh-theme-holo 0.0.0-stage → 1.0.7

package/INSTALL.md

@@ -0,0 +1,191 @@
+# 安装 dsh-theme-holo
+
+三种方式，按推荐顺序排列。装完都要**重启 DSH**。
+
+---
+
+## 环境要求
+
+| 项 | 要求 | 说明 |
+| --- | --- | --- |
+| DeepSeek Harness | `>=0.2.0-rc.1 <0.3.0-0` | 用了 `webServer` 路由、`theme.overrideTokens`、`slots` 等接口，低于此版本会静默不生效 |
+| Node.js | `>=22` | DSH 自带运行时即满足 |
+| 操作系统 | Windows / macOS / Linux | 已在 Windows 11 + DSH 0.2.1-rc.2 实测 |
+| 磁盘 | 约 16 MB | 其中素材约 15 MB（`素材/动画/` 六段视频 12.9 MB） |
+| 第三方依赖 | 无 | 没有 npm 依赖，不需要 `pnpm install` |
+
+---
+
+## 方式一：应用内安装（推荐）
+
+DSH 的插件管理器接受 Git 地址。打开：
+
+```
+设置 → 插件 → 添加插件
+```
+
+填入：
+
+```
+github:1015677515/dsh-theme-holo
+```
+
+点安装，等它下载完，然后**立即启用**，再重启 DSH。
+
+> **【未验证】** 这条 `github:` 路径没有在隔离环境里逐步实测过。如果你的 DSH
+> 版本解析失败（提示找不到包、或下载后不显示在列表里），请直接用下面的方式二。
+
+> 从 GitHub 下载时若卡住，可在插件管理器里把**安装源**换成国内镜像；
+> 但镜像只替代 npm 注册表，不替代 GitHub 仓库下载，GitHub 直连不通时仍需代理。
+
+---
+
+## 方式二：本地目录 + `link:` 依赖（一定可用）
+
+**第 1 步**，把仓库下载到本地任意目录（下称 `<插件目录>`）。
+
+```cmd
+git clone https://github.com/1015677515/dsh-theme-holo.git "A:\你的路径\dsh-theme-holo"
+```
+
+**第 2 步**，打开 profile 的 `package.json`：
+
+```
+%USERPROFILE%\.dsh\profiles\desktop\package.json
+```
+
+加入两处（其余内容保持不动）：
+
+```jsonc
+{
+  "dependencies": {
+    "dsh-theme-holo": "link:A:/你的路径/dsh-theme-holo"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": [
+        "dsh-theme-holo"
+      ]
+    }
+  }
+}
+```
+
+> `link:` 后面用**正斜杠**，路径里不要有空格；Windows 盘符写法是 `link:A:/...`。
+> Linux / macOS 写成 `link:/home/you/dsh-theme-holo`。
+
+**第 3 步**，在 profile 的 `node_modules` 下建一个目录链接。
+
+Windows（管理员 PowerShell 或 cmd）：
+
+```cmd
+mklink /J "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-theme-holo" "<插件目录>"
+```
+
+Linux / macOS：
+
+```bash
+ln -s "<插件目录>" ~/.dsh/profiles/desktop/node_modules/dsh-theme-holo
+```
+
+**第 4 步**，重启 DSH。
+
+---
+
+## 方式三：解压压缩包 + `link:` 依赖
+
+不打算用 git 的话：
+
+1. 下载仓库的 ZIP，解压到 `<插件目录>`
+2. 照方式二的第 2–4 步做
+
+---
+
+## 装好之后
+
+重启完成、开场动画播完，界面变成羊皮纸色就是生效了。
+
+如果检测到 `dsh-whale-widget` 挂件，会弹一次「要不要把赫萝装进挂件」的对话框。
+选择「安装」会把「赫萝」「赫萝Q版」两个角色和一条「愣住」语音写进挂件；
+不想装就选「暂不安装」，之后不再弹。详见
+[README 的小鲸鱼联动一节](README.md#小鲸鱼挂件联动)。
+
+---
+
+## 自检：确认装对了
+
+打开「设置 → 插件」，应能看到 `dsh-theme-holo`，版本号与
+[`package.json`](package.json) 一致，描述是中文。
+
+再进插件详情页，应看到：
+
+- 顶部一张 1920×620 的封面横幅
+- 下方「插件设置」区，含开关若干（探头、开场动画、黑夜模式等）
+
+两处都在，说明宿主半与浏览器半都加载成功。
+
+如果只有版本号、没有设置区，通常是 `cordis.patch.yml` 没被读到——
+检查 profile 的 `dsh.profile.bundles` 里有没有 `dsh-theme-holo`。
+
+如果出现的是默认蓝色图标而不是赫萝图标，检查 `package.json` 的
+`icon` 字段是否指向 `assets/icon.jpg`。
+
+---
+
+## 卸载
+
+删掉方式二里加的两行（`dependencies` 一行、`bundles` 一行），重启即可。
+
+插件所有效果都挂在自己的 fiber 上：样式表、片头层、偷看层、档案卡、浮动字标、
+麦田、待机画面、日志标签属性，都会随 fiber 一起移除，不会在页面上留下任何东西。
+
+目录本身和 junction 可以留着（下次启用只需把两行加回来），也可以一并删掉。
+
+**注意**：插件写过的 `localStorage` 键（探头位置、开关状态等）不会自动清除。
+要彻底清干净，在浏览器控制台执行：
+
+```js
+Object.keys(localStorage)
+  .filter(k => k.startsWith('dsh-theme-holo.'))
+  .forEach(k => localStorage.removeItem(k))
+```
+
+若装过小鲸鱼联动，角色与语音写在 `%USERPROFILE%\.dsh\whale-roles\` 与
+`%USERPROFILE%\.dsh\whale-audio\`，需要的话手动删除对应文件。
+
+---
+
+## 常见问题
+
+**桌面版启动就崩，日志里是 `Unexpected token '\uFEFF'`？**
+
+不是本插件的问题。profile 配置清单 `%USERPROFILE%\.dsh\profiles\desktop\package.json`
+开头被写入了 UTF-8 BOM，DSH 的引导层用 `JSON.parse` 直接解析它，遇 BOM 即抛错、Host 退出。
+
+**本插件从不写这个文件。** 去掉文件开头 3 个字节（备份后改）、确认文件能被 `JSON.parse`
+读通，再重启 DSH 即可。**别用 PowerShell 5.1 的 `Set-Content -Encoding UTF8` /
+`Out-File -Encoding UTF8` 改它**——那两种写法必定写 BOM。
+
+完整说明见 [README 常见问题](README.md#常见问题)。
+
+**装完没有任何变化？**
+
+按 F12 打开控制台，看有没有 `[dsh-theme-holo]` 开头的报错。没有报错但也没效果，
+多半是 `bundles` 没登记——重启一次通常解决。
+
+**开场动画每次都播，很烦？**
+
+插件设置里点「关闭开场动画」，之后启动直接进界面。设置记在 `localStorage`。
+
+**颜色太淡 / 想换深色？**
+
+插件设置里有「黑夜模式」开关。深色是测试功能，未完全适配，谨慎打开。
+
+**和 `dsh-plugin-wallpaper-engine` 的液体玻璃一起用时动画发虚？**
+
+那是壁纸插件的 `backdrop-filter` 雾化导致的，不是本插件的问题。
+关掉壁纸插件的「液体玻璃」即可恢复清晰。
+
+---
+
+[← 返回 README](README.md) · [更新记录](CHANGELOG.md) · [问题反馈](https://github.com/1015677515/dsh-theme-holo/issues)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1015677515 (https://github.com/1015677515) and holoiallo (https://github.com/holoiallo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,49 @@
+# 适用范围 / Scope
+
+本文件说明 `LICENSE`（MIT）覆盖什么、不覆盖什么。
+
+This file explains what the MIT `LICENSE` covers and what it does not.
+
+---
+
+## 源代码 / Source code
+
+`LICENSE` 中的 MIT 许可**仅适用于本项目的源代码**——即仓库里的 JavaScript、JSON、
+YAML 与 Markdown 文件。
+
+The MIT license in `LICENSE` applies **only to the source code of this project** —
+that is, the JavaScript, JSON, YAML, and Markdown files in this repository.
+
+---
+
+## 素材 / Assets
+
+`LICENSE` **不适用于** `assets/` 与 `素材/` 目录下的图像、动画与音频素材。
+
+The MIT license does **not** extend to the image, animation, and audio assets
+under `assets/` and `素材/`.
+
+这些素材来自网络，为个人非商业用途收集并二次加工，并非本项目作者原创，
+原作者已难以逐一追溯。此处不主张、也不授予任何权利。
+
+Those assets were collected from the internet and edited for personal,
+non-commercial use. They are not original works of this project's authors, the
+original creators could not be traced individually, and no rights over them are
+claimed or granted here.
+
+若你是权利人，认为某件素材不应出现在本仓库，请开
+[issue](https://github.com/1015677515/dsh-theme-holo/issues) 告知，提出后即予移除。
+
+If you are a rights holder and object to any asset appearing in this
+repository, please open an
+[issue](https://github.com/1015677515/dsh-theme-holo/issues) and it will be
+removed on request.
+
+---
+
+## 仅限学习交流 / Learning and personal use only
+
+本项目仅供学习与交流使用，不得用于商业用途。
+
+This project is provided for learning and personal use only, not for
+commercial purposes.