dsh-exv-theme 0.0.0-stage → 2.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VMW_HW
+
+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/README.md

@@ -1,3 +1,112 @@
-# Temporary Holding Version
+# DSH EXV Theme
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**DSH EXV Theme** — 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 制作的科幻 HUD 主题包：纯黑底 + 青色 HUD、分层视差背景、代码雨与扫描波、15 个 Live2D 主人物、可自定义的 HUD 组件。完全自包含，不依赖任何外部资源服务。
+
+A self-contained sci-fi HUD theme pack for DeepSeek Harness: black-and-cyan HUD, layered parallax backdrop, code rain, 15 Live2D characters and a customizable HUD. Everything ships inside the package — no external asset server, no network calls.
+
+<img width="2560" height="1440" alt="EXV theme screenshot" src="https://github.com/user-attachments/assets/81479d15-ee22-496d-b08e-70d3425adbcf" />
+<img width="1164" height="761" alt="EXV theme screenshot" src="https://github.com/user-attachments/assets/6776baa6-0037-4aa7-81f3-ddfd19eb3fd9" />
+<img width="1164" height="540" alt="EXV theme screenshot" src="https://github.com/user-attachments/assets/ebb79364-d4fb-4806-9ea1-cc9436a773c1" />
+<img width="808" height="809" alt="EXV theme screenshot" src="https://github.com/user-attachments/assets/cb75588d-ba86-4986-bd5e-2e9e56d4cd84" />
+
+## 安装 / Install
+
+从 2.3.0 起这是一个标准的 DSH 插件包（一个安装入口，包含三个子插件）。
+
+**图形界面（推荐）**
+
+侧边栏 **Plugins → Add plugin**，填入包名：
+
+```text
+dsh-exv-theme
+```
+
+**命令行**
+
+```bash
+# 桌面端（Windows 客户端）
+dsh plugin --profile desktop add dsh-exv-theme
+
+# Web / CLI profile
+dsh plugin --profile web add dsh-exv-theme
+```
+
+安装完成后重启 DSH（或按提示刷新页面）。主题会在 **Plugins** 页显示为一个 bundle，包含三行可单独开关的插件：
+
+| 插件 | 作用 |
+| --- | --- |
+| `dsh-exv-cyan-theme` | 黑色 + 青色 HUD、背景编辑面板、组件系统、桌面模式 |
+| `dsh-exv-parallax-bg` | 视差背景、代码雨 / 扫描波、15 个 Live2D 主人物 |
+| `dsh-exv-flat-corners` | 去掉界面圆角 |
+
+**离线安装包**
+
+不想用插件市场或 npm 时，下载 [Releases](../../releases) 里的 `DSH-EXV-Theme-<版本>.zip`，解压后双击 `install.cmd`。它会关闭 DSH、安装三个插件、更新 profile 并重新启动。两种方式装的是同一套代码。
+
+**从 2.2.x 升级**
+
+2.2.x 的包名是 `@local/*`。请先卸载旧版，再按上面的方式安装 2.3.0；离线安装器会自动清理旧条目。
+
+## 功能 / Features
+
+- **背景**：default / chips / cyberpunk / starsky / frankfurt 五种预设，可调节位移呼吸、亮度呼吸。
+- **代码雨**：帧率 30/60、分辨率 720P/1K/2K、密度 25–200%、下落速度 25–200%，支持 2D/3D 扫描波与点击涟漪。
+- **主人物**：关闭 / 静态（9 个立绘）/ 动态（15 个 Live2D 模型，入场 + 待机循环，眼神与头部跟随鼠标，待机时会偶尔瞟一眼屏幕中心）。
+- **LOGO**：三种预设，可调大小与呼吸。
+- **HUD 组件**：时间 / 峰谷状态 / 余额 / 剪贴板，可拖动、缩放、单独开关；余额支持本金与赠金明细、实时消耗速率。
+- **其他**：桌面模式、拖拽照明、指针照明、方角界面（flat-corners）。
+
+配置保存在浏览器 `localStorage`（`dsh-exv-theme.config.v1`），面板左下角可一键恢复默认。
+
+## 系统要求 / Requirements
+
+- Windows 10 / 11（x64）桌面端；Web 端同样可用。
+- DeepSeek Harness `>= 0.2.2-rc.1 < 0.3.0`（`engines.dsh`）。
+- 主题依赖宿主的内部 DOM 结构与类名，DSH 大版本升级后需要等主题跟进。
+
+## 权限与数据 / Permissions
+
+- 不访问网络，不上传任何数据，不读写用户文件。
+- 不调用系统命令，不修改宿主安装目录。
+- 唯一写入的是 `localStorage` 里的主题配置；卸载后配置保留，可在设置里清除。
+
+## 卸载 / Uninstall
+
+- **Plugins** 页找到 `dsh-exv-theme` → Remove；或
+  ```bash
+  dsh plugin --profile desktop remove dsh-exv-theme
+  ```
+- 离线版：双击 `uninstall.cmd`。
+
+## 默认设置 / Defaults
+
+- Live2D 帧率 120（30/60/90/120）
+- 代码雨 60 FPS、2K、密度与速度 100%
+- 拖拽照明强度 100%（滑条居中）
+- 暂停策略：仅页面最小化时暂停；切到其他窗口继续运行
+
+## 已知限制 / Known limitations
+
+- M4 SOPMOD II 4507 N/D 与 M4 SOPMOD II MOD 三个模型本身没有眼动参数，面板会自动隐藏眼动开关。
+- 首次加载与冷切换 Live2D 模型需要解码资源，会有一瞬间卡顿；切换过的模型（LRU 2）可秒切。
+- 2K + 120 帧对集成显卡有压力，可在面板里降档。
+- 桌面模式只隐藏主对话流，输入框仍保留。
+- 4K 全屏下扫描波峰值仍可能掉帧（2K 分辨率满帧）。
+
+## 从源码构建 / Build from source
+
+`plugins/parallax-bg/client.js` 是约 40 MB 的构建产物，**不进 git**，只随 Release 和 npm 包分发。需要自行构建时见 [BUILDING.md](BUILDING.md)：准备 `assets/`（图片与 Live2D 模型）和 `vendor/`（Cubism Core / Pixi / cubism4），然后运行
+
+```bash
+node tools/build-parallax.mjs
+```
+
+## 许可证与第三方 / License
+
+- 本项目自写的代码采用 [MIT](LICENSE) 许可。
+- `parallax-bg` 内嵌的 Live2D Cubism Core、pixi.js、pixi-live2d-cubism4，以及《少女前线》的模型与美术素材**不在 MIT 范围内**，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+- 本项目是爱好者作品，与 Sunborn / MICA Team / Live2D 株式会社没有隶属或授权关系；角色素材仅供学习与个人测试，请勿用于商业用途。
+
+## 反馈 / Feedback
+
+请开 Issue，并附上 DSH 版本、Windows 版本、安装方式（npm / 离线包 / 源码自建）和相关日志。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,76 @@
+# 第三方组件与素材声明 / Third-Party Notices
+
+本仓库**自写的代码**采用 MIT 许可证（见 [LICENSE](LICENSE)）。
+下列第三方组件与素材**不在 MIT 授权范围内**，其版权与使用条件归各自权利人所有。
+
+## 0. 适用范围 / Scope
+
+MIT 只覆盖本项目自写的源代码、构建脚本与文档；**不覆盖**插件产物里内嵌的第三方组件与角色素材，尤其包括：Live2D Cubism Core、pixi.js、pixi-live2d-cubism4，以及《少女前线》的模型与美术素材。它们仍归各自权利人所有，不在 MIT 下再授权。
+
+> 这一段原先附在 LICENSE 末尾，导致 GitHub 把整个仓库识别为 "Other / NOASSERTION"；现在只保留纯 MIT 正文，适用范围放在这里。
+
+---
+
+## 1. Live2D Cubism Core
+
+- **内嵌位置**：`plugins/parallax-bg/client.js`（压缩后的 `Live2DCubismCore`）
+- **版权**：`(C) 2019 Live2D Inc. All rights reserved.`
+- **许可**：Live2D Proprietary Software License Agreement（专有软件许可协议）
+- **协议全文**：<https://www.live2d.com/eula/live2d-proprietary-software-license-agreement_en.html>
+- **文件内声明**：该文件对应协议中的 "Redistributable Code"（可再分发代码），授权声明原文保留在打包产物中，**请勿删除或修改**。
+
+使用与再分发时请注意（依据上述协议）：
+
+- 不得删除或改写产物中 Live2D 的版权、商标与许可声明（6.1 条）；
+- 不得对再分发代码适用 MIT 等「开放源码类许可证」（协议 5.3.2 条所指的 excluded license）；
+- 再分发需遵守协议的 5.2 条（保留主要功能、要求下游接受同等保护、原样再分发等）；
+- 如将本项目用于公开分发的衍生作品，请自行确认是否需要与 Live2D 签订「出版许可协议」；个人、小规模事业者与教育机构在协议 2.2 条下有豁免条件，具体以协议原文为准。
+
+---
+
+## 2. pixi.js
+
+- **版本**：v6.5.10
+- **内嵌位置**：`plugins/parallax-bg/client.js`
+- **许可**：MIT License
+- **版权**：Copyright (c) 2015-2021 Mat Groves / Goodboy Digital
+- 产物内保留了原始 MIT 许可 banner。
+- 项目主页：<https://github.com/pixijs/pixijs>
+
+---
+
+## 3. pixi-live2d-cubism4
+
+- **版本**：1.3.2
+- **内嵌位置**：`plugins/parallax-bg/client.js`
+- **许可**：MIT License
+- **作者**：guansss
+- 项目主页：<https://github.com/guansss/pixi-live2d-cubism4>
+
+---
+
+## 4. Live2D 模型与角色素材
+
+- **素材内容**：15 套 Live2D 模型（`.moc3`、WebP 贴图、全部 `motion3.json` 动作、`physics3.json`），内嵌于 `plugins/parallax-bg/client.js`。
+- **来源**：手机游戏《少女前线》（Girls' Frontline）。
+- **权利归属**：角色形象与模型资产版权归**上海散爆网络科技有限公司（Sunborn Network Technology）**及相关权利人所有。
+- **使用范围**：本项目将其用于**学习、研究与个人测试**，**禁止任何商业用途**。
+- **非官方声明**：本项目为爱好者作品，与 Sunborn / MICA Team / 云母组 **无任何隶属、授权或背书关系**。
+
+---
+
+## 5. 其他图像素材
+
+`plugins/` 内嵌的背景图、LOGO、角色立绘与缩略图同样来自上述作品的公开素材，仅用于个人学习与展示，版权归原权利人所有。
+
+---
+
+## 6. 再分发提示
+
+如果你 fork、镜像或二次分发本项目：
+
+1. 请完整保留本文件与 `LICENSE`；
+2. 不要把 Live2D 模型素材用于商业产品或公开商业分发；
+3. 不要删除打包产物中的第三方版权与许可声明。
+
+如权利人认为本仓库中的任何素材存在不妥，请通过 Issue 联系，确认后会尽快移除相关内容。

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+- insert:
+    - id: parallax-bg
+      name: 'dsh-exv-parallax-bg'
+    - id: flat-corners
+      name: 'dsh-exv-flat-corners'
+    - id: cyan-theme
+      name: 'dsh-exv-cyan-theme'

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect x="5" y="5" width="54" height="54" fill="#000000" stroke="#00fff0" stroke-width="4"/>
+  <path d="M20 20h24M20 32h18M20 44h24" stroke="#00fff0" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/index.js

@@ -0,0 +1,9 @@
+/**
+ * Umbrella bundle for the EXV theme pack.
+ *
+ * The Host half only declares the three plugin rows through cordis.patch.yml;
+ * every piece of runtime code lives in the dsh-exv-* sub-packages, so this
+ * package stays small and the sub-packages can be published and versioned on
+ * their own. Installing this package installs the whole theme.
+ */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "EXV HUD Theme",
+    "description": "Sci-fi cyan HUD theme pack: layered parallax backdrop, code rain, Live2D characters, and a customizable HUD."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "EXV 科幻 HUD 主题包",
+    "description": "黑青科幻 HUD 主题包：视差背景、代码雨、Live2D 主人物，以及可自定义的 HUD 组件。"
+  }
+}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "dsh-exv-theme",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.3.0",
+  "type": "module",
+  "description": "Sci-fi cyan HUD theme pack for DeepSeek Harness: layered parallax backdrop, code rain, Live2D characters, and a customizable HUD.",
+  "license": "MIT",
+  "author": "VMW_HW",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "theme",
+    "hud",
+    "live2d",
+    "cyberpunk"
+  ],
+  "engines": {
+    "dsh": ">=0.2.2-rc.1 <0.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VMWHW/dsh-exv-theme.git"
+  },
+  "homepage": "https://github.com/VMWHW/dsh-exv-theme#readme",
+  "bugs": {
+    "url": "https://github.com/VMWHW/dsh-exv-theme/issues"
+  },
+  "dependencies": {
+    "dsh-exv-cyan-theme": "2.3.0",
+    "dsh-exv-parallax-bg": "2.3.0",
+    "dsh-exv-flat-corners": "2.3.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
 }